PAG Server Installation Instructions

System Requirements

To be able to the Portal Access Grid Portlet the following software packages are necessary:

Java JRE-1.5+

the Java environment ... recommended is the Sun Java Runtime environment from http://www.java.com

Apache Tomcat

the Java Servlet and Java Server Pages engine ...the version to choose is dependent on the Portal environment ...at the time of writing the recommended version is the latest version of the Tomcat 5.5 series

Portal environment

a JSR 168 complient portal environment to host the portlet ...recommended portal evnironments:

gridsphere

the development team has successfully run the portlet using gridsphere 3.0.8 and gridphere 3.1

uPortal

the portlet was successfully tested on uPortal 2.5.x

Pluto

the portlet was successfully tested on uPortal 1.1.7

System Installation

Java

Please follow the installation instructions provided by the Java Vendor.

Unfortunately there seems to be a problem in Java's IP6 networking stack to work with PAG. To avoid issues with the bridge-testing please enable the IPv4-networking stack. In order to do this pass the following options to the JVM when you start your tomcat:

     -Djava.net.preferIPv4Stack=true

Apache Tomcat

Please follow the tomcat installation instructions. Once the installation is complete you need to make sure that tomcat allows an empty session path. To do this edit the connector section of the server.xml file in the conf/ directory adding

     emptySessionPath="true"  

In tomcat5.5 the section should read:

     <Connector port="8080" maxHttpHeaderSize="8192"
                maxThreads="150" minSpareThreads="25"
                maxSpareThreads="75" enableLookups="false" 
                redirectPort="8443" acceptCount="100">
                connectionTimeout="20000"
                disableUploadTimeout="true"
                emptySessionPath="true"/>

Portal Environment

Please follow the installation instructions provided by the Portal Vendor.

Installing the PAG Portlet

Installation into tomcat

Extract the pag_1-3.tar.gz file into the webapps directory of your tomcat installation. On a Linux system :

      tar xfvz pag_1-3.tar.gz

Restart your tomcat server to recognize the new web-application.

Installation into the Portal environment

Please follow the installation instructions for integrating a portlet into the portal environment.