summaryrefslogtreecommitdiffstats
path: root/release_docs/INSTALL_TFLOPS
diff options
context:
space:
mode:
authorElena Pourmal <epourmal@hdfgroup.org>2001-07-05 16:36:40 (GMT)
committerElena Pourmal <epourmal@hdfgroup.org>2001-07-05 16:36:40 (GMT)
commitb2375a85c1c68cc6a19f92055d8d8ed24b2c5d90 (patch)
tree9a4da05ee3d6ffda29953a205526df2b66e5499d /release_docs/INSTALL_TFLOPS
parentcf5d06ef3645e19991c573b988cedd662796d0e3 (diff)
downloadhdf5-b2375a85c1c68cc6a19f92055d8d8ed24b2c5d90.zip
hdf5-b2375a85c1c68cc6a19f92055d8d8ed24b2c5d90.tar.gz
hdf5-b2375a85c1c68cc6a19f92055d8d8ed24b2c5d90.tar.bz2
[svn-r4114]
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_TFLOPS163
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
+
+