== B. Obtain Slice == {{{ #!html
Image Map
}}} === 2) Obtain slice of GENI resources, install I&M tools and experiment services === === B.1 Select target aggregates === In this tutorial, we focus on ExoGENI and do not select any additional aggregates. In future tutorials we will present how GIMI can support experiments on other aggregates and a combination of aggregates (e.g., ExoGENI and WiMAX). ---- === B.2 Formulate slice topology for experiment, and build request rspec === We will not go into any detail on this topic since this is covered in the ExoGENI tutorial. ---- === B.2 Acquire resources and load images/packages for I&M tools and experiment services === === B.2.1 Flukes === ''B.2.1.1'' Download the RDF file that describes the ExoGENI topology for your experiment with the following commands: {{{ #!html Don't forget to replace gimiXX with your current userID. }}} {{{ $ cd ~/Tutorials/GIMI/gimiXX $ wget http://emmy9.casa.umass.edu/RDFs/gimiXX.rdf }}} ''B.2.1.2'' Before experimenters can use Flukes, its properties file has to be modified. Open the properties file with your favorite text editor (e.g., nano): {{{ $ nano ~/.flukes.properties }}} Then change the file as indicated below. {{{ # Do not change these orca.xmlrpc.url=https://geni.renci.org:11443/orca/xmlrpc,https://rci-hn.exogeni.net:11443/orca/xmlrpc,https://bbn-hn.exogeni.net:11443/orca/xmlrpc,https://nicta-hn.exogeni.net:11443/orca/xmlrpc ssh.options=-o UserKnownHostsFile=/dev/null -o StrictHostKeyChecking=no -X xterm.path=/usr/bin/xterm # replace XX with your user index (with leading 0, if necessary) user.keystore=/home/geniuser/Tutorials/GIMI/gimiXX/ssh/gimiXX.jks ssh.key=/home/geniuser/Tutorials/GIMI/gimiXX/ssh/gimiXX_key ssh.pubkey=/home/geniuser/Tutorials/GIMI/gimiXX/ssh/gimiXX_key.pub image1.name=gec15-gimi-image image1.url=http://emmy9.casa.umass.edu/GEC15-GIMI-Tutorial/gec-15-tutorial.xml image1.hash=fb135d730ec37d92a6f4c873f26cea72af1c0a31 }}} The following [http://emmy9.casa.umass.edu/GEC15-GIMI-Tutorial/videos/Flukes_properties.mp4 video] gives more details on the necessary changes of the file. Now start Flukes by double-clicking on the icon on the VM's desktop. ''B.2.1.3'' In the tutorial VM start Flukes and load gimiXX.rdf. (Also here, replace gimiXX with your assigned user ID.) In Flukes select ''Files->Open Request->select gimiXX.rdf in ~/Tutorials/GIMI/gimiXX''. ''B.2.1.4'' Verify settings and create slice. First select the the ''Request View'' tab. * To verify settings right-click on each node and select ''Edit Properties'' * To create a slice enter your slice name ''gimiXX-tutorial'' in to the empty field next to the ''Submit Request'' button and the click the latter. ''B.2.1.5'' To check if all the resources have come up go to the ''Manifest View'' tab and enter your slice name (''gimiXX-tutorial'') into the empty field. Then click ''Query for Manifest''. After a short moment a box with all the requested resources and their respective status will appear. (This box does not update automatically and you have to hit the ''Query for Manifest'' button again to receive and update). ''B.2.1.6'' GIMI specific post boot script. Each node uses the same image but runs a slightly different post boot script. The latter allows for individualized settings at each node. An example post boot script for NodeA is shown below: {{{ # Experiment slice name used by OMF. Should be unique for each experiment sn=gimi31 # For now ExoGENI does not assign the "Name" assigned in Flukes as hostname. This will not be needed in future versions. hostname nodeA #OMF related update of image. gem install oml4r # This line registers the node with the XMPP server (emmy9.casa.umass.edu in this case) to allow # the experiment controller to communicate with the node. omf_create_psnode-5.4 emmy9.casa.umass.edu mkslice $sn nodeA # The following curl downloads are needed to update omf and oml and will most likely not be needed anymore # when we create a new GIMI ExoGENI kernel. curl https://pkg.mytestbed.net/ubuntu/precise/omf-resctl-5.4_5.4.2-ubuntu6_all.deb -o /root/omf-rc.deb dpkg -i /root/omf-rc.deb curl https://pkg.mytestbed.net/ubuntu/oneiric/oml2-otg2_2.5.0-ubuntu2_amd64.deb -o /root/oml2-otg2.deb dpkg -i /root/oml2-otg2.deb curl https://pkg.mytestbed.net/ubuntu/oneiric/oml2-trace_2.5.0-ubuntu2_amd64.deb -o /root/oml2-trace.deb dpkg -i /root/oml2-trace.deb curl https://pkg.mytestbed.net/ubuntu/oneiric/oml2-iperf_2.0.5-1ubuntu5_amd64.deb -o /root/oml2-iperf.deb dpkg -i /root/oml2-iperf.deb curl https://pkg.mytestbed.net/ubuntu/oneiric/oml2-nmetrics_2.5.0-ubuntu2_amd64.deb -o /root/oml2-nmetrics.deb dpkg -i /root/oml2-nmetrics.deb curl http://emmy9.casa.umass.edu/pingWrap.rb -o /root/pingWrap.rb chmod +x /root/pingWrap.rb #curl http://emmy9.casa.umass.edu/enrolled.patch -o enrolled.patch #patch -p1 < /enrolled.patch curl http://emmy9.casa.umass.edu/omf-resctl.yaml -o /etc/omf-resctl-5.4/omf-resctl.yaml perl -i.bak -pe "s/\:slice\:/\:slice\: $sn/g" /etc/omf-resctl-5.4/omf-resctl.yaml # The above updates require a restart of the OMF resource controller. /etc/init.d/omf-resctl-5.4 restart }}} ---- === B.2.2 Omni === In this section, we present an alternative approach to setup a slice by using the Omni command line tools to reserve resources. To perform this task the following steps have to be executed: ''B.2.2.1'' The post boot script that is used in the case of slice reservation via Flukes has to be converted from an RDF file into a single bash script that takes slice name and node ID as arguments. This script will be installed and executed on the nodes by an execute service defined in the rspec as follows: {{{ }}} ''B.2.2.2'' The rdf file has to be converted into an rspec (see attached gec15-tutorial-gimi09-nospec.rspec). You will notice that the rspec has to be slice-specific because it needs to pass the slice name into the post boot script. ''B.2.2.3'' Then the following commands have to be executed to set up and manage the slice with Omni: * Create the slice: {{{ omni.py createslice johGimi09-tutorial }}} * Create the sliver: {{{ omni.py -a eg-sm createsliver johGimi09-tutorial ~/Tutorials/GIMI/gimi09/gec15-tutorial-gimi09-nospec.rspec }}} * Check the status of the sliver: {{{ omni.py -a eg-sm sliverstatus johGimi09-tutorial 2>&1 | grep geni_status }}} * Get the manifest of the sliver (to get the login information): {{{ omni.py -a eg-sm listresources johGimi09-tutorial -o }}} * Delete the sliver: {{{ omni.py -a eg-sm deletesliver johGimi09-tutorial }}} ---- 2.1) Select target aggregates 2.2) Select desired software images/packages for I&M tools and experiment services 2.3) Obtain certs, credentials, passwords and keys 2.4) Formulate slice topology for experiment, and build request rspec 2.5) Acquire resources and load images/packages for I&M tools and experiment services 2.6) Start selected software processes 2.7) Confirm slice with installed I&M tools and experiment services [[BR]] [[BR]] [[http://groups.geni.net/geni/wiki/GIMIv1.1Tutorial/Environment Back to previous step]] [[http://groups.geni.net/geni/wiki/GIMIv1.1Tutorial/Orchestrate Forward to next step]] [[http://groups.geni.net/geni/wiki/GIMIv1.1Tutorial/ Back to tutorial main page]]