12_Installation

Marc A. Smith edited this page Mar 2, 2017 · 3 revisions

Install Prerequisites

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.


Installing ESOS (Linux)

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.


Installing ESOS (Windows)

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.

  1. Download the desired install package from the ESOS downloads page.
  2. Extract the .zip archive using Windows Explorer.
  3. Insert your USB flash drive (>= 4 GB).
  4. Browse to the extract package directory and run the "install.vbs" script.
  5. Accept (click "Yes") when/if prompted for UAC privilege elevation.
  6. Follow the interactive install script to complete your ESOS USB flash drive installation.

Installing ESOS (macOS)

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:

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.

  1. Download the ESOS installation package from the project site.
  2. Extract the archive (.zip file) if it hasn't already been done for you.
  3. Open the Terminal application and change to the ESOS package directory: cd esos-trunk_r734
  4. Next execute the ESOS installation script: ./install.sh
  5. Follow the interactive install script to complete your ESOS USB flash drive installation.

Next Steps

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.