Changes between Version 8 and Version 9 of GEMINIv1.1Tutorial


Ignore:
Timestamp:
10/21/12 19:08:26 (12 years ago)
Author:
Ahmed El-Hassany
Comment:

--

Legend:

Unmodified
Added
Removed
Modified
  • GEMINIv1.1Tutorial

    v8 v9  
    6060More information about the User Workspace can be found at [http://groups.geni.net/geni/wiki/GENIUserWorkspace].
    6161
    62 Before configuring your slice, you will need to configure a few things for your user by following these [http://groups.geni.net/geni/wiki/GEMINIGEC14VMInstructions instructions].
     62Before configuring your slice, you will need to configure a few things for your user by following these [http://groups.geni.net/geni/wiki/GEMINIGEC15VMInstructions instructions].
    6363
    6464After GEC15, you can configure your own GENI credentials according to the [http://groups.geni.net/geni/wiki/GENIUserWorkspace/ConfigCredentials Configuring Credentials] instructions.
     
    1101102.3)  Obtain certs, credentials, passwords and keys
    111111
    112 2.4)  Formulate slice topology for experiment, and build request rspec
     112==== 2.4)  Formulate slice topology for experiment, and build request rspec ====
    113113
    114114In order to use the GEMINI I&M system to instrument your slice, you have to add GEMINI specific rspec extensions to your slice. This can be done at the time you create your rspec. The GEMINI I&M system requires that you add an extra node with public IP address into your slice that we call as the GLOBAL Node (GN). This node does not need to have any links to any other nodes in your slice.
     
    343343
    344344
    345 2.5)  Acquire resources and load images/packages for I&M tools and experiment services
     345==== 2.5)  Instrumentize proces ====
     346
     347Things to verify before instrumenting your slice :
     348  1. Know the path to your GENI certificate file
     349  2. Know the passphrase for your GENI certificate file. GEMINI currently does not support decrypted/unencrypted GENI certificates. Its easier and less cumbersome if you can store your passphrase in ~/.ssl/password as explained in the User Workspace setup explained earlier.
     350  3. The sliver status for your slice is "READY".
     351  4. Make sure you can ssh into the nodes in your slice without being prompted for password. This functionality is one of the fundamental and necessary requirements of setting up the GEMINI I&M System on your slice.  See [http://groups.geni.net/geni/wiki/GEMINIGEC15VMInstructions#SSLKeyPasswordConfiguration instructions] for adding your key to the ssh-agent.
     352  5. Renew your slice and slivers. Some certificates used in GEMINI are tied to your slice's expiration date and would need to be manually updated if your slice is renewed after the instrumentize process.
     353
     354 
     355In order to instrument your slice using GEMINI we use the script called "instrumentize.py" with the below mentioned parameters
     356  instrumentize.py -f <PATH TO YOUR GENI CREDENTIAL FILE> -n <SLICENAME>
     357 
     358For example, in your User Workspace VM that your are using in this tutorial, do
     359{{{
     360#!sh
     361geni@UserWorkspace:~$ cd ~/Tutorials/GEMINI/commmon/
     362geni@UserWorkspace:~/Tutorials/GEMINI/commmon$./instrumentize.py -f /path/to/your/geni/credential/file -n some_slice_name
     363}}}
     364
     365If you are experiencing problems , it is helpful to run the above command with a debug option enabled (- d) like below
     366{{{
     367#!sh
     368geni@UserWorkspace:~/Tutorials/GEMINI/commmon$./instrumentize.py -d -f /path/to/your/geni/credential/file -n some_slice_name
     369}}}
     370
     371While the instrumentize process is running you will see messages printed out on your terminal informing the action being performed at each stage of the process. In short, the list of steps being performed are
     372
     373    1. Check all Nodes to be intrumentized for OS compatibility with the GEMINI Software
     374    2. Send your manifest to the UNIS Server (UNIS is mentioned in the GEMINI Documentation)
     375    3. Obtain Credential to view Active measurements
     376    4. Install all software required for the Passive measurements on the Global Node and Measurement points
     377    5. Install all software required for the Active measurements on the Global Node and Measurement points
     378    6. Send slice information to the GEMINI Portal
     379
     380Steps 4 and 5 do take considerable amount of time to complete, hence please be patient. ( currently around 20 minutes on VMs and 10 minutes when using raw nodes )
     381
     382
     383On successful completion of the instrumentation process you will be given a username,password, link to the geminiportal website, and other information that you may need to login to the geminiportal site ([https://geminiportal.netlab.uky.edu/]). Please note this information down for use later. Below are screenshots of a GEMINI Instrumentation process and the execution flow of what you would see during this process.
     384
     385
     386
    346387
    3473882.6)  Start selected software processes