1 / 20

Hyrax Configuration: Single or Multiple Machine Setup

Learn about the various choices for configuring a Hyrax server, including options for single or multiple machines, back-end servers, web servers, data formats, catalog customization, security, testing, and command line tools. This workshop provides step-by-step instructions for setting up a single back-end server on a SLAX Linux virtual machine using Tomcat.

joeljenkins
Download Presentation

Hyrax Configuration: Single or Multiple Machine Setup

An Image/Link below is provided (as is) to download presentation Download Policy: Content on the Website is provided to you AS IS for your information and personal use and may not be sold / licensed / shared on other websites without getting consent from its author. Content is provided to you AS IS for your information and personal use only. Download presentation by click this link. While downloading, if for some reason you are not able to download a presentation, the publisher may have deleted the file from their server. During download, if you can't get a presentation, the file might be deleted by the publisher.

E N D

Presentation Transcript

  1. Hyrax Configuration

  2. Hands on: Hyrax Configuration • Choices: • Single or Multiple machine • Single or Multiple back-end servers • Tomcat or Apache web server • Data formats • Catalog customization • Security • Testing • Command line tools for system administrators • Web browser

  3. BOM Workshop Configuration • Run a single BES and the OLFS on one host (the virtual machine running SLAX Linux) • Use Tomcat running on port 8080 • Data formats: NetCDF and FreeForm • No custom THREDDS catalog • No firewall

  4. BOM Hardware • SLAX Linux VMware Virtual Appliance • All the software needed has been built, installed and configured • Start the virtual machine now…

  5. Starting the Virtual Machine • Insert the CD-ROM • Drag the opendap_vm and Wintools folders to the Windows desktop • Open the Wintools folder and double click the setup-slax-iso script • Once the setup script ends, open the opendap_vm folder and double click on the opendap_vm.vmx virtual machine configuration file or start VMware Player/Workstation/Fusion and open opendap_vm.vmx from there. • The virtual host will boot and the SLAX (slackware Linux with KDE) desktop will appear.

  6. Installing the Software • Already present on the virtual machine • But, if it wasn’t, you’d go to the OPeNDAP web site* and download: • Binaries or source for the BES and the data handlers needed. • Get the OLFS web archive file (which is a compiled java servlet). • You also need the Tomcat servlet engine * http://opendap.org/download/hyrax.html

  7. Location of Server Files on the Virtual Machine • On your virtual machine: • The Tomcat servlet engine is in /usr/local/javadev/apache/tomcat-5.5.12 (this is the value of $CATALINA_HOME) • The BES, data handlers and related source files are in /usr/local/src. The BES has been built and installed in /usr/local/ ($prefix) • The OLFS web archive file is $CATALINA_HOME/webapps/opendap.war • BES: bes.conf, found at $prefix/etc/bes/bes.conf • OLFS: olfs.xml and catalog.xml, found at $CATALINA_HOME/content/opendap

  8. Background: Starting the Server • Start the BES (back-end data processing component) • Use bescmdln to verify it’s working • Start Tomcat: This automatically starts all installed servlets • Servlets are installed by copying the .war file to the servlet’s webapps directory • Verify it’s working using a web browser

  9. Configure the BES • BES configuration is in bes.conf • Modules to load: • On the virtual machine, the list of modules is already set • BES.modules=dap,cmd,…,mod1 • BES.module.mod1=/path/to/libmod1_module.so

  10. Configuring Modules

  11. Configure the BES • BES configuration is in the bes.conf file • Other parameters typically changed: • BES.ChacheDir=/path/to/cache/directory • BES.CacheSize=1 • BES.Data.RootDirectory=/dev/null • BES.Catalog.catalog.RootDirectory=/path/to/data/root/dir • BES.Catalog.catalog.TypeMatch=nc:.*\.nc$;nc:.*\.nc\.gz$; • BES.ServerAdministrator=admin@yoursite.org • BES.LogName=/path/to/log/file/bes.log

  12. Start the BES

  13. Verify the BES is running

  14. Start Tomcat & the OLFS • Typical steps: • Unpack the olfs jar-file • Copy the opendap.war file to Tomcat’s webapps directory • Start Tomcat • Since all but the last step has been done already, start Tomcat: • /usr/local/javadev/apache-tomcat-5.5.12/bin/startup.sh

  15. …terminal view

  16. Verify Tomcat is running http://localhost:8080

  17. …and Hyrax http://localhost:8080/opendap

  18. Complete the Configuration • Steps you would typically perform: • Security: Set up a firewall! Limit access to port 10002 to this host only • Custom catalogs: Edit the catalog.xml configuration file. By default automatic catalogs are generated • Logging: Edit the log4j.xml file. By default all accesses are logged

  19. Stopping Hyrax First, stop Tomcat using ‘shutdown.sh’ …then stop the BES using ‘besctl’

  20. Hyrax Configuration Summary • For our chosen configuration, we used only Tomcat, plus the Hyrax web application which consists of the BES and the OLFS • The tools bescmdln, getdap and a web browser were used to test the installation • There are a lot of options, but the default settings produce a working server • Security is a must for a web application; use a firewall to isolate the BES so only the local host can connect to it.

More Related