Skip to content

Latest commit

 

History

History
160 lines (117 loc) · 5.72 KB

Hyrax_OLFS_Installation.adoc

File metadata and controls

160 lines (117 loc) · 5.72 KB

OLFS Installation

Table of Contents

1. Introduction

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

2. Install Tomcat

  1. Install tomcat.noarch: sudo yum install tomcat.noarch.

  2. Create the directory /etc/olfs, change its group to tomcat, and set it group writable:

    mkdir /etc/olfs
chgrp tomcat /etc/olfs
chmod g+w /etc/olfs)

    Alternatively, get Apache Tomcat-8.x from the Apache Software Foundation and install it wherever you’d like—​for example, /usr/local/.

3. Download

Follow the steps below to download the latest OLFS distribution:

  1. Visit the official OPeNDAP website and go to Latest Release.

  2. Scroll down the following page until you reach the section entitled Linux Binaries

  3. Directly underneath, you should see the OLFS download link, named something like OLFS_x.x.x._Web_Archive_File. Click to download.

  4. The downloaded file will be named something like: olfs-x.x.x-webapp.tgz.

4. Unpack

Unpack the jar file with the command tar -xvf olfs-x.x.x-webapp.tgz

This will unpack the files directory called olfs-x.x.x-webapp.

5. Install

Inside of the olfs-x.x.x-webapp directory, locate opendap.war and copy it into Tomcat’s webapps directory:

cp opendap.war /usr/share/tomcat/webapps

Or, if you installed tomcat from the ASF distribution, its web application directory, for example…​

/usr/local/apache-tomcat-8.5.34/webapps

5.1. CentOS-7/SELinux and Yum installed Tomcat

Recent versions of CentOS-7 are shipped with default SELinux settings that prohibit Tomcat from reading or opening the opendap.war file. This can be addressed by issuing the following two commands:

sudo semanage fcontext -a -t tomcat_var_lib_t /var/lib/tomcat/webapps/opendap.war
sudo restorecon -rv /var/lib/tomcat/webapps/

After this you will need to restart Tomcat:

sudo service tomcat restart

6. Starting and Stopping the OLFS/Tomcat

If you followed this tutorial and are using a YUM-installed Tomcat, it should already be integrated into the system with a tomcat entry in /etc/init.d and you should be able to…​

  • Start Tomcat: sudo service tomcat start

  • Stop Tomcat: sudo service tomcat stop

You can verify that the server is running by visiting http://localhost:8080/opendap/. If you have installed Hyrax on a virtual machine, replace localhost with the virtual machine’s IP address.

Note
 If you are installing the OLFS in conjunction with ncWMS2 version 2.0 or higher, copy both the opendap.war and the ncWMS2.war files into the Tomcat webapps directory. (Re)Start Tomcat.