Changes between Initial Version and Version 1 of GIMI-GEC16-Tutorials/GIMI-GEC16-TutorialB/Environment


Ignore:
Timestamp:
03/09/13 12:28:20 (11 years ago)
Author:
Cong
Comment:

--

Legend:

Unmodified
Added
Removed
Modified

  • GIMI-GEC16-Tutorials/GIMI-GEC16-TutorialB/Environment

    v1 v1  
     1== A. Establish Environment ==
     2
     3{{{
     4#!html
     5<div style="text-align:left; width:323px; margin-left:auto; margin-right:auto;">
     6<img id="Image-Maps_2201210012154478" src="http://emmy9.casa.umass.edu/images/GIMI_workflow_A.jpg" usemap="#Image-Maps_2201210012154478" border="0" width="323" height="531" alt="" />
     7<map id="_Image-Maps_2201210012154478" name="Image-Maps_2201210012154478">
     8<area shape="rect" coords="14,16,52,54" href="http://groups.geni.net/geni/wiki/gimiv1.1tutorial/environment" alt="" title=""    />
     9<area shape="rect" coords="53,10,152,60" href="http://groups.geni.net/geni/wiki/GIMIv1.1Tutorial/Environment" alt="" title=""    />
     10<area shape="rect" coords="53,86,152,136" href="http://groups.geni.net/geni/wiki/GIMIv1.1Tutorial/Slice" alt="" title=""    />
     11<area shape="rect" coords="53,162,152,212" href="http://groups.geni.net/geni/wiki/GIMIv1.1Tutorial/Orchestrate" alt="" title=""    />
     12<area shape="rect" coords="53,237,152,287" href="http://groups.geni.net/geni/wiki/GIMIv1.1Tutorial/Observe" alt="" title=""    />
     13<area shape="rect" coords="52,312,151,362" href="http://groups.geni.net/geni/wiki/GIMIv1.1Tutorial/Toirods" alt="" title=""    />
     14<area shape="rect" coords="53,387,152,437" href="http://groups.geni.net/geni/wiki/GIMIv1.1Tutorial/Fromirods" alt="" title=""    />
     15<area shape="rect" coords="169,388,268,438" href="http://groups.geni.net/geni/wiki/GIMIv1.1Tutorial/Analyze" alt="" title=""    />
     16<area shape="rect" coords="53,462,152,512" href="http://groups.geni.net/geni/wiki/GIMIv1.1Tutorial/Cleanup" alt="" title=""    />
     17<area shape="rect" coords="12,91,55,128" href="http://groups.geni.net/geni/wiki/GIMIv1.1Tutorial/Slice" alt="" title=""    />
     18<area shape="rect" coords="11,167,54,204" href="http://groups.geni.net/geni/wiki/GIMIv1.1Tutorial/Orchestrate" alt="" title=""    />
     19<area shape="rect" coords="11,242,54,279" href="http://groups.geni.net/geni/wiki/GIMIv1.1Tutorial/Observe" alt="" title=""    />
     20<area shape="rect" coords="9,317,52,354" href="http://groups.geni.net/geni/wiki/GIMIv1.1Tutorial/Toirods" alt="" title=""    />
     21<area shape="rect" coords="269,393,312,430" href="http://groups.geni.net/geni/wiki/GIMIv1.1Tutorial/Analyze" alt="" title=""    />
     22<area shape="rect" coords="10,391,53,428" href="http://groups.geni.net/geni/wiki/GIMIv1.1Tutorial/Fromirods" alt="" title=""    />
     23<area shape="rect" coords="11,467,54,504" href="http://groups.geni.net/geni/wiki/GIMIv1.1Tutorial/Cleanup" alt="" title=""    />
     24<area shape="rect" coords="321,529,323,531" href="http://www.image-maps.com/index.php?aff=mapped_users_2201210012154478" alt="Image Map" title="Image Map" />
     25</map>
     26<!-- Image map text links - End - -->
     27
     28</div>
     29}}}
     30
     31----
     32
     33=== A.1 Establish experiment managment (user workspace) service ===
     34
     35 * Bring up tutorial VM and log in.[[BR]]
     36   User: geniuser, PW: gec15user (ATTENTION account and PW for VirtualBox are different from those for GENI credentials. The latter will be handed out to you at the beginning of the tutorial!)
     37 * Open Firefox web browser
     38 * Open a terminal window
     39 * The software required for this tutorial is already installed in the tutorial VM.
     40 * Download GIMI tutorial specific configuration files by issuing the following command in a terminal window:
     41
     42{{{
     43#!html
     44<span style="color:red">It is important that you replace gimiXX with your actual user account (e.g., gimi01).
     45</span>
     46}}}
     47
     48{{{
     49$ wget emmy9.casa.umass.edu/GEC15-GIMI-Tutorial/wget_gec15.sh
     50$ chmod a+x wget_gec15.sh
     51$ ./wget_gec15.sh gimiXX
     52}}}
     53
     54----
     55
     56=== A.2 Copy and paste in user workspace ===
     57
     58It might be helpful to use shortcuts in the user workspace VM:
     59
     60Firefox/Flukes:
     61    Cut = Ctrl-X
     62    Copy = Ctrl-C
     63    Paste = Ctrl-V
     64
     65Terminal:
     66    Cut = Shift+Ctrl-X
     67    Copy = Shift + Ctrl-C
     68    Paste = Shift + Ctrl-V
     69
     70----
     71
     72=== A.3 Gather necessary keys, certificates and credentials ===
     73Since credentials are required for the different tools used within GIMI these have to be set up first. For this tutorial 30 GENI accounts were created (gimi01-gimi30). At the beginning of the tutorial you'll have received your personal account information for the day on a piece of actual paper!
     74It is IMPORTANT that you always use the account name exactly as specified. E.g, always use gimi01 and NOT gimi1!!
     75
     76To configure your credential in the user workspace VM execute the following command in the terminal:
     77
     78{{{
     79$ credconfig.sh -g ~/Tutorials/GIMI/gimiXX/ssh/gimiXX.pem  -f ~/Tutorials/GIMI/gimiXX/ssh/gimiXX.jks -i ~/Tutorials/GIMI/gimiXX/gimiXXIrodsEnv
     80}}}
     81
     82Where gimiXX has to be replaced by your actual user name. For the case of username gimi16 the command would look as follows:
     83
     84{{{
     85$ credconfig.sh -g ~/Tutorials/GIMI/gimi16/ssh/gimi16.pem  -f ~/Tutorials/GIMI/gimi16/ssh/gimi16.jks -i ~/Tutorials/GIMI/gimi16/gimi16IrodsEnv
     86}}}
     87
     88The gimiXX account will not stay active after the end of the tutorial. In case you are interested in further using GIMI tools (and we sure hope you are), here how you can use the script to configure the user workspace with your own, personal GENI credentials:
     89
     90
     91 * credconfig.sh -g ~/mypgenicert.pem -f ~/mypgeni.jks -i ~/myirodsEnv
     92
     93
     94[http://groups.geni.net/geni/wiki/GENIUserWorkspace/ConfigCredentials Here] you can find more detailed information on the credential management and configuration.
     95
     96And here we list the steps the script actually performs:
     97
     98    1.  Installs the GENI certificate in $HOME/.ssl
     99    2.  Creates an SSH key pair based on the private key in the GENI certificate and installs the pair in $HOME/.ssh/geni_key and $HOME/.ssh/geni_key.pub
     100    3.  Creates omni_config to point to the certificate and key pair.
     101    4.  Configures .flukes.properties with the appropriate keystore and key pair.
     102    5.  Configures .irods/.irodsEnv with the appropriate username and server information
     103    6.  Runs ssh-add to add the geni_key private key to the ssh agent for password-less login to the nodes.
     104
     105----
     106
     107=== A.4 Verify availability of desired aggregates ===
     108In this section, we provide some basic information about how an experimenter can determine what services are actually active and which ones are down.
     109We would like to emphasize that first and foremost experimenters should join the mailing lists mentioned in Section 5 of the Introduction. Service or infrastructure outage should usually reported on these lists. In some cases you can perform some basic investigations yourself.
     110
     111 * '''ExoGENI:''': Check mailing list: geni-orca-users@googlegroups.com
     112 * '''XMPP server:''' Just check if this [http://emmy9.casa.umass.edu:9090 link] works.
     113 * '''OML server:''' The OML server is running on port 3003 on emmy9.casa.umass.edu. A simple test if a service is running on this port can be performed with the following command:
     114{{{
     115$ nc -zv -w 10 emmy9.casa.umass.edu 3003
     116}}}
     117 * '''iRODS:''' A simple 'ils' at the command line will indicate potential problems with iRODS.
     118
     119----
     120
     121=== A.5 Verify availability of desired software images/packages ===
     122
     123The following software packages and scripts required for this tutorial are already installed on the VM:
     124
     125 * OMF EC, RC, AM (version 5.4)
     126 * OML server, iperf, nmetrics (version 2.8)
     127 * OMF web (version 5.4)
     128 * R (version 2.15.1)
     129 * iRODS client (version 3.1)
     130 * ExoGENI Software:
     131  * Link to Flukes on the desktop
     132  * .flukes.properties in /home/geniuser
     133
     134Any further software packages that might be required for other experiments have to be installed by the
     135experimenter.
     136
     137----
     138
     139=== A.6 Verify availability of necessary operational services, and access to those services ===
     140
     141 * IRODS: To test if the iRODS client can connect to the iRODS server simply execute the following command:
     142
     143{{{
     144$ ils
     145}}}
     146
     147As a result the content of our iRODS home directory should be listed:
     148
     149{{{
     150/geniRenci/home/gimi30:
     151  test.2
     152}}}
     153
     154In [http://groups.geni.net/geni/wiki/GIMIv1.1Tutorial/Toirods part E] of the tutorial, we introduce the iRODS web portal, which offers an alternative way of verifying if the iRODS service is up and running.
     155
     156----
     157
     158[[BR]]
     159[[BR]]
     160
     161
     162[http://groups.geni.net/geni/wiki/GIMIv1.1Tutorial/Intro Back to previous step]
     163
     164[http://groups.geni.net/geni/wiki/GIMIv1.1Tutorial/Slice  Forward to next step]
     165
     166[http://groups.geni.net/geni/wiki/GIMIv1.1Tutorial/ Back to tutorial main page]