|Version 4 (modified by 10 years ago) ( diff ),|
Table of Contents
This page contains instructions for GENI experimenters describing how to use GIMI on a GENI WiMAX aggregate. If you are a site administrator looking for instructions on how to add GIMI functionality to your site, please see the setup instructions.
GIMI provides I&M services for experimenters. Running a GIMI-enabled experiment involves three components:
- Instrument an experiment with OML
- Execute an experiment with OMF
- Archive experiment measurements to iRODS
The steps required to instrument an experiment with OML are already well documented as well. Use these links to find out how to:
- Instrument an application that is written in C/C++, Ruby, or Python or
- Write a wrapper for an application written in another language, or one whose source code is not available
- Create an application definition for your application
Similarly, there is a already a great deal of documentation on using OMF on a WiMAX testbed. Refer to this self-guided tutorial for further details.
GIMI uses the iRODS data grid for archiving and further processing. The rest of this page describes how to get an iRODS account and then use it to archive experiment results gathered on a WiMAX testbed to iRODS.
Archiving an Experiment to iRODS
Get an iRODS account (one time only)
Use of iRODS is on an opt-in basis. To get an iRODS account, contact the designated administrator for your WiMAX testbed:
Initialize your iRODS account (one time only)
The first time you use this account, you must initialize it using
iinit and the values provided by your site administrator. For example:
$ iinit One or more fields in your iRODS environment file (.irodsEnv) are missing; please enter them. Enter the host name (DNS) of the server to connect to:emmy9.casa.umass.edu Enter the port number:1247 Enter your irods user name:ffund Enter your irods zone:geniRenci Those values will be added to your environment file (for use by other i-commands) if the login succeeds. Enter your current iRODS password:
Then add a line to your
~/.irods/.irodsEnv file indicating your default resource on the iRODS server. For example:
echo "irodsDefResource=iRODSUmass2" >> ~/.irods/.irodsEnv
ipasswd to change your password from the default password given to you by the iRODS site adminstrator.