summaryrefslogtreecommitdiffstats
path: root/release_docs/INSTALL_TFLOPS
blob: 7b158d35d4ae87387d84980e80b7a274bfe84368 (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
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 --host=i386-intel-osf1
   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 --host=i386-intel-osf1
   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