Hyrax - OLFS Installation

From OPeNDAP Documentation

Jump to: navigation, search

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.


Contents

[edit] Install The BES

[edit] 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-x.x.x-webapp.jar

[edit] Unpack

Unpack the jar file with the command:

jar -xvf olfs-x.x.x-webapp.jar

which will unpack a directory called olfs-x.x.x-webapp

[edit] Install

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

cp olfs-x.x.x-webapp/opendap.war /usr/local/apache-tomcat-6.x.x/webapps/</code>

(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.)

[edit] 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-6.x.x

[edit] Start Tomcat

In the top level tomcat directory (apache-tomcat-6.x.x 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.



Views
Personal tools