Portal 2.2 Upgrade Guide

	Table of Contents Introduction Obtaining the caGrid Portal 2.2 Software Download the Release Subversion Checkout on Windows caGrid 1.3 Release Stream Obtain Required Software Update Properties Upgrade caGrid Portal Software

Introduction

This guide explains how to upgrade an existing caGrid Portal 2.1.x installation to version 2.2

If you are running an earlier version (<2.1) of the Portal, we recommend that you re-install the latest release following the 2.2 Installation Guide.

Obtaining the caGrid Portal 2.2 Software

You can download the caGrid Portal release or check out the code from Subversion.

Download the Release

You can download caGrid Portal 2.2 release from gforge.

Subversion Checkout on Windows

The caGrid 1.3 release stream provides access to the official source code repository for caGrid 1.3. On Windows systems, we recommend the following 3rd party tool as a GUI front-end to subversion to check out a caGrid release: http://tortoisesvn.tigris.org The command line version of subversion can be obtained from http://subversion.apache.org/source-code.html

caGrid 1.3 Release Stream

caGrid 1.3 latest

 svn checkout https://ncisvn.nci.nih.gov/svn/cagrid/branches/caGrid-1_3_release/cagrid-1-0/caGrid

caGrid 1.3.0.2

 svn checkout https://ncisvn.nci.nih.gov/svn/cagrid/tags/caGrid-1_3_release_1_3_0_2/cagrid-1-0/caGrid/

caGrid 1.3.0.1

 svn checkout https://ncisvn.nci.nih.gov/svn/cagrid/tags/caGrid-1_3_release_1_3_0_1/cagrid-1-0/caGrid/

caGrid 1.3.0.0

 svn checkout https://ncisvn.nci.nih.gov/svn/cagrid/tags/caGrid-1_3_release_final/cagrid-1-0/caGrid

After checkout, the caGrid Portal source code directory (referred to henceforth as $SRC) is located at ./cagrid-portal.

Note: Portal version 2.2.1 is the latest point release of the 2.2 branch

Obtain Required Software

You must install the following software:

• Java 1.5
  • Make sure JAVA_HOME is set and Java SDK executable is on the PATH.
• Ant 1.6.5
  • Make sure that ANT_HOME is set and Ant executable is on the PATH.

Update Properties

The caGrid Portal build script uses build-local.properties and build-<target.env>.properties files for setting all its properties (Note: build-local.properties overrides all other properties). You can copy these property files from your existing portal installation or simply edit these properties for your environment.

<target.env> is the environment in which the Portal is being installed. By default, the distribution of caGrid Portal is pre-configured for the following environments:

• nci_dev
• nci_qa
• nci_prod
• training (default)

  Note- The build-local.properties has a list of properties that are NEEDED to configure the installation to the local environment (database connections settings etc.). Users are expected to fill in the appropriate values in the build-local.properties file.

  Note- The Portal does not have a build-nci_stage.properties for the nci_stage tier. For nci_stage tier, you must update the build-local.properties with relevant information for that tier and also add the following property - aggr.trust.target.grid=nci_stage

  NOTE: The default property evs.remoteAPI.url points to http://evsapi.nci.nih.gov/evsapi40. This URL is unreachable from outside the NIH network. So this might need to be changed, in build.properties or build-local.properties, to http://evsapi.nci.nih.gov/evsapi40 if you are deploying the Portal outside the NIH firewall.

Upgrade caGrid Portal Software

Do the following to upgrade caGrid Portal.

• Shut down JBOSS.
• Since this release of the caGrid Portal also updates the Liferay Portal software, you must delete your existing caGrid Portal and Liferay Portal installations from the JBOSS server. Typically you must delete the following directories:

Note: These paths may vary.

   ${JBOSS_HOME}/server/default/deploy/cagrid-minimal.war
   ${JBOSS_HOME}/server/default/deploy/cagridportlets.war
   ${JBOSS_HOME}/server/default/deploy/liferay-portal.war

* Clean the JBOSS cache, i.e delete $JBOSS_HOME/server/default/tmp and $JBOSS_HOME/server/default/work directories.

• Run ant -Dtarget.env=nci_dev liferay:install-liferay.
• Run ant -Dtarget.env=nci_dev liferay:deploy-all.
• Start up JBOSS.

Note: The concept of target environment (-Dtarget.env) is explained in the 2.1 Upgrade Guide and you may wish to use a different target environment.

Note: Wait for JBOSS server to restart and fully deploy the caGrid Portal (typically 5 minutes) before opening the Portal homepage in the browser (eg. http://localhost:8080)