4.2. Deploying in JBoss

Introduction

These instructions are applicable on both Linux and Windows and have been tested on JBoss Application Server 4.0.2 and later.

Procedure

There are two restrictions on deploying a GRIA service in JBoss:

1. JBoss must be installed in a directory that has no spaces in its path (for instance, not in C:\Program Files).
2. The GRIA war file must be deployed statically.

To describe how to deploy a GRIA service statically, we will take the example of the GRIA OGSA-DAI service being deployed in the default JBoss server.

GRIA services are supplied as war files. These are actually just zip archives. The service must be unzipped by hand but the directory that results must be renamed to end with the .war file extension:

1. Stop JBoss
2. Take the GRIA package, e.g. gria-ogsadai-service.war and place it in server/default/deploy.
3. Change the file extension from "war" to "zip" and unzip the package.
4. Rename the new directory from e.g. gria-ogsadai-service to gria-ogsadai-service.war.
5. Remove the zip file.
6. Start JBoss

Once the service has been deployed, navigate to the GRIA Service in your web browser (e.g. http://localhost:8080/gria-ogsadai-service). The GRIA installation wizard will then guide you through the rest of the configuration process.

Next: Service Administration Previous: Deploying in Tomcat