Upgrade the Index Service

Step 0: Shutdown caGrid 1.3 Index Service

Connect to your caGrid 1.3 Index server
Shutdown your Tomcat Container
```
 $ $CATALINA_HOME/bin/shutdown.sh
```

Step 1: Prepare caGrid 1.4 Host

The caGrid 1.4 Training grid host was installed and configured according to the specifications listed on caGrid 1.4 Host Configuration page.

Index specific requirements:

Non-secure container
Larger memory allocation for JVM

Step 2: Install caGrid 1.4 Software

In this step you will use the installer to install and configure caGrid. Be sure to read the following blue info box for special instructions for step 11, 15 and 16 of the installer before proceeding.

Install caGrid and Configure a Non-Secure Container Using the caGrid 1.4 Installer

At Step 11: Make sure you select the correct target grid for your installation
QA: NCI QA Grid for caGrid 1.4
Stage: NCI QA Grid for caGrid 1.4
Production: NCI QA Grid for caGrid 1.4
Training: Training Grid for caGrid 1.4

Step 15: The hostname must be the externally routable name. For example, the Training Grid Master GTS external hostname is mastergts.training.cagrid.org and internal is cagrid-1_3-training-master-gts.cagrid.org. We specified mastergts.training.cagrid.org when creating credentials.

At this point, your should set the following environment variables. The last step of the installer provides the paths for these settings:

CAGRID_HOME which points to the location of your 'caGrid' source directory
ANT_HOME which points to the location of your apache-ant-1.7.0 directory
JAVA_HOME which points to the location of your jdk1.6.0_* directory
GLOBUS_LOCATION which points to the location of your ws-core-4.0.3 directory
CATALINA_HOME which points to the location of your apache-tomcat-5.5.27 directory

Step 3: Set the location of the Xindice DB

The Xindice DB is used to store metadata. This file can be placed anywhere on your system. Set an environment variable to speficy the location.

 $ export CATALINA_OPTS='-Dxindice.db.home=/home/<user>/tmp/xindice-db -Xmx1024m'

Step 4: Deploy Index Service

At this point we have completed configuring GTS and the Tomcat container. We are now ready to deploy Index to the non-secure Tomcat Container. This can be done as follows from a command prompt:

$ cd $CAGRID_HOME/projects/index
$ ant deployIndexTomcat

You should see a significant amount of output to the screen, if the deployment is successful you should see the words "BUILD SUCCESSFUL" printed to the screen.

Step 5: Start your container

If you chose a Tomcat container, start Tomcat as follows:

  $CATALINA_HOME/bin/startup.sh

Check the $CATALINA_HOME/logs/catalina.out file for any errors.

Step 6: Validate Installation

You can follow the steps here to validate the functionality of the Index Service:

Step 7: Configure Tomcat to Start on Reboot

Configure Tomcat to start automatically: http://tomcat.apache.org/tomcat-5.5-doc/setup.html

Step 8: Update DNS, if needed

If you have installed GTS to a new host you now need to update your DNS to point to the IP address of the new host.