Installation

This guide illustrates the installation procedure for the GridPort Demo Portal.

Required Software Prerequisites

The following software packages are prerequisites to using the GridPort Demo Portal:

  • Java 1.4.2_xx. Please download and install the latest version of the Java 1.4.2 SDK.
  • Ant 1.6.x. Please download and install the latest version of Apache Ant.
  • Maven 1.0.2. Please download and install Maven version 1.0.2.

    Note: The GridPort Demo Portal has not been tested with more recent versions of Maven.
  • Tomcat 5.0.xx or 5.5.x. Please download and install the latest version of Tomcat 5.0.xx or 5.5.x.

    Note: If you are using Tomcat 5.5.x, you will need to also download and install the compatability patch (labeled jakarta-tomcat-5.5.x-compat) to allow Tomcat 5.5.x to work with Java 1.4.2_xx. Additionally, you will also need to add the ant.jar and ant-launcher.jar jar files from a Tomcat 5.0.xx distribution to your Tomcat's common/lib directory. For convenience, these jars can be obtained here.
  • GridSphere 2.0.2. Please download and unpack GridSphere 2.0.2.

    Note: You only need to unpack the GridSphere distribution; the build will install GridSphere into Tomcat. The GridPort Demo Portal has not been tested with more recent versions of GridSphere.

We recommend setting up a dedicated system account to run the portal software. To install the portal, you will need write permissions in your Tomcat, GridSphere, and GridPort Demo Portal directories. Thus, you should install these as your dedicated portal user. The other required software may be installed as any user.

Environment

In order to use the software required to support the GridPort Demo Portal, you must first set up your environment. You will need to set the JAVA_HOME, ANT_HOME, and MAVEN_HOME environment variables and ensure that the respective binaries are in your PATH. Additionally, you will need to set the CATALINA_HOME and GRIDSPHERE_HOME environment variables appropriately. The following is an example environment script. 


### for sh-based shells

### DEV SOFTWARE
export JAVA_HOME=/opt/java/j2sdk1.4.2_07;
export ANT_HOME=/opt/ant/apache-ant-1.6.2;
export MAVEN_HOME=/opt/maven/maven-1.0.2;
export PATH=${JAVA_HOME}/bin:${ANT_HOME}/bin:${MAVEN_HOME}/bin:${PATH};

### PORTAL ENVIRONMENT
export CATALINA_HOME=/opt/tomcat/jakarta-tomcat-5.5.7;
export GRIDSPHERE_HOME=/opt/gridsphere/gridsphere-2.0.2;

Installation

After installing the prerequisite software and setting up your environment, please download the GridPort Demo Portal and unpack the distribution. To install the portal, from within the unpacked demo portal distribution directory, use Maven to attain the install goal of the Maven GridPort Plugin and (re)start Tomcat. 


    maven gp:install

You can now point your browser to http://localhost:8080/gridsphere to view the portal. You will be presented with the Grid Information Browser portlet and a Login portlet. Login to the portal as the root user with no passphrase. Upon logging in to the portal, various grid-enabled portlets will be available.

You may now customize the Demo Portal to tailor it to your grid environment. In order for your modifications to take effect, you will need to re-deploy the portal (or the particular component you modified). To do this, simply attain the deploy goal of the Maven GridPort Plugin. 


    maven gp:deploy
Please refer to the Maven GridPort Plugin documentation for more deployment options.

Restarting Tomcat

To startup Tomcat up using the following command: 


    localhost> $CATALINA_HOME/bin/startup.sh
To shutdown Tomcat up using the following command: 

    localhost> $CATALINA_HOME/bin/startup.sh
To restart Tomcat combine the previous commands: 

    localhost> $CATALINA_HOME/bin/shutdown.sh; $CATALINA_HOME/bin/startup.sh