Upgrade FQP

Step 0: Shutdown caGrid 1.3 FQP Service

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

Step 1: Prepare Host

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

FQP specific requirements:

Secure Container

Step 2: Prepare Configuration Files

Copy FQP configuration files to new host.

Download and extract https://wiki.cagrid.org/download/attachments/10617829/caGrid-1.4-Configs-NCI.zip.
1. Copy <target_grid>/FQP/serviceMetadata.xml to $HOME/tmp

Step 3: Install caGrid 1.4 Software and Configure a secure container

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 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.

Step 16: Select the option to create credentials with the GAARDS UI

Start GAARDS UI
```
  $ cd $CAGRID_HOME 

$ ant security
```
Click the "Login" button.
1. Enter user and password of a user with administration privileges.
Open the "Request Host Certificate" Panel via the "My Account" menu -> "Request Host Certificate".
1. Type the externally routable hostname of the new FQP service in the "Host" field.
2. The "Specify directory to Write Credentials" should be your griduser's /home/griduser/.cagrid/certificates directory. This will overwrite the previous credentials.
3. Click "Request Certificate"
4. Close the GAARDS UI

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 4: Configure FQP with prepared configuration files

Copy serviceMetadata.xml

 $ cp $USER_HOME/tmp/serviceMetadata.xml $CAGRID_HOME/projects/fqp/etc/.

Step 5: Install the Transfer Service

Install the Transfer service. The "no.deployment.validation" option allows us to skip the deployment validation steps. We can do this because Transfer does not need service metadata.

Go to the Transfer directory
```
 $ cd $CAGRID_HOME/projects/transfer 
```
Edit the Transfer deploy properties to disable service registration
1. Open 'deploy.properties' for editing
2. Change the "perform.index.service.registration" setting to false
Deploy the Transfer service.

 $ ant -Dno.deployment.validation=true deployTomcat

Step 6: Install FQP Service

 $ cd $CAGRID_HOME/projects/fqp 

$ ant deployTomcat

Step 7: Start Tomcat

Start Tomcat as follows:

  $ $CATALINA_HOME/bin/startup.sh

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

Step 8: Validate

Run a DCQL query against the service

  $ cd $CAGRID_HOME/projects/fqp

$ ant -Dservice.url=YOUR_SERVICE_URL runClient

You should see output similar to the below:

[cagrid@fqp fqp]$ ant -Dservice.url=https://fqp.training.cagrid.org:8443/wsrf/services/cagrid/FederatedQueryProcessor runClient
Buildfile: build.xml

setGlobus:

checkGlobus:
     [echo] Globus: /home/cagrid/ext/ws-core-4.0.3

defineContribTasks:

defineClasspaths:

defineExtendedClasspaths:
     [echo] Defining extended classpaths
     [echo] Defining extended classpaths
     [echo] Defining extended classpaths

runClient:
     [echo] Connecting to service: https://fqp.training.cagrid.org:8443/wsrf/services/cagrid/FederatedQueryProcessor
     [echo] Issuing query: test/resources/caBIO_Example.xml
     [java] JVM args ignored when same JVM is used.
     [java] Running the Grid Service Client
     [java] ......Got results from:http://cabiogrid40.nci.nih.gov:80/wsrf/services/cagrid/CaBIO40GridSvc
     [java] ===== RESULT [0] =====
     [java] <ns2:Gene bigid="hdl://2500.1.PMEUQUCCL5/KFGT4V4ZB2" clusterId="530940" fullName="BRCA1 associated protein" id="24851" symbol="BRAP" xmlns:ns2="gme://caCORE.caBIO/4.0/gov.nih.nci.cabio.domain"/>
     [java] ===== END RESULT=====
     [java] 
     [java] 
     [java] ===== RESULT [1] =====
     [java] <ns3:Gene bigid="hdl://2500.1.PMEUQUCCL5/QZJKL2AP7F" clusterId="153372" fullName="BRCA1 associated protein" id="133167" symbol="Brap" xmlns:ns3="gme://caCORE.caBIO/4.0/gov.nih.nci.cabio.domain"/>
     [java] ===== END RESULT=====
     [java] 
     [java] 
     [java] ===== RESULT [2] =====
     [java] <ns4:Gene bigid="hdl://2500.1.PMEUQUCCL5/6KXALDMETE" clusterId="3779" fullName="Brca1 associated protein 1" id="124104" symbol="Bap1" xmlns:ns4="gme://caCORE.caBIO/4.0/gov.nih.nci.cabio.domain"/>
     [java] ===== END RESULT=====
     [java] 
     [java] 
     [java] ===== RESULT [3] =====
     [java] <ns5:Gene bigid="hdl://2500.1.PMEUQUCCL5/2BIDJ3T3CX" clusterId="106674" fullName="BRCA1 associated protein-1 (ubiquitin carboxy-terminal hydrolase)" id="3915" symbol="BAP1" xmlns:ns5="gme://caCORE.caBIO/4.0/gov.nih.nci.cabio.domain"/>
     [java] ===== END RESULT=====
     [java] 
     [java] 
     [java] ===== RESULT [4] =====
     [java] <ns6:Gene bigid="hdl://2500.1.PMEUQUCCL5/RCL4SLIGNU" clusterId="591642" fullName="BRCA1 associated RING domain 1" id="43730" symbol="BARD1" xmlns:ns6="gme://caCORE.caBIO/4.0/gov.nih.nci.cabio.domain"/>
     [java] ===== END RESULT=====
     [java] 
     [java] 
     [java] ===== RESULT [5] =====
     [java] <ns7:Gene bigid="hdl://2500.1.PMEUQUCCL5/NI6JWFVDBW" clusterId="472810" fullName="BRCA1 associated RING domain 1" id="198056" symbol="Bard1" xmlns:ns7="gme://caCORE.caBIO/4.0/gov.nih.nci.cabio.domain"/>
     [java] ===== END RESULT=====
     [java] 
     [java] 
     [java] ===== RESULT [6] =====
     [java] <ns8:Gene bigid="hdl://2500.1.PMEUQUCCL5/WSGPC6MODL" clusterId="10764" fullName="BRCA1 associated RING domain 1" id="125023" symbol="Bard1" xmlns:ns8="gme://caCORE.caBIO/4.0/gov.nih.nci.cabio.domain"/>
     [java] ===== END RESULT=====
     [java] 
...
     [java] 
     [java] ===== RESULT [18] =====
     [java] <ns20:Gene bigid="hdl://2500.1.PMEUQUCCL5/2FQGWY45RZ" clusterId="679846" fullName="BRCA2 region, mRNA sequence GT605" id="97514" xmlns:ns20="gme://caCORE.caBIO/4.0/gov.nih.nci.cabio.domain"/>
     [java] ===== END RESULT=====
     [java] 
     [java] 

BUILD SUCCESSFUL
Total time: 25 seconds

Step 9: Configure FQP to Start Automatically

For the FQP service to be available upon reboot of your server Tomcat must be configured to start automatically.

Tomcat

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