| 8 | | - Most common tools are installed in /opt |
| 9 | | |
| 10 | | |
| 11 | | == Configuring Credentials == |
| 12 | | |
| 13 | | You will need three sets of credentials (two optional) when using the user workspace: |
| 14 | | |
| 15 | | 1. A GENI certificate. |
| 16 | | This is the SSL certificate (with .pem extension) |
| 17 | | that you download from one of the slice authorities (e.g. emulab.net |
| 18 | | or pgeni.gpolab.bbn.com) |
| 19 | | |
| 20 | | You can use a certificate with or without a passphrase. |
| 21 | | |
| 22 | | 2. (Optional) An iRODS account. |
| 23 | | This is only needed if you want to access an iRODS server from the |
| 24 | | user workspace. |
| 25 | | You must have the following information in an irods configuration file. |
| 26 | | |
| 27 | | {{{ |
| 28 | | irodsHost |
| 29 | | irodsPort |
| 30 | | irodsDefResource |
| 31 | | irodsHome |
| 32 | | irodsCwd |
| 33 | | irodsUserName |
| 34 | | irodsZone |
| 35 | | }}} |
| 36 | | |
| 37 | | Make sure you remember the password for your iRODS account. You will |
| 38 | | need this when you run credconfig.sh below. |
| 39 | | |
| 40 | | |
| 41 | | 3. (Optional) A Java Keystore file created from your GENI certificate. |
| 42 | | '''This is only needed if you want to use Flukes.''' |
| 43 | | See https://geni-orca.renci.org/trac/wiki/flukes/#Userauthorization |
| 44 | | for instructions on how to generate the keystore file. |
| 45 | | |
| 46 | | Make sure you remember the alias and password that you used when |
| 47 | | creating the keystore file. You will need this when you run Flukes. |
| 48 | | |
| 49 | | Transfer these files to a location in your home directory. You can do this with ftp, scp, or [wiki:GENIUserWorkspace#UsingSharedFolders shared folders]. |
| 50 | | |
| 51 | | With these 1-3 files, you can configure your credentials with the credconfig.sh tool. |
| 52 | | |
| 53 | | {{{ |
| 54 | | $ credconfig.sh -g <path-to-geni-credential> -i <path-to-irods-config> -f <path-to-jks-file> |
| 55 | | }}} |
| 56 | | |
| 57 | | |
| 58 | | The -g parameter is required and the -i and -f parameters are optional. |
| 59 | | |
| 60 | | Example: |
| 61 | | |
| 62 | | {{{ |
| 63 | | $ credconfig.sh -g /home/geniuser/gpo_ctcert.pem -f /home/geniuser/pgeni.jks -i /home/geniuser/irods.config |
| 64 | | }}} |
| 65 | | |
| 66 | | A pair of SSH keys will be generated for you using the private key from your GENI certificate. |
| 67 | | |
| 68 | | == Using Shared Folders == |
| 69 | | |
| 70 | | If you need to transfer files from your host machine/laptop, the easiest way is typically using Shared Folders. |
| 71 | | Follow these steps to set up a shared folder on your user workspace. |
| 72 | | |
| 73 | | 1. Go to the !VirtualBox "Devices" menu and select "Shared Folders..." |
| 74 | | |
| 75 | | 2. Click on the "Add" button on the right (looks like a folder with a plus sign). |
| 76 | | |
| 77 | | 3. Select the path of the folder you would like to share with your VM. |
| 78 | | |
| 79 | | 4. Enter the name you would like to give this shared folder in "Folder Name:" (e.g. myshared) |
| 80 | | |
| 81 | | 5. Click on "OK" in the Add Shares window |
| 82 | | |
| 83 | | 6. Click on "OK" in the Shared Folders window |
| 84 | | |
| 85 | | 7. Create the directory where you would like you shared folder mounted (e.g. /media/shared): |
| 86 | | {{{ |
| 87 | | sudo mkdir /media/shared |
| 88 | | }}} |
| 89 | | |
| 90 | | 8. Mount the shared folder: |
| 91 | | {{{ |
| 92 | | sudo mount -t vboxsf myshared /media/shared |
| 93 | | }}} |
| 94 | | |
| 95 | | You should now be able to access your folder at /media/shared. |
| 96 | | |
| 97 | | |
| 98 | | == Basic Environment == |
| 99 | | |
| 100 | | - Ubuntu 12.04 |
| 101 | | - OpenJDK JRE 7 |
| 130 | | === GENI certificate === |
| 131 | | - Download from Emulab or GPO |
| 132 | | - With or without passphrase |
| 133 | | - Location added to omni_config, environment variables, and .flukes.properties |
| 134 | | |
| 135 | | === Java Keystore === |
| 136 | | - This file is needed to run Flukes |
| 137 | | - This is generated from the GENI certificate downloaded from Emulab or GPO |
| 138 | | - See [https://geni-orca.renci.org/trac/wiki/flukes/#Userauthorization] for instructions on how to generate the JKS file. |
| 139 | | |
| 140 | | === iRODS account === |
| 141 | | - Configured in $HOME/.irods/.irodsEnv |
| 142 | | |
| 143 | | ---- |
| | 31 | You can install your own set of credentials by following these [wiki:GENIUserWorkspace/ConfigCredentials Configuring Credentials] instructions. |
| | 54 | |
| | 55 | - Example: |
| | 56 | {{{ |
| | 57 | # iRODS server host name: |
| | 58 | irodsHost 'emmy9.casa.umass.edu' |
| | 59 | # iRODS server port number: |
| | 60 | irodsPort 1247 |
| | 61 | |
| | 62 | # Default storage resource name: |
| | 63 | irodsDefResource 'iRODSUmass' |
| | 64 | # Home directory in iRODS: |
| | 65 | irodsHome '/geniRenci/home/gimiXX' |
| | 66 | # Current directory in iRODS: |
| | 67 | irodsCwd '/geniRenci/home/gimiXX' |
| | 68 | # Account name: |
| | 69 | irodsUserName 'gimiXX' |
| | 70 | # Zone: |
| | 71 | irodsZone 'geniRenci' |
| | 72 | }}} |
