[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.

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
+
+