This document describes the standard installation. Please see the reference guide for possible variations.
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.
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.
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 JC-CEC web-application. E.g., if you name the web-application context "JC-CEC-1", the URLs will be of the form
For this kind of CEC, you must provide the applications as a compiled Java-class. When correctly configured, the CEC will present every static method of that class as a CEA application. The methods that become applications can only have primitive arguments or arguments of type java.lang.String: custom objects as arguments are not supported. Each such method should return its result in the Java sense (i.e. don't write the result to standard output). Don't include a Main method in the class; that will show up as a separate, broken application in the CEA. See the reference manual for more advice on providing Java-class applications.
Your 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 CEC web-application.
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 CEC can search for resources 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 CEC.