Install caGrid and Configure a Secure Container Using the caGrid 1.3 Installer

Installer Prerequisites

The caGrid Installer installs all prerequisites except for Java and MySQL.

Java 1.5 JDK
(Optional) If you are deploying caGrid core services locally, you may also need a MySQL database.
Note
MySQL is only required for the security services and GME. You can use 4.x (with transaction enabled; i.e., use InnoDB engine) or 5.x.
Make sure the JAVA_HOME environment variable is set and points to the correct location.

Download the caGrid 1.3 Installer. The downloaded installer should be contained in the file caGrid-installer-1.3.zip.
Unzip the file caGrid-installer-1.3.zip, this should create the directory caGrid-installer-1.3, from this point forward we will refer to this directory as CAGRID_INSTALLER_LOCATION.

From a command prompt launch the installer:

 > cd <CAGRID_INSTALLER_LOCATION> 
 > java -jar caGrid-installer-1.3.jar

Select the I agree to this license checkbox and click Next.

Select the Install/Configure caGrid Software and Install/Configure Grid Service Container checkboxes and click Next.

The installer detects whether or not you have already installed Ant. It installs or reinstalls it, depending on the installation status. In either case, you must specify where you want to install Ant.
The installer detects whether or not you have already installed Globus. It installs or reinstalls it, depending on your installation status. In either case, you must specify where you want to install Globus.

The installer prompts you to speciry where you want to install caGrid. Specify a location and then click Next.

The installer displays a list of tasks that the installer will perform. Click Next to start the installation process. The installer downloads, builds, and installs several components. Note: This process takes several minutes.

Once the installer has completed installing all the components, click Next.

The installer ask you which Grid you would like to configure your installation to use. The installer supports configuring caGrid to work out of the box with many community Grid environments. For testing and development purposes we recommend selecting the Training Grid. If you do not want to configure caGrid to work with an existing Grid, you may select that as well. The installer can also be modified to support additional Grids.

The installer shows a summary of the tasks to be completed. Click Next to configure caGrid to use the selected target Grids. Note: This process takes several minutes.

Once the installer has finished configuring caGrid to use the target Grid, click Next.

Select the Container to which you want to deploy your service. This guide provides instructions for using the Tomcat container. Check the Should this container be secure? option and then click Next.

In the hostname box, enter the hostname of your server; this should match the hostname you used in creating your host credentials. Click Next.

If you plan on using this container to deploy a service that registers to an existing grid, you must use a publicly resolvable DNS name (or static IP). If you do not, you will have to manually edit configuration files later.

From the Obtain host credentials method list, select the option that applies to your situation and click Next.

Options:

If you do not yet have credentials for your service, then select Use GAARDS to obtain host credentials.
If you have host credentials that are not in the default location, then select Browse to host credential on the file system
If you have host credentials that are in the default location, then select Host credentials are already installed

Note: Use of the Copy in host credentials manually option is not recommended. Use the Browse to host credential on the file system option instead.

Default credential location:

On Windows, this will be a path like "C:\Documents and Settings\<USERNAME>\.cagrid\certificates".
On Linux/MAC this will be a path like "/Users/YOUR_USERNAME/.cagrid/certificates".

Enter the location of your host certificate into the Certificate box. Enter the location of your private key into Key box. Click Next.

The next screen prompts you to specify where you want to install Tomcat. In the Directory box, enter the installation location and then click Next.

The next screen displays a list of tasks that the installer will perform to install and configure Tomcat. Click Next.

Once the installer has completed installing all the components, click Next.

Click Next. The final screen will remind you set your ANT_HOME, GLOBUS_LOCATION and CATALINA_HOME environment variables. Set these variables immediately and then click Finish.
These instructions are also written to a file called CAGRID_POST_INSTALLATION.txt in the directory from which you ran the installer.

Close the installer by clicking Close.