Chapter 13. Deploying OGSA-DAI - additional options

13.1. Deploying OGSA-DAI GT - additional options
13.1.1. Build an OGSA-DAI GT GAR file
13.1.2. Deploy an OGSA-DAI GT GAR file onto Globus Toolkit container
13.1.3. Deploy an OGSA-DAI GT GAR file onto Tomcat
13.1.4. Build an OGSA-DAI GT GAR file and deploy onto Globus Toolkit container
13.1.5. Build an OGSA-DAI GT GAR file and deploy onto Tomcat
13.1.6. Summary of OGSA-DAI GT deployment and usage approaches
13.1.7. Useful information

This documents the complete range of options available when deploying OGSA-DAI.

13.1. Deploying OGSA-DAI GT - additional options

13.1.1. Build an OGSA-DAI GT GAR file

To build a GAR file run:

$ ant buildGAR -Dgt.dir=/PATH/TO/GT \
  [-Ddai.gar=LOCATION-OF-BUILT-GAR] \ Default: build/dai.gar
  [-Ddai.host=HOST]                 \ Default: localhost
  [-Ddai.port=PORT]                 \ Default: 8080
  [-Ddai.webapp=WEBAPP]             \ Default: wsrf
  [-Ddai.dres.service.name=DRES-SERVICE] \ Default: DataRequestExecutionService
  [-Ddai.dris.service.name=DRIS-SERVICE] \ Default: DataResourceInformationService
  [-Ddai.dsos.service.name=DSOS-SERVICE-NAME] \ Default: DataSourceService
  [-Ddai.dsis.service.name=DSIS-SERVICE-NAME] \ Default: DataSinkService
  [-Ddai.sms.service.name-SMS-SERVICE-NAME]   \ Default: SessionManagementService
  [-Ddai.rms.service.name=RMS-SERVICE-NAME]     Default: RequestManagementService
  • When building a GAR file the host name, port and webapp given as arguments must match the host name, port and webapp as used by the target Globus Toolkit container upon which the GAR file will be deployed.
  • Choosing a service name SERVICE-NAME results, after deployment, in a service with URL:
    http://HOST:PORT/WEBAPP/services/SERVICE-NAME
    

13.1.2. Deploy an OGSA-DAI GT GAR file onto Globus Toolkit container

To deploy an OGSA-DAI GT GAR file onto the Globus Toolkit container

$ ant deployGAR -Dgt.dir=/PATH/TO/GT \
  [-Ddai.gar=LOCATION-OF-BUILT-GAR]  \ Default: build/dai.gar
  [-Ddai.host=HOST]                  \ Default: localhost
  [-Ddai.port=PORT]                  \ Default: 8080
  [-Ddai.webapp=WEBAPP]                Default: wsrf

The GAR file will be deployed into Globus Toolkit container. The GAR file prefix (e.g. dai determines the name of the directory where deployment descriptors and other configuration files go in the Globus Toolkit etc directory.

13.1.3. Deploy an OGSA-DAI GT GAR file onto Tomcat

To deploy an OGSA-DAI GT GAR file onto Tomcat

$ ant deployGARTomcat -Dgt.dir=/PATH/TO/GT -Dtomcat.dir=/PATH/TO/TOMCAT \
  [-Ddai.gar=LOCATION-OF-BUILT-GAR] \ Default: build/dai.gar
  [-Ddai.host=HOST]                 \ Default: localhost
  [-Ddai.port=PORT]                 \ Default: 8080
  [-Ddai.webapp=WEBAPP]               Default: wsrf

The GAR file will be deployed into Tomcat. The GAR file prefix (e.g. dai determines the name of the directory where deployment descriptors and other configuration files go in the Globus Toolkit webapp's etc directory.

[Note]Note
This mode of deployment is not supported by GT. This is our own version. GT recommend deployment into a GT container (e.g. using deployGAR) and then deploying the GT container as a whole into Tomcat using the Globus Toolkit using deployTomcat command.

13.1.4. Build an OGSA-DAI GT GAR file and deploy onto Globus Toolkit container

To build a GAR file and then deploy the GAR file onto the Globus Toolkit container

$ ant buildAndDeployGAR

This command just invokes the buildGAR and deployGAR commands so the command-line options are as for these two commands.

13.1.5. Build an OGSA-DAI GT GAR file and deploy onto Tomcat

To build a GAR file and then deploy the GAR file into Tomcat

$ ant buildAndDeployGARTomcat

This command just invokes the buildGARTomcat and deployGARTomcat commands so the command-line options are as for these two commands.

13.1.6. Summary of OGSA-DAI GT deployment and usage approaches

To summarize, there are three possible deployment and usage approaches:

  1. Use Globus Toolkit - deploy a GAR file onto Globus Toolkit container then startup the container.
  2. Use Globus Toolkit and Tomcat - deploy a GAR file onto Globus Toolkit container, deploy Globus Toolkit container onto Tomcat then startup Tomcat.
  3. Use Globus Toolkit and Tomcat - deploy Globus Toolkit container onto Tomcat, deploy a GAR file onto Tomcat then startup Tomcat.

13.1.7. Useful information

The Globus Toolkit deployGAR command can be run as follows (assuming that an environment variable GLOBUS_LOCATION points to the Globus Toolkit distribution).

$ ant -f /PATH/TO/GT/share/globus_wsrf_common/build-packages.xml \
  deployGar -Dgar.name=GAR-NAME.gar

For example:

$ ant -f /PATH/TO/GT/share/globus_wsrf_common/build-packages.xml \
  deployGar -Dgar.name=dai.gar

Useful links: