[svn-r1557] INSTALL:

    Edited for 1.2.0beta release.
INSTALL.ascired:
    Updated with simplified steps.
INSTALL_parallel:
    Updated with information that was in INSTALL and INSTALL.parallel.
INSTALL_parallel.ascired:
    Removed old setup no longer needed.
    RUNPARALEL, RUNSERIAL, disable-shared are specified in config/intel-osf1.
README:
    Update mailing list subscription instruction.
RELEASE:
    Updated for 1.2.0beta release information.
INSTALL_Windows.txt:
    Contains Windows platform installation instructions.
INSTALL.parallel:
    Removed because its content has been moved to INSTALL_parallel.

1 files changed, 38 insertions, 64 deletions

diff --git a/INSTALL.ascired b/INSTALL.ascired
index cd11de0..43dea2a 100644
--- a/INSTALL.ascired
+++ b/INSTALL.ascired
@@ -10,51 +10,51 @@ 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.  Special effort must be made to move the compiled and linked
-testers to disks local to the processors for execution.  This special
-effort is shown here at steps 9) and steps 10).
+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.
 
-The total required steps are something similar to:
-FROM SASN100,
-
-1) uncompress hdf5-1.1.0.tar.Z
+Assuming you have already unpacked the HDF5 tar-file into the 
+directory <hdf5>, follow the steps below:
 
-2) tar xvf hdf5-1.1.0.tar
+FROM SASN100,
 
-3) cd ./hdf5
+1) cd <hdf5>
 
-4) ./configure tflop
+2) ./configure tflop
 
-5) make H5detect
+3) make H5detect
 
 
 FROM JANUS, 
 
-6) cd ./hdf5
+4) cd <hdf5>
 
-7) make H5Tinit.c
+5) make H5Tinit.c
 
 
 FROM SASN100,
 
-8) make >&! comp.out &
+6) make
 
 
 When everything is finished compiling and linking,
+you can run the tests by
 FROM JANUS, 
 
-9) cp -r ../hdf5 /scratch
+7.1) Due to a bug, you must first remove the following line from
+     the file test/Makefile before the next step.
+     RUNTEST=$(LT_RUN)
+7.2) make check 
 
-10) cd /scratch/hdf5/test
 
-11) make test >&! test.out
-
-
-Once satisfied with the test results, as long as you 
-have the correct permission,
+Once satisfied with the test results, you can install
+the software by
 FROM SASN100,
 
-12) make install
+8) make install
 
 
 ---------------
@@ -62,72 +62,46 @@ 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.  It is done by a
-coordination of events from sasn100 and janus.  Special effort must be made to
-move the compiled and linked single processor testers to disks local to the
-processor for execution.  This special effort is shown here at steps 9) and
-steps 10).  Following these test, there are the edit, compile, link, and
-execution of parallel tests described in steps 12) through 16).
+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.
 
-
-The total required steps are something similar to:
+Assuming you have already unpacked the HDF5 tar-file into the 
+directory <hdf5>, follow the steps below:
 FROM SASN100,
 
-1) uncompress hdf5-1.1.0.tar.Z
-
-2) tar xvf hdf5-1.1.0.tar
-
-3) cd ./hdf5
+1) cd <hdf5>
 
-4) sh INSTALL_parallel.ascired   /* this is different from the sequential version */
+2) sh INSTALL_parallel.ascired   /* this is different from the sequential version */
 
-5) make H5detect
+3) make H5detect
 
 
 FROM JANUS, 
 
-6) cd ./hdf5
+4) cd <hdf5>
 
-7) make H5Tinit.c
+5) make H5Tinit.c
 
 
 FROM SASN100,
 
-8) make >&! comp.out &
+6) make
 
 
 When everything is finished compiling and linking,
 FROM JANUS, 
 
-9) cp -rp ../hdf5 /scratch
-
-10) cd /scratch/hdf5/test
-
-11) make test >&! test.out
-
-
-Once satisfied with the single processor test results, 
-FROM SASN100,
-
-12) cd testpar
-
-13) go through the README file.
-
-14) make -f Makefile.ascired
-
-
-When everything is finished compiling and linking,
-FROM JANUS, 
-
-15) cd ./hdf5/testpar
-
-16) make test -f Makefile.ascired >&! test.out
+7.1) Due to a bug, you must first remove the following line from
+     the file test/Makefile before the next step.
+     RUNTEST=$(LT_RUN)
+7.2) make check 
 
 
 Once satisfied with the parallel test results, as long as you 
 have the correct permission,
 FROM SASN100,
 
-17) make install
+8) make install