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