Fixes #160 Signed-off-by: Mark D Horn <mark.d.horn@intel.com>
Clear Linux Installer
Clear Linux OS Security
As the installer is a part of the Clear Linux OS distribution, this program follows the Clear Linux OS Security processes.
Dependencies
The following bundles are required in order to run clr-installer:
- sysadmin-basic (for kbd)
- storage-utils
- network-basic
How to test?
Make sure you have any extra storage device, an USB memory stick should work fine, the installer will detect and use it if you choose.
Clone this repository
git clone https://github.com/clearnlinux/clr-installer.git
Build the installer
cd clr-installer && make
Install (installing the installer)
To create a bootable image which will launch the installer, use the installer-image.yaml in the scripts directory.
To create a raw image file and perform a Clear Linux install to it.
sudo .gopath/bin/clr-installer --config scripts/installer-image.yaml
Create a bootable installer on USB media:
sudo .gopath/bin/clr-installer --config scripts/installer-image.yaml -b installer:<usb device>
Note: Replace
<usb device>by your usb's device file, i.e/dev/sdb, in that case your command would look like:sudo .gopath/bin/clr-installer --config scripts/installer-image.yaml -b installer:/dev/sdb
Testing [Run as root]
In order to execute an install the user must run clr-installer as root. It's always possible to tweak configurations and only save the configuration for future use, in that case it's not required to run as root.
Having said that, to run a install do:
sudo .gopath/bin/clr-installer
Multiple Installer Modes
Currently the installer supports 2 modes (a third one is on the way):
- Mass Installer - using an install descriptor file
- TUI - a text based user interface
- GUI - a graphical user interface (yet to come)
Using Mass Installer
In order to use the Mass Installer provide a --config, such as:
sudo .gopath/bin/clr-installer --config ~/my-install.yaml
Using TUI
Call the clr-installer executable without any additional flags, such as:
sudo .gopath/bin/clr-installer
Reboot
If you're running the installer on a development machine you may not want to reboot the system after the install completion, for that use the --reboot=false flag, such as:
sudo .gopath/bin/clr-installer --reboot=false
or if using the Mass Installer mode:
sudo .gopath/bin/clr-installer --config=~/my-install.yaml --reboot=false