Administration
Portal 2.1 Upgrade Guide
 | Note: This guide explains how to upgrade an existing caGrid Portal 2.0.2 installation to version 2.1
If you are running the 2.0.1 version of Portal (which is the version that the caGrid 1.2 installer would have installed). We recommend that you re-install following the 2.1 Installation Guide and then follow the rest of this guide to upgrade to the 2.1 version. |
Obtaining the caGrid Portal 2.1 Software
You can download the caGrid Portal release or check out the code directly from Subversion.
Download the Release
The caGrid Portal 2.1 release can be downloaded from gforge
.
Check-out caGrid Portal from Subversion
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
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
After checkout, the caGrid Portal source code directory (referred to henceforth as $SRC) will be located under ./cagrid-portal.
Obtain Required Software
The following software must be installed:
- 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-Portal does not have a build-nci_stage.properties for the nci_stage tier. For nci_stage tier, you will need to update the build-local.properties with relevant information for that tier and also add the following property -
aggr.trust.target.grid=nci_stage
Upgrade caGrid Portal Software
The following steps will upgrade the existing installation of caGrid Portal to 2.1
- Run 'ant -Dtarget.env=nci_dev update_from_2_0_2_to_2_1'
Deploy caGrid Portal
The following will deploy the latest caGrid Portal into JBOSS. Make sure you have configured your environment as explained above
- Shutdown JBOSS
- Run 'ant -Dtarget.env=nci_dev liferay:deploy-all'
- Startup JBOSS
Note: The concept of target environment (-Dtarget.env) is explained earlier
Update caBIG Participant information
caGrid Portal 2.1 has updated the list of caBIG participants, that are loaded into the database when the portal is first installed. Follow the instructions here to upload the new participant information.
Upgrade Portal Site Structure
We have an updated UI layout in caGrid Portal 2.1 You can follow these instructions on how to import the Site Structure into the Liferay Portal Server.
The only difference would be the source of the layout files (lars). You should use the layouts from the 2.1 distribution. These layout files are located in cagrid-portal/portals/liferay/lars/