Changes between Version 1 and Version 2 of GEMINI/Tutorial/GEC15/Background/VM

Timestamp:

10/22/12 23:46:50 (11 years ago)

Author:

carpenter@vis.uky.edu

Comment:

--

GEMINI/Tutorial/GEC15/Background/VM

@@ -1 @@
-= GEMINI/Tutorial/GEC15/Background/VM =
+[[PageOutline]]
+
+== Instructions for using the GEC15 Tutorial VM for GEMINI ==
+
+=== Logging in ===
+
+Login information for the VM will be provided at the beginning of the tutorial.
+
+Once you are on the VM, you can access the credentials directly in the directory:
+/home/geniuser/Tutorials/GEMINI.[[BR]] There is a directory for each user.  The ssh
+directory contains the certificates and keys.
+
+You will be assigned a username and password at the beginning of the tutorial.
+
+=== SSL Key/Password Configuration ===
+The instrumentize.py script requires password-less access to the nodes.  Follow these steps to set this up.
+
+1.  Place your GENI password in the file /home/geniuser/.ssl/password
+2.  Add your ssh key to the ssh-agent by running the command (replacing geminiXX with your username):
+{{{
+$ ssh-add /home/geni/Tutorials/GEMINI/geminiXX/ssh/geminiXX_key
+}}}
+
+
+=== Updating the code ===
+
+You can get the latest scripts, configuration, and rspec files by changing to the GEMINI common directory and doing a git pull:
+
+{{{
+$ cd ~/Tutorials/GEMINI/common
+$ git pull
+}}}
+
+=== Creating the slice ===
+
+    - '''Flack:'''  log in as the tutorial user that you chose[[BR]]
+    (don't forget to log into the SA first:  pgeni.gpolab.bbn.com).  There are bookmarks
+     for both in the Firefox toolbar.
+
+    - '''OMNI:'''  cd to the directory for your user (~/Tutorials/GEMINI/<username>)[[BR]]
+    You can run omni commands directly from here and it will use the omni_config in that directory.
+
+    - '''Protogeni test scripts:''' you can find them in /opt/protogeni.[[BR]]  Use the -f option to specify the path to the certificate (/home/geniuser/Tutorials/GEMINI/<username>/ssh/<username>.pem)
+
+=== Running instrumentize script ===
+
+  - Make sure you have the most up-to-date scripts (see ''Updating the code'' above).
+
+  - Run instrumentize.py from the directory /home/geni/Tutorials/GEMINI/common specifying your GENI certificate and the slice name.
+
+{{{
+$ instrumentize.py -f /home/geni/Tutorials/GEMINI/geminiXX/ssh/geminiXX.pem -n geminiXXslice
+}}}
+
+=== Accessing the portal ===
+
+Before accessing the portal, add your certificate to the browser using these [wiki:GEMINIFirefoxCertInstall instructions]
+
+=== Issues? ===
+
+Notify geni-gemini-users@googlegroups.com if you run into any issues.