wiki:GIMIv1.1Tutorial/Environment

Version 41 (modified by zink@cs.umass.edu, 7 years ago) (diff)

--

A. Establish Environment

Image Map

A.1 Establish experiment managment (user workspace) service

  • Bring up tutorial VM and log in.
    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!)
  • Open Firefox web browser
  • Open a terminal window
  • The software required for this tutorial is already installed in the tutorial VM.
  • Download GIMI tutorial specific configuration files by issuing the following command in a user workspace terminal:
    $ cd ~/Tutorials/GIMI/common/
    $ git pull
    

A.2 Gather necessary keys, certificates and credentials

Since 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 (gimi1-gimi30). At the beginning of the tutorial you'll have received your personal account information for the day on a piece of actual paper! It is IMPORTANT that you always use the account name exactly as specified. E.g, always use gimi01 and NOT gimi1!!

To configure your credential in the user workspace VM execute the following command in the terminal:

$ credconfig.sh -g ~/Tutorials/GIMI/gimiXX/ssh/gimiXX.pem  -f ~/Tutorials/GIMI/gimiXX/ssh/gimiXX.jks -i ~/Tutorials/GIMI/gimiXX/gimiXXIrodsEnv

Where gimiXX has to be replaced by your actual user name. For the case of username gimi16 the command would look as follows:

$ credconfig.sh -g ~/Tutorials/GIMI/gimi16/ssh/gimi16.pem  -f ~/Tutorials/GIMI/gimi16/ssh/gimi16.jks -i ~/Tutorials/GIMI/gimi16/gimi16IrodsEnv

The 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:

credconfig.sh -g ~/mypgenicert.pem -f ~/mypgeni.jks -i ~/myirodsEnv

Here you can find more detailed information on the credential management and configuration.


A.3 Verify availability of desired aggregates

MZ: For this tutorial I think that should be covered in part B.


A.4 Verify availability of desired software images/packages

The following software packages and scripts required for this tutorial are already installed on the VM:

  • Git repository (git://github.com/johren/GENI-UserWorkspace.git)
    • located at ~/Tutorials/GIMI/common
    • contains:
      • GIMI scripts
      • Resource Description Files (RDF) for Flukes
  • OMF EC, RC, AM (version 5.4)
  • OML server, iperf, nmetrics (version 2.8)
  • OMF web
  • R
  • iRODS client (version 3.1)
  • ExoGENI Software:
    • Link to Flukes on the desktop
    • .flukes.properties in /home/geniuser

These additional tools and libraries are also installed on the VM:

  • python-m2crypto
  • git
  • vim
  • screen
  • emacs
  • apache2
  • adobe-flashplugin
  • python-dev

Any further software packages that might be required for other experiments have to be installed by the experimenter.


A.5 Verify availability of necessary operational services, and access to those services

  • IRODS: To test if the iRODS client can connect to the iRODS server simply execute the following command:
$ ils

As a result the content of our iRODS home directory should be listed:

/geniRenci/home/gimi30:
  test.2

In 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.


1) Establish experiment environment

1.1) Establish experiment managment (user workspace) service

1.2) Gather necessary keys, certificates and credentials

1.3) Verify availability of desired aggregates

1.4) Verify availability of desired software images/packages

1.5) Verify availability of necessary operational services, and access to those services



Back to previous step

Forward to next step

Back to tutorial main page

Attachments (1)

Download all attachments as: .zip