2. Installation

Up one level

Prerequisites

• Java 5.0 (1.5.0) or later. Use java -version to display the version.

Unpacking the software

This document explains how to install the command-line client library. This program allows you to perform operations on the GRIA services by giving commands at a command line (Unix shell or Windows DOS prompt).

Unpack the gria-client-<version>.zip or gria-client-<version>.tar.gz archive into a new directory. The archive contains the following items:

conf

The configuration files go here. This can be set to another directory be setting an environment variable GRIA_CONF_DIR

gridcli (Linux) or gridcli.bat (Windows)

Scripts to run the command-line client easily.

lib

All the .jar files needed to run the client.

doc

The documentation files.

README.html

A file telling you where the documentation files are.

LICENSE.txt

License terms.

Upgrading

To upgrade from a GRIA Client 5.x simply set the GRIA_CONF_DIR directory environment variable to the location of your old configuration directory . There is then no need to generate a keystore but you should edit the gridcli or gridcli.bat if by default your system uses an unoffical version of Java.

Running the client

To test the client, try running it with the following command, from within the installation directory:

Windows

c:\grid-client-<version> gridcli

Linux

$ ./gridcli

Note that you must use an official Sun version of Java. On systems which default to their own version (such as Fedora Core), you may need to edit the gridcli script to run the Sun version rather than the system default. For example, if you have installed java in /opt then modify

java -Dgrid.config.dir=$CLIDIR/conf -jar $CLIDIR/lib/itinnov-grid-client-cli-4.jar "$@"

to

/opt/java/bin/java -Dgrid.config.dir=$CLIDIR/conf -jar $CLIDIR/lib/itinnov-grid-client-cli-4.jar "$@"

Creating an alias

You'll probably want to use the gridcli command from other directories. To do this:

Windows

Copy gridcli.bat into a directory in your path and then edit gridcli.bat to set the original installation path as explained in the file. Alternatively, set your Path system variable (Control Panel -> System -> Advanced -> Environment Variables).

Linux or Unix

Copy the shell script called gridcli to your /usr/local/bin directory and edit it as described in the comments inside the file. You may have to type rehash before your shell will notice the new command.

Configuring a web-proxy

In some network configurations, the site firewall prevents you from connecting to services directly. Instead, all requests must go via a proxy, which is set up by your network administrator. In this case, you need to edit the conf/HTTP-proxy.properties file and set the indicated values.

If you are not sure whether you are using a proxy, consult your network adminstrator. You may be able to find out whether you are using a proxy by checking your browser's settings:

Checking settings (Firefox browser)

1. Open then Edit menu and choose Preferences (use Tools -> Options on Windows).
2. In the General section, click on Connection Settings....
3. The hostname and port for SSL Proxy are the values you need.