Versions Compared

Old Version 16

changes.mady.by.user ChadC

Saved on

compared with

New Version 17

changes.mady.by.user Ian Young

Saved on

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

...

  1. Download and extract the distribution

HTML Comment

Web Service Distribution

Note

The web service distribution is not yet available. The following documentation is a work in progress.

The metadata aggregator web service is a standard Java web application. The distribution comes with a Servlet container (Jetty) bundled with it. Most people should use this container (it will be configured for you during the install process) unless there is a strong reason to use another container. If you need to use another container the WAR file, which is what Jetty uses, is available in the distribution.

Required Information

Before you begin, you'll need to have the following things ready:

  • IP address you want the service to listen on (if your host has more than one)
  • SSL key/certificate you want to use (if you want to serve content over HTTPS)

TODO: any other?

Installation

  1. Download and extract the metadata aggregator
  2. Run the install script

TODO: how to start/stop service

Using Another Container

Since the metadata aggregator web service is a standard Java web app any container capable of working with Servlet 2.5 apps may be used. To deploy the application in another container you need to:

  1. Give the location of the WAR to the container. The WAR is located in the $MDA_HOME/war directory.
  2. Set the contextConfigLocation init parameter whose value is the absolute path to the $MDA_HOME/conf/mda-config.xml file.
Note, most Servlet containers provide a way to point to a WAR on the file system and to set context init parameters without copying the war or editing any of its files. For example, you can use a deployment descriptor in Tomcat. If your container provides such mechanisms you should use them. It will make upgrading much easier.