Changes between Version 9 and Version 10 of HowToUseOmni


Ignore:
Timestamp:
08/22/12 12:57:39 (9 years ago)
Author:
nriga@bbn.com
Comment:

--

Legend:

Unmodified
Added
Removed
Modified
  • HowToUseOmni

    v9 v10  
    2222
    2323To access GENI resources, an experimenter must have GENI credentials! If you don't have credentials, follow the instructions at SignMeUp.
     24
    2425'''Note:''' If you have an account with a Clearinghouse other than pgeni.gpolab.bbn.com (e.g. www.emulab.net, planet-lab.org) you can still use Omni to reserve resources but you will not be able to complete the above two examples so we strongly recommend that you [wiki:SignMeUp sign up] with GPO's clearing house.
    25 
    26 The Clearinghouse must have a copy of your existing or newly generated SSH public key, which is placed on the allocated resource to allow access.  The Omni tools automatically upload your SSH public key when you create a slice, so if you plan to use Omni tools you can skip the manual SSH key upload. Without Omni tools, this is done manually by logging into the server ([https://www.pgeni.gpolab.bbn.com GPO ProtoGENI],[https://planet-lab.org PlanetLab], or [https://www.emulab.net Emulab]) and uploading the SSH keys that you will use to run the experiment.  For [https://planet-lab.org PlanetLab], the ssh key manual uploaded is in the ''My Account'' page in the ''keys'' section. For ProtoGENI [https://www.emulab.net Emulab], the manual key uploaded in the ''Profile'' tab in the ''Edit SSH Keys'' page. 
    27 
    28 A SSL certificate is also required to manage access to GENI resources. For !PlanetLab resources, the user generates his/her own SSL certificate, while for the ProtoGENI Clearinghouses the experimenter uses the ProtoGENI server to generate the SSL certificate.  On the [https://www.pgeni.gpolab.bbn.com GPO ProtoGENI], and [https://www.emulab.net Emulab] servers, the SSL certificate is generated in the ''Profile'' tab, use the ''Generate SSL certificate'' option to create and download an encrypted SSL certificate.  The encrypted certificate must be passphrase protected and should be downloaded into your ''~/.ssl '' directory. If you do not want to type the SSL certificate passphrase each time your certificate is used, see these optional [wiki:GENIExperimenter/ExperimentCredentials#OptionalRemovingofSSLPasswordPrompt instructions] to remove the pass-phrase prompt.
    2926
    3027== 2. Get Omni Tools ==
    3128
    32 To get access to the GENI resources you can use the OMNI client which is part of the [http://trac.gpolab.bbn.com/gcf/wiki GENI Control Framework] (GCF) software package.  Get the GCF package at this [http://trac.gpolab.bbn.com/gcf/wiki/GettingGcf GCF location] and install it using the [http://trac.gpolab.bbn.com/gcf/wiki/QuickStart Quick Start] instructions.
     29To get access to the GENI resources you can use the OMNI client which is part of the [http://trac.gpolab.bbn.com/gcf/wiki GENI Control Framework] (GCF) software package.  Get the GCF package at this [http://trac.gpolab.bbn.com/gcf/wiki/GettingGcf GCF location] and install it using the http://trac.gpolab.bbn.com/gcf/wiki/OmniQuickStart Quick Start] instructions.
    3330
    34 Once the GCF package is installed, configure the [http://trac.gpolab.bbn.com/gcf/wiki/Omni Omni tools] by defining the Clearinghouse and user credentials that you plan to use for accessing the resources.  For the supporting GENI Experiment Examples 1 and 2, the Omni configuration file is modified to includes settings shown [wiki:GENIExperimenter/ExperimentExample#OmniConfiguration here].
    35 
    36 For users who have existing accounts at [https://planet-lab.org PlanetLab] or [https://www.emulab.net Emulab] and want to use those credentials, information on how to configure Omni for those clearinghouses can be found at [http://trac.gpolab.bbn.com/gcf/wiki/OmniPlanetLab Omni PlanetLab] page or the [http://trac.gpolab.bbn.com/gcf/wiki/OmniProtoGeni ProtoGENI Omni] page.
     31Once the [http://trac.gpolab.bbn.com/gcf/wiki/Omni Omni tool] is installed, follow the [http://trac.gpolab.bbn.com/gcf/wiki/OmniConfigure configuration instructions].
    3732
    3833== 3. Define Required Resources ==