Skip to content

Latest commit

 

History

History
74 lines (48 loc) · 3.86 KB

Master_Hyrax_Installation.adoc

File metadata and controls

74 lines (48 loc) · 3.86 KB

Installation

Table of Contents

Hyrax is a data server that implements the DAP2 and DAP4 protocols, works with a number of different data formats and supports a wide variety of customization options from tailoring the look of the server’s web pages to complex server-side processing operations. This page describes how to build the server’s source code. If you’re working on a Linux or OS/X computer, the process is similar so we describe only the linux case; we do not support building the server on Windows operating systems.

There are broadly three ways to install and run Hyrax Data Server

Hyrax_DockerHub_Installation.adoc

1. (pre-compiled) Binaries

Prerequisites:

  1. Java>=11

  2. Tomcat>=9

Installing a Hyrax binary release typically involves the following steps

  1. Download the latest Hyrax release (Hyrax 1.17-1). It is composed of:

    1. 2 RPM files (one for libdap, one for the BES).

    2. The OLFS binary distribution file. You can also install the OLFS Automatic robots.txt, if available.

  2. Install the libdap RPM.

  3. Install the BES RPM.

  4. Unpack the OLFS distribution file, and install the opendap.war file into your Tomcat instance’s webapps directory.

  5. (optional) ncWMS2. You will need to use the EDAL web page to locate the latest ncWMS2 “Servlet Container” software bundle as a WAR file. Install it into the same Tomcat instance as the OLFS. See here for more instructions.

Tip
 The detailed download and installation instructions for Hyrax are published on the download page for each release of the server. Find the latest release and its associated installation details on the Hyrax downloads page.
Warning
 If you are upgrading Hyrax from any previous installation older than 1.16.5, read this! The internal format of the olfs.xml file has been revised. No previous version of this file will work with Hyrax >=1.16.5. In order to upgrade your system, move your old configuration directory aside (mv /etc/olfs ~/olfs-OLD) and then follow the instruction to install a new OLFS. Once you have it installed and running you will need to review your old configuration and make the appropriate changes to the new olfs.xml to restore your server’s behavior. The other OLFS configuration files have not undergone any structural changes and you may simply replace the new ones that were installed with copies of your previously working ones.
Note
 To make the server restart with when host boots, use systemctl enable besd and systemctl enable tomcat, or chkconfig besd on and chkconfig tomcat on depending on the specifics of your Linux distribution.

Hyrax_Source_Installation.adoc

If you are interested in working on Hyrax or want to build the server from source code (as opposed to using the prebuilt binaries that we provide), you can get signed source distributions from the download page referenced above. See also the For Software Developers section below.

2. WCS Installation

The WCS 2 service comes bundled as part of Hyrax-1.14.0 and newer. For more information about configuring WCS with your installation of Hyrax, please refer to the WCS Installation Guide that appears later in this document.