Hyrax - Installation Instructions: Difference between revisions

From OPeNDAP Documentation
⧼opendap2-jumptonavigation⧽
No edit summary
No edit summary
 
(42 intermediate revisions by 3 users not shown)
Line 1: Line 1:
Hyrax is really fairly easy to configure, but because there are several different components involved, it can seem complicated. Essentially you need to configure the BES to load and use one of more data handlers and to look in the right place for your data. The OLFS only will work out of the box, but will need configuration to enable THREDDS functionality and Access Logging. Similarly, Tomcat needs no configuration although you might want to change the port from 8080 to 80 if it's going to be the only web server on your host. But you don't need to do that, it's just that you can if you want. Lastly, you can configure an Apache server to hand off requests to the server and, at the same time, have it emulate all your old Server3 URLs. That way catalogs, hot lists and other places where URLs to your data are stored will still work.
<font size="5">
This is not a complete manual for the BES. Instead of explaining all of the parameters and how their different setting can be used to control the BES, the discussion here is limited to what is used when the BES is run as part of Hyrax. In addition, there are number of parameters that should always be left to their default values for a Hyrax configuration and those will also be skipped. This makes it much easier to focus on those parameters that an installer really must understand.
;This page is deprecated
:These instructions apply to Hyrax version 1.10 and older.
: [[Hyrax#Install|Current Installation Instructions Can Be Found Here.]]
</font>
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:
What you will need to install a binary distribution:


* 30 minutes
* 5 minutes
* C++ compiler
* Java 1.7 Runtime
* Java 1.5 Runtime or Development Environment
* Tomcat 7 or newer
* Tomcat 5.5.x or newer
* The two pieces of software the make up Hyrax
* A web browser


==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. While that information is somewhat dated since it describes an older version of Hyrax, the approach is generally applicable to the current version of Hyrax.


----
For our binary distribution of Hyrax for CentOS/RedHat/Fedora, use either ''yum'' or ''rpm'' to install the libdap and BES RPM packages. We also have DEB packages for Ubuntu/Debian. Either ''yum'' or ''apt-get'' will find and install any dependencies the libdap or BES package needs.
=[[Hyrax: BES Installation|Install the BES]]=


[[Hyrax: BES Installation|First install and configure the BES.]]
==Secure Installation Guidelines==


[[Hyrax - Secure Installation Guidelines|Making Hyrax Secure]]
----


=[[Hyrax: OLFS Installation| Install the OLFS]]=
==Install the BES==


[[Hyrax: OLFS Installation|Next You need to install and configure the OLFS inside of a Tomcat server]]
[[Hyrax - BES Installation|Install and configure the BES.]]


==Install the OLFS==


----
[[Hyrax - OLFS Installation|Next You need to install and configure the OLFS inside of a Tomcat server]]
=Starting and Stopping Hyrax=


==Starting and Stopping Hyrax==
To correctly start and stop Hyrax, follow these simple recipes.  
To correctly start and stop Hyrax, follow these simple recipes.  


===Starting===
=====Starting=====
# Start the BES first using the ''besctl'' program with the ''start'' argument. See [[Hyrax_-_Starting_and_stopping_the_BES|Starting and stopping the BES]] for more information.
# Start the OLFS using the Tomcat startup script. See [[Hyrax_-_OLFS_Installation#Start_Tomcat| Starting Tomcat]] for more information.


1. Start the BES first using the ''besctl'' program with the ''start'' argument. See [[Hyrax: BES Installation|First install and configure the BES.]] for more information.
=====Stopping=====
2. Start the OLFS using the Tomcat startup script. See [[Hyrax: OLFS Installation| Install the OLFS]] for more information.
# Stop the OLFS first using the tomcat shutdown script.
# Stop the BES using the ''besctl'' program with the ''stop'' argument.


===Stopping===
==Test the server==
 
1. Stop the OLFS first using the tomcat shutdown script.
2. Stop the BES using the ''besctl'' program with the ''stop'' argument.
 
 
----
=Test the OLFS servlet.=


To test/use the server, open a web browser and open the URL:  http://localhost:8080/ and you should see the Tomcat default page.  
To test/use the server, open a web browser and open the URL:  http://localhost:8080/ and you should see the Tomcat default page.  
Line 49: Line 49:
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.
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==
----
 
=[[Hyrax: Configuration|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.
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=
==Miscellaneous==


Once opendap.war is expanded, manually copy the file favicon.ico file:
Once opendap.war is expanded, manually copy the file favicon.ico file:

Latest revision as of 15:55, 28 April 2015

This page is deprecated
These instructions apply to Hyrax version 1.10 and older.
Current Installation Instructions Can Be Found Here.

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 to install a binary distribution:

  • 5 minutes
  • Java 1.7 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. While that information is somewhat dated since it describes an older version of Hyrax, the approach is generally applicable to the current version of Hyrax.

For our binary distribution of Hyrax for CentOS/RedHat/Fedora, use either yum or rpm to install the libdap and BES RPM packages. We also have DEB packages for Ubuntu/Debian. Either yum or apt-get will find and install any dependencies the libdap or BES package needs.

Secure Installation Guidelines

Making Hyrax Secure

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
  1. Start the BES first using the besctl program with the start argument. See Starting and stopping the BES for more information.
  2. Start the OLFS using the Tomcat startup script. See Starting Tomcat for more information.
Stopping
  1. Stop the OLFS first using the tomcat shutdown script.
  2. Stop the BES using the besctl program with the stop argument.

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