wiki:GEMINI/Tutorial/GEC15/Background/Instrumentize

Version 4 (modified by carpenter@vis.uky.edu, 11 years ago) (diff)

--

GEMINI/Tutorial/GEC15/Background/Instrumentize

Instrumentize process

Things to verify before instrumenting your slice :

  1. Know the path to your GENI certificate file
  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.
  3. The sliver status for your slice is "READY".
  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 instructions for adding your key to the ssh-agent.
  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.

In order to instrument your slice using GEMINI we use the script called "instrumentize.py" with the below mentioned parameters

instrumentize.py -f <PATH TO YOUR GENI CREDENTIAL FILE> -n <SLICENAME>

For example, in your User Workspace VM that your are using in this tutorial, do

geni@UserWorkspace:~$ cd ~/Tutorials/GEMINI/commmon/ 
geni@UserWorkspace:~/Tutorials/GEMINI/commmon$./instrumentize.py -f /path/to/your/geni/credential/file -n some_slice_name

If you are experiencing problems , it is helpful to run the above command with a debug option enabled (- d) like below

geni@UserWorkspace:~/Tutorials/GEMINI/commmon$./instrumentize.py -d -f /path/to/your/geni/credential/file -n some_slice_name

While 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

  1. Check all Nodes to be instrumentized for OS compatibility with the GEMINI Software
  2. Send your manifest to the UNIS Server (UNIS is mentioned in the GEMINI Documentation)
  3. Obtain Credential to view Active measurements
  4. Install all software required for the Passive measurements on the Global Node and Measurement points
  5. Install all software required for the Active measurements on the Global Node and Measurement points
  6. Send slice information to the GEMINI Portal

Steps 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 )

On 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.

Attachments (3)

Download all attachments as: .zip