Skip to content

Omni Configuration ProtoGENI

Tom Mitchell edited this page May 15, 2017 · 3 revisions

These instructions of for Omni users that have a ProtoGENI account. If you have a:

1. Download your SSL Cert

  • Login to the ProtoGENI Authority, where you got your account from; e.g. http://www.emulab.net or, https://authority.ilabt.iminds.be or https://www.uky.emulab.net/.

  • OPTIONAL: Click on the Generate an SSL cert link on the left of your screen. Make sure you remember the passphrase you use here. If you have specified the GENI SSL Passphrase during the account creation, you can skip this step

  • Click on the Download cert link on the left of your screen. Click on that and select the option about downloading as a pem file.

    Save this page under ~/.ssl/geni_cert_pg.pem. You will need to type the path, instead of navigating to the folder.

2. Run the omni-configure script

  • Open a terminal window and type:

    omni-configure -f pg
    

    You will be asked for your passphrase multiple times. This is the passphrase you used when generating your certificate.

This step will produce the configuration file that omni needs.

3. Test your configuration

In a terminal window run:

omni getversion -a ig-gpo

Your output should look similar to this:

bash-3.2$ omni -a gpo-ig getversion
11:47:18 INFO    : Loading agg_nick_cache file '/Users/vthomas/.gcf/agg_nick_cache'
11:47:18 INFO    : Loading config file '/Users/vthomas/.gcf/omni_config'
11:47:18 INFO    : Using control framework portal
11:47:18 INFO    : Member Authority is https://ch.geni.net/MA (from config)
11:47:18 INFO    : Slice Authority is https://ch.geni.net/SA (from config)
11:47:18 INFO    : Substituting AM nickname gpo-ig with URL https://boss.instageni.gpolab.bbn.com:12369/protogeni/xmlrpc/am/2.0, URN urn:publicid:IDN+instageni.gpolab.bbn.com+authority+cm
11:47:19 INFO    :  (PG log url - look here for details on any failures: https://boss.instageni.gpolab.bbn.com/spewlogfile.php3?logfile=848bd8195a7633d1505c6908634eeeb8)
11:47:19 INFO    : AM gpo-ig URN: urn:publicid:IDN+instageni.gpolab.bbn.com+authority+cm (url: https://boss.instageni.gpolab.bbn.com:12369/protogeni/xmlrpc/am/2.0) has version: ( (PG log url - look here for details on any failures: https://boss.instageni.gpolab.bbn.com/spewlogfile.php3?logfile=848bd8195a7633d1505c6908634eeeb8).)
11:47:19 INFO    : {   'code_tag': '41522dbf6ad03cec7f5c25af1d312ff019340551',
    'geni_ad_rspec_versions': [   {   'extensions': [],
                                      'namespace': 'http://www.protogeni.net/resources/rspec/0.1',
                                      'schema': 'http://www.protogeni.net/resources/rspec/0.1/ad.xsd',
                                      'type': 'ProtoGENI',
                                      'version': '0.1'},
                                  {   'extensions': [],
                                      'namespace': 'http://www.protogeni.net/resources/rspec/0.2',
                                      'schema': 'http://www.protogeni.net/resources/rspec/0.2/ad.xsd',
                                      'type': 'ProtoGENI',
                                      'version': '0.2'},
                                  {   'extensions': [   'http://www.protogeni.net/resources/rspec/ext/emulab/1',
                                                        'http://www.protogeni.net/resources/rspec/ext/site-info/1'],
                                      'namespace': 'http://www.protogeni.net/resources/rspec/2',
                                      'schema': 'http://www.protogeni.net/resources/rspec/2/ad.xsd',
                                      'type': 'ProtoGENI',
                                      'version': '2'},
                                  {   'extensions': [   'http://www.protogeni.net/resources/rspec/ext/emulab/1',
                                                        'http://www.protogeni.net/resources/rspec/ext/site-info/1'],
                                      'namespace': 'http://www.geni.net/resources/rspec/3',
                                      'schema': 'http://www.geni.net/resources/rspec/3/ad.xsd',
                                      'type': 'GENI',
                                      'version': '3'}],
    'geni_api': 2,
    'geni_api_versions': {   '1': 'https://boss.instageni.gpolab.bbn.com:12369/protogeni/xmlrpc/am/1.0',
                             '2': 'https://boss.instageni.gpolab.bbn.com:12369/protogeni/xmlrpc/am/2.0',
                             '3': 'https://boss.instageni.gpolab.bbn.com:12369/protogeni/xmlrpc/am/3.0'},
    'geni_request_rspec_versions': [   {   'extensions': [],
                                           'namespace': 'http://www.protogeni.net/resources/rspec/0.1',
                                           'schema': 'http://www.protogeni.net/resources/rspec/0.1/request.xsd',
                                           'type': 'ProtoGENI',
                                           'version': '0.1'},
                                       {   'extensions': [],
                                           'namespace': 'http://www.protogeni.net/resources/rspec/0.2',
                                           'schema': 'http://www.protogeni.net/resources/rspec/0.2/request.xsd',
                                           'type': 'ProtoGENI',
                                           'version': '0.2'},
                                       {   'extensions': [   'http://www.protogeni.net/resources/rspec/ext/emulab/1'],
                                           'namespace': 'http://www.protogeni.net/resources/rspec/2',
                                           'schema': 'http://www.protogeni.net/resources/rspec/2/request.xsd',
                                           'type': 'ProtoGENI',
                                           'version': '2'},
                                       {   'extensions': [   'http://www.protogeni.net/resources/rspec/ext/emulab/1'],
                                           'namespace': 'http://www.geni.net/resources/rspec/3',
                                           'schema': 'http://www.geni.net/resources/rspec/3/request.xsd',
                                           'type': 'GENI',
                                           'version': '3'}],
    'hostname': 'boss.instageni.gpolab.bbn.com',
    'hrn': 'bbninstageni.cm',
    'interface': 'aggregate',
    'url': 'https://boss.instageni.gpolab.bbn.com:12369/protogeni/xmlrpc/am',
    'urn': 'urn:publicid:IDN+instageni.gpolab.bbn.com+authority+cm'}
11:47:19 INFO    :  ------------------------------------------------------
11:47:19 INFO    :  Completed getversion:

  Options as run:
		aggregate: ['gpo-ig']
		framework: portal
		noGetVersionCache: True
		project: vicsandbox

  Args: getversion

  Result Summary: 
Got version for gpo-ig
 
11:47:19 INFO    :  ======================================================
bash-3.2$ 

OPTIONAL: Clear the passphrases from your cert and key

In the previous omni command you had to type your passphrase once. For other omni commands you might be asked for your passphrase multiple times and it can become an unwanted overhead. There is a script that will help you remove the passphrase from you SSL certificate and/or your SSH key that you will use to login to your nodes.

If you decide to do this run:

clear-passphrases 

Use the same passphrase as before (last time!).

Adding multiple users

If you want more users to have access to the resources you reserve with Omni, please follow these instructions.