The Enhanced OPeNDAP HDF4 Handler Installation Guide

1. First make sure that GNU auto tools are the latest.
   • automake
   • autoconf
2. Install HDF4 source .
   1. tar zxvf hdf-4.2.5.tar.gz
   2. cd hdf-4.2.5
   3. ./configure --prefix=/usr/local/hdf4
   4. make install
3. Install HDF-EOS2 library source (version 2.17).
   1. uncompress HDF-EOS2.17v1.00.tar.Z
   2. tar xvf HDF-EOS2.17v1.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.11.0).
   1. tar zxvf lbdap-3.11.0.tar.gz
   2. cd libdap-3.11.0
   3. ./configure --prefix=/usr/local/opendap
   4. make install
5. Install BES source (version 3.9.0).
   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.9.0.tar.gz
   5. cd bes-3.9.0
   6. ./configure --prefix=/usr/local/opendap
   7. make install
6. Install general purpose handler source (version 4.1.0).
   1. tar zxvf dap-server-4.1.0.tar.gz
   2. cd dap-server-4.1.0
   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 hdf4_handler source.
   1. tar zxvf hdf4_handler-3.9.1.tar.gz
   2. cd hdf4_handler-3.9.1
   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 --with-hdf4=/usr/local/hdf4 --with-hdfeos2=/usr/local/hdfeos2 --enable-short-name # Use --with-hdfeos2 option to make OPeNDAP visualization clients work. The --enable-shor-name is optional but useful for some OPeNDAP clients like GrADS.
   5. make install

Testing with Apache Tomcat server

1. 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 h4.conf file exists under /usr/local/opendap/etc/bes/modules directory. Please see BES Configuration for other configuration options.

2. Become a super user and start BES server by typing besctl start.
3. Install Apache Tomcat server.
4. Download and install OLFS. (version 1.7.1).
   (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.
5. 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.
6. Copy some HDF4 files under /usr/local/opendap/share/hyrax/data/.
7. Try URL http://your_host_address:your_tomcat_port/opendap/data/ on your web browser.