Child pages
  • 2 Installation Guide
Skip to end of metadata
Go to start of metadata

You are viewing an old version of this page. View the current version.

Compare with Current View Page History

« Previous Version 14 Next »

Installation Guide

As mentioned in the introduction, the metadata aggregator has two usage patterns: a command line and a web service. The command line distribution, as its name suggests, contains just the command line interface. The web service distribution contains both the command line interface and the web service interface.

Command Line Distribution

Installation

  1. Download and extract the distribution

Unknown macro: {htmlcomment}

Web Service Distribution

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.

  • No labels