Portal 2.0.2 QA Install


	Table of Contents Local Functional Testing Get the portal source code Install a Tomcat container and deploy Globus to it Create 6 WSRF web application contexts Install index service Install FQP Install data services Start Tomcat and verify deployment Install the Portal Test the Portal

Local Functional Testing

In order to do functional tests of the portal, you'll need to have several services installed locally:

index service
federated query processor (FQP)
four test data services (two instances of two different services)

I'm going to explain how to install all of them in a single container.

Get the portal source code

Look at the "Download the Release" section of this page: 2.0.2 Installation Guide

Install a Tomcat container and deploy Globus to it

Use the caGrid 1.2 Installer

Download the installer (http://gforge.nci.nih.gov/frs/download.php/3738/caGrid-installer-1.2.zip)
Unzip to some temp directory and go to that directory.
Type:
```
    java -jar caGrid-installer-1.2.jar
```
The installer will ask you if it should install Ant, Tomcat, Globus, and caGrid. Even if you have all of these already installed, just go ahead and install them in some temporary location. That will make the following instructions easier to follow.
Do the following:
- Accept license, Click Next.
- Select only Configure Container. Make sure other boxes are NOT checked. Click Next.
- Select a Container Type of Tomcat. Click Next.
- Specify where you want Ant installed. Click Next.
- Specify where you want Tomcat installed. Click Next.
- Specify where you want Globus installed. Click Next.
- Specify where you want caGrid installed. Click Next.
- Click the Start button. When finished downloading, click Next.
- Don't check the Yes box on the "Secure Deployment?" screen. Click Next.
- Leave Hostname as "localhost". Click Next.
- Change Shutdown Port to 8006 and HTTP Port to 8081. Click Next.
- Click the Start button. When finished deploying, click Next.
- Click Finish. Click Close.

Be sure to set your CATALINA_HOME, ANT_HOME, and GLOBUS_LOCATION environment variables to point to where you have just installed Tomcat, Ant, and Globus.

Create 6 WSRF web application contexts

Go to <tomcat_install>/webapps directory. Zip the wsrf directory:

 zip wsrf.zip -r wsrf/*

Create additional 4 copies of the wsrf directory:

 mkdir wsrf1
 cp -R wsrf/* wsrf1/
 mkdir wsrf2
 cp -R wsrf/* wsrf2/
 mkdir wsrf3
 cp -R wsrf/* wsrf3/
 mkdir wsrf4
 cp -R wsrf/* wsrf4/

Keep one copy named wsrf (i.e. don't delete the directory named wsrf; we'll need it later).

Install index service

Go to <cagrid_src>/projects/index Type:

 ant deployIndexTomcat

This will deploy it to <tomcat_install>/webapps/wsrf. Go to <tomcat_install>/webapps Rename wsrf to wsrf5. Unzip wsrf.zip to <tomcat_install>/webapps.

Install FQP

Go to <cagrid_src>/projects/fqp Type:

  ant deployTomcat

This will deploy it to <tomcat_install>/webaps/wsrf Go to <tomcat_install>/webapps Rename wsrf to wsrf6.

Install data services

Go to <portal_src>/exp/model1-svc Type:

  ant deployTomcat -Dglobus.webapp=wsrf1
  ant deployTomcat -Dglobus.webapp=wsrf3

Go to <portal_src>/exp/model2-svc Type:

  ant deployTomcat -Dglobus.webapp=wsrf2
  ant deployTomcat -Dglobus.webapp=wsrf4

Start Tomcat and verify deployment

Go to <tomcat_install>/bin Unix:

 chmod u+x *.sh
 ./startup.sh

Windows:

 startup.bat

Go to <cagrid_src>/projects/discovery Type:

 ant runClient -Dservice.url=http://localhost:8081/wsrf5/services/DefaultIndexService

You should see 5 services listed: the FQP service URL, two Model1Svc URLs, and two Model2Svc URLs.

Install the Portal

For the most part, you'll be able to follow the instructions here: Installation Guide. However, you'll need to make some modifications.

Create the databases. Create the keystore. Get the Google and Yahoo keys. Since we won't be testing any of the security-related features, you won't need to do anything with caGrid trust fabric configuration. Just modify your build-local.properties file to look something like this.

liferay.admin.password=p0rtal@dmin
liferay.db.name=lportal
liferay.db.username=dbuser
liferay.db.password=dbuser
cagrid.portal.db.url=jdbc:mysql://localhost:3306/portal2
cagrid.portal.db.username=dbuser
cagrid.portal.db.password=dbuser
cagrid.portal.geocoder.yahoo.appId=Qe7jSizV34F.2qscztSCYBhp6wBahsYBLHnqZrZ_ivRFflp9Fxhh83JuSbnT04DS1Q--
cagrid.portal.map.google.apiKey=ABQIAAAA8g3SgjzSraL7VirbuaelwhSZhAwg1T6Cj9L6Y1CRi3YIYx6IHhQlLsIR2usu8NKDKCmrdAcVRkqh8w
cagrid.portal.security.encryption.key=963-hkjjgoyu78490hkkkbluuuug09733023gljgg985678
cagrid.portal.indexServiceUrls=http://localhost:8081/wsrf5/services/DefaultIndexService
fqp.service.url=http://localhost:8081/wsrf6/services/cagrid/FederatedQueryProcessor

Then, type:

  ant install

You won't need to set the target.env property since we are using the "local" environment (which is default). This will install JBoss at $HOME/portal-liferay/jboss-4.0.5.GA, create the schemas, load the data, and deploy everything.

After that, you can follow the "Post-Installation" instructions on the wiki page.

Test the Portal

DCQL Query wizard Test Plan

Also, refer to the Use Cases