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

Timestamp:

10/21/12 19:08:26 (12 years ago)

Author:

Ahmed El-Hassany

Comment:

--

GEMINIv1.1Tutorial

@@ -60 +60 @@
 More information about the User Workspace can be found at [http://groups.geni.net/geni/wiki/GENIUserWorkspace].
 
-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].
+Before 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].
 
 After GEC15, you can configure your own GENI credentials according to the [http://groups.geni.net/geni/wiki/GENIUserWorkspace/ConfigCredentials Configuring Credentials] instructions.
@@ -110 +110 @@
 2.3)  Obtain certs, credentials, passwords and keys
 
-2.4)  Formulate slice topology for experiment, and build request rspec
+==== 2.4)  Formulate slice topology for experiment, and build request rspec ==== 
 
 In 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. 
@@ -343 +343 @@
 
 
-2.5)  Acquire resources and load images/packages for I&M tools and experiment services
+==== 2.5)  Instrumentize proces ==== 
+
+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 [http://groups.geni.net/geni/wiki/GEMINIGEC15VMInstructions#SSLKeyPasswordConfiguration 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 
+{{{
+#!sh
+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
+{{{
+#!sh
+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 intrumentized 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. 
+
+
+
 
 2.6)  Start selected software processes