Hyrax - OLFS Installation

The OLFS comes with a default configuration that is compatible with the default configuration of the BES. If you do a default install of each one you should get a running Hyrax server that will be pre-populated with test data suitable for running the integrity tests.

Download

If you haven't already got it, go get the latest OLFS distribution from here. You should get the binary jar file which will be named something like: olfs-0.1.5-webapp.jar

Unpack

Unpack the jar file with the command:

jar -xvf olfs-0.1.5-webapp.jar

which will unpack a directory called olfs-0.1.5-webapp

Install

Inside the that directory find the opendap.war file, and copy it into the Tomcat's webapps directory:

cp olfs-0.1.5-webapp/opendap.war /usr/local/apache-tomcat-5.5.15/webapps/

(Assuming the your Tomcat server is in /usr/logcal) If you're replacing an old copy, make sure that remove the 'opendap' directory that Tomcat will have created when it was started.)

Setup Tomcat

Configure the Tomcat environment by setting the environment variable CATALINA_HOME to the full path for the Tomcat distribution.

In bash:

export CATALINA_HOME = /usr/local/apache-tomcat-5.5.20

Start Tomcat

In the top level tomcat directory (apache-tomcat-5.5.20 on my machine) issue the command:

bin/startup.sh; tail -f logs/catalina.out

Wait a few seconds while it all starts up.

When Tomcat starts up it will unpack your 'OLFS and install the webapp.

Usage Note: If you use ctrl-c to stop watching the tail of the servers output, make sure to run the command:

bin/shutdown.sh

to shutdown Tomcat. If you don't, you may get errors when you next try to start the Tomcat server.

---