-
Notifications
You must be signed in to change notification settings - Fork 59
12_Installation
You may use a Linux, Windows, or macOS machine to create a bootable ESOS USB flash drive.
Here is a list of the install requirements:
- If using a Linux machine, it should be a recent release of a modern Linux distribution (32-bit or 64-bit), with common system tools (dd, cpio, etc.) installed.
- If you're using a Windows host, the required binary programs (dd, ext2fsd, etc.) are all included in the ESOS install package.
- A USB flash drive that is at least 4 GB large.
- The ESOS image/install package available from the downloads page, or a ESOS disk image that you built from source.
- For macOS you'll need to install OSXFUSE and the ext2 FUSE module; see below for details.
Hint: If you're using 'wget' to retrieve the installer package, add the '--content-disposition' flag so the file is named properly.
If using a pre-built image package, you will need to extract it (version 0.1-r656 in our example):
unzip esos-0.1-r656.zip
If using a ESOS image you built from source, you should now be in that directory, otherwise change to the package directory you just extracted:
cd esos-0.1-r656
At this point, you should now plug in the USB flash drive you'd like to install ESOS to; you may need to unmount any file systems on your flash drive if you use a desktop-like Linux distribution (eg, Ubuntu).
The lsscsi tool makes it very easy to find your USB drive SCSI device node (needed during the install). Here is an example of what that looks like:
[root@localhost ~]# lsscsi
[0:0:0:0] disk ATA ST9160412AS D005 /dev/sda
[1:0:0:0] cd/dvd TSSTcorp DVD+-RW TS-L633C DW50 /dev/sr0
[8:0:0:0] disk Kingston DataTraveler G3 1.00 /dev/sdb
In the example above, we clearly recognize "Kingston DataTraveler G3" (hopefully) as our USB flash drive, and we can see the device node is "/dev/sdb" (far right column).
You can now run the installer script (root privileges required):
sudo ./install.sh
The install.sh script will verify the integrity of the ESOS disk image file, check for the required install tools, prompt for the desired SCSI device node to install ESOS on, and finally write the image to disk.
After the image is completely written to your USB flash drive, then installation script will then ask you if you'd like to install any proprietary RAID controller CLI tools (optional). Some of these tools (eg, StorCLI, arcconf, etc.) are required for certain TUI functions in ESOS. The script will print the required files and download locations with instructions on where to place the files and complete the installation.
If you have any installation issues, please use the esos-users Google Group.
The ESOS package (.zip archive) includes all tools required to create a ESOS USB flash drive using a Windows host. The install script has been tested on Windows 7 64-bit and Windows 8[.1] 64-bit machines.
- Download the desired install package from the ESOS downloads page.
- Extract the .zip archive using Windows Explorer.
- Insert your USB flash drive (>= 4 GB).
- Browse to the extract package directory and run the "install.vbs" script.
- Accept (click "Yes") when/if prompted for UAC privilege elevation.
- Follow the interactive install script to complete your ESOS USB flash drive installation.
The standard Linux install script (install.sh) is also compatible for installing from a macOS host. There are a couple requirements before running the install.sh script on macOS:
- Install "OSXFUSE" (FUSE for OS X) from this page: http://osxfuse.github.io
- When installing the above package, choose the MacFUSE compatability option during install wizard.
- Download and install the Ext2 FUSE module (fuse-ext2): http://fuse-ext2.sourceforge.net
After completing the above requirements, you can then continue the ESOS USB flash drive installation. When downloading proprietary CLI tools on macOS, you may need to disable Safari (or others) from extracting/opening the archives on download. The install script expects the archive files to be intact.
- Download the ESOS installation package from the project site.
- Extract the archive (.zip file) if it hasn't already been done for you.
- Open the Terminal application and change to the ESOS package directory: cd esos-trunk_r734
- Next execute the ESOS installation script: ./install.sh
- Follow the interactive install script to complete your ESOS USB flash drive installation.
Once you have successfully installed the ESOS image to a USB flash device, take the flash drive and plug it into your storage server. Then reboot the storage server and set USB devices to first (only) in the boot order. Then proceed to the 21_Initial_System_Configuration page.