Prev Part III. OGSA-DAI for deployers Next

Appendix M. Appendix - Enhanced OGSA-DAI deployment options

M.1. Deploying OGSA-DAI GT - additional options
M.1.1. Build an OGSA-DAI GT GAR file
M.1.2. Deploy an OGSA-DAI GT GAR file onto Globus Toolkit container
M.1.3. Deploy an OGSA-DAI GT GAR file onto Tomcat
M.1.4. Build an OGSA-DAI GT GAR file and deploy onto Globus Toolkit container
M.1.5. Build an OGSA-DAI GT GAR file and deploy onto Tomcat
M.1.6. Summary of OGSA-DAI GT deployment and usage approaches
M.1.7. Deploy an OGSA-DAI GT GAR file onto Globus Toolkit container using Globus Toolkit
M.1.8. Useful information

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

M.1. Deploying OGSA-DAI GT - additional options

M.1.1. Build an OGSA-DAI GT GAR file

To build a GAR file run: 

$ ant buildGAR -Dgt.dir=$GLOBUS_LOCATION      \
  [-Ddai.gar=GAR-LOCATION]                    \
  [-Ddai.host=HOST]                           \
  [-Ddai.port=PORT]                           \
  [-Ddai.webapp=WEBAPP]                       \
  [-Ddai.dres.service.name=DRES-SERVICE]      \
  [-Ddai.dris.service.name=DRIS-SERVICE]      \   
  [-Ddai.dsos.service.name=DSOS-SERVICE-NAME] \
  [-Ddai.dsis.service.name=DSIS-SERVICE-NAME] \
  [-Ddai.sms.service.name-SMS-SERVICE-NAME]   \
  [-Ddai.rms.service.name=RMS-SERVICE-NAME]

where:

  • GAR-LOCATION - destination file for GAR file. Default build/dai.gar.
  • HOST - host on which server is running. This must not be localhost since the host name is inserted into the OGSA-DAI server configuration and is used in the construction of web service endpoint references.
  • PORT - port number on server accepts requests. Default 8080.
  • WEBAPP - name of OGSA-DAI webapp. Default wsrf.
  • DRES-SERVICE - data request execution service name. Default DataRequestExecutionService.
  • DRIS-SERVICE - data resource information service name. Default DataResourceInformationService.
  • DSOS-SERVICE - data source service name. Default DataSourceService.
  • DSIS-SERVICE - data sink service name. Default DataSinkService.
  • SMS-SERVICE - session management service name. Default SessionManagementService.
  • RMS-SERVICE - request management service name. Default RequestManagementService.

Choosing a service name SERVICE-NAME results, after deployment, in a service with URL: 

http://HOST:PORT/WEBAPP/services/GAR-NANE/SERVICE-NAME

where GAR-NAME is the prefix of the GAR file name e.g. dai.

M.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=$GLOBUS_LOCATION \
  [-Ddai.gar=GAR-LOCATION]                \
  [-Ddai.host=HOST]                       \
  [-Ddai.port=PORT]                       \
  [-Ddai.webapp=WEBAPP]

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.

M.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=$GLOBUS_LOCATION \
  -Dtomcat.dir=$CATALINA_HOME                   \ 
  [-Ddai.gar=LOCATION-OF-BUILT-GAR]             \ 
  [-Ddai.host=HOST]                             \ 
  [-Ddai.port=PORT]                             \ 
  [-Ddai.webapp=WEBAPP]
[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.

M.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.

M.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.

M.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.

M.1.7. Deploy an OGSA-DAI GT GAR file onto Globus Toolkit container using Globus Toolkit

The Globus Toolkit deployGAR command can be run as follows: 

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

For example: 

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

M.1.8. Useful information

Useful links:

Prev Up Next
Appendix L. Appendix - Persistence and update policies Home Appendix N. Appendix - Troubleshooting, hints and tips for deployers