[Top] [Prev]

Appendix B HDF Installation Overview

B.1 General HDF Installation Overview

B.1.1 Acquiring the HDF Library Source

You may obtain HDF via FTP, an archive server, or US mail.

FTP server: If you are connected to Internet (NSFNET, ARPANET, MILNET, etc.) you may download HDF source code at no charge from the anonymous ftp server at NCSA. The Internet address of the server is:

	ftp.ncsa.uiuc.edu or 141.142.3.135 
Note: the IP address has been changed from 141.142.20.50 to 141.142.3.135. Log in by entering anonymous for the name and your local e-mail address ("login@host") for the password.

After logging in change directory to "HDF/HDF_Current/". If you want packed source code, change directory to "tar/", "hqx/", or "zip/". Files in those directories must be transferred using binary mode.

If you want unpacked source code, change directory to "unpacked/" and transfer all the files in unpacked/ and in its subdirectories to your host.

If you have any questions regarding this procedure or whether you are connected to Internet, consult your local system administration or network expert.

We have set up an HDF anonymous FTP server to mirror what is on the FTP server. The internet address of the HDF server is:

 	hdf.ncsa.uiuc.edu (141.142.21.14)
If you try to log on to NCSA's ftp server and receive the message saying too many users are connected to NCSA ftp, try this HDF ftp server.

B.1.2 Building the HDF Library Source

For instructions on building HDF from the source code, please refer to the INSTALL file in the top directory of the HDF source tree.

B.2 Instructions for Compiling an HDF Application

Please refer to the file ./release_notes/compile.txt for information on compiling an HDF application. The directory release_notes can be found in the top directory of the HDF source code tree, as well as in the top directory of the pre-compiled binary version on each platform.

B.3 Use of the Pablo Instrumentation of HDF

This version of the distribution has support for creating an instrumented version of the HDF library (libdf-inst.a). This library, along the Pablo performance data capture libraries, can be used to gather data about I/O behavior and procedure execution times.

More detailed documentation on how to use the instrumented version of the HDF library with Pablo can be found in the Pablo directory '$(toplevel)/hdf/pablo'. See the provided '$(toplevel)/hdf/pablo/README.Pablo' and the Postscript file '$(toplevel)/hdf/pablo/Pablo.ps'.

To enable the creation of an instrumented library the following section in the makefile fragment($(toplevel)/config/mh-<os>) must be uncommented and set.




	# ------------ Macros for Pablo Instrumentation  --------------------
	# Uncomment the following lines to create a Pablo Instrumentation
	# version of the HDF core library called 'libdf-inst.a'
	# See the documentation in the directory 'hdf/pablo' for further
	# information about Pablo and what platforms it is supported on
	# before enabling.
	# You need to set 'PABLO_INCLUDE' to the Pablo distribution
	# include directory to get the files 'IOTrace.h' and 'IOTrace_SD.h'.
	#PABLO_FLAGS  = -DHAVE_PABLO
	#PABLO_INCLUDE = -I/hdf2/Pablo/Instrument.HP/include
After setting these values you must re-run the top-level 'configure' script. Make sure that your start from a clean re-build(i.e. 'make clean') after re-running the toplevel 'configure' script and then run 'make'. Details on running configure can be found in the section 'General Configuration/Installation - Unix' found in the top-level installation file '$(toplevel)/INSTALL'.



[Top] [Prev]

hdfhelp@ncsa.uiuc.edu
HDF User's Guide - 07/21/98, NCSA HDF Development Group.