Configuration

The component may be manually configued using the standard astrogrid config system - i.e. setting properties as environment variables, or in a configuration file (astrogrid.properties), or within the JNDI service in Tomcat. See the general config documentation for details.

Configuration Properties

The configuration properties that JES understands are as follows

Working Directory

JES requires a directory in which to store workflow transcripts, and other bookeeping information. Jes will create a series of directories under the direcory given in the jes.jobfactory.file.basedir property. This base directory must be writable by Tomcat (and JES given permission under any security manager you may be running).

Registry Endpoint

The property astrogrid.registry.endpoint should contain the URL endpoint of the Registry webservice this JES is to use.

Callback Endpoints

When JES dispatches a step to a CEA server, it needs to tell the server where to send notification of the step execution. The properties jes.monitor.endpoint.url and jes.results.endpoint.url contain the absolute URL endpoints of the callback webservices for this JES server. These always follow the same pattern

jes.monitor.endpoint.url=http://server.name:port/jes-context/services/JobMonitorService
jes.results.endpoint.url=http://server.name:port/jes-context/services/ResultListener

Where server.name is the DNS resolvable name (not 'localhost') of the machine the Tomcat is running on, port is the port that Tomcat is listening on, and jes-context is the context in Tomcat that the jes service is installed at.

Required Properties

JES also requires the following keys to be set. Don't alter the values - these keys just need to be as follows for a deployed JES Server.

jes.locator=registry
jes.store=file
org.astrogrid.registry.result.version=0.9

Example Configuration File

# file: astrogrid.properties - sample configuration file for a JES Server
# Working directory for jes
jes.jobfactory.file.basedir=/home/tomcat/jes

#Registry Endpoint
org.astrogrid.registry.query.endpoint=http://capc49.ast.cam.ac.uk/galahad-registry/services/RegistryQuery

#Callback Endpoints
jes.monitor.endpoint.url=http://my.server.name:8080/astrogrid-jes/services/JobMonitorService
jes.results.endpoint.url=http://my.server.name:8080/astrogrid-jes/services/ResultListener


#Required Properties.
org.astrogrid.registry.result.version=0.9
jes.locator=registry
jes.store=file