mirror of
https://github.com/HDFGroup/hdf5.git
synced 2024-12-03 02:32:04 +08:00
95d86b38c5
Updated the installation instruction for the Tflops machine.
Moved the parallel HDF5 building instructions to the front
and putting in a NOTE that the sequential version is not supported
any more because it has little practical value to build sequential
applications for the Tflops machine.
178 lines
4.5 KiB
Plaintext
178 lines
4.5 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
|
|
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 "--host=i386-intel-osf1" to get rid of the WARNING.
|
|
|
|
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
|
|
|
|
|
|
---------------
|
|
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
|
|
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 "--host=i386-intel-osf1" to get rid of the WARNING.
|
|
|
|
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
|
|
|
|
|