Installing GPE Portal Client

Alexander Lukichev, Intel Corporation

Version 1.0 November 16, 2007

Version history

1 Obtaining GPE Portal Client

Before installing GPE Portal Client you have to obtain its package. One possible option is to build it from the sources.

1. Checkout the sources from SVN GPE4GTK repository:

   $ svn co https://gpe4gtk.svn.sf.net/svnroot/gpe4gtk/gpe4gtk/branches/1.5.0

   
   
2. Prepare for building the packages:

$ cd 1.5.0/shared/build; mvn install



3. Build the shared code:

$ cd 1.5.0/shared; mvn install



4. Build the gpe4gtk code:

$ cd 1.5.0/gtk4; mvn install

The portal client WAR can now be found in 1.5.0/gtk4/clients/portlet/target.

2 Obtaining the portlet container

Obtain a portlet container. One possible option is to download Apache Pluto bundled with Tomcat. After the portlet container is downloaded, unpack it. Don't forget to set the appropriate CATALINA_HOME environment variable.

3 Installing portlet web application

3.1 Unpacking portlet

Unpack the portlet bundle to the corresponding webapp location. For example for Pluto container this may look like:

$ cd $CATALINA_HOME/webapps
$ mkdir gpeportalclient && cd gpeportalclient
$ jar xvf gpe4gtk-portlet-client-1.5.2.war

3.2 Deploying portlet

The portlet container must be configured to include the installed portlet. Refer the portlet container manual for the deployment procedure.

Deploying to a Pluto container includes:

• unpacking the portlet;
• editing $CATALINA_HOME/webapps/pluto/WEB-INF/pluto-portal-driver-config.xml

3.3 Configuring the GPE Portal Client

Additional configuration steps must be performed before running the client:

• Editing VOCS URL

  The VO Credential Service (VOCS) is used for issuing proxy certificates to the registered users. The users provide their Grid login and password during GPE Portal Client login stage (don't miss with the container login stage that may be performed before!). The VOCS URL is defined at gpeportalclient/WEB-INF/potrlet.xml with the parameter VOCS_URL.

  
  
• Providing trusted CA list

  The list of trusted CA certificates is used for establishing secure connections to the grid services. You should place the trusted CA certificates in POM format to the gpeportalclient/WEB-INF/trusted directory.

4 Running the GPE Portlet Client

Run the portlet container. E.g. for Pluto container:

$ $CATALINA_HOME/bin/startup.sh