Service install

The install toolkit contains all of the components required to install and configure the AstroGrid Community WebService.

The toolkit includes the following components :

  • Ant script
  • Ant properties
  • WebService war file
  • 3rd party libraries

Required components

The install toolkit requires the following pre-requisites installed on the target system(s).

  • Apache Ant (recomended version 1.5.4)
  • Apache Tomcat (recomended version 4.1.24)

Service properties

The install toolkit uses the following properties, configured in the install.properties file supplied with the toolkit.

  • org.astrogrid.community.ident - the ivo name of your Community.
  • database.home - the location of the Community database files.
# Your community name.
# Change this property to set the service identifier.
org.astrogrid.community.ident=org.astrogrid.localhost

# Database files location.
# The default is to put the database files in '/var/astrogrid'.
# Change this property if you want to relocate the database files.
database.home=/var/astrogrid/community

Local install

The install toolkit can install the WebService directly into a Tomcat instance on the local system.

Assuming that the pre-requisites are already installed, and the service properties have been configured, executing the install Ant task will automatically install and configure the WebService. 

ant -f install.xml install

This will install the basic WebService into Tomcat container.

To install and configure the database, refer to the Database install page.

Remote deploy

Remote deployment is not implemented in the current release.

The install toolkit can also deploy the WebService into a Tomcat server running on a remote system.

Deploying the WebService on a remote system requires Tomcat installed and running on the target system, and Ant installed on the local system. Assuming that the pre-requisites are already installed, executing the deploy Ant task will automatically deploy the WebService on the target machine. 

ant -f install.xml deploy \
    -Dtomcat.host=host.astrogrid.org \
    -Dtomcat.manager.name=xyz \
    -Dtomcat.manager.pass=xyz

Alternatively, the Tomcat properties can be set by providing a local properties file, tomcat.properties. 

#
# Target deployment hostname.
# Used by the remote deployment task.
# Change this property to specify a remote system.
tomcat.host=localhost

#
# Tomcat manager name and password
# Change these properties to match the settings on the target system.
tomcat.manager.name=QWERTY
tomcat.manager.pass=qwerty

In which case, the Ant command can be simplified to the following. 

ant -f install.xml deploy