Changes between Initial Version and Version 1 of GENIExperimenter/Tutorials/SystematicExprCaseStudy/InstallSoftware

08/12/14 18:03:25 (7 years ago)



  • GENIExperimenter/Tutorials/SystematicExprCaseStudy/InstallSoftware

    v1 v1  
     3'''[ A Tutorial on Systematic Experimental Design]'''
     10<div style="text-align:center; width:495px; margin-left:auto; margin-right:auto;">
     11<img id="Image-Maps_5201305222028436" src="" usemap="#Image-Maps_5201305222028436" border="0" width="495" height="82" alt="" />
     12<map id="_Image-Maps_5201305222028436" name="Image-Maps_5201305222028436">
     13<area shape="rect" coords="12,12,132,73" href="" alt="" title=""    />
     14<area shape="rect" coords="185,12,313,73" href="" alt="" title=""    />
     15<area shape="rect" coords="364,12,490,73" href="" alt="" title=""    />
     16<area shape="rect" coords="493,136,495,138" href="" alt="Image Map" title="Image Map" />
     18<!-- Image map text links - End - -->
     25Our goal is to setup a layer-3 virtual network with multiple virtual routers. Hence, the first step is to install the routing software. There are various options, such as [ `XORP`] and [ `Quagga`]. In this tutorial, we will install XORP to enable routing functionalities on nodes.
     27Sometimes it may take a long time to install software on a node, so it is always good to start with one node to test out the whole installation process. The figure below provides an overview of the software installation to a VM. This process turns a generic VM into a software router.
     31= 1. Reserve a VM with Standard Image =
     33Assume we have a slice created already. We want to reserve a XenVM running a standard Ubuntu image as the basis of the software router. 
     35== a. Create VM from an InstaGENI ==
     37Launch Flack for your slice, and reserve a virtual machine from one of the aggregates (e.g., InstaGENI aggregate at Clemson).
     46<table border="0" cellpadding="0" cellspacing="0"><tr><td><img src="" width="50" height="50" alt="Note"></td><td> Please go to <a href="">HowToReserveVM</a> for details on how to reserve a VM from an aggregate.</td></tr></table>
     47  </li>
     57== b. Select a Standard Image ==
     59Click [[Image(XuanSandbox/InstallSoftware:info.jpg)]] to edit the property of the VM.
     61Select the disk image that is to be loaded to the VM. In this tutorial, we select '''Ubuntu 12.04 LTS'''.
     63[[Image(XuanSandbox/InstallSoftware:flack-vm-property.png, 48%, nolink)]]
     65Click [[Image(XuanSandbox/InstallSoftware:apply.png)]] to save the change.
     67== c. Reserve the VM ==
     69Click [[Image(XuanSandbox/InstallSoftware:flack-submit.png)]] to send the VM reservation request.
     74== d. Login to the VM ==
     76Once the VM allocation is ready (i.e., the canvas turns into green in Flack), we are able to login to the node from a terminal using `ssh`.
     78ssh username@hostname -p xxxxx
     84<table border="0" cellpadding="0" cellspacing="0">
     86<td><img src="" width="50" height="50" alt="Note"></td>
     87<td>  You can find information on how to login to GENI hosts from <a href="">HOWTOLOGIN</a>.</td></tr></table>
     88  </li>
     96= 2. Manual Installation =
     98In this tutorial, we will install `XORP 1.8.5` on `Ubuntu 12.04`, and the installation takes the following steps:
     100 * Install Dependencies
     102$sudo apt-get update
     103$sudo apt-get install libssl-dev
     104$sudo apt-get install ncurses-dev
     105$sudo apt-get install libpcap-dev
     106$sudo apt-get install g++ traceroute
     107$sudo apt-get install scons
     109 * Download XORP source files
     111$cd ~/
     113$tar jvxf xorp-1.8.5-src.tar.bz2
     116 * Compile and build `XORP`
     118$cd xorp
     120$sudo scons install
     123 * Verify the `XORP` installation (Optional)
     125$scons check
     129The whole installation process without the last optional step will take about 40 minutes to complete. Running `scons check` will probably take another hour to complete. If everything goes smoothly, you should be able to find the directory `xorp` under path `/usr/local/`.
     134<table border="0" cellpadding="0" cellspacing="0">
     136<td><img src="" width="50" height="50" alt="Note"></td>
     137<td>  If you try to install other version of XORP, please check the <a href=" XORP Official Website">XORP Official Website</a> for details on the dependencies and installation instructions. </td></tr></table>
     138  </li>
     145= 3. Create Custom Image =
     147From the manual installation procedure, we learned that it is not efficient to login to every VM and then install `XORP`. An alternative way is to create a custom image of `Ubuntu 12.04 LTS` with `XORP` pre-installed, and save this custom image for future usage. We can create InstaGENI custom image via either Flack or Omni, details can be found at [ ManageCustomImageInstaGENI].
     149Here we use Flack to create InstaGENI custom image of `Ubuntu 12.04` that has `XORP` pre-installed.
     151In Flack, for the same VM that we have just installed `xorp`, go to it's node property (i.e., clicking [[Image(XuanSandbox/InstallSoftware:info.jpg)]]), and click the button "Create Image".
     153[[Image(XuanSandbox/InstallSoftware:flack-vm-customimage.png, 60%, nolink)]]
     155In about 10 minutes, you will get an email that has image information similar to the following:
     157Image URN:
     158Image URL:
     164<table border="0" cellpadding="0" cellspacing="0">
     166<td><img src="" width="50" height="50" alt="Note"></td>
     167<td>  The custom image with XORP preinstalled with URL below is ready for use, if you want to skip Step 2 (Manual Installation). </td></tr></table>
     168  </li>
     181If your are going to use the same slice in the next step, now it's time to release the VM resource.
     182 * Use Omni
     184$ -a <aggregate name> deletesliver <slicename>
     187 * Use Flack
     188  * Press the '''Delete''' button in the bottom of your canvas.
     189  * Select '''Delete at used manager''' and '''confirm''' your selection.
     192= 4. Verify InstaGENI Custom Image =
     194Now let's load the custom image created in Step 3.
     196Create a new VM in Flack, and edit the node property. Instead of selecting an advertised image as we did in step 1.b, we will use the URL to the custom image we just created in step 3. Copy an paste the following URL
     197to the URL field.
     204[[Image(XuanSandbox/InstallSoftware:flack-load-customimage.png, 60%, nolink)]]
     206Apply the change, and submit the VM reservation request in Flack.
     208Once the VM is ready to login, we can verify the XORP installation.
     211xuanliu@xen:$ cd /usr/local/xorp/sbin
     212xuanliu@xen:/usr/local/xorp/sbin$ ls  xorp_profiler  xorpsh
     214call_xrl        xorp_rtrmgr
     217= 5. Cleanup the Slice =
     219After verify the `XORP` installation, we can cleanup the slice for next step.
     221 * Use Omni
     223$ -a <aggregate name> deletesliver <slicename>
     226 * Use Flack
     227  * Press the '''Delete''' button in the bottom of your canvas.
     228  * Select '''Delete at used manager''' and '''confirm''' your selection.
     232[ Overview]
     234[ Step II: Small Topology]