| 1 | |
| 2 | == Instructions for using the GEC14 Tutorial VM for GEMINI == |
| 3 | |
| 4 | === Loggin in === |
| 5 | |
| 6 | Login information for the VM should be in the email that was sent with the download information.[[BR]] |
| 7 | Email Jeanne if you cannot find it. |
| 8 | |
| 9 | Once you are on the VM, you can access the credentials directly in the directory: |
| 10 | /home/geniuser/Tutorials/GEMINI.[[BR]] There is a directory for each user. The ssh |
| 11 | directory contains the certificates and keys. |
| 12 | |
| 13 | Pick a user and use the associated password send in a previous email.[[BR]] |
| 14 | Place this password in the file /home/geniuser/.ssl/password |
| 15 | |
| 16 | |
| 17 | === Creating the slice === |
| 18 | |
| 19 | - If you are using Flack '''(there is currently a bug being fixed here)''', log in as the tutorial user that you chose[[BR]] |
| 20 | (don't forget to log into the SA first: pgeni.gpolab.bbn.com). There are bookmarks |
| 21 | for both in the Firefox toolbar. |
| 22 | |
| 23 | - If you are using omni, cd to the directory for your user (~/Tutorials/GEMINI/<username>)[[BR]] |
| 24 | You can run omni commands directly from here and it will use the omni_config in that directory. |
| 25 | |
| 26 | - If you are using 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) |
| 27 | |
| 28 | === Running instrumentize script === |
| 29 | |
| 30 | - Make sure you have the most up-to-date scripts by running "git pull" in the directory ~/src/UW. |
| 31 | |
| 32 | - Before running instrumentize.py, you will want to start the ssh-agent and add your key to the agent using the following commands: |
| 33 | {{{ |
| 34 | $ ssh-agent -s |
| 35 | $ ssh-add /home/geniuser/Tutorials/GEMINI/<username>/ssh/<username>_key |
| 36 | }}} |
| 37 | |
| 38 | This will keep it from continuously prompting you for the password. |
| 39 | |
| 40 | - You can then run instrumentize.py from the directory /home/geniuser/Tutorials/GEMINI/common |
| 41 | |
| 42 | {{{ |
| 43 | instrumentize.py -f /home/geniuser/Tutorials/GEMINI/geminiXX/ssh/geminiXX_key -n geminXXslice |
| 44 | }}} |
| 45 | |
| 46 | === Accessing the portal === |
| 47 | |
| 48 | Before accessing the portal, add your certificate to the browser using these [wiki:GEMINIFirefoxCertInstall instructions] |
| 49 | |
| 50 | === Using iRODS === |
| 51 | |
| 52 | Before using iRODS, you will need to configure /home/geniuser/.irods/.irodsEnv |
| 53 | replacing ''thisIrodsUser'' with your tutorial username. |
| 54 | |
| 55 | You can then run ''iinit'' to store the password so you are not prompted each time. |
| 56 | |
| 57 | === Issues? === |
| 58 | |
| 59 | Notify Jeanne if you run into any issues. |