| 1 | |
| 2 | == Configuring Credentials == |
| 3 | |
| 4 | You will need three sets of credentials (two optional) when using the user workspace: |
| 5 | |
| 6 | 1. A GENI certificate. |
| 7 | This is the SSL certificate (with .pem extension) |
| 8 | that you download from one of the slice authorities (e.g. emulab.net |
| 9 | or pgeni.gpolab.bbn.com) |
| 10 | |
| 11 | You can use a certificate with or without a passphrase. |
| 12 | |
| 13 | 2. (Optional) An iRODS account. |
| 14 | This is only needed if you want to access an iRODS server from the |
| 15 | user workspace. |
| 16 | You must have the following information in an irods configuration file. |
| 17 | |
| 18 | {{{ |
| 19 | irodsHost |
| 20 | irodsPort |
| 21 | irodsDefResource |
| 22 | irodsHome |
| 23 | irodsCwd |
| 24 | irodsUserName |
| 25 | irodsZone |
| 26 | }}} |
| 27 | |
| 28 | Make sure you remember the password for your iRODS account. You will |
| 29 | need this when you run credconfig.sh below. |
| 30 | |
| 31 | |
| 32 | 3. (Optional) A Java Keystore file created from your GENI certificate. |
| 33 | '''This is only needed if you want to use Flukes.''' |
| 34 | See https://geni-orca.renci.org/trac/wiki/flukes/#Userauthorization |
| 35 | for instructions on how to generate the keystore file. |
| 36 | |
| 37 | Make sure you remember the alias and password that you used when |
| 38 | creating the keystore file. You will need this when you run Flukes. |
| 39 | |
| 40 | Transfer these files to a location in your home directory. You can do this with ftp, scp, or [wiki:GENIUserWorkspace#UsingSharedFolders shared folders]. |
| 41 | |
| 42 | With these 1-3 files, you can configure your credentials with the credconfig.sh tool. |
| 43 | |
| 44 | {{{ |
| 45 | $ credconfig.sh -g <path-to-geni-credential> -i <path-to-irods-config> -f <path-to-jks-file> |
| 46 | }}} |
| 47 | |
| 48 | |
| 49 | The -g parameter is required and the -i and -f parameters are optional. |
| 50 | |
| 51 | Example: |
| 52 | |
| 53 | {{{ |
| 54 | $ credconfig.sh -g /home/geniuser/gpo_ctcert.pem -f /home/geniuser/pgeni.jks -i /home/geniuser/irods.config |
| 55 | }}} |
| 56 | |
| 57 | A pair of SSH keys will be generated for you using the private key from your GENI certificate. |