= For users you had the portal generate their user certificate =

== Action needed to use Omni ==

For your convenience, the following is an expanded version of the
instructions found on the portal in the section "Option 1: Automatic
omni configuration" on the Profile page: 
     https://portal.geni.net/secure/profile.php

1. Make sure you are running omni 2.3.1 or later.
   a. To determine the version of an existing omni installation, run:
       $ omni.py --version
   b. If necessary, update to Omni 2.3.1
      i. Download the software: http://software.geni.net/local-sw/download&software=gcf-2.3.1.tar.gz
      ii. Install the software: http://trac.gpolab.bbn.com/gcf/wiki/QuickStart

2. Download a new omni bundle (this will contain your certificate and
other files needed for configuring omni).
   a. Browse and login to the new portal: https://portal.geni.net/secure/omni-bundle.php
      i. Use the same login information you used previously on the old
      portal
      ii. Be sure to select which project you would like to be the default
      for running experiments in GENI. You can always change the
      project that is used with the `-r` command line option of Omni.
   c. Download and save the bundle at:
{{{
   	     ~/Downloads/omni-bundle.zip
}}}

3. Configure omni using omni-configure.py distributed with omni: 
{{{
	$ omni-configure.py
}}}
 
4. Test omni:
{{{
   	$ omni.py -a ig-gpo getversion
}}}
   The output should look similar to this: http://trac.gpolab.bbn.com/gcf/attachment/wiki/OmniConfigure/Automatic/getversion.out

Congratulations! You're done.

== Action needed to use other outside tools ==

1. Download a new certificate at the GENI Experimenter Portal
   a. Browse and login to the new portal: 
      	     https://portal.geni.net/secure/kmcert.php
      Use the same login information you used previously on the old
   portal
   b. Download the certificate

2. Point your tool at the new user certificate


= For users used a CSR to generate their user certificate =

== Action needed to generate a new certificate ==
1. Create a new certificate at the GENI Experimenter Portal
   a. Browse and login to the new portal: https://portal.geni.net/secure/kmcert.php
      * Use the same login information you used previously on the old portal
   b. Follow the instructions to create a certificate
2. Point your tool at the new user certificate
   a. If you are using omni, please following the instruction below in
      "Action needed to use Omni".
   b. If you are using another tool, 
      i. Download the certificate
      ii. Use the new user certificate with your tool

=== Action needed to use Omni ===
For your convenience, the following is an expanded version of the
instructions found on the portal in the section "Option 1: Automatic
omni configuration" on the Profile page: https://portal.geni.net/secure/profile.php

1. Make sure you are running omni 2.3.1 or later.
   a. To determine the version of an existing omni installation, run:
{{{
       $ omni.py --version
}}}
   b. If necessary, update to Omni 2.3.1
      i. Download the software: http://software.geni.net/local-sw/download&software=gcf-2.3.1.tar.gz
      ii. Install the software: http://trac.gpolab.bbn.com/gcf/wiki/QuickStart

2. Download a new omni bundle (this will contain your certificate and
other files needed for configuring omni).
   a. Browse and login to the new portal: https://portal.geni.net/secure/omni-bundle.php
      i. Use the same login information you used previously on the old
      portal
      ii. Be sure to select which project you would like to be the default
      for running experiments in GENI. You can always change the
      project that is used with the `-r` command line option of Omni.
   b. Download and save the bundle at:
{{{
   	     ~/Downloads/omni-bundle.zip
}}}

3. Configure omni using omni-configure.py distributed with omni: 
{{{
	$ omni-configure.py
}}}
 
4. (Optional) You may find it helpful to clear the passphrase from your cert/key:
{{{
        $ clear-passphrases.py
}}}

5. Test omni:
{{{
   	$ omni.py -a ig-gpo getversion
}}}
The output should look similar to this: 
      http://trac.gpolab.bbn.com/gcf/attachment/wiki/OmniConfigure/Automatic/getversion.out

Congratulations! You're done.