mirror of
https://github.com/HDFGroup/hdf5.git
synced 2024-11-27 02:10:55 +08:00
156 lines
4.4 KiB
Plaintext
156 lines
4.4 KiB
Plaintext
FOR THE INTEL TFLOPS MACHINE:
|
|
|
|
Below are the step-by-step procedures for building, testing, and
|
|
installing the parallel and sequential versions of the HDF5 library.
|
|
|
|
-----------------
|
|
Software locations
|
|
------------------
|
|
The zlib compression library is installed in /usr/community/hdf5/ZLIB.
|
|
The latest version is zlib v1.1.3.
|
|
The mpich library, including mpi-io support, is in /usr/community/mpich/.
|
|
The latest version used is mpich-1.2.3.
|
|
|
|
---------------
|
|
Parallel HDF5:
|
|
---------------
|
|
|
|
The setup process for building the parallel version of the HDF5 library for the
|
|
ASCI Red machine is very similar to the sequential version. Since TFLOPS
|
|
does not support MPIO, we have prepared a shell-script file that configures
|
|
with the appropriate MPI library.
|
|
|
|
Assuming you have already unpacked the HDF5 tar-file into the
|
|
directory <hdf5>, follow the steps below:
|
|
FROM SASN100,
|
|
|
|
1) cd <hdf5>
|
|
|
|
2) CC=/usr/community/mpich/mpich-1.2.3/bin/mpicc \
|
|
./configure --host=i386-intel-osf1 --with-zlib=/usr/community/hdf5/ZLIB
|
|
|
|
Skip the "--with-zlib=..." option if you do not wish to include the zlib
|
|
compression feature. Without the zlib compression feature, the library
|
|
will not be able to access zlib compressed datasets.
|
|
|
|
You may safely ignore the WARNING message,
|
|
=========
|
|
configure: WARNING: If you wanted to set the --build type, don't use --host.
|
|
If a cross compiler is detected then cross compile mode will be used.
|
|
=========
|
|
You may add the option "--build=i386-intel-osf1" to get rid of the WARNING.
|
|
|
|
(The previous bugs in src/Makefile and test/Makefile have been resolved.
|
|
You don't need to edit them any more.)
|
|
|
|
3) make H5detect
|
|
|
|
|
|
FROM JANUS,
|
|
|
|
4) cd <hdf5>
|
|
|
|
5) make H5Tinit.c
|
|
|
|
|
|
FROM SASN100,
|
|
|
|
6) make
|
|
|
|
|
|
When everything is finished compiling and linking,
|
|
FROM JANUS,
|
|
|
|
7) make check
|
|
Sometimes the "make check" fails in the sub-directories of test
|
|
or tools with a message as "print not found". This is due to the
|
|
"make" of Janus thinking some binary code needs to be recompiled.
|
|
The easiest way to fix it is
|
|
FROM SASN100
|
|
cd <hdf5>/test # or cd <hdf5>/tools
|
|
make clean; make # re-make all binary
|
|
|
|
|
|
Once satisfied with the parallel test results, as long as you
|
|
have the correct permission,
|
|
FROM SASN100,
|
|
|
|
8) make install
|
|
|
|
|
|
---------------
|
|
Sequential HDF5:
|
|
---------------
|
|
(**NOTE** We have stopped testing sequential HDF5 for the Tflops machine
|
|
since it has little practical value to build sequential applications for
|
|
the Tflops machine. The instruction below are kept more for historical
|
|
purpose.)
|
|
|
|
The setup process for building the sequential HDF5 library for the
|
|
ASCI Red machine is done by a coordination of events from sasn100 and
|
|
janus. Though janus can do compiling, it is better to build it
|
|
from sasn100 which has more complete building tools and runs faster.
|
|
It is also anti-social to tie up janus with compiling. The HDF5 building
|
|
requires the use of janus because one of steps is to execute a program
|
|
to find out the run-time characteristics of the TFLOPS machine.
|
|
|
|
Assuming you have already unpacked the HDF5 tar-file into the
|
|
directory <hdf5>, follow the steps below:
|
|
|
|
FROM SASN100,
|
|
|
|
1) cd <hdf5>
|
|
|
|
2) ./configure --host=i386-intel-osf1 --with-zlib=/usr/community/hdf5/ZLIB
|
|
|
|
Skip the "--with-zlib=..." option if you do not wish to include the zlib
|
|
compression feature. Without the zlib compression feature, the library
|
|
will not be able to access zlib compressed datasets.
|
|
|
|
You may safely ignore the WARNING message,
|
|
=========
|
|
configure: WARNING: If you wanted to set the --build type, don't use --host.
|
|
If a cross compiler is detected then cross compile mode will be used.
|
|
=========
|
|
You may add the option "--build=i386-intel-osf1" to get rid of the WARNING.
|
|
|
|
(The previous bugs in src/Makefile and test/Makefile have been resolved.
|
|
You don't need to edit them any more.)
|
|
|
|
3) make H5detect
|
|
|
|
|
|
FROM JANUS,
|
|
|
|
4) cd <hdf5>
|
|
|
|
5) make H5Tinit.c
|
|
|
|
|
|
FROM SASN100,
|
|
|
|
6) make
|
|
|
|
|
|
When everything is finished compiling and linking,
|
|
you can run the tests by
|
|
FROM JANUS,
|
|
|
|
7) make check
|
|
Sometimes the "make check" fails in the sub-directories of test
|
|
or tools with a message as "print not found". This is due to the
|
|
"make" of Janus thinking some binary code needs to be recompiled.
|
|
The easiest way to fix it is
|
|
FROM SASN100
|
|
cd <hdf5>/test # or cd <hdf5>/tools
|
|
make clean; make # re-make all binary
|
|
|
|
|
|
Once satisfied with the test results, you can install
|
|
the software by
|
|
FROM SASN100,
|
|
|
|
8) make install
|
|
|
|
|