Hyrax Installation

Updated for Hyrax version 1.17.x

Note: For more verbose instructions, see The Hyrax Installation and Configuration Guide.

First:

Build and install the bes and it's submodules.
Launch the bes (you can use besctl to do that).
Make sure there is a beslistener process runnning.

Check out the OLFS:

git clone https://github/opendap/olfs

Build it:

ant server

Install it:

rm -rf $CATALINA_HOME/webapps/opendap*
cp build/dist/opendap.war $CATALINA_HOME/webapps

Launch it:

$CATALINA_HOME/bin/startup.sh

Configure it:

The OLFS configuration location has changed!
By default the OLFS will utilize it's bundled default configuration in the directory $CATALINA_HOME/webapps/opendap/WEB-INF/conf

In order to localize your configuration so that your configuration changes are persistent you will need to do one of the following:

For the user that will be running the OLFS (the Tomcat user), set the environment variable OLFS_CONFIG_DIR to an existing directory to which the Tomcat user has both read and write privileges.
Create the directory /etc/olfs and set it's permissions/ownership so that the Tomcat user has both read and write permission.*
Create the directory /usr/share/olfs and set it's permissions/ownership so that the Tomcat user has both read and write permission.*

These will be prioritized in the order they appear here. So if more than one of these has been done then the priority is given to the firest one found, searched in the above order. Note:When running under SELinux (CentOS-7 for example) you will need to do some things to allow Tomcat to write to those directories. Read about it in Section 2.7.1 of the Hyrax user Guide

Now, Restart Tomcat:

$CATALINA_HOME/bin/shutdown.sh

$CATALINA_HOME/bin/startup.sh

When it starts the OLFS will check these locations and then install a copy of its default configuration into the new spot. Edit the configuration files as needed. (If, for example, your beslistener is not running at localhost:10022 then in the olfs.xml file edit the <BES> element adjust the values for <host> and <port>)
Once your edits are completed then:

Relaunch it: