GT 3.9.0 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
  • 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>/java/core/test/unit directory.
2

Deploy the unit tests by running:

 ant deploy

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

Run the unit 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 interoperability scenarios
1 Change to the <distribution directory>/java/core/test/interop directory
2

Deploy the interoperability test services by running:

 ant deploy

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

In another window, change to the <distribution directory> and run:

 ant startContainer

(requires either GLOBUS_LOCATION to be set or a installation in <distribution directory>/install)
4

In the initial window, run the interoperability scenarios by executing:

 ant test
5 Wait. These tests take a little while...
Run the counter sample
1 Change to the <distribution directory>/java/core/samples/counter directory.
2

Deploy the counter service and client by running:

 ant deploy

This will install the counter example 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/foobar:16:16:22: ./bin/counter-client 
   Got notification with value: 3
   Counter has value: 3