Access Keys:
Skip to content (Access Key - 0)

Upgrade Slave GTS

Contents

These instructions explain how to install a Slave GTS to a new host, copy the caGrid 1.3 GTS database and credentials, and configure the new GTS.

Shut Down caGrid 1.3 Slave GTS Service

  1. Connect to your caGrid 1.3 Slave GTS server.
  2. Shut down 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.

GTS specific requirements:

  • MySQL 5.0.45 database
  • Secure Container

Create the GTS Database

  1. You or your DB administrator must create a new Slave GTS database.
    1. Connect to MySQL as root. 
       $ mysql --user=root --password=<PASSWORD>
    2. Set default engine to INNODB 
       $ SET storage_engine=INNODB;
    3. Create the GTS database. 
       $ create database <DBNAME>;
    4. Create user and grant permissions. 
       $ GRANT ALL PRIVILEGES on <DBNAME>.
      * to '<DBUSER>'@'%' IDENTIFIED BY '<PASSWORD>' WITH GRANT OPTION;
    5. Logout of MySQL. 
        $ quit

Step 2: Obtain caGrid 1.3 GTS Files

Backup the Slave GTS Database

  1. Connect to caGrid 1.3 Slave GTS host.
  2. You or your DB administrator must execute a MySQL dump to file. 
     $ mysqldump --user=<DBUSER> --password=<PASSWORD> <DBAME> > <DBNAME>.sql
  3. Verify INNODB Engine Type for Tables
    1. Run the following command and view the Engine type of GTS tables 
       $ grep -i "Engine=" <DBNAME>.sql
    2. If any table specifies an "engine" that is not INNODB, update the file to specify the required type.
    3. Save file.

Copy Database and Certificates to caGrid 1.4 Host

  1. Secure Copy GTS database from caGrid 1.3 Slave GTS. 
     $ scp <DBNAME>.sql <griduser>@<cagrid1.4-GTSSlave>:/home/griduser/tmp/<DBNAME>.sql
  2. Copy host keys and certificates from caGrid Slave GTS. 
     $ scp -r ~/.cagrid/certificates <griduser>@<cagrid1.4-GTSSlave>:/home/griduser/tmp/

Step 3: Prepare Database and Configuration Files

Copy the GTS configuration files to new host.

  1. Download and extract https://wiki.cagrid.org/download/attachments/10617829/caGrid-1.4-Configs-NCI.zip.
    1. Copy gts-conf.xml to $HOME/tmp/gts-conf.xml.
    2. Copy serviceMetadata.xml to $HOME/tmp/serviceMetadata.xml.
    3. Copy sync-description.xml to $HOME/tmp/sync-description.xml.

Load GTS Database

  1. You or your DB administrator must load the Slave GTS dump to the new database. 
     $ mysql --user=<DBUSER> --password=<PASSWORD> <DBNAME> < $HOME/tmp/<DBNAME>.sql

Step 4: Install caGrid 1.4 Software

At Step 11 of the caGrid install 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

Use the installer to install caGrid using these instructions: Install caGrid Using the caGrid 1.4 Installer

Your user should have the following environment variables set. The last step of the installer provides the paths for these settings:
  1. CAGRID_HOME, which points to the location of your 'caGrid' source directory
  2. ANT_HOME, which points to the location of your apache-ant-1.7.0 directory
  3. JAVA_HOME, which points to the location of your jdk1.6.0_* directory
  4. GLOBUS_LOCATION, which points to the location of your ws-core-4.0.3 directory

Step 5: Configure the Container

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

Step 6: Select the option to browse to credentials on the host. Use the /home/griduser/tmp/certificates location.

Use the installer to create a secure Tomcat container using the following instructions.

Configure Containers Using the caGrid 1.4 Installer

Your user should now have the following environment variables set. The last step of the installer provides the paths for these settings.
  1. CATALINA_HOME which points to the location of your apache-tomcat-5.5.27 directory

Step 6: Configure GTS

  1. Copy the edited gts-conf.xml to the GTS project. 
      $ cp $HOME/tmp/gts-conf.xml $CAGRID_HOME/projects/gts/etc/
  2. Copy GTS serviceMetadata.xml to the GTS project. 
      $ cp $HOME/tmp/serviceMetadata.xml $CAGRID_HOME/projects/gts/etc/
  3. Copy the SyncGTS configuration. 
     $ cp $HOME/tmp/sync-description.xml $CATALINA_HOME/webapps/wsrf/WEB-INF/etc/cagrid_SyncGTS/

Step 7: Deploy GTS

We have completed configuring GTS and the Tomcat container. We are now ready to deploy GTS to the Secure Tomcat Container. This can be done as follows from a command prompt. 

 $ cd $CAGRID_HOME/projects/gts $ ant deployTomcat
You should see a significant amount of output to the screen. If the deployment is successful, you should see the words "BUILD SUCCESSFUL" on the screen.

Step 8: Start the Container

  1. 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.
  2. If you chose a JBoss container, start JBoss as follows:
    1. Windows: 
       $JBOSS_HOME\run.bat
    2. Unix/Mac: 
       $JBOSS_HOME/run.sh
Check the $CATALINA_HOME/logs/catalina.out file for any errors.

Step 9: Validate Installation

Verify that you can hit the Service URL.

  • Open a browser to: https://<IP>:8443/wsrf/services/cagrid/GTS
    You should see "Hi there, this is an AXIS service!"

Test using GAARDS UI

Step 10: Configure Mysql and Tomcat to Start Automatically

For the GTS service to be available upon reboot of your server, both MySQL and Tomcat must be configured to start automatically.

MySQL

  1. You or your DB administrator should configure MySQL to start automatically: http://dev.mysql.com/doc/refman/5.0/en/automatic-start.html

Tomcat

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

Step 11: 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.
Last edited by
William Stephens (633 days ago) , ...
Adaptavist Theme Builder Powered by Atlassian Confluence