== OS Installation ==

[[TOC(WiMAX/dSite*)]]

=== Base OS installation ===

Our platform is built on top of [http://mirrors.mit.edu/ubuntu-releases/12.04.4/ Ubuntu 12.04.04]. The installation iso used was [http://mirrors.mit.edu/ubuntu-releases/12.04.4/ubuntu-12.04.4-server-amd64.iso ubuntu-12.04.4-server-amd64.iso]. The following settings were applied during the installation process:

 1. Choose relevant language and keyboard settings
 2. We expect '''eth2''' is the up-link interface (used to internet access and remote control) and should be interface chosen for installation. It is also expected that '''eth2''' will be connect to a network that will assign it a dhcp address.
 3. Specify a local ''USERNAME/PASSWORD'' combo. Please keep track of this information, it will be required for all setup procedures later on.
 4. Specify Manual partitioning and partition the disk as follows:

    || Number || Type    || Size  || Flags    || File System || Mount Point ||
    || 1      || Primary || 20GB  || Bootable || Ext4        || /           || 
    || 2      || Primary || 20GB  ||          || Ext4        || /home       ||
    || 3      || Primary || 116GB ||          || Ext4        || /export     ||
    || 4      || Primary || 4GB   ||          || Swap        ||             ||
 5. Leave the http Proxy field empty
 6. specify '''NO AUTOMATIC UPDATES'''. This is important as the auto-update process may break some orbit packages. 
 7. Choose opensssh server in the task selection menu. All other tasks will be installed as seprate packages and do not need to be specified here.
 

'''Note:'''
 * If no explicit instruction is given for a setting, it's safe to assume the default should work. 
 * This version of Ubuntu does not work well with USB flash disk installations, The best results are with a  burned CD/DVD and a USB CD/DVD drive as a the boot medium,[https://lists.ubuntu.com/archives/foundations-bugs/2014-February/182463.html refrenced here].

=== Configure Host Name ===

/etc/hosts
/etc/hostname

=== Configure Networking ===
* Four networks
* Data
* CM
* Control
* Outside

Setup networking as follows on the console host

{{{
# This file describes the network interfaces available on your system
# and how to activate them. For more information, see interfaces(5).

# The loopback network interface
auto lo
iface lo inet loopback

# The CM network interface
auto eth1
iface eth1 inet static
      address 10.1.0.254
      netmask 255.255.255.0
      broadcast 10.1.0.255

# The Control network interface
auto eth3
iface eth3 inet static
      address 10.10.0.254
      netmask 255.255.255.0
      broadcast 10.10.0.255

# The  Data network interface
auto eth0
iface eth0 inet static
      address 10.20.0.254
      netmask 255.255.255.0
      broadcast 10.20.0.255

# The primary network interface
auto eth2
iface eth2 inet dhcp
}}}