This shows you the differences between two versions of the page.
| Both sides previous revision Previous revision Next revision | Previous revision | ||
|
openos [2016/06/20 07:20] payonel [Installing Additional Software] |
openos [2018/01/07 06:46] payonel |
||
|---|---|---|---|
| Line 53: | Line 53: | ||
| {{api:system_ready.png?nolink&600}} | {{api:system_ready.png?nolink&600}} | ||
| - | Install Tool | ||
| - | ------------ | ||
| - | |||
| - | In various places in the documentation we refer to running a command in shell called `install`. This is referring to a versatile tool that comes as part of the OpenOS software package and installation. | ||
| - | |||
| - | To understand more about command line options for `install`, it is recommended to read its man pages by running `man install`, or by reading the man page online [[https://raw.githubusercontent.com/MightyPirates/OpenComputers/master-MC1.7.10/src/main/resources/assets/opencomputers/loot/openos/usr/man/install|here]]. | ||
| - | |||
| - | `install` takes the following actions | ||
| - | |||
| - | - Step One: Scan for Software to Install | ||
| - | |||
| - | First it scans for candidate source filesystems. These are filesystems, such as [[:item:loot disks|loot disks]], that can be used as a software package for installation. If more than one candidate source filesystem is found, it prompts the user, asking | ||
| - | |||
| - | `What do you want to install?` | ||
| - | |||
| - | Followed by a list of disks it found that can be installed. | ||
| - | |||
| - | - Step Two: Scan for Hard Drives | ||
| - | |||
| - | The next step is a scan for candidate target filesystems. These are filesystems, such as hard drives, that can be the target of an install. In the example of installing OpenOS from a loot disk to the hard drive, the hard drive is the target filesystem. Like candidate sources, if `install` finds multiple candidate targets, it asks the user to select one: | ||
| - | |||
| - | `Where do you want to install to?` | ||
| - | |||
| - | Followed by a list of disks it found that can be installed **to**. | ||
| - | |||
| - | - Step Three: Installation | ||
| - | |||
| - | Before continuing with the install, the user is asked for confirmation to install | ||
| - | |||
| - | `Install OpenOS to /mnt/e03/? [Y/n]` | ||
| - | |||
| - | Confirming this step will copy the files from the (e.g.) loot disk to the target filesystem. Software installs may have an optional `.prop` file which can tell `install` whether or not to set the default filesystem the computer should boot to, what label if any to set, and whether the system should reboot when installation is complete. | ||
| - | There is also the option for software disks to provide a fully custom install experience by creating an `.install` file at the root of the disk's filesystem. After confirming the source and target, `install` will invoke `.install` if it exists in the source filesystem. | ||
| - | |||
| - | - Optional Arguments | ||
| - | |||
| - | It is recommend to review the `install` man page for greater details and a full list of supported arguments. But I considered it interesting to mention here that the label of the loot disk can be used as a command line argument for install -- which will refine the candidate search to disks matching that label. | ||
| - | |||
| - | `install openos` | ||
| - | |||
| - | Note that the argument is case insensitive. In a scenario where there would have been multiple software disks available to install, specifying the label in this manner may allow `install` to reduce the candidate selection without prompting the user. | ||
| - | |||
| - | |||
| - | |||
| - | Command Line Interface | ||
| - | ------------ | ||
| - | |||
| - | Installing Additional Software | ||
| - | ------------ | ||
| - | |||
| - | See [[item:loot_disks|Loot Disks]], | ||