Pre-requisites

The following pre-requisites and the indirect dependencies must be installed and tested prior to installing GridRUS.

• Open Middleware Infrastructure Institute - Client (3.4.0): Open Middleware Infrastructure Institute - Client (3.4.0) must be installed and tested according to the OMII installation procedure. This is ONLY REQUIRED if you intend to use the GridRUS client tools. The installation directory will be referred to as OMIICLIENT_HOME in this document. The GridRUS tools assume the default to be $HOME/OMIICLIENT unless specified.
• Open Middleware Infrastructure Institute - Server (3.4.0): Open Middleware Infrastructure Institute - Server (3.4.0) must be installed and tested according to the OMII installation procedure. This is ONLY REQUIRED if you intend to deploy a GridRUS service instance. This will be referred to as OMII_HOME in this document. The GridRUS tools assume this to be /usr/local/OMII unless specified.
• Apache Ant - 1.6+: Apache Ant (version 1.6 or above) must be installed and available in your PATH in order to install the GridRUS client and server distribution without using the OMII Stack Installer.

Downloading GridRUS

Official GridRUS binary releases can be downloaded here. You can also obtain the continuous build to enjoy the latest bug fixes and cutting-edge features.

Distributions are packaged in .tar.gz and .zip formats. Packages named GridRUS-X.Y.Z-bin-server.[tar.gz] is the server binary distribution, while GridRUS-X.Y.Z-bin-client.[tar.gz|zip] is the client binary distribution. Package named GridRUS-X.Y.Z-src.[tar.gz] contains the source distribution.

To follow the Quick Start Guide, you must download the the server and client distribution

To build a binary release from source code, please consult the Developer Guide for instruction.

Installing the GridRUS service

1. Please ensure the OMII container is not running.
2. Place the GridRUS-X.Y.Z-server.[tar.gz|zip] archive in a temporary directory (e.g. /tmp).
3. Unpack the archive using the GNU tar or the zip command.

   $> cd /tmp
   
   $> tar zxvf gridrus-X.Y-server.tar.gz
   
   or
   
   $> unzip gridrus-X.Y-server.zip
   
   $> ls -l gridrus-server
   drwxr-xr-x    8 wwhl  wwhl       272 May 27 12:26 .
   drwx------   18 wwhl  wwhl       612 May 27 13:10 ..
   -rw-r--r--    1 wwhl  wwhl    100872 May 26 15:01 LICENCE.3RDPARTY.txt
   -rw-r--r--    1 wwhl  wwhl      1531 May 26 15:01 LICENCE.txt
   -rw-r--r--    1 wwhl  wwhl      4274 May 27 12:21 build.xml
   drwxr-xr-x    3 wwhl  wwhl       102 May 26 15:01 config
   drwxr-xr-x   43 wwhl  wwhl      1462 May 27 12:26 docs
   -rw-r--r--    1 wwhl  wwhl  16385683 May 27 12:21 gridrus.war

4. If you have a previous version of GridRUS service installed, you need to first uninstall it using the command,

   $> ant uninstall -Domii.server.home=${OMII_HOME} 

5. To install, execute the installation Ant script,

   $> cd gridrus-server
   $> ant install -Domii.server.home=${OMII_HOME} 

6. Look for the line "BUILD SUCCESSFUL" in the output which indicates the installation has completed successfully.

Installing the GridRUS client

1. Place the GridRUS-X.Y.Z-client.[tar.gz|zip] archive in a temporary directory (e.g. /tmp).
2. Unpack the archive using the GNU tar or the zip command.

   $> cd /tmp
   
   $> tar zxvf gridrus-X.Y-client.tar.gz
   
   or
   
   $> unzip gridrus-X.Y-client.zip
   
   $> ls -l gridrus-client
   drwxr-xr-x    9 wwhl  wwhl     306 May 27 12:26 .
   drwx------   18 wwhl  wwhl     612 May 27 13:10 ..
   -rw-r--r--    1 wwhl  wwhl  100872 May 26 15:01 LICENCE.3RDPARTY.txt
   -rw-r--r--    1 wwhl  wwhl    1531 May 26 15:01 LICENCE.txt
   drwxr-xr-x   12 wwhl  wwhl     408 May 27 12:21 bin
   -rw-r--r--    1 wwhl  wwhl    3098 May 27 12:21 build.xml
   drwxr-xr-x    3 wwhl  wwhl     102 May 26 15:01 data
   drwxr-xr-x   43 wwhl  wwhl    1462 May 27 12:26 docs
   drwxr-xr-x   15 wwhl  wwhl     510 May 27 12:21 lib

3. If you have a previous version of GridRUS client installed, you need to first uninstall it using the command,

   $> ant uninstall -Domii.client.home=${OMIICLIENT_HOME}

4. To install, execute the installation Ant script,

   $> cd gridrus-client
   $> ant install -Domii.client.home=${OMII_CLIENT_HOME}

5. Look for the line "BUILD SUCCESSFUL" in the output which indicates the installation has completed successfully.

Running the GridRUS Service

Restart the OMII container after the installation has completed.

$> cd ${OMII_HOME}/jakarta-tomcat-5.0.25/bin
$> ./start_base.sh
Starting up tomcat
Using CATALINA_BASE:   /usr/local/OMII/jakarta-tomcat-5.0.25
Using CATALINA_HOME:   /usr/local/OMII/jakarta-tomcat-5.0.25
Using CATALINA_TMPDIR: /usr/local/OMII/jakarta-tomcat-5.0.25/temp
Using JAVA_HOME:       /usr/local/jdk1.4
Waiting....!....!.... Started.
$>

The default setup uses an embedded XML database based on the eXist framework. Please consult the Deployment Guide for advance configuration instruction.

To verify the GridRUS service is deployed successfully, consult the GridRUS log file $OMII_HOME/jakarta-tomcat-5.0.25/logs/gridrus.log and look for the lines

...
2006-05-23 11:28:45,505 INFO  [ApplicationContextConfigurator] GridRUS machinery initialised
...

The GridRUS service is initialised correctly if there is no ERROR messages originated from the gridrus webapp in the log file.

You may use the installation test tool to verify the service has been properly deployed

$> cd /tmp/gridrus-service
$> ant test-install -Dtomcat.port=${YOUR_TOMCAT_PORT}