wiki:GIMIv1.1Tutorial/Environment

Version 32 (modified by zink@cs.umass.edu, 11 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
    
  • The iRODS client uses a configuration file (~/.irods/.irodsEnv) that sets certain parameter for the icommands. Here is and example:
    # iRODS personal configuration file.
    #
    # This file was automatically created during iRODS installation.
    #   Created Thu Feb 16 14:06:27 2012
    #
    # iRODS server host name:
    irodsHost 'emmy9.casa.umass.edu'
    # iRODS server port number:
    irodsPort 1247
    
    # Default storage resource name:
    irodsDefResource 'iRODSUmass'
    # Home directory in iRODS:
    irodsHome '/geniRenci/home/gimiXX'
    # Current directory in iRODS:
    irodsCwd '/geniRenci/home/gimiXX'
    # Account name:
    irodsUserName 'gimiXX'
    # Zone:
    irodsZone 'geniRenci'
    

  • First of all copy the template iRODS configuration file to .irodsEnv with the following command:
    $ cp ~/Tutorials/GIMI/gimiXX/gimiIrodsEnv ~/.irods/.irodsEnv
    
  • Open ~/.irods/.irodsEnv with your favorite text editor (we recommend nano) and change gimiXX to your assigned username (e.g., gimi04).
  • Register with iRODS server by issuing the following command (more details on iRODS will be given shortly):
    $ iinit
    

  • You will be prompted for a password. Please type in the password you were provided with on the paper handout!!

A.2 Gather necessary keys, certificates and credentials

For the specific case of this tutorial all necessary keys, certificates and credentials have already been set up and configured for the tutorial accounts (gimi1-gimi30). http://groups.geni.net/geni/wiki/GENIUserWorkspace/ConfigCredentials 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)
  • 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:

$
$

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