| 1 | = For users you had the portal generate their user certificate = |
| 2 | |
| 3 | = For users used a CSR to generate their user certificate = |
| 4 | |
| 5 | == Action needed to generate a new certificate == |
| 6 | 1. Create a new certificate at the GENI Experimenter Portal |
| 7 | a. Browse and login to the new portal: https://portal.geni.net/secure/kmcert.php |
| 8 | * Use the same login information you used previously on the old portal |
| 9 | b. Follow the instructions to create a certificate |
| 10 | 2. Point your tool at the new user certificate |
| 11 | a. If you are using omni, please following the instruction below in |
| 12 | "Action needed to use Omni". |
| 13 | b. If you are using another tool, |
| 14 | i. Download the certificate |
| 15 | ii. Use the new user certificate with your tool |
| 16 | |
| 17 | === Action needed to use Omni === |
| 18 | For your convenience, the following is an expanded version of the |
| 19 | instructions found on the portal in the section "Option 1: Automatic |
| 20 | omni configuration" on the Profile page: https://portal.geni.net/secure/profile.php |
| 21 | |
| 22 | 1. Make sure you are running omni 2.3.1 or later. |
| 23 | a. To determine the version of an existing omni installation, run: |
| 24 | {{{ |
| 25 | $ omni.py --version |
| 26 | }}} |
| 27 | b. If necessary, update to Omni 2.3.1 |
| 28 | i. Download the software: http://software.geni.net/local-sw/download&software=gcf-2.3.1.tar.gz |
| 29 | ii. Install the software: http://trac.gpolab.bbn.com/gcf/wiki/QuickStart |
| 30 | |
| 31 | 2. Download a new omni bundle (this will contain your certificate and |
| 32 | other files needed for configuring omni). |
| 33 | a. Browse and login to the new portal: https://portal.geni.net/secure/omni-bundle.php |
| 34 | i. Use the same login information you used previously on the old |
| 35 | portal |
| 36 | ii. Be sure to select which project you would like to be the default |
| 37 | for running experiments in GENI. You can always change the |
| 38 | project that is used with the `-r` command line option of Omni. |
| 39 | b. Download and save the bundle at: |
| 40 | {{{ |
| 41 | ~/Downloads/omni-bundle.zip |
| 42 | }}} |
| 43 | |
| 44 | 3. Configure omni using omni-configure.py distributed with omni: |
| 45 | {{{ |
| 46 | $ omni-configure.py |
| 47 | }}} |
| 48 | |
| 49 | 4. (Optional) You may find it helpful to clear the passphrase from your cert/key: |
| 50 | {{{ |
| 51 | $ clear-passphrases.py |
| 52 | }}} |
| 53 | |
| 54 | 5. Test omni: |
| 55 | {{{ |
| 56 | $ omni.py -a ig-gpo getversion |
| 57 | }}} |
| 58 | The output should look similar to this: |
| 59 | http://trac.gpolab.bbn.com/gcf/attachment/wiki/OmniConfigure/Automatic/getversion.out |
| 60 | |
| 61 | Congratulations! You're done. |