The Enhanced OPeNDAP HDF4 Handler Installation Guide

1. First make sure that GNU auto tools are up to date.
   • automake 1.10.1 or above
   • autoconf 2.63 or above
2. Install HDF4 source (version 4.2r4).
   1. tar zxvf HDF4.2r4.tar.gz
   2. cd HDF4.2r4
   3. ./configure --prefix=/usr/local/hdf4
   4. make install
3. (Optional) Install HDF-EOS2 library source (version 2.16).
   1. uncompress HDF-EOS2.16v1.00.tar.Z
   2. tar xvf HDF-EOS2.16v1.00.tar
   3. cd hdfeos
   4. setenv CC /usr/local/hdf4/bin/h4cc
   5. ./configure --prefix=/usr/local/hdfeos2 --with-hdf4=/usr/local/hdf4 --enable-install-include
   6. make install
4. Install libdap source (version 3.9.3).
   1. tar zxvf lbdap-3.9.3.tar.gz
   2. cd libdap-3.9.3
   3. ./configure --prefix=/usr/local/opendap
   4. make install
5. Install BES source (version 3.7.2).
   1. set path = (/usr/local/opendap/bin /usr/local/hdf5/bin $path) # We assume that (t)csh as a current shell.
   2. setenv LD_LIBRARY_PATH /usr/local/opendap/lib::$LD_LIBRARY_PATH # We assume that (t)csh as a current shell.
   3. setenv PKG_CONFIG_PATH /usr/local/opendap/lib/pkgconfig:/usr/lib/pkgconfig # We assume that the system wide package configuration files (*.pc) are under /usr/lib/pkgconfig
   4. tar zxvf bes-3.7.2.tar.gz
   5. cd bes-3.7.2
   6. ./configure --prefix=/usr/local/opendap
   7. make install
6. Install general purpose handler source (version 3.9.3).
   1. tar zxvf dap-server-3.9.3.tar.gz
   2. cd dap-server-3.9.3
   3. setenv PKG_CONFIG_PATH /usr/local/opendap/lib/pkgconfig:/usr/lib/pkgconfig # We assume that the system wide package configuration files (*.pc) are under /usr/lib/pkgconfig
   4. ./configure --prefix=/usr/local/opendap
   5. make install
7. Install the latest hdf4_handler source.
   1. svn co http://scm.opendap.org:8090/svn/trunk/hdf4_handler
   2. cd hdf4_handler
   3. setenv PKG_CONFIG_PATH /usr/local/opendap/lib/pkgconfig:/usr/lib/pkgconfig # We assume that the system wide package configuration files (*.pc) are under /usr/lib/pkgconfig
   4. autoreconf --v
   5. ./configure --prefix=/usr/local/opendap --with-hdf4=/usr/local/hdf4 --enable-cf
   6. (Optional) ./configure --prefix=/usr/local/opendap --with-hdf4=/usr/local/hdf4 --enable-cf --with-hdf-eos2=/usr/local/hdfeos2 # Use this if HDF-EOS2 Library is installed.
   7. (Optional) make check # See 'Testing HD4 Handler with Testsuite' below.
   8. make install

Testing HDF4 Handler with Testsuite

BES Testsuite

• besstandalone -c bes-testsuite/bes.conf -i bes-testsuite/h4/S2000415.HDF.0.bescmd # returns semantic attribute output.
• besstandalone -c bes-testsuite/bes.conf -i bes-testsuite/h4/S2000415.HDF.1.bescmd # returns syntactic structure output.
• besstandalone -c bes-testsuite/bes.conf -i bes-testsuite/h4/S2000415.HDF.2.bescmd # returns XML output that includes both syntactic and semantic output.
• besstandalone -c bes-testsuite/bes.conf -i bes-testsuite/h4/S2000415.HDF.3.bescmd |getdap -M - # returns binary data output in ASCII

Testing with Apache Tomcat server

1. Run bes-dap-data.sh under /usr/local/opendap/bin. This will update /usr/local/opendap/etc/bes/bes.conf file to include the BES ascii/usage/info module.
2. Run bes-hdf4-data.sh under /usr/local/opendap/bin. This will update /usr/local/opendap/etc/bes/bes.conf file to include the BES h4 module.
3. Modify the following parameters in bes.conf file under /usr/local/opendap/etc/bes. BES.ServerAdministrator=username@yoursite.com # Your e-mail address BES.User=username # Output of UNIX "users" command BES.Group=groupname # Output of UNIX "groups" command BES.ServerPort=10002 # (Optional) Change it to other number if you want to run multiple servers. Make sure that following options are enabled. BES.Catalog.catalog.TypeMatch=h5.*\.(he5)(\.gz|\.bz2|\.Z)?$;h5:.*.h5(.bz2|.gz|.Z)?$; BES.modules=dap,cmd,ascii,usage,www,h4 BES.module.dap=/usr/local/opendap/lib/bes/libdap_module.so BES.module.cmd=/usr/local/opendap/lib/bes/libdap_cmd_module.so BES.module.ascii=/usr/local/opendap/lib/bes/libascii_module.so BES.module.usage=/usr/local/opendap/lib/bes/libusage_module.so BES.module.www=/usr/local/opendap/lib/bes/libwww_module.so BES.module.h4=/usr/local/opendap/lib/bes/libhdf4_module.so Please see BES Configuration for other configuration options.

4. Become a super user and start BES server by typing besctl start.
5. Install Apache Tomcat server (version 6.0.16).
6. Download and install OLFS. (version 1.5.2).
   (You may want to compile and install OLFS. Please refer to OLFS Build Instructions for instruction.)
   • If you have installed OLFS before, shutdown TomCat server and remove the old contents first: % rm -rf $tomcat_install_root/webapps/opendap/
   • Put the opendap.war under $tomcat_install_root/webapps.
   • Start Tomcat server. You'll see a new $tomcat_install_root/webapps/opendap directory is created.
   • Shutdown the Tomcat server.
   • Pay attention to BES server port number in webapps/opendap/initialContent/olfs.xml if you changed the BES port in bes.conf file.
7. Start Tomcat by running $tomcat_install_root/bin/startup.sh.
   • If you run multiple Tomcat servers, you need to edit port numbers in $tomcat_install_root/conf/server.xml. <Connector port="8888" protocol="HTTP/1.1" connectionTimeout="20000" redirectPort="8443" /> <!-- A "Connector" using the shared thread pool--> <!-- <Connector executor="tomcatThreadPool" port="8888" protocol="HTTP/1.1" connectionTimeout="20000" redirectPort="8443" /> --> <!-- Define a SSL HTTP/1.1 Connector on port 8443 This connector uses the JSSE configuration, when using APR, the connector should be using the OpenSSL style configuration described in the APR documentation --> <!-- <Connector port="8443" protocol="HTTP/1.1" SSLEnabled="true" maxThreads="150" scheme="https" secure="true" clientAuth="false" sslProtocol="TLS" /> --> From the above example file, change both 8888 and 8443 to other numbers like 8889 and 8444.
8. Copy some HDF4 files under /usr/local/opendap/share/hyrax/data/.
9. Try URL http://your_host_address:your_tomcat_port/opendap/data/ on your web browser.