Installing and Uninstalling OGSA-DAI WSI 2.2

This OGSA-DAI distribution provides a WSI-based service interface, using Apache Axis.

Contents

• Versions
• Prerequisites
  • Prerequisite Software
  • Data Resource Drivers
• Build the Binary Distribution
• Install OGSA-DAI WSI
• Uninstall OGSA-DAI WSI

Versions

OGSA-DAI WSI comes in two versions:

• Those bundled with Axis 1.2.1. These distributions are named:
  • ogsadai-wsi-2.2-src.tar.gz
  • ogsadai-wsi-2.2-src.zip
  • ogsadai-wsi-2.2-bin.tar.gz
  These versions are suitable for use with Axis 1.2.1 on Tomcat. They are not suitable for use with the OMII middleware.
• Those bundled with Axis 1.2RC3. These distributions are named:
  • ogsadai-omii-2.2-src.tar.gz
  • ogsadai-omii-2.2-src.zip
  • ogsadai-omii-2.2-bin.tar.gz
  These versions are suitable for use with Axis 1.2RC3 on Tomcat. They are also suitable for use with the OMII middleware.

Prerequisites

The installation and use of the OGSA-DAI WSI distribution will be easier if you are already familiar with:

• OGSA-DAI concepts and terms.

Prerequisite Software

To use OGSA-DAI WSI you will need the following software:

• Java 1.4.x and above
  • OGSA-DAI WSI has been tested on various versions of Java 1.4 and also Java 1.5.
• Apache ANT 1.5 or 1.6.
  • See http://ant.apache.org.
• Apache Axis and Jakarta Tomcat:
  • Apache Axis - http://ws.apache.org/axis/. OGSA-DAI WSI has been tested with Apache Axis 1.2.1 and Apache Axis 1.2 RC3. It is not compatible with Apache Axis 1.3.
  • Jakarta Tomcat - http://jakarta.apache.org/tomcat/. OGSA-DAI WSI has been tested with Tomcat 5.0.28.
  • You can test your Axis/Tomcat installation by visiting the URL http://localhost:8080/axis/happyaxis.jsp when your container is running (ensure that the correct port number for your installation is used). If there are any problems then you will be notified. Please refer to the Axis or Tomcat documentation for more information.
  • Please ensure that you have installed Axis/Tomcat and that it is working properly before proceeding to install OGSA-DAI.
• A database management system (DBMS)
  • One of the OGSA-DAI supported data resources as described on the Supported Data Resources page.

We strongly recommend that Windows users re-locate Java, ANT, Tomcat and OMII (if applicable) to directories which have no spaces in their paths. For example:

C:\Tomcat
C:\jdk1.4.1
C:\ant

OMII Compatibility

OMII-compliant versions of OGSA-DAI WSI - see versions at the top of the page - are compatible with OMII 2.3.3.

To get OMII 2.3.3 go to http://www.omii.ac.uk.

Data Resource Drivers

The Supported Data Resources page lists the data resource-specific JARs that may be be required depending on the databases you wish to expose and additional functionality required. These database drivers have all been tested with OGSA-DAI.

Build the Binary Distribution

If you have downloaded the binary distribution then skip to Installing OGSA-DAI WSI below.

If you have the OGSA-DAI source distribution you will need to generate a binary release. You can do this as follows:

1. Run the following target to build the OGSA-DAI binary distribution:

   $ ant createBinaryDistribution
   

   Progress messages will appear and if there are any problems then you will be notified. You may also see warning messages such as:

   [axis-wsdl2java] - Unable to find required classes... Attachment support is disabled.
   

   These can safely be ignored because they are of no consequence to OGSA-DAI. The Axis documentation contains further details.
2. When complete, you will have a zipped and tarred binary distribution within your OGSA-DAI source distribution directory. You will also have a binary directory containing the binary release.
3. You should now change into the binary directory:

   $ cd binary
   

Install OGSA-DAI WSI

The OGSA-DAI WSI binary distribution can be installed onto your Web services container using either of the following:

• the command-line installer
• the GUI installer

Expose Data Resources using OGSA-DAI WSI

To expose a data resource via an OGSA-DAI WSI data service is a three-step process:

1. Deploy an OGSA-DAI data service. This data service initially exposes 0 data service resources.
2. Deploy a data service resource. The data service resource contains information about a data resource and the activities clients can perform.
3. Request that the data service expose the data service resource. This instructs the data service to expose the data service resource and so allows clients to interact with the data service resource - thereby interacting with a data resource.

More details are provided on the deployment pages.

For those who want a quick practical introduction to OGSA-DAI WSI, we recommend:

1. Startup your Web services container.
2. Deploy a new data service.
3. Test the data service resource using the ListResources client and ensuring that the service is available and exposes 0 data service resources.
4. Deploy a new data service resource.
5. Request that the data service expose the data service resource.
6. Restart your Web services container so that the changes take effect.
7. Submit a perform document to the data service resource exposed by your data service using is described the End-to-end client.

Uninstall OGSA-DAI WSI

Uninstallation erases all OGSA-DAI XML Schema, OGSA-DAI-specific JAR files and configuration files from a Web services container.

The OGSA-DAI WSI binary distribution can be uninstalled from your Web services container using either of the following:

• the command-line uninstaller
• the GUI uninstaller

Before attempting to uninstall the OGSA-DAI WSI binary distribution, ensure that none of the deployment files or directories are open. These files are described on the Where does stuff go? page. If any of these are open, the uninstallation tools may be unable to delete them and an error will be displayed.