close Warning: Can't synchronize with repository "(default)" (/common/SVN/wimax does not appear to be a Subversion repository.). Look in the Trac log for more information.

Version 11 (modified by msherman, 9 years ago) ( diff )

OS Installation

Table of Contents

    Base OS installation

    Our platform is built on top of Ubuntu 12.04.04. The installation iso used was 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
    1. Leave the http Proxy field empty
    2. specify NO AUTOMATIC UPDATES. This is important as the auto-update process may break some orbit packages.
    3. 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.
    4. Answer Yes to installing grub on the local boot disk
    5. Remove the media (and the drive if needed) and reboot.


    • 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,refrenced here.

    Configure Host Name

    A important initial step specifying the hostname of the console. Many of the later services will depend heavily on this name resolution. It is assumed that the general form of the console's fully qualified domain name (FQDN) is console.geni.DOMAIN, where DOMAIN comes from your organization. As an example the DOMAIN for Rutgers is

    To set the host name edit the follow files (here we assumed that DOMAIN =

    • /etc/hosts - Local file for name resolution. e.g.       localhost console
      # The following lines are desirable for IPv6 capable hosts
      ::1     ip6-localhost ip6-loopback
      fe00::0 ip6-localnet
      ff00::0 ip6-mcastprefix
      ff02::1 ip6-allnodes
      ff02::2 ip6-allrouters
    • /etc/hostname - Modify this file to properly resolve the hostname of the machine. e.g.

    Configure Networking

    For proper console operation, The console is expected to be connected to 4 Networks. Their respective names and purposes are:

    • Data - For experiment traffic, Ideally this is in a separate switch plane to avoid mixing / clobbering control traffic
    • CM - Low speed network for soft control of power and terminal output of each node
    • Control - Management and control traffic to the Nodes. This network is used for imaging and is needs to be fast. Ideal on a non-blocking switch with good back plane throughput.
    • Outside - External access for the console. Mostly for remote control and package updates.

    To establish the proper address spaces, we put appropriate rules in the /etc/network/interfaces file. We assume the following mapping of interfaces to subnets:

    # 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 Control network interface
    auto eth3
    iface eth3 inet static
    # The  Data network interface
    auto eth0
    iface eth0 inet static
    # The CM network interface
    auto eth1
    iface eth1 inet static
    # The primary network interface
    auto eth2
    iface eth2 inet static

    Note: The dns-nameservers is a temporary setting, we'll need to reconfigure the console to resolve against it self once the DNS service is installed

    Additional Instructions when using 14.04 instead

    Also edit /etc/default/grub, and make sure the lines match the below:



    Then run sudo update-grub

    Note: See TracWiki for help on using the wiki.