{toc:outline=true|exclude=Portal 2.0 Installation Guide|style=none}
{cagridroundpanel}

h1. Pre-Installation

h3. Download the Release

The caGrid Portal 2.0 release can be downloaded [here|https://gforge.nci.nih.gov/frs/download.php/3672/cagrid-portal-2.0.1.zip].

h3. Check-out caGrid Portal from CVS

You can use the following settings to check out the source code:
* username: anonymous
* password: anonymous
* protocol: ssh
* host: cbiocvs2.nci.nih.gov
* repository: /share/content/gforge/cagrid-1-0
* module: cagrid-1-0/Applications/cagrid-portal
* tag: cagrid-portal-2-0-1_release_final

If you are using a commandline CVS client, you could use this command:
{code}
export CVS_RSH=ssh
cvs -d :ext:anonymous@cbiocvs2.nci.nih.gov:/share/content/gforge/cagrid-1-0 co \
-r cagrid-portal-2-0-1_release_final \
-d cagrid-portal cagrid-1-0/Applications/cagrid-portal

** 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.
* MySQL 5\+
** You will need privileges to create and delete databases.

create database portal2;
{code}

You will also need to provision an account that has access to these databases. If the same account will have full access to both database, you can uses the following SQL:
{code}
grant all privileges on lportal.* to 'portalacct'@'%' identified by 'mypwd';
grant all privileges on portal2.* to 'portalacct'@'%' identified by 'mypwd';
flush privileges;
{code}

This gives the user 'portalacct' all privileges on these databases and this user can access the databases from any host. See the MySQL admin documentation for details:[http://dev.mysql.com/doc/refman/5.0/en/index.html|http://dev.mysql.com/doc/refman/5.0/en/index.html]

The basic process of creating a keystore using Java's keytool is as follows:

{code}
$JAVA_HOME/bin/keytool -genkey -alias tomcat -keyalg RSA -keystore /path/to/my/keystore
{code}

Make sure to use the same password for keystore and key. When prompted for first and last name, specify the host name.

If you are using one of the following grids:
* nci_dev
* nci_stage
* osu_dev
* training

# Configure caGrid Portal to use your sync-description.xml configuration.

To configure the portal to uses your sync-description.xml and certificates, you need to edit the 'aggr.trust.syncgts.file' and 'aggr.trust.certs.dir' properties to the path to your sync-description.xm file and the directory in which the root certificates are found, respectively.

Directions for configuring a trust fabric using caGrid tools are [here|gts12:Syncing With the Trust Fabric].

* liferay.db.port
* liferay.db.name
* liferay.db.username
* liferay.db.password
* cagrid.portal.admin.email
* cagrid.portal.db.url
* cagrid.portal.db.username
* cagrid.portal.db.password
* cagrid.portal.geocoder.yahoo.appId
* cagrid.portal.map.google.apiKey
* cagrid.portal.security.encryption.key

ant -Dtarget.env=<envname> install
{code}

If you have just updated build.properties or build-local.properties directly, then the command would be:
{code}
ant install
{code}

%HOMEDRIVE%%HOMEPATH%\portal-liferay\jboss-4.0.5.GA
{code}

On Unix/Linux/Mac, the default location will be $HOME/portal-liferay/jboss-4.0.5.GA. You can set the environment variable in the bash shell as follows:
{code}
export JBOSS_HOME=$HOME/portal/liferay/jboss-4.0.5.GA
{code}

On Unix/Linux/Mac, you should do something like this:
{code}
cd $JBOSS_HOME/bin
chmod u+x *
./run.sh > portal.log &
{code}

h3. Login as Admin

* See the [admin guide|Administrator's Guide#Login as Portal Administrator] to login into the Portal as the administrator.

h3. Setup the Administrator community Layout

This step can only be done once. If you have already setup the administrators community previously, you should skip ahead to the next section
* From upper right-hand corner, click "Welcome" drop-down list, then select MyPlaces > My Community. Then click on the icon to the right of the "Private Pages" text.
* Click on the "Import/Export" tab.
* Click on the "Import" sub tab.

*Note* If you don't see the Import sub tab, that would mean you have already setup this community.
* Select the "Portlet Preferences" and "Portlet Data" checkboxes.
* Press the "Browse..." button to navigate to and select "portaladmin-private-community.lar"
* Click "OK"
* Click "Import" button.
* Click the back arrow icon in upper, right-hand corner.n

h3. Setup the Guest community Layout

* In upper right-hand corner, click "Welcome" drop-down list, then select My Places > My Community > Private Pages. This time, just click on the "Private Pages" text, NOT the icon to the right.
* In Communities portlet, click "Communities I have joined" tab.
* Click the "Configure Pages" icon for the "Guest" community. That's the 3rd icon from the left. It looks two pieces of paper.
* Click on the "Import/Export" tab.
* Click on the "Import" sub tab.
* Select the "Portlet Preferences" and "Portlet Data" checkboxes.
* Press the "Browse..." button to navigate to and select "guest-community.lar"
* Click "OK"
* Click "Import" button.
* Click back arrow icon in upper, right-hand corner of page.
* In upper, right-hand cornder, click "Welcome" drop-down list, then selected My Places > Guest Community > Public Pages.

You should see the caGrid Portal Home page. Sign out by selecting the "Sign Out" option from the "Welcome" drop-down list.

*Note:* If you see an error message on the Home page saying that "you don't have privileges to view this portlet", right below the Google Map, just restart JBoss.

# Drop the portal2 and lportal databases.
# Re-create databases.
# From $SRC, run:
{code}
ant -Dtarget.env=<env> clean install
{code}

export ANT_OPTS="-Dhttp.proxyHost=proxy -Dhttp.proxyPort=8080"
{code}

Further instructions are here: [http://ant.apache.org/manual/proxy.html|http://ant.apache.org/manual/proxy.html]

IF YOU HAVE NO INTERNET ACCESS, you can still use the installation script. You will just need to download the dependencies manually and then edit/provide the following properties in build.properties so that they point to local directories/files:

{code}
- liferay.jboss.home
- liferay.jboss.zip
- liferay.downloads.dir
- liferay.dependencies.zip
- liferay.war
{code}

See build-liferay.xml for details.