GT 3.9.1 Java WSRF Core Preview Installation Guide

Prerequisites

  • Java JDK v1.3 or higher

    When using IBM's JDK v1.4 you will need to obtain the Xerces-2 jars and place them in $JAVA_HOME/lib/endorsed

    Refer to other Java installation requisites in the security document.

  • Apache Ant 1.5 or higher

    You will need to install the JUnit jar to be able to run the tests.

Installation

1 Un-tar the distribution.
2 Change into the wsrf directory, henceforth referred to as the <distribution directory>.
3

Set the GLOBUS_LOCATION environment variable to the absolute path of the target directory of your installation.

  • If not set, the WSRF preview will create an install directory in the distribution directory.
  • If GLOBUS_LOCATION is set when running ant clean, it will be deleted. If it isn't set, then ant clean will try to delete the install directory in the current directory.
4

Run:

 ant deploy

You should now have an installation of the WSRF preview in either $GLOBUS_LOCATION or install.

Troubleshooting Your Installation

  • No known issues right now

Testing Your Installation

Run the unit tests
1 Change to the <distribution directory> directory.
2

Make sure you have the JUnit jar on your CLASSPATH and then deploy the tests by running:

 ant deployTest

The tests will be installed in either $GLOBUS_LOCATION (if set) or <distribution directory>/install. This installs the test services.
3

Make sure you have a valid proxy. This may be done by setting the GLOBUS_LOCATION environment variable and then running $GLOBUS_LOCATION/bin/grid-proxy-init. Be aware that this version of grid-proxy-init echoes the password to your screen as you type it. The above presumes that you have a prior security setup. If this is not the case, you can acquire certificates for testing purposes from the Globus Certificate Service. Note that requesting and installing certificates from the Globus Certificate Service requires that you have a full installation of a stable Globus Toolkit release
4

Run the tests by executing:

 ant test
  • Currently causes exceptions to scroll across your screen. These are part of the normal tests and can be ignored unless the actual test returns a failure.
  • Test reports are placed in the test-reports directory.
4. Wait. These tests take a little while...
Run the counter sample
1 Change to the <distribution directory> directory.
2

Deploy the samples by running:

 ant deploySamples

This will install the counter and management examples to your installation directory ($GLOBUS_LOCATION or <distribution directory>/install)
3

Start the container by running:

 $GLOBUS_LOCATION/bin/globus-start-container

(requires GLOBUS_LOCATION to be set)
4

In another window, run:

 $GLOBUS_LOCATION/bin/counter-client

(requires GLOBUS_LOCATION to be set)

As a result you should see something like the following:

 ~/test/wsrf/install:17:56:52: ./bin/counter-client 
 Counter service: http://localhost:8080/wsrf/services/CounterService
 Got notification with value: 3
 Counter has value: 3
 Got notification with value: 13