[[TOC]]

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 [wiki:WiMAX/GIMISetup setup instructions].

== Overview ==

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 [http://mytestbed.net/projects/oml/wiki/Client_Programming C/C++], [http://rubydoc.info/gems/oml4r/ Ruby], or [http://pypi.python.org/pypi/oml4py/ Python] or
 * [http://mytestbed.net/projects/omf/wiki/OMLWrapperHowTo Write a wrapper] for an application written in another language, or one whose source code is not available
 * Create an [https://mytestbed.net/projects/omf/wiki/BasicTutorialStage3-5-3 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 [http://groups.geni.net/geni/wiki/GEC15Agenda/WiMAXTutorial/SelfGuided 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:

||Site||Contact||
||WINLAB||witestlab@poly.edu||
||NYU-Poly||witestlab@poly.edu||

=== 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
}}}

Finally, use {{{ipasswd}}} to change your password from the default password given to you by the iRODS site adminstrator.