The Enhanced OPeNDAP HDF4 Handler Installation Guide
This installation guide is for
Hyrax.
- First make sure that GNU auto tools are the latest.
- Install HDF4
source
.
- tar zxvf hdf-4.2.5.tar.gz
- cd hdf-4.2.5
- ./configure --prefix=/usr/local/hdf4
- make install
- Install HDF-EOS2 library
source
(version 2.17).
- uncompress HDF-EOS2.17v1.00.tar.Z
- tar xvf HDF-EOS2.17v1.00.tar
- cd hdfeos
- setenv CC /usr/local/hdf4/bin/h4cc
- ./configure --prefix=/usr/local/hdfeos2 --with-hdf4=/usr/local/hdf4 --enable-install-include
- make install
- Install libdap
source
(version 3.11.0).
- tar zxvf lbdap-3.11.0.tar.gz
- cd libdap-3.11.0
- ./configure --prefix=/usr/local/opendap
- make install
- Install BES source (version 3.9.0).
- set path = (/usr/local/opendap/bin /usr/local/hdf5/bin $path) # We assume that (t)csh as a current shell.
- setenv LD_LIBRARY_PATH /usr/local/opendap/lib::$LD_LIBRARY_PATH # We assume that (t)csh as a current shell.
- 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
- tar zxvf bes-3.9.0.tar.gz
- cd bes-3.9.0
- ./configure --prefix=/usr/local/opendap
- make install
- Install general purpose handler source (version 4.1.0).
- tar zxvf dap-server-4.1.0.tar.gz
- cd dap-server-4.1.0
- 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
- ./configure --prefix=/usr/local/opendap
- make install
- Install hdf4_handler source.
- tar zxvf hdf4_handler-3.9.1.tar.gz
- cd hdf4_handler-3.9.1
- 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
- ./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.
- make install
Testing with Apache Tomcat server
- 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.
- Become a super user and start BES server by typing besctl start.
- Install Apache Tomcat server.
- 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.
- 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.
From the above example file, change both 8888 and 8443 to other numbers like 8889 and 8444.
- Copy some HDF4 files under /usr/local/opendap/share/hyrax/data/.
- Try URL http://your_host_address:your_tomcat_port/opendap/data/ on your web browser.
Last Updated: 2011.04.05