Changes between Version 74 and Version 75 of GENIExperimenter/Tutorials/SystematicExprCaseStudy/SmallTopo/DesignSetup


Ignore:
Timestamp:
05/08/17 09:26:43 (7 years ago)
Author:
lnevers@bbn.com
Comment:

--

Legend:

Unmodified
Added
Removed
Modified
  • GENIExperimenter/Tutorials/SystematicExprCaseStudy/SmallTopo/DesignSetup

    v74 v75  
    7676{{{
    7777#!html
    78 <table border="0" cellpadding="0" cellspacing="0"><tr><td><img src="http://trac.gpolab.bbn.com/gcf/raw-attachment/wiki/Graphics/stock_notes.png" width="40" height="40" alt="Note"></td><td> The download command does not allow naming it simply uses the slice name to generate a RSpec file.  We have save a copy of this RSpec, which you may choose to download, available at <a href="http://www.gpolab.bbn.com/exp/sysexpr/rspec-for-wiki/4node-v1.rspec">here</a> </td></tr></table>
     78<table border="0" cellpadding="0" cellspacing="0"><tr><td><img src="http://trac.gpolab.bbn.com/gcf/raw-attachment/wiki/Graphics/stock_notes.png" width="40" height="40" alt="Note"></td><td> The download command does not allow naming it simply uses the slice name to generate a RSpec file.  We have save a copy of this RSpec, which you may choose to download, available at <a href="https://github.com/GENI-NSF/geni-tutorials/blob/master/SystematicExprCaseStudy/4node-v1.rspec">here</a> </td></tr></table>
    7979  </li>
    8080</ol>
     
    266266== d. Automate `OSPF` Configuration ==
    267267
    268 By understanding the syntax of the `OSPF` configuration file for `XORP`, we are able to automate the `OSPF` configuration for every virtual router in a topology, assuming these virtual routers are identical. You can download the automation scripts from [http://www.gpolab.bbn.com/exp/sysexpr/xorp_autostart.tar.gz XORPAutoStart].
     268By understanding the syntax of the `OSPF` configuration file for `XORP`, we are able to automate the `OSPF` configuration for every virtual router in a topology, assuming these virtual routers are identical. You can download the automation scripts from [https://github.com/GENI-NSF/geni-tutorials/blob/master/SystematicExprCaseStudy/xorp_autostart.tar.gz XORPAutoStart].
    269269
    270270=== i. Test the Automation ===
     
    279279Last login: Mon Jun 30 14:56:51 2014 from 128.89.69.127
    280280xuanliu@router-3:~$ cd /local
    281 xuanliu@router-3:/local$ sudo wget http://www.gpolab.bbn.com/exp/sysexpr/xorp_autostart.tar.gz
     281xuanliu@router-3:/local$ sudo wget https://github.com/GENI-NSF/geni-tutorials/blob/master/SystematicExprCaseStudy/xorp_autostart.tar.gz
    282282xuanliu@router-3:/local$ sudo tar -zxvf xorp_autostart.tar.gz
    283283xuanliu@router-3:/local/xorp_autostart$ /bin/bash start-xorp.sh
     
    342342[[Image(GENIExperimenter/Tutorials/SystematicExprCaseStudy/SmallTopo/DesignSetup:import-rspec-from-file.png)]]
    343343
    344 Now, we are ready to add an install script by editing the node property. For each node, click [[Image(GENIExperimenter/Tutorials/SystematicExprCaseStudy/SmallTopo/DesignSetup:info.jpg)]] to see the node information. By clicking [[Image(GENIExperimenter/Tutorials/SystematicExprCaseStudy/SmallTopo/DesignSetup:add-service-btn.png)]], we are able to add a service that usually refers to an install script. In this tutorial, we will add an install script called `xorp_autostart.tar.gz`, by entering the link ''http://www.gpolab.bbn.com/exp/sysexpr/xorp_autostart.tar.gz'', and the install path is set as ''/local''. By clicking [[Image(GENIExperimenter/Tutorials/SystematicExprCaseStudy/SmallTopo/DesignSetup:add-exe-serv-btn.png)]], we can add the commend that execute the install script. In the execute box, we enter `/bin/bash /local/xorp_autostart/start-xorp.sh`, and the shell type is `sh`.
     344Now, we are ready to add an install script by editing the node property. For each node, click [[Image(GENIExperimenter/Tutorials/SystematicExprCaseStudy/SmallTopo/DesignSetup:info.jpg)]] to see the node information. By clicking [[Image(GENIExperimenter/Tutorials/SystematicExprCaseStudy/SmallTopo/DesignSetup:add-service-btn.png)]], we are able to add a service that usually refers to an install script. In this tutorial, we will add an install script called `xorp_autostart.tar.gz`, by entering the link ''https://github.com/GENI-NSF/geni-tutorials/blob/master/SystematicExprCaseStudy/xorp_autostart.tar.gz'', and the install path is set as ''/local''. By clicking [[Image(GENIExperimenter/Tutorials/SystematicExprCaseStudy/SmallTopo/DesignSetup:add-exe-serv-btn.png)]], we can add the commend that execute the install script. In the execute box, we enter `/bin/bash /local/xorp_autostart/start-xorp.sh`, and the shell type is `sh`.
    345345
    346346[[Image(GENIExperimenter/Tutorials/SystematicExprCaseStudy/SmallTopo/DesignSetup:node-install-service.png)]]
     
    348348Once we added the service and the execute service in Flack, apply the changes and submit the VM reservation request, the OSPF configuration file will be automatically created and the XORP will be started at `router-1` once it is initialized.
    349349
    350 Repeat the same procedures for the other three routers (i.e., `router-2`, `router-3`, `router-4`), and then '''submit''' the request. When all resources are ready, '''Save''' the RSpec as `4node-v2.rspec` at this stage, we will load this RSpec in the next step to get the same setup. (You can download a sample RSpec for `4node-v2.rspec` at [http://www.gpolab.bbn.com/exp/sysexpr/rspec-for-wiki/4node-v2.rspec here])
     350Repeat the same procedures for the other three routers (i.e., `router-2`, `router-3`, `router-4`), and then '''submit''' the request. When all resources are ready, '''Save''' the RSpec as `4node-v2.rspec` at this stage, we will load this RSpec in the next step to get the same setup. (You can download a sample RSpec for `4node-v2.rspec` at [https://github.com/GENI-NSF/geni-tutorials/blob/master/SystematicExprCaseStudy/4node-v2.rspec here])
    351351
    352352Setting up the install script will automate installation or configuration process at every node's postboot stage, and we do not need to login to every node to run `start-xorp.sh` manually.
     
    387387   <services>
    388388      <execute command="/bin/bash /local/xorp_autostart/start-xorp.sh" shell="sh"/>
    389       <install install_path="/local" url="http://www.gpolab.bbn.com/exp/sysexpr/xorp_autostart.tar.gz"/>
     389      <install install_path="/local" url="https://github.com/GENI-NSF/geni-tutorials/blob/master/SystematicExprCaseStudy/xorp_autostart.tar.gz"/>
    390390   </services>
    391391}}}
     
    399399
    400400
    401 In this tutorial, one metric we would like to evaluate is how often the routing table will be updated when there is a link/node failure. To emulate a link failure, we can disable the virtual interfaces, and to emulate a virtual router failure, we can stop the XORP process at the virtual router. A short script (downloaded from [http://www.gpolab.bbn.com/exp/sysexpr/xorp_run.tar.gz here] is available to be loaded as an install script.
     401In this tutorial, one metric we would like to evaluate is how often the routing table will be updated when there is a link/node failure. To emulate a link failure, we can disable the virtual interfaces, and to emulate a virtual router failure, we can stop the XORP process at the virtual router. A short script (downloaded from [https://github.com/GENI-NSF/geni-tutorials/blob/master/SystematicExprCaseStudy/xorp_run.tar.gz here] is available to be loaded as an install script.
    402402
    403403Delete any existing resources or create a new slice, '''LOAD''' the RSpec `4node-v2.rspec`, and add a new install service to every node in Flack. Now, the service portion for each node becomes to
     
    405405    <services>
    406406      <execute command="/bin/bash /local/xorp_autostart/start-xorp.sh" shell="sh"/>
    407       <install install_path="/local" url="http://www.gpolab.bbn.com/exp/sysexpr/xorp_autostart.tar.gz"/>
    408       <install install_path="/local" url="http://www.gpolab.bbn.com/exp/sysexpr/xorp_run.tar.gz"/>
     407      <install install_path="/local" url="https://github.com/GENI-NSF/geni-tutorials/blob/master/SystematicExprCaseStudy/xorp_autostart.tar.gz"/>
     408      <install install_path="/local" url="https://github.com/GENI-NSF/geni-tutorials/blob/master/SystematicExprCaseStudy/xorp_run.tar.gz"/>
    409409    </services>
    410410}}}
    411411
    412 After adding the new install script to every node, send the resource reservation request. When all nodes are ready to login,  we save the new modified RSpec as `4node-v3.rspec`. (You can download a sample RSpec for `4node-v3.rspec` at [http://www.gpolab.bbn.com/exp/sysexpr/rspec-for-wiki/4node-v3.rspec here])
     412After adding the new install script to every node, send the resource reservation request. When all nodes are ready to login,  we save the new modified RSpec as `4node-v3.rspec`. (You can download a sample RSpec for `4node-v3.rspec` at [https://github.com/GENI-NSF/geni-tutorials/blob/master/SystematicExprCaseStudy/4node-v3.rspec here])
    413413
    414414In the next step, we will add two end hosts to current four-node topology, so now we can delete existing resources from the current slice.
     
    435435
    436436
    437 Or, we can also write a script to install `iperf` to the client and server, load it as an install script by following the same steps as we just did for XORP. The install scripts for client and server can be downloaded from [http://www.gpolab.bbn.com/exp/sysexpr/install_script.tar.gz here]. An sample RSpec with iperf install script and execute command can be downloaded at [http://www.gpolab.bbn.com/exp/sysexpr/rspec-for-wiki/4node-v4.rspec `4node-v4.rspec`].
     437Or, we can also write a script to install `iperf` to the client and server, load it as an install script by following the same steps as we just did for XORP. The install scripts for client and server can be downloaded from [https://github.com/GENI-NSF/geni-tutorials/blob/master/SystematicExprCaseStudy/install_script.tar.gz here]. An sample RSpec with iperf install script and execute command can be downloaded at [https://github.com/GENI-NSF/geni-tutorials/blob/master/SystematicExprCaseStudy/4node-v4.rspec `4node-v4.rspec`].
    438438
    439439[[Image(GENIExperimenter/Tutorials/SystematicExprCaseStudy/SmallTopo/DesignSetup:4node-add-endhosts.png)]]