| 1 | = ProtoGENI Evaluation = |
| 2 | |
| 3 | This evaluation is a documentation effort. ProtoGENI software installation was executed by Chaos, who has captured all installation findings in the [http://groups.geni.net/syseng/wiki/OpsProtoGeni OpsProtoGeni] page. |
| 4 | |
| 5 | The [http://groups.geni.net/syseng/wiki/OpsProtoGeni OpsProtoGeni] page was initially reviewed, but it was determined that it could not be published externally without major changes. Mostly because many details were very GPO Lab specific. For example: |
| 6 | |
| 7 | * Lots of puppet instructions |
| 8 | * The 3 network used in ProtoGENI were replaced by one network in our installations. |
| 9 | * All references to the 3 network point to the one generic network. |
| 10 | * Some housekeeping operation are not placed in proper context. |
| 11 | * Some image are re-located to GPO Lab servers, need reference to external sources. |
| 12 | * Various reference to "Node" do not clearly state what type of node. |
| 13 | |
| 14 | Because of the above, changed approach to start with the ProtoGENI Emulab documentation and add our findings. |
| 15 | |
| 16 | This effort is documented in internal pages, and was not completed. |
| 17 | |
| 18 | = ProtoGENI Findings = |
| 19 | |
| 20 | = ProtoGENI How-to = |
| 21 | |
| 22 | The ProtoGENI software installation is made up of various steps which are highlighted in this page, the full details of the |
| 23 | installation are found at the Emulab wiki. Throughout this document references are made to the appropriate Emulab page. |
| 24 | This page will expand on the instructions provided, when appropriate. |
| 25 | |
| 26 | 1. According to the [https://users.emulab.net/trac/protogeni/wiki/ProtoGENIInstall ProtoGENI Install] page, the latest ProtoGENI Development software should be used, which can be accessed as describe in [http://users.emulab.net/trac/emulab/wiki/GitRepository Git Repository] page: |
| 27 | |
| 28 | {{{ |
| 29 | $ git clone git-public.flux.utah.edu:/flux/git/emulab-devel.git |
| 30 | }}} |
| 31 | |
| 32 | 2. Users are instructed to update the Boss system as been described in [http://users.emulab.net/trac/emulab/wiki/install/update-testbed.html update] page. |
| 33 | |
| 34 | 3. The libdnet port should be installed on the boss server. [http://libdnet.sourceforge.net/ Libnet] provides a simplified, portable interface to several low-level networking routines. |
| 35 | |
| 36 | 4. Configuration is required to enable GENI. The defs (~/emulab-devel/defs-default) to include: |
| 37 | |
| 38 | {{{ |
| 39 | PROTOGENI_SUPPORT=1 |
| 40 | PROTOGENI_DOMAIN="myProtoGENI" |
| 41 | }}} |
| 42 | |
| 43 | Once the settings are in place, compilation can be performed: |
| 44 | {{{ |
| 45 | $ sudo cp /usr/testbed/tmp/defs-pgeniN /proj/emulab-ops/data/src/testbed/defs-gpolab-pgeniN |
| 46 | $ cd /proj/emulab-ops/data/obj/testbed |
| 47 | $ /proj/emulab-ops/data/src/testbed/configure --with-TBDEFS=/proj/emulab-ops/data/src/testbed/defs-gpolab-pgeniN |
| 48 | $ gmake clean |
| 49 | $ gmake |
| 50 | $ sudo gmake boss-install |
| 51 | $ cd protogeni |
| 52 | $ gmake |
| 53 | $ sudo gmake install |
| 54 | }}} |
| 55 | ''' Question: Where did obj dir come from? ''' |
| 56 | |
| 57 | 5. Run the initsite script, which can be run multiple times until all initialization pre-requisites are met: |
| 58 | {{{ |
| 59 | $sudo /usr/testbed/sbin/protogeni/initsite |
| 60 | }}} |
| 61 | |
| 62 | See the [http://groups.geni.net/syseng/wiki/OpsProtoGeni#InstallProtoGeni InstallProtoGENI] Section Step 5 for an |
| 63 | example captures of 6 consecutive runs that eventually initialize the site. |
| 64 | |
| 65 | 6. Site is now initialized. |
| 66 | |
| 67 | 7. Install and start the ProtoGENI expiration daemon. The expiration daemon backgrounds itself and will automatically starts as part of boss system startup: |
| 68 | {{{ |
| 69 | $ cd /proj/emulab-ops/data/obj/testbed/rc.d |
| 70 | $ gmake |
| 71 | $ sudo gmake install |
| 72 | $ sudo /usr/testbed/sbin/protogeni/expire_daemon |
| 73 | }}} |
| 74 | |
| 75 | 8. To register resources with the clearinghouse run the following on the boss system: |
| 76 | {{{ |
| 77 | $ /usr/testbed/sbin/protogeni/register_resources |
| 78 | }}} |
| 79 | |
| 80 | |