Skip to main content

OLFS: The Hyrax Front End

The OPeNDAP Lightweight Frontend Servlet (OLFS) provides the public-accessible client interface for Hyrax. The OLFS communicates with the Back End Server (BES) to provide data and catalog services to clients. The OLFS implements the DAP2 protocol and supports some of the new DAP4 features. We hope that other groups will develop new front end modules that will implement other protocols.

New Features:

If you are looking for the OPeNDAP 4 Data Server (aka Hyrax) software, the Hyrax page provides a single place where each of the components of Hyrax can be downloaded and also provides information about which versions work together to properly support Hyrax's various features.

OLFS 1.6.2 (25 June 2010)

Part of Hyrax release 1.6.1 Not compatible with earlier versions of Hyrax.

This release contains bug fixes for:

  • A problem with the automatically generated THREDDS catalogs from the BES. Ticket 1579
  • A problem in which thredds:datasetScan elements in static THREDDS catalogs were "leaking" into the catalogs returned to requesting clients. Ticket 1572

Look at our documentation site for Hyrax release notes.

Binaries

Version 1.6.2


Compressed tar file containing the Web Archive binary and instructions. (gpg signature)
Unpack using: tar -xvf olfs-1.6.2-webapp.tgz
Binaries built using Java 6 (java version "1.6.0_17") and tested on Tomcat 6.0.x

SoapTestClient (gpg signature) - A client for testing the prototype SOAP interface.

Source code

Version 1.6.2
Source (gpg signature)
Documentation (gpg signature)
SoapTestClient jar (gpg signature)

OLFS 1.6.1 (13 May 2010)

Part of Hyrax release 1.6.1

