...setup the GT3 command line clients

Most of the examples in the tutorial depend on a set of very handy command line clients included in GT3. For example, to create a Grid Service instance we can use the ogsi-create-service command:

ogsi-create-service
  http://localhost:8080/ogsa/services/tutorial/core/factory/MathFactoryService

Without the command line clients, we would need to run a Java class, which is not as easy to remember as ogsi-create-service.

java org.globus.ogsa.client.CreateService
     http://localhost:8080/ogsa/services/tutorial/core/factory/MathFactoryService

Furthermore, using the Java class directly, we would first have to set all the necessary environment variables first (the CLASSPATH, etc.). The command line clients take care of all this automatically.

However, these command line clients are, by default, not setup. To do so, follow these simple steps:

  1. Set an environment variable called GLOBUS_LOCATION with the path of the root of your GT3 installation. For example, /usr/local/gt3/

  2. Run the command ant setup from the root of your GT3 installation. Make sure you run this with a user with write permissions on that directory.

  3. All the command line clients will be created in $GLOBUS_LOCATION/bin. You can now run the commands from that directory.

  4. (Optional) To run the commands from any directory, add $GLOBUS_LOCATION/bin to your PATH variable.

You can find more detailed instructions on how to setup the clients, along with a description of all the available clients, in the User's Guide included with GT3, which you can find in: $GLOBUS_LOCATION/docs/users_guide.html (11 - Command Line Clients)