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 *

7. Location of Server Files on the Virtual Machine
On your virtual machine:
The Tomcat servlet engine is in /usr/local/javadev/apache/tomcat (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
The BES Configuration file installed is very well documented and should be easy to configure

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.LogName=/path/to/log/file/bes.log
The cache directory should be placed under the directory that the BES has access to
CacheSize is set to the number of Megabytes
Probably don’t want to mention BES.Data.RootDirectory at all, but it’s there just in case

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 /bin/startup.sh

15. …terminal view

16. Verify Tomcat is running

17. …and Hyrax

18. Complete the Configuration
Steps you would typically perform:
Security: Set up a firewall! Limit access to port 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.