diff options
author | Elena Pourmal <epourmal@hdfgroup.org> | 2001-07-05 15:51:25 (GMT) |
---|---|---|
committer | Elena Pourmal <epourmal@hdfgroup.org> | 2001-07-05 15:51:25 (GMT) |
commit | 6d7917d341e0c2a1a96e55f94f6d14c65e0266e9 (patch) | |
tree | f6ce17b3c29f0bd3db388648fbd655528c3288bc /release_docs/INSTALL_TFLOPS | |
parent | e6379c6d3da0e9b81e3a1a14fbf64c2043fbc972 (diff) | |
download | hdf5-6d7917d341e0c2a1a96e55f94f6d14c65e0266e9.zip hdf5-6d7917d341e0c2a1a96e55f94f6d14c65e0266e9.tar.gz hdf5-6d7917d341e0c2a1a96e55f94f6d14c65e0266e9.tar.bz2 |
[svn-r4112]
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.
Diffstat (limited to 'release_docs/INSTALL_TFLOPS')
-rw-r--r-- | release_docs/INSTALL_TFLOPS | 163 |
1 files changed, 163 insertions, 0 deletions
diff --git a/release_docs/INSTALL_TFLOPS b/release_docs/INSTALL_TFLOPS new file mode 100644 index 0000000..a05ef7f --- /dev/null +++ b/release_docs/INSTALL_TFLOPS @@ -0,0 +1,163 @@ + +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 + + |