Pre Tutorial Install

Table of Contents

1 Pre Tutorial Install
2 Install Software

2.1 Remove Cached Introduce Files
2.2 Install Java 1.5
2.3 Install caGrid

2.3.1 From CD or Memory Stick
2.3.2 From Web

3 Set Up Environment

3.1 Option 1 (Setting environment variables):
3.2 Option 2 ( Windows Users - Using the provided batch file):

4 Validate Pre-Requisite Software
5 Continue to Tutorials

Install Software

Remove Cached Introduce Files

If you have installed caGrid or Introduce before you will need to remove the cache files that are used to maintain users preferences.
- In order to remove these files you need to remove the .introduce and .cagrid directories, if they exist, from your users home directory. In windows this directory is found in C:\Documents and Settings\<username> and in unix based systems this is typically /home/<username>.

Install Java 1.5

http://java.sun.com/javase/downloads/index_jdk5.jsp

Install caGrid

From CD or Memory Stick

Execute the cagrid-training.exe self extraction utility.
or
Copy the zip archive cagrid-training.zip to a location on your hard drive, and unzip it.

From Web

Choose the self extracting install file or the zip file below.
- Download and execute the windows self extracting install file. (~200MB)
- Download and unzip the tutorial software bundle. (~200MB)
  The provided tutorial distribution is a trimmed down version of the actual caGrid 1.0 release. It has the following changes:
configurations modified to use the training services
pre-built
does not have any caGrid projects that are not used in the tutorial
simplified build process only capable of running the tools used for the tutorial

After the tutorial, users who are interested in additional capabilities of caGrid are encouraged to delete this distribution and download the actual release.

Set Up Environment

Set the following environment variables:

JAVA_HOME (pointing to the root directory of the java installation)

Microsoft has a help page describing how to set environment variables under Windows XP.

Option 1 (Setting environment variables):

Set the following environment variables:

ANT_HOME (pointing to the root directory of the ant installation <......>cagrid-training\apache-ant-1.6.5)
GLOBUS_LOCATION (pointing to the root directory of the Globus installation <......>cagrid-training\ws-core-4.0.3)
CAGRID_LOCATION (pointing to the root directory of the caGrid installation <......>cagrid-training\caGrid-1.0)

Add ANT_HOME/bin and JAVA_HOME/bin to your environments PATH variable

Option 2 (Windows Users - Using the provided batch file):

There is a terminal.bat file in the top directory of the tutorial distribution. You can just double-click this file whenever you need a "command prompt" and it will set the environment variables above for the duration of the command prompt session.

Result of double-clicking terminal.bat

If you get an error message, you need to set your JAVA_HOME environment variable to the directory in which java is installed, and run again.

NOTE: There is a limit to the command length a windows terminal can run, and some of the caGrid classpath's can be quite long; if you encounter problems running the tools, try extracting the files to a short path (such as c:\cagrid-training as opposed to your Desktop).

Validate Pre-Requisite Software

To validate that we have installed Java, and Ant correctly.

%> java -version 

%> ant -version

Result of running java -version

To validate that we have installed Globus correctly, we will start up the globus container.

%> cd %GLOBUS_LOCATION%\bin 

%> globus-start-container -nosec

Result of starting globus

To validate that caGrid has installed correctly, execute the Introduce Grid Service Authoring Toolkit.

%> cd %CAGRID_LOCATION% 

%> ant introduce