Administration
Tutorial Preparation
 |
 |
 |
 |
Table of Contents
|
 |
 |
 |
 |
caGrid Software Installation
Background Information
This tutorial uses caGrid 1.3. We provide a hackathon.zip that includes caGrid 1.3, scripts that help you complete the tutorial, and more. Even if you currently have caGrid 1.3 installed, please download the hackathon.zip and use it for this tutorial. It is likely that a future version of this tutorial will specify instructions for using an existing caGrid 1.3 installation (stay tuned!).
Prerequisite
Please verify that you have the JDK for Java 1.5 installed. If you do not have it installed, please download Java 1.5 JDK
Download and Unzip
 | Please be patient when downloading! The hackathon.zip file is ~1.7Gb and will take some time to download. You will also need an additional 2Gb on you hard drive to unzip the file. |
- Download the hackathon.zip archive
- Unzip the file to your "c:\" directory using zip utility (i.e. Winzip)
- This creates a new directory C:\hackathon
Note: For the purposes of this tutorial, we have chosen "c:\" due to its accessibility. You may choose another directory, but note that this tutorial will always reference the directory c:\hackathon for the location of caGrid files.
Locations of important files once unzipped:
- The caGrid 1.3 Installer: C:\hackathon\caGrid-installer-1.3
- caGrid 1.3: C:\hackathon\caGrid
- Apache Ant: C:\hackathon\apache-ant-1.7.0
- Globus Toolkit for Java: C:\hackathon\ws-core-4.0.3
Installation
 | IMPORTANT NOTE: if you have previously installed caGrid, please rename or move the .cagrid\installer-1.3 directory in your home directory (e.g., C:\Documents and Settings\Username or ~/.cagrid/installer-1.3) Don't delete ~/.cagrid itself as it contains your security certificates. |
Once the file has been unzipped, open the caGrid 1.3 installer: C:\hackathon\caGrid-installer-1.3\installLocal. Follow the steps in the installer to install caGrid into the C:\hackathon directory. For more information on using the installer, see Install caGrid Using the caGrid 1.3 Installer
| If you have previously installed caGrid, the installer will ask if you want to reinstall Ant, Globus and caGrid. Check Yes for each and click Next. When asked to provide the directory for Ant, Globus, and caGrid to be installed in, browse to C:/hackathon as the destination for the install. |
Configuration
When prompted to specify which target grid you want to configure your installation to use, select Training Grid.
Once caGrid is installed successfully, the installer will ask you to set the following SYSTEM environment variables: ANT_HOME and GLOBUS_LOCATION. Since we have included the neccessary files in the hackathon.zip file that you unzipped, the following environment variables should be set as follows:
- JAVA_HOME is set to your JDK directory (this is the prerequisite that was mentioned above)
- ANT_HOME=C:\hackathon\apache-ant-1.7.0
- GLOBUS_LOCATION=C:\hackathon\ws-core-4.0.
- CATALINA_HOME=C:\hackathon\apache-tomcat-5.5.27
Add ";%ANT_HOME%\bin;%JAVA_HOME%\bin" to the end of your SYSTEM path.
For more information on how to set environment variables, please see Configuration of Windows System environment variables.
Additional software included in hackathon.zip:
- Notepad++, A free file editor application: C:\hackathon\notepad++
- Software Distributions: C:\hackathon\dist
- Completed PhotoSharing Service: C:\hackathon\PhotoSharing-solution
Mac / Linux Settings
This tutorial assumes you are using Windows XP or Vista with the tutorial installed at C:\hackathon. With two simple modifications, you can run the tutorial in an OS X or Linux environment.
Steps to run on OS X or Linux:
- Modify cagrid.installer.unix.properties and download.unix.properties (in C:\hackathon\caGrid-installer-1.3). Replace the multiple text occurances of "PATH_TO_HOME_DIR" with the appropriate value for your system.
- Modify build.xml in the top level hackathon directory. Update line 46 by changing the line from:<sysproperty key="download.properties" value="download.properties"/>to:<sysproperty key="download.properties" value="download.unix.properties"/>