6 | | - Currently on a BBN internal server. Will be moved to an external server in the near future. |
7 | | [Add link here] |
8 | | |
9 | | - OVF image coming soon |
10 | | [Add link here] |
| 6 | |
| 7 | - You can downloaded it from the BBN FTP server. |
| 8 | - FTP information will be emailed to the appropriate lists. |
| 9 | - Usernames and passwords will be emailed |
| 10 | |
| 11 | == Installing the VM == |
| 12 | |
| 13 | 1. Install !VirtualBox |
| 14 | |
| 15 | Download the !VirtualBox software from http://www.virtualbox.org. |
| 16 | |
| 17 | If you already have !VirtualBox installed on your machine, make sure it is version 4.1 or above. |
| 18 | |
| 19 | 2. Download !VirtualBox VM image for tutorials |
| 20 | |
| 21 | Download the !VirtualBox VM image (GENI UW 12.04 v1.0.ova) from the BBN FTP server. |
| 22 | |
| 23 | 3. Install the ''GENI UW 12.04 v1.0.ova'' virtual machine image |
| 24 | |
| 25 | Start up !VirtualBox, select File->Import Appliance..., and follow the |
| 26 | instructions. Accept the default VM settings during the import. |
| 27 | |
| 28 | To run the virtual machine, go to the Oracle VM !VirtualBox Manager window, select the VM and click the |
| 29 | green arrow labeled Start at the top of this window. |
| 30 | |
| 31 | == Configuring Credentials == |
| 32 | |
| 33 | You will need three sets of credentials (two optional) when using the user workspace: |
| 34 | |
| 35 | 1. A GENI certificate. |
| 36 | This is the SSL certificate (with .pem extension) |
| 37 | that you download from one of the slice authorities (e.g. emulab.net |
| 38 | or pgeni.gpolab.bbn.com) |
| 39 | |
| 40 | You can use a certificate with or without a passphrase. |
| 41 | |
| 42 | 2. (Optional) An iRODS account. |
| 43 | This is only needed if you want to access an iRODS server from the |
| 44 | user workspace. |
| 45 | You must have the following information in an irods configuration file. |
| 46 | |
| 47 | {{{ |
| 48 | irodsHost |
| 49 | irodsPort |
| 50 | irodsDefResource |
| 51 | irodsHome |
| 52 | irodsCwd |
| 53 | irodsUserName |
| 54 | irodsZone |
| 55 | }}} |
| 56 | |
| 57 | Make sure you remember the password for your iRODS account. You will |
| 58 | need this when you run credconfig.sh below. |
| 59 | |
| 60 | |
| 61 | 3. (Optional) A Java Keystore file created from your GENI certificate. |
| 62 | '''This is only needed if you want to use Flukes.''' |
| 63 | See https://geni-orca.renci.org/trac/wiki/flukes/#Userauthorization |
| 64 | for instructions on how to generate the keystore file. |
| 65 | |
| 66 | Make sure you remember the alias and password that you used when |
| 67 | creating the keystore file. You will need this when you run Flukes. |
| 68 | |
| 69 | Transfer these files to a location in your home directory. You can do this with ftp, scp, or [wiki:#UsingSharedFolders shared folders]. |
| 70 | |
| 71 | With these 1-3 files, you can configure your credentials with the credconfig.sh tool. |
| 72 | |
| 73 | {{{ |
| 74 | $ credconfig.sh -g <path-to-geni-credential> -i <path-to-irods-config> -f <path-to-jks-file> |
| 75 | }}} |
| 76 | |
| 77 | Example: |
| 78 | |
| 79 | {{{ |
| 80 | $ credconfig.sh -g /home/geniuser/gpo_ctcert.pem -f /home/geniuser/pgeni.jks -i /home/geniuser/irods.config |
| 81 | }}} |
| 82 | |
| 83 | A pair of SSH keys will be generated for you using the private key from your GENI certificate. |
| 84 | |
| 85 | == Using Shared Folders == |
| 86 | |
| 87 | If you need to transfer files from your host machine/laptop, the easiest way is typically using Shared Folders. |
| 88 | Follow these steps to set up a shared folder on your user workspace. |
| 89 | |
| 90 | 1. Go to the !VirtualBox "Devices" menu and select "Shared Folders..." |
| 91 | |
| 92 | 2. Click on the "Add" button on the right (looks like a folder with a plus sign). |
| 93 | |
| 94 | 3. Select the path of the folder you would like to share with your VM. |
| 95 | |
| 96 | 4. Enter the name you would like to give this shared folder in "Folder Name:" (e.g. myshared) |
| 97 | |
| 98 | 5. Click on "OK" in the Add Shares window |
| 99 | |
| 100 | 6. Click on "OK" in the Shared Folders window |
| 101 | |
| 102 | 7. Create the directory where you would like you shared folder mounted (e.g. /media/shared): |
| 103 | {{{ |
| 104 | sudo mkdir /media/shared |
| 105 | }}} |
| 106 | |
| 107 | 8. Mount the shared folder: |
| 108 | {{{ |
| 109 | sudo mount -t vboxsf myshared /media/shared |
| 110 | }}} |
| 111 | |
| 112 | You should now be able to access your folder at /media/shared. |
| 113 | |
96 | | === Digital Object Repository and Data Archive === |
97 | | - Repository installed in /opt/dorepository |
98 | | - web interface installed in /var/lib/tomcat6/webapps |
99 | | - Currently uses handle server at mda.doregistry.org |
100 | | - Should this be moved local? |
101 | | - Uses shared archive at mda. |
102 | | |
103 | | === GEMINI Portal === |
104 | | - TBD |
105 | | |
106 | | === GIMI Portal === |
107 | | - TBD |
108 | | |
109 | | === Measurement Data Object Descriptor Editor === |
110 | | - TBD |
111 | | |
112 | | === Development Tools? === |
| 179 | === iRODS client === |
| 180 | - Installed in /opt/irods |
| 181 | - Version 3.1 downloaded from https://www.irods.org/download.html |
| 182 | - Config file installed in each users home directory |
| 183 | - .irods/.irodsEnv |
| 184 | |
| 185 | === Development Tools === |