Installation

This document describes the standard installation. Please see the reference guide for possible variations.

Prerequisites

Web container (Jakarta-Tomcat)

You must install Jakarta-Tomcat: this is the only supported container for the web-application. AstroGrid recommends Tomcat v5.0.28. V5.5.x is not suitable.

Tomcat roles

You will need to use Tomcat's administration features to configure the web-application. You should configure Tomcat with a local user-name that has the admin and manager roles.

Naming the web-application context

You must choose a name for the "context" in which the web-application runs. This name will become part of the URLs for your HTTP-CEC web-service and the web pages of your HTTP-CEC web-application. E.g., if you name the web-application context "HTTP-CEC-1", the URLs will be of the form

http://your.server.address:8080/HTTP-CEC-1/
http://your.server.address:8080/HTTP-CEC-1/services/CommonExecutionConnectorService 
respectively.

Related components

FileStore

Your HTTP-CEC works with AstroGrid's FileManager component to read and write files in VOSpace. The details of which stores to use are set by the clients of the web-application in requests to the CEC web-service. You do not need to supply your own FileManager to operate the HTTP-CEC web-application.

Registry

Your web application uses an IVOA resource-registry to publicize its capabilities. You must have access to a registry in which you can publish your resources and a registry from which your HTTP-CEC web-application can search for its registration at run-time.

The publishing registry and the searchable registry may be the same service. In this case, you will typically use an external registry. As an alternative, you may choose to run a local publishing registry. This makes it easier to publish and maintain groups of services on your site and also helps you establish a "brand" for your services by associating them with your own publishing authority. If you want to run a publishing registry, then you should install and set up the AstroGrid registry component before setting up your HTTP-CEC.

Installation procedure

  1. Obtain a copy of the WAR file for the HTTP-CEC from the AstroGrid software site. See the guide to downloading for details.
  2. Rename the WAR file to match the chosen name of the web-application context; e.g. HTTP-CEC-1.war if the context is HTTP-CEC-1 as in the example above.
  3. Copy your renamed WAR file into the webapps sub-directory of your Tomcat installation. Wait a few seconds. Tomcat notices the WAR file, unpacks the web-application into a sub-directory tree in the webapps directory and starts the web-application.
  4. Check that the web-application has started correctly by going, with a web-browser, to the root of the web application (http://your.server.address:8080/HTTP-CEC-1/ in the example above). If no web-page is returned, then there is a problem with the WAR.
  5. Now set up your web-application by following the instructions in the configuration guide.