This release contains:

  • Automatically generated THREDDS catalogs now have a "file" service. If a file is not identified as data by the BES then it is listed as a dataset with just "file" access.
  • Bug fix (http://scm.opendap.org/trac/ticket/1408)
  • Netcdf_fileout response has been changed to be compatible with certain 3.6.3 netcdf clients. (http://scm.opendap.org/trac/ticket/1295)

Look at our documentation site for Hyrax release notes.

Binaries

Version 1.6.1


Compressed tar file containing the Web Archive binary and instructions. (gpg signature)
Unpack using: tar -xvf olfs-1.6.1-webapp.tgz
Binaries built using Java 5.0 (JVM1.5) and tested on Tomcat 6.0.x

SoapTestClient (gpg signature) - A client for testing the prototype SOAP interface.

Source code

Version 1.6.1
Source (gpg signature)
Documentation (gpg signature)
SoapTestClient jar (gpg signature)

OLFS 1.6.0 (10 February 2010)

Part of Hyrax release 1.6.0

This release contains:

  • Automatically generated THREDDS catalogs now have a "file" service. If a file is not identified as a data by the BES then it is listed as a dataset with just "file" access.
  • Bug fix (http://scm.opendap.org/trac/ticket/1408)
  • Netcdf_fileout response has been changed to be compatible with certain 3.6.3 netcdf clients. (http://scm.opendap.org/trac/ticket/1295)

Look at our documentation site for Hyrax release notes.

Binaries

Version 1.6.0


Compressed tar file containing the Web Archive binary and instructions. (gpg signature)
Unpack using: tar -xvf olfs-1.6.0-webapp.tgz
Binaries built using Java 5.0 (JVM1.5) and tested on Tomcat 6.0.x

SoapTestClient (gpg signature) - A client for testing the prototype SOAP interface.

Source code

Version 1.6.0
Source (gpg signature)
Documentation (gpg signature)
SoapTestClient jar (gpg signature)

OLFS 1.5.4 (31 March 2010)

Part of Hyrax release 1.5.2

This release contains minor updates to the default configuration.

Binaries

Version 1.5.4


Compressed tar file containing the Web Archive binary and instructions. (gpg signature)
Unpack using: tar -xvf olfs-1.5.4-webapp.tgz
Binaries built using Java 5.0 (JVM1.5) and tested on Tomcat 6.0.x

SoapTestClient (gpg signature) - A client for testing the prototype SOAP interface.

Source code

Version 1.5.4
Source (gpg signature)
Documentation (gpg signature)
SoapTestClient jar (gpg signature)

OLFS 1.5.0 (12 April 2008)

Part of Hyrax release 1.5.0

This release contains:

  • Performance enchancemnets (Roughly 10 times faster for small requests.)
  • New THREDDS implementation.
    • Fast
    • Scaleable
    • Presentation views (HTML pages) generated using XSLT
    • Minimal configuration - works out of the box.
  • Simple robot blocker forthose plagued by bots that consistently ignore robots.txt.
  • If you are updating from an older version of Hyrax you will need to update your olfs.xml file! See $CATALINA_HOME/webapps/opendap/initialContent/olfs.xml for the default olfs.xml for Hyrax 1.5.0. For more detailed information see the Hyrax Configuration Documentation

Look at our documentation site for Hyrax release notes.

Binaries

Version 1.5.0

If you are updating from an older version of Hyrax you will need to update your olfs.xml file! See $CATALINA_HOME/webapps/opendap/initialContent/olfs.xml for the default olfs.xml for Hyrax 1.5.0. For more detailed information see the Hyrax Configuration Documentation

Compressed tar file containing the Web Archive binary and instructions. (gpg signature)
Unpack using: tar -xvf olfs-1.5.0-beta2-webapp.tgz
Binaries built using Java 5.0 (JVM1.5) and tested on Tomcat 6.0.x

SoapTestClient (gpg signature) - A client for testing the prototype SOAP interface.

Source code

Version 1.5.0
Source (gpg signature)
Documentation (gpg signature)
SoapTestClient jar (gpg signature)

OLFS 1.4.1 (20 March 2008)

Part of Hyrax release 1.4.0

This release contains:

  • Bug fix - Repairs a problem with the way in which the xdods-server HTTP header was being generated. This bug prevented some older DAP2 clients from accessing Hyrax.

Note: This is a relatively small change. Updating Hyrax 1.4.0 to use OLFS 1.4.1 does not require configuration changes. Simply replace the opendap.war file in $CATALINA_HOME/webapps and then restart Tomcat.

Look at our documentation site for Hyrax release notes.

Binaries

Version 1.4.1
Jar file containing the Web Archive binary and instructions. (gpg signature)
Unpack using: jar -xvf olfs-1.4.0-webapp.jar
Binaries built using Java 5.0 (JVM1.5) and tested on Tomcat 6.0.x
 
SoapTestClient (gpg signature) - A client for testing the prototype SOAP interface.

Source code

Version 1.4.1
source jar (gpg signature)
documentation jar (gpg signature)
SoapTestClient jar (gpg signature)

OLFS 1.4.0 (29 February 2008)

Part of Hyrax release 1.4.0

This release contains:

  • Bug fixes and feature additions
  • Significant speed improvements for large data transfers (Details Here and Here.)
  • Tested and approved for Tomcat 1.6.x
  • Improved Error Messaging.
  • XSLT based directory and error pages allow site administrators to customize Hyrax for visual integration with existing sites. (More Here)

Note: This version of the OLFS is NOT compatible with earlier versions of the BES. It must be used in conjunction with BES version 3.6.0 or newer.

Look at our documentation site for Hyrax release notes.

Binaries

Version 1.4.0
Jar file containing the Web Archive binary and instructions. (gpg signature)
Unpack using: jar -xvf olfs-1.4.0-webapp.jar
Binaries built using Java 5.0 (JVM1.5) and tested on Tomcat 6.0.x
 
SoapTestClient (gpg signature) - A client for testing the prototype SOAP interface.

Source code

Version 1.4.0
source jar (gpg signature)
documentation jar (gpg signature)
SoapTestClient jar (gpg signature)

OLFS 1.3.2 (19 February 2008)

Part of Hyrax release 1.3.1

This release is a bug fix to correct a problem in which data set URLs containing underscores ("_") or spaces (" ") where not being handled correctly.

This release can be installed into Hyrax by:

  • Getting and installing the updates to libdap, the BES, and the data handlers.
  • Getting the jar file containing the webb application.
  • Unpack the file: jar -xvf olfs-1.3.2-webapp.jar
  • In the resulting directory find the file opendap.war and copy it to the webapps directory of your Tomcat installation:

    cp olfs-1.3.2-webapp/opendap.war $CATALINA_HOME/webapps/

  • Restart Tomcat.

Done!

Look at our documentation site for Hyrax release notes.

Binaries

Version 1.3.2
Jar file containing the Web Archive binary and instructions. (gpg signature)
Unpack using: jar -xvf olfs-1.3.1-webapp.jar
Binaries built using Java 5.0 (JVM1.5) and tested on Tomcat 5.5.
 
SoapTestClient (gpg signature) - A client for testing the prototype SOAP interface.

Source code

Version 1.3.2
source jar (gpg signature)
documentation jar (gpg signature)
SoapTestClient jar (gpg signature)

OLFS 1.3.1 (14 November 2007)

Part of Hyrax release 1.3.1

This release includes:

  • Version Update

This release can be installed into Hyrax by:

  • Getting and installing the updates to libdap, the BES, and the data handlers.
  • Getting the jar file containing the webb application.
  • Unpack the file: jar -xvf olfs-1.3.1-webapp.jar
  • In the resulting directory find the file opendap.war and copy it to the webapps directory of your Tomcat installation:

    cp olfs-1.3.1-webapp/opendap.war $CATALINA_HOME/webapps/

  • Restart Tomcat.

Done!

Look at our documentation site for Hyrax release notes.

Binaries

Version 1.3.1
Jar file containing the Web Archive binary and instructions. (gpg signature)
Unpack using: jar -xvf olfs-1.3.1-webapp.jar
Binaries built using Java 5.0 (JVM1.5) and tested on Tomcat 5.5.
 
SoapTestClient (gpg signature) - A client for testing the prototype SOAP interface.

Source code

Version 1.3.1
source jar (gpg signature)
documentation jar (gpg signature)
SoapTestClient jar (gpg signature)

OLFS 1.3.0 (14 November 2007)

Part of Hyrax release 1.3.0

This release includes:

  • Bug fixes
  • Hyrax control script - Simplifies starting and stopping Hyrax when running the BES and the OLFS on the same machine.

This release can be installed into Hyrax by:

  • Getting and installing the updates to libdap, the BES, and the data handlers.
  • Getting the jar file containing the webb application.
  • Unpack the file: jar -xvf olfs-1.3.0-webapp.jar
  • In the resulting directory find the file opendap.war and copy it to the webapps directory of your Tomcat installation:

    cp olfs-1.3.0-webapp/opendap.war $CATALINA_HOME/webapps/

  • Restart Tomcat.

Done!

Look at our documentation site for Hyrax release notes.

Binaries

Version 1.3.0
Jar file containing the Web Archive binary and instructions. (gpg signature)
Unpack using: jar -xvf olfs-1.3.0-webapp.jar
Binaries built using Java 5.0 (JVM1.5) and tested on Tomcat 5.5.
 
SoapTestClient (gpg signature) - A client for testing the prototype SOAP interface.

Source code

Version 1.3.0
source jar (gpg signature)
documentation jar (gpg signature)
SoapTestClient jar (gpg signature)

OLFS 1.2.3 (21 May 2007)

Part of Hyrax release 1.2.1

This minor release corrects a problem with the transmission of 32-bit floating point arrays.

This release can be installed into Hyrax by:

  • Getting the jar file containing the webb application.
  • Unpack the file: jar -xvf olfs-1.2.3-webapp.jar
  • In the resulting directory find the file opendap.war and copy it to the webapps directory of your Tomcat installation:

    cp olfs-1.2.3-webapp/opendap.war $CATALINA_HOME/webapps/

  • Restart Tomcat.

Done!

Look at our documentation site for Hyrax release notes.

Binaries

Version 1.2.3
Jar file containing the Web Archive binary and instructions.
Unpack using: jar -xvf olfs-1.2.3-webapp.jar
Binaries built using Java 5.0 (JVM1.5) and tested on Tomcat 5.5.
 
SoapTestClient - A client for testing the prototype SOAP interface.

Source code

Version 1.2.3
source jar
documentation jar
SoapTestClient jar

OLFS 1.2.2 (1 May 2007)

Part of Hyrax release 1.2.0

This minor release corrects a problem with the DAP version (.ver) response in the OLFS.

This release can be installed into Hyrax by:

  • Getting the jar file containing the webb application.
  • Unpack the file: jar -xvf olfs-1.2.2-webapp.jar
  • In the resulting directory find the file opendap.war and copy it to the webapps directory of your Tomcat installation:

    cp olfs-1.2.2-webapp/opendap.war $CATALINA_HOME/webapps/

  • Restart Tomcat.

Done!

Look at our documentation site for Hyrax release notes.

Binaries

Version 1.2.2
Jar file containing the Web Archive binary and instructions. md5
Unpack using: jar -xvf olfs-1.2.2-webapp.jar
Binaries built using Java 5.0 (JVM1.5) and tested on Tomcat 5.5.
 
SoapTestClient - A client for testing the prototype SOAP interface.

Source code

Version 1.2.2
source jar - md5
documentation jar - md5
SoapTestClient jar

OLFS 1.2.1 (27 April 2007)

Part of Hyrax release 1.2.0

This minor release patches a concurrency problem in the OLFS.

This release can be installed into Hyrax by:

  • Getting the jar file containing the webb application.
  • Unpack the file: jar -xvf olfs-1.2.1-webapp.jar
  • In the resulting directory find the file opendap.war and copy it to the webapps directory of your Tomcat installation:

    cp olfs-1.2.1-webapp/opendap.war $CATALINA_HOME/webapps/

  • Restart Tomcat.

Done!

Look at our documentation site for Hyrax release notes.

Binaries

Version 1.2.1
Jar file containing the Web Archive binary and instructions. md5
Unpack using: jar -xvf olfs-1.2.1-webapp.jar
Binaries built using Java 5.0 (JVM1.5) and tested on Tomcat 5.5.
 
SoapTestClient - A client for testing the prototype SOAP interface.

Source code

Version 1.2.1
source jar - md5
documentation jar - md5
SoapTestClient jar

OLFS 1.2.0 (23 April 2007)

Part of Hyrax release 1.2.0

Look at our documentation site for Hyrax release notes.

We have added two major features:

  • Support for multiple BES's: Data providers may configure a single Hyrax installation to work with multiple BES's.

  • The OLFS dispatch code has been refactored to allow 3rd party dispatch handlers to be added simply by modifying the configuration and adding the java class files to the Tomcat library directory.

ATTENTION:

For those of you that already have Hyrax this change will render your current olfs.xml obsolete. You have two options, either:

Remove the directory $CATALINA_HOME/content/opendap. Restarting Tomcat will cause it to be recreated with a new compatible olfs.xml file.

OR

Copy the file from the web application:

cp $CATALINA_HOME/webapps/opendap/initialContent/olfs.xml $CATALINA_HOME/content/opendap

You will want (need?) to read the new configuration documents to localize your new installation:

 

Binaries

Version 1.2.0
Jar file containing the Web Archive binary and instructions.
Unpack using: jar -xvf olfs-0.1.5-webapp.jar
Binaries built using Java 5.0 (JVM1.5) and tested on Tomcat 5.5.
 
SoapTestClient - A client for testing the prototype SOAP interface.

Source code

Version 1.2.0
source jar, documentation jar.
SoapTestClient jar

OLFS 1.1.1 (19 March 2007)

Partial release 1.1.1 is part of Hyrax release 1.1.0

Look at our documentation site for Hyrax release notes

Binaries

Version 1.1.1
Jar file containing the Web Archive binary and instructions.
Unpack using: jar -xvf olfs-0.1.5-webapp.jar
Binaries built using Java 5.0 (JVM1.5) and tested on Tomcat 5.5.
 
SoapTestClient - A client for testing the prototype SOAP interface.

Source code

Version 1.1.1
documentation jar.
SoapTestClient jar

OLFS 0.1.5 (beta) (9 February 2007)

Release beta-0.1.5, part of Hyrax release 1.0.2

This release features:

  • Bug fixes (Tickets: 767, 784, 789, 793, and others)
  • Partial implementation of logging (Ticket 785)

Binaries

Version 0.1.5
Jar file containing the Web Archive binary and instructions.
Unpack using: jar -xvf olfs-0.1.5-webapp.jar
Binaries built using Java 5.0 (JVM1.5) and tested on Tomcat 5.5.
 
SoapTestClient - A client for testing the prototype SOAP interface.

Source code

Version 0.1.5
documentation jar.
SoapTestClient jar

OLFS 0.1.4 (beta) (6 November 2006)

Release beta-0.1.4

This release adds support for:

  • HTTP/1.1 persistent connections.
  • Improved OPeNDAP directory response.
  • Prototype SOAP Interface.
  • Server UUID on top level directory for improved web searchability.
  • Persistent content (configurations, user supplied documents/web pages, etc.)
  • Improved internal efficency via BES client connection pooling.

 

Binaries

Version 0.1.4 -
binary jar, Built using Java 5.0 (JVM1.5) and tested on Tomcat 5.5.
SoapTestClient

Source code

Version 0.1.4
source jar, documentation jar.
TestClient jar

OLFS 0.1.3 (alpha) (15 September 2006)

Release alpha-0.1.3

This release adds support for:

  • HTTP/1.1 caching - Support for conditional GET using If-Modified-Since and If-Unmodified-Since headers.

  • Peristent Configurations - Now local configurations will not be destroyed when installing new versions of the software.
    Configurations are stored in the $TOMCAT_HOME/content/opendap directory.

  • Advanced THREDDS catalogs - These require thoughtful modification of the catalog.xml file located in the persisent content/configuration directory.

  • A prototype SOAP interface. This is documented at: http://rsg.opendap.org:8090/server-4/templates/soapAPI.html
  • A SoapTestClient that utilizes the prototype SOAP interface

 

Binaries

For all of the jar files, unpack using 'jar -xvf <file>.jar' and follow the instructions in the README file.

Version 0.1.3 -
binary jar (2.6 MB), Built using Java 5.0 (JVM1.5) and tested on Tomcat 5.5.
SOAPTestClient (2.6MB)

Source code

For all of the jar files, unpack using 'jar -xvf <file>.jar' and follow the instructions in the README or index.html files.

Version 0.1.3
source jar (2.6 MB), documentation jar (.3 MB).
SOAPTestClient source code jar (2.6MB)

OLFS 0.1.2 (alpha) (1 July 2006)

Binaries

Version 0.1.2 - Built using Java 5.0 (JVM1.5) and tested on Tomcat 5.5.
Web Archive file (2.6 MB)

Source code

Version 0.1.2
source jar (2.0 MB), documentation jar (1.5 MB).