mirror of
https://github.com/HDFGroup/hdf5.git
synced 2024-11-27 02:10:55 +08:00
b2375a85c1
Purpose:
Maintenance
Description:
Source directory has been rearranged. INSTALL*, HISTORY.txt and RELEASE.txt were moved to the release_docs directory. *.zip files were moved to the windows directory. README file was renamed to README.txt MANIFEST was updated to reflect those changes.
164 lines
3.7 KiB
Plaintext
164 lines
3.7 KiB
Plaintext
|
|
FOR THE INTEL TFLOPS MACHINE:
|
|
|
|
Below are the step-by-step procedures for building, testing, and
|
|
installing both the sequential and parallel versions of the HDF5 library.
|
|
|
|
-----------------
|
|
Software locations
|
|
------------------
|
|
The zlib compression library is installed in /usr/community/hdf5/ZLIB.
|
|
The mpich library, including mpi-io support, is in
|
|
/usr/community/mpich/mpich-1.2.0.
|
|
|
|
---------------
|
|
Sequential HDF5:
|
|
---------------
|
|
|
|
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 tflop
|
|
Due to a bug, you need to patch up two Makefile, src/Makefile and
|
|
test/Makefile, before the next step. You can use the following
|
|
shell commands.
|
|
|
|
# Patch up various Makefile's.
|
|
# patch up src/Makefile
|
|
echo "patching src/Makefile"
|
|
ed - src/Makefile <<'EOF'
|
|
/^LT_RUN=.*/s//LT_RUN=$(RUNTEST)/
|
|
w
|
|
q
|
|
EOF
|
|
|
|
# patch up test/Makefile
|
|
echo "patching test/Makefile"
|
|
ed - test/Makefile <<'EOF'
|
|
/^RUNTEST=$(LT_RUN)/s/^/#/
|
|
w
|
|
q
|
|
EOF
|
|
|
|
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
|
|
|
|
|
|
---------------
|
|
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.0/bin/mpicc ./configure tflop
|
|
Due to a bug, you need to patch up two Makefile, src/Makefile and
|
|
test/Makefile, before the next step. You can use the following
|
|
shell commands.
|
|
|
|
# Patch up various Makefile's.
|
|
# patch up src/Makefile
|
|
echo "patching src/Makefile"
|
|
ed - src/Makefile <<'EOF'
|
|
/^LT_RUN=.*/s//LT_RUN=$(RUNTEST)/
|
|
w
|
|
q
|
|
EOF
|
|
|
|
# patch up test/Makefile
|
|
echo "patching test/Makefile"
|
|
ed - test/Makefile <<'EOF'
|
|
/^RUNTEST=$(LT_RUN)/s/^/#/
|
|
w
|
|
q
|
|
EOF
|
|
|
|
|
|
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
|
|
|
|
|