Hyrax - Installation Instructions: Difference between revisions
mNo edit summary |
|||
Line 9: | Line 9: | ||
==System Requirements== | ==System Requirements== | ||
Hyrax is supported on Linux and OS/X, although we only build binary versions for Linux. We do not support Hyrax on Windows or Vista, although see the [[Using Virtual Machines to Serve Data]] project for a solution applicable to Win32 platforms. | |||
You can use either ''yum'', ''rpm'' or ''apt-get'' to get binary packages for the required software listed below. If you're building using our source distributions or a GitHub clone, be sure to get the ''-devel'' (rpm) or ''-dev'' (deb) packages; if you're using our binary builds then the plain packages will be fine. | |||
You can use either ''yum'', ''rpm'' or ''apt-get'' to get binary packages for | |||
=== ''For the impatient'' === | === ''For the impatient'' === | ||
# On Linux system that uses RPM packages (Red Hat, CentOS, Fedora Core, ...), use ''yum'' to install epel-release. Then install our packages for libdap and BES. | |||
On Linux system that uses RPM packages (Red Hat, CentOS, Fedora Core, ...), use ''yum'' to install | # Get/install Tomcat | ||
# Download the OLFS package, unpack the tar.gz file and copy ''opendap.war'' into Tomca's webapps directory. | |||
# Start the BES | |||
# Start Tomcat | |||
# look at http://localhost:8080/opendap in a web browser | |||
=== Short list === | === Short list === |
Revision as of 17:09, 10 April 2015
Hyrax is fairly easy to configure, but because there are several different components involved, it can seem complicated. Essentially you need to install two pieces of software: the BES and the OLFS. The BES reads data files and builds various kinds of responses and the OLFS is an interface to the BES that provides a web presence for the data and services. Because Hyrax uses a web server to work with web browsers and other kinds of programs, you will need to install the Apache Tomcat software too.
What you will need:
- 5 minutes
- Java 1.8 Runtime
- Tomcat 7 or newer
- The two pieces of software the make up Hyrax
System Requirements
Hyrax is supported on Linux and OS/X, although we only build binary versions for Linux. We do not support Hyrax on Windows or Vista, although see the Using Virtual Machines to Serve Data project for a solution applicable to Win32 platforms.
You can use either yum, rpm or apt-get to get binary packages for the required software listed below. If you're building using our source distributions or a GitHub clone, be sure to get the -devel (rpm) or -dev (deb) packages; if you're using our binary builds then the plain packages will be fine.
For the impatient
- On Linux system that uses RPM packages (Red Hat, CentOS, Fedora Core, ...), use yum to install epel-release. Then install our packages for libdap and BES.
- Get/install Tomcat
- Download the OLFS package, unpack the tar.gz file and copy opendap.war into Tomca's webapps directory.
- Start the BES
- Start Tomcat
- look at http://localhost:8080/opendap in a web browser
Short list
- libdap
- libxml2 2.6.16*
- libcurl 7.10.6*
- pthreads (part of glibc on linux)*
- uuid
- bes
- to build ssl authenticated connections, install openssl
- to use the bes command line utility, install readline-dev(el)
- dap-server (referred to as General purpose handlers on download page)
- OLFS
- Tomcat 6.0.x
- Java 1.5* run-time (or newer, depending on the requirements of the Tomcat software).
Additional stuff
When building from source, to run tests:
- dejagnu
- cppunit
To serve NetCDF files:
- The netCDF handler
- libnetcdf 3.x
To serve HDF4 files:
- The HDF4 handler
- The HDF4 library (4.x) and it's required software (often libjpeg, zlib* and szip)
To serve formatted ASCII using FreeForm:
- The FreeForm handler
To serve HDF5 files:
- The HDF5 handler
- The HDF5 library (1.6.0 or 1.8.x) (and often zlib*)
To provide data responses as NetCDF files:
- The Fileout NetCDF handler
- libnetcdf 3.x
To use NCML:
- The NCML Handler
- libicu 3.6
- At least one data handler
*Stock on any recent linux or OS/X distribution
Secure Installation Guidelines
Install the BES
Install and configure the BES.
Install the OLFS
Next You need to install and configure the OLFS inside of a Tomcat server
Starting and Stopping Hyrax
To correctly start and stop Hyrax, follow these simple recipes.
Starting
- Start the BES first using the besctl program with the start argument. See Starting and stopping the BES for more information.
- Start the OLFS using the Tomcat startup script. See Starting Tomcat for more information.
Stopping
- Stop the OLFS first using the tomcat shutdown script.
- Stop the BES using the besctl program with the stop argument.
See above for stopping information.
Test the server
To test/use the server, open a web browser and open the URL: http://localhost:8080/ and you should see the Tomcat default page.
Open the URL: http://localhost:8080/opendap/ to see an HTML directory of the top of your data archive.
You can get the HTML view THREDDS catalog by appending "catalog.html" to the end of any URL that returns an HTML directory, like so: http://localhost:8080/opendap/catalog.html But you may need to do some additional configuration that to work.
Configure Your Hyrax Installation
At this point, Hyrax should be working. When you install Hyrax for the first time it is pre-configured to serve test data sets that come with each of the installed data handlers. This will allow you to test the server and make sure it is functioning correctly. After that you will want to configure so that it works with your data.
Miscellaneous
Once opendap.war is expanded, manually copy the file favicon.ico file:
$CATALINA_HOME/webapps/opendap/docs/images/favicon.ico
to
$CATALINA_HOME/webapps/ROOT/
The favicon.ico file is mostly a convenience to keep browsers from constantly asking for it (substitute your own icon if you like!).