Changes between Version 2 and Version 3 of dSite/gGIMISetup

Timestamp:

Nov 26, 2012, 10:14:15 PM (11 years ago)

Author:

ffund01

Comment:

—

dSite/gGIMISetup

@@ -20 +20 @@
 This document primarily describes how to provide tools for users to archive an experiment to iRODS. This consists of three parts:
  * Installing {{{icommands}}}
- * Installing the extra {{{iarchive script}}}
+ * Installing the extra {{{iarchive}}} script
  * Setting up iRODS accounts for users
+ * Extending the OMF experiment controller (optional)
  * Installing the iRODS web frontend (optional)
+
+
+== Install {{{icommands}}} ==
+
+The iRODS software may be downloaded [https://www.irods.org/download.html here].
+
+Use the {{{irodssetup}}} script inside this package and choose to build only the {{{icommands}}}. Then make these commands available to all users as follows:
+{{{
+cp iRODS/clients/icommands/bin/* /usr/local/bin/
+}}}
+
+== Install {{{iarchive}}} ==
+
+Download the {{{iarchive}}} script, install it in /usr/local/bin, and make it executable:
+{{{
+wget http://witestlab.poly.edu/repos/misc/iarchive
+mv iarchive /usr/local/bin
+chmod +x /usr/local/bin/iarchive
+}}}
+
+If necessary, edit the script and replace the {{{ICMD_PATH}}}, {{{OML_DIR}}}, and {{{EC_LOG_DIR}}} with the relevant values for your system:
+ * {{{ICMD_PATH}}} is the location where the {{{icommands}}} are installed
+ * {{{OML_DIR}}} is the location where the OML server stores sq3 files (future version of this script will also accept a URL of an OMF results service)
+ * {{{EC_LOG_DIR}}} is the location where the OMF experiment controller stores experiment log files
+
+
+== Set up iRODS accounts for users ==
+
+The administrator for the iRODS server you are using must create an account that is in the {{{rodsadmin}}} group. With this account, you can now create new users using the {{{iadmin}}} commands.
+
+The first time you use this account, you must initialize it using {{{iinit}}} and the values provided by the administrator of the iRODS site you are using. 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:
+{{{
+irodsDefResource=iRODSUmass2
+}}}
+
+Finally, use {{{ipasswd}}} to change your password from the default password given to you by the iRODS site adminstrator.
+
+Once your account is initialized, use these steps to create new user:
+ * Temporarily set your irodsHost environment variable to the address of the iCAT server (not necessarily the iRODS server). For example:
+{{{ 
+export irodsHost=geni-gimi.renci.org
+}}}
+ * Use {{{iadmin}}} to create a new user, enroll that use in your site "group", and create an initial password for the user. In this example, we create a user {{{x0dros}}} in the {{{nyupoly}}} group and give him the initial password {{{<password>}}}:
+{{{
+iadmin mkuser x0dros#geniRenci rodsuser
+iadmin atg nyupoly x0dros#geniRenci
+iadmin moduser x0dros#geniRenci password <password>
+iadmin quit
+}}}
+ * Finally, unset the temporary irodsHost environment variable:
+{{{
+unset irodsHost
+}}}