File: installation.html

package info (click to toggle)
petsc 2.3.2-1
  • links: PTS
  • area: main
  • in suites: etch, etch-m68k
  • size: 77,732 kB
  • ctags: 314,526
  • sloc: ansic: 254,277; python: 26,350; cpp: 18,257; fortran: 15,694; makefile: 11,000; sh: 3,638; xml: 620; csh: 211
file content (572 lines) | stat: -rw-r--r-- 24,219 bytes parent folder | download
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
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
248
249
250
251
252
253
254
255
256
257
258
259
260
261
262
263
264
265
266
267
268
269
270
271
272
273
274
275
276
277
278
279
280
281
282
283
284
285
286
287
288
289
290
291
292
293
294
295
296
297
298
299
300
301
302
303
304
305
306
307
308
309
310
311
312
313
314
315
316
317
318
319
320
321
322
323
324
325
326
327
328
329
330
331
332
333
334
335
336
337
338
339
340
341
342
343
344
345
346
347
348
349
350
351
352
353
354
355
356
357
358
359
360
361
362
363
364
365
366
367
368
369
370
371
372
373
374
375
376
377
378
379
380
381
382
383
384
385
386
387
388
389
390
391
392
393
394
395
396
397
398
399
400
401
402
403
404
405
406
407
408
409
410
411
412
413
414
415
416
417
418
419
420
421
422
423
424
425
426
427
428
429
430
431
432
433
434
435
436
437
438
439
440
441
442
443
444
445
446
447
448
449
450
451
452
453
454
455
456
457
458
459
460
461
462
463
464
465
466
467
468
469
470
471
472
473
474
475
476
477
478
479
480
481
482
483
484
485
486
487
488
489
490
491
492
493
494
495
496
497
498
499
500
501
502
503
504
505
506
507
508
509
510
511
512
513
514
515
516
517
518
519
520
521
522
523
524
525
526
527
528
529
530
531
532
533
534
535
536
537
538
539
540
541
542
543
544
545
546
547
548
549
550
551
552
553
554
555
556
557
558
559
560
561
562
563
564
565
566
567
568
569
570
571
572
<html>
<body BGCOLOR="FFFFFF">

      <table border="0" width="100%">
        <tbody>
          <tr>
            <td width="50%">
            <h1><b><a name="Docs: Installation">Docs:&nbsp;
Installation</a></b></h1>
            </td>
            <td width="50%"><img src="../images/headbang.gif" border="0"
 height="113" width="113"></td>
          </tr>
        </tbody>
      </table>


      <h3>&nbsp; Quick instructions:</h3>
&nbsp; Invoke the following commands from the toplevel PETSc
directory
[using bash shell]&nbsp; <br>
      <div style="margin-left: 40px;"><font color="#ff0000">export
PETSC_DIR=$PWD</font><br>
      </div>
      <div style="margin-left: 40px;"><font color="#ff0000">./config/configure.py
--with-cc=gcc --with-fc=g77 --download-f-blas-lapack=1
--download-mpich=1</font><br>
      </div>
      <div style="margin-left: 40px;"><font color="#ff0000">make all
test</font></div>
      <h3>&nbsp; Detailed instructions:</h3>
      <ul>
        <li><a name="(Windows only)">(MS Windows
only) Install</a> <a href="#Cygwin:">cygwin</a>
package (including <font color="#ff1a8b">make,
python </font>modules<strong></strong>) and use
cygwin shell.<br>
        </li>
        <li>In the directory you wish PETSc installed: <font
 color="#ff0000">gunzip -c <a href="../download/index.html">petsc-2.3.2.tar.gz</a>
| tar -xof -</font></li>
        <li><font color="#ff0000">cd petsc-2.3.2-p0</font></li>
        <li>sh/bash shell:&nbsp;&nbsp; <font color="#ff0000">PETSC_DIR=`pwd`;
export PETSC_DIR</font>
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; (note the
backquote)<br>
csh/tcsh shell:&nbsp; <font color="#ff0000">setenv
PETSC_DIR `pwd`</font></li>
        <li><font color="#ff0000">./config/configure.py</font>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;
(use --help for options)</li>
        <li> <font color="#ff0000">make all</font></li>
        <li><font color="#ff0000">make test</font></li>
        <li>Encounter problems?
          <ul>
            <li> <strong>Read the error message from
./config/configure.py!</strong> </li>
            <ul>
              <li>If you get the message 'No such file or
directory'
try <font color="#ff0000">python config/configure.py</font></li>
              <li><a href="#BLAS/LAPACK"> BLAS and
LAPACK problems</a> </li>
              <li><a href="#MPI:"> MPI problems</a>.
I <a href="#I%20don%27t%20want%20to%20use%20MPI:">Don't
want MPI</a></li>
            </ul>
            <li> Check the <a
 href="http://www.mcs.anl.gov/petsc/petsc-as/documentation/bugreporting.html">
bug-reporting</a> section</li>
          </ul>
        </li>
        <li> <a name="external"></a><a
 href="../miscellaneous/external.html">Optional external
packages</a>
for PETSc to use</li>
        <ul>
          <li><font color="#ff0000">--download-PACKAGE</font>
for example: <span style="color: rgb(255, 0, 0);">--download-mpich</span>
or <span style="color: rgb(255, 0, 0);">--download-hypre</span><br>
          </li>
        </ul>
      </ul>
      </td>
    </tr>
  </tbody>
</table>
<table width="100%">
  <tbody>
    <tr>
      <td valign="top" width="75%">
      <h3><b>Example Usages:</b></h3>
      <ul>
        <li>Examples are at <span style="font-weight: bold;">config/*.py</span>.
We use some of these scripts locally for testing - <span
 style="font-weight: bold;"></span>for example <span
 style="font-weight: bold;">config/linux-gnu-amd64.py</span><br>
        </li>
        <li>Using the bash shell, assuming BLAS,
LAPACK, MPICH are not currently installed <font color="#551a8b">./config/configure.py</font>
will download &amp;
install BLAS, LAPACK, MPICH if they are not already installed on the
system) :<br>
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; <font color="#ff0000">export
PETSC_DIR=/home/petsc/petsc-2.3.2-p0<br>
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;
cd $PETSC_DIR<br>
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;
./config/configure.py
--download-f-blas-lapack=1 --download-mpich=1<br>
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;
make <br>
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;
make test</font></li>
        <li>Same as above - but build Complex version of PETSc [using
c++ compiler]:<br>
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; <font color="#ff0000">export
PETSC_DIR=/home/petsc/petsc-2.3.2-p0<br>
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;
cd $PETSC_DIR<br>
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;
./config/configure.py
--download-f-blas-lapack=1 --download-mpich=1
--with-scalar-type=complex --with-clanguage=cxx<br>
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;
make <br>
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;
make test</font></li>
        <li>Using the bash shell, assuming BLAS,
LAPACK, MPICH software are installed at the specified locations:<br>
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; <font color="#ff0000">export
PETSC_DIR=/home/petsc/petsc-2.3.2-p0<br>
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;
cd $PETSC_DIR<br>
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;
./config/configure.py
--with-blas-lapack-dir=/usr/local/lib --with-mpi-dir=/usr/local/mpich<br>
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;
make <br>
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;
make test</font><font color="#ff0000"> </font></li>
        <li>Using tcsh shell, install PETSc with default BLAS and
LAPACK and no MPI:<br>
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; <font color="#ff0000">setenv
PETSC_DIR /home/petsc/petsc-2.3.2-p0<br>
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;
cd $PETSC_DIR<br>
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;
./config/configure.py
--with-mpi=0<br>
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;
make <br>
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;
make test </font></li>
        <li>Install PETSc with default BLAS, LAPACK and MPI using
the
GNU compilers, build the optimized version of the libraries:<br>
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; <font color="#ff0000">./config/configure.py
--with-vendor-compilers=0<br>
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;
make<br>
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;
make test </font></li>
        <li>Using csh shell, install PETSc on Linux with two
different
sets of compilers:<br>
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; <font color="#ff0000">setenv
PETSC_ARCH linux-gnu<br>
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;
./config/configure.py
--with-vendor-compilers=0 --with-mpi-dir=/usr/local/mpich-gnu<br>
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;
make<br>
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;
make test<br>
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;
setenv PETSC_ARCH
linux-gnu-intel<br>
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;
./config/configure.py
--with-vendor-compilers=intel --with-gnu-compilers=0
--with-blas-lapack-dir=/usr/local/mkl
--with-mpi-dir=/usr/local/mpich-intel<br>
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;
make<br>
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;
make test </font></li>
      </ul>
      <hr>
      <p>Several variables control the configuration and build
process
of PETSc. They can either be given as arguments to <font
 color="#ff0000">make</font> or be set as environment
variables. </p>
      <p><b><a name="PETSC_DIR"><font color="#551a8b">PETSC_DIR</font></a></b>:
- this
environment/make variable should point to the location of the PETSc
installation that is used. You can add <font color="#ff0000">export
PETSC_DIR=value</font> in your .profile or .sh file or <font
 color="#ff0000">setenv PETSC_DIR value</font> in your
.cshrc or
.tcshrc
file. Multiple PETSc versions can coexist on the same
file-system. By changing PETSC_DIR one can switch between the
versions</p>
      <p><b><font color="#551a8b">PETSC_ARCH</font></b>:
this
environment/make variable is used to specify the configuration that
should currently be used. It corresponds to the configuration files
in bmake/${PETSC_ARCH}. Multiple variants of PETSc libraries can be
installed - each variant corresponding to a different PETSC_ARCH. One
can switch between using these variants - by changing the value of
PETSC_ARCH. If PETSC_ARCH is not set, the configuration from the last
time you ran <font style="font-weight: bold;" color="#551a8b">./config/configure.py</font>
will
be used.</p>
      <p><font color="#551a8b"><b><a href="#Docs:%20%20Installation">Return
to Installation Instructions</a>
&nbsp;&nbsp;&nbsp;&nbsp;</b></font> </p>
      <hr>
      <h4><font color="#551a8b"><a name="Cygwin:">Cygwin</a></font> <span
 style="font-weight: 400;">&nbsp;provides
UNIX tools on Microsoft
Windows. When installing Cygwin <font color="#ff0000">make
sure</font>
you install the following additional
packages</span></h4>
      <ul>
        <li> <span style="font-weight: 400;"><font color="#ff0000">make</font></span>
        </li>
        <li> <span style="font-weight: 400;"><font color="#ff0000">python</font></span>
        </li>
      </ul>
      <h4><span style="font-weight: 400;">Cygwin
also has GNU
compilers ( <font color="#ff1a8b">gcc, g++, g77</font>)
which can be
used&nbsp; if Microsoft, Intel, or Borland Group compilers are not
available</span></h4>
      <p>Note: Previously we recommanded doing 'rebaseall' to
avoid
python problems. However 'rebaseall' has its own problems - so if there
any python issues, the current recommendation is to reinstall cygwin
from scratch.<br>
      </p>
      <table style="border-collapse: collapse;" id="AutoNumber1"
 border="1" bordercolor="#111111" cellpadding="0" cellspacing="0"
 width="72%">
        <tbody>
          <tr>
            <td width="23%">&nbsp;Cygwin</td>
            <td width="77%">&nbsp;<a href="http://www.cygwin.com">http://www.cygwin.com</a></td>
          </tr>
        </tbody>
      </table>
      <p><font color="#551a8b"><b><a href="#Docs:%20%20Installation">Return
to Installation Instructions</a>&nbsp;&nbsp;&nbsp;&nbsp;</b></font></p>
      <hr>
      <p><font color="#551a8b"><b><a name="BLAS/LAPACK">BLAS/LAPACK</a>:</b></font>
these packages provide some basic numeric kernels used by PETSc.</p>
      <ul>
        <li>If <font color="#0f0000">./config/configure.py</font>
cannot locate BLAS and LAPACK you can use the options <font
 color="#0f0000">--with-blas-lapack-dir=directory</font>
or <font color="#0f0000">--with-blas-lib=library</font>
and <font color="#0f0000">--with-lapack-lib=library</font>
or <font color="#0f0000">--with-blas-lapack-lib=library</font>
to indicate the
location of the libraries.
          <ul>
            <li>on Microsoft Windows, Linux and Intel based Apple
Macs, one can use <a href="http://www.intel.com/software/products/mkl">Intel
MKL</a></li>
          </ul>
        </li>
        <li>Use the <font color="#0f0000">./config/configure.py</font>
options <font color="#0f0000">--download-f-blas-lapack=yes</font>
or <font color="#0f0000">--download-f-blas-lapack=ifneeded</font>,
then PETSc
will download and install a BLAS and LAPACK for you. <br>
        </li>
        <li>Use <font color="#0f0000">--download-c-blas-lapack
(as
opposed to </font><font color="#0f0000">--download-f-blas-lapack)
only
if there is no fortran compiler.</font></li>
        <li><font color="#0f0000">Sadly, IBM's ESSL
does not have all the private routines of BLAS that some packages, such
as SuperLU expect; in particular slmach, dlmach and xerbla. Therefor
you need to either use </font><font color="#0f0000">--download-f-blas-lapack=yes
or install a copy of BLAS/LAPACK from <a href="http://www.netlib.org">Netlib</a>
instead of using ESSL directly.</font></li>
      </ul>
      <p><font color="#551a8b"><b><a href="#Docs:%20%20Installation">Return
to Installation Instructions</a>&nbsp;&nbsp;&nbsp;&nbsp;</b></font></p>
      <hr>
      <p><font color="#551a8b"><b><a name="MPI:">MPI:</a></b></font>
This software provides the parallel functionality for PETSc. </p>
      <ul>
        <li> If <font color="#0f0000">./config/configure.py</font>
cannot locate MPI you can indicate its location with <font
 color="#0f0000">--with-mpi-dir=directory</font> or <font
 color="#0f0000">--with-mpi-include=directory</font> <font
 color="#0f0000">--with-mpi-lib=libraryname</font> <font
 color="#0f0000">--with-mpirun=pathofmpirun</font> </li>
        <ul>
          <li>On parallel machines, Vendor provided MPI might
already
be installed.&nbsp; IBM, SGI, Cray etc provide their own.&nbsp;</li>
          <li>If vendor provided MPI is not available, it can be
installed from sources. We recommend MPICH</li>
        </ul>
        <li>Use the <font color="#0f0000">./config/configure.py</font>
option <font color="#0f0000">--download-mpich=yes</font>
then PETSc
will download and install MPICH for you. </li>
      </ul>
      <table style="border-collapse: collapse;" id="AutoNumber5"
 border="1" bordercolor="#111111" cellpadding="0" cellspacing="0"
 width="72%">
        <tbody>
          <tr>
            <td width="26%">&nbsp;MPI&nbsp;&nbsp;&nbsp; </td>
            <td width="74%">&nbsp;<a href="http://www.mpi-forum.org">http://www.mpi-forum.org</a></td>
          </tr>
          <tr>
            <td width="26%">&nbsp;MPICH</td>
            <td width="74%">&nbsp;<a
 href="http://www.mcs.anl.gov/mpi/mpich">http://www.mcs.anl.gov/mpi/mpich</a></td>
          </tr>
          <tr>
            <td width="26%">&nbsp;LAM</td>
            <td width="74%">&nbsp;<a href="http://www.lam-mpi.org">http://www.lam-mpi.org</a></td>
          </tr>
          <tr>
            <td width="26%">&nbsp;MPICH-NT (Microsoft
Windows)</td>
            <td width="74%">&nbsp;<a
 href="http://www-unix.mcs.anl.gov/%7Eashton/mpich.nt">http://www-unix.mcs.anl.gov/~ashton/mpich.nt</a></td>
          </tr>
          <tr>
            <td width="26%">&nbsp;MPI/Pro (Microsoft
Windows)</td>
            <td width="74%">&nbsp;<a
 href="http://www.mpi-softtech.com/products/mpi_pro">http://www.mpi-softtech.com/products/mpi_pro</a></td>
          </tr>
          <tr>
            <td width="26%">&nbsp;HPVM (Microsoft
Windows)</td>
            <td width="74%">&nbsp;<a
 href="http://www-csag.ucsd.edu/projects/hpvm.html">http://www-csag.ucsd.edu/projects/hpvm.html</a></td>
          </tr>
          <tr>
            <td width="26%">&nbsp;WMPI (Microsoft
Windows)</td>
            <td width="74%">&nbsp;<a
 href="http://www.criticalsoftware.com/hpc">http://www.criticalsoftware.com/hpc</a></td>
          </tr>
        </tbody>
      </table>
      <p><font color="#551a8b"><b><a href="#Docs:%20%20Installation">Return
to Installation Instructions</a>&nbsp;&nbsp;&nbsp;&nbsp;</b></font> </p>
      <hr>
      <p><font color="#551a8b"><b><a name="I don't want to use MPI:">I
don't want to use MPI:</a></b></font> You can build
(sequential) PETSc
without an MPI.</p>
Run <font color="#ff0000">./config/configure.py
--with-mpi=0 ....</font>
      <p><font color="#551a8b"><b><a href="#Docs:%20%20Installation">Return
to Installation Instructions</a>&nbsp;&nbsp;&nbsp;&nbsp;</b></font> </p>
      <hr>
      <h3><a name="AdditionalMicrosoftWindowsNotes"><font
 color="#551a8b">Additional
Microsoft Windows Notes:</font></a></h3>
      <p><font color="#551a8b"><b>Microsoft Compilers</b></font><font
 color="#551a8b"><b>:</b> </font>Use configure with the following
options to build for Microsoft C/C++ &amp; Compaq Fortran [assuming
MPICH &amp; Intel MLK are already installed in the default locations]<br>
      <font color="#ff0000">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;
./config/configure.py
--with-cc='win32fe cl' --with-fc='win32fe f90'&nbsp;
--with-cxx='win32fe cl'<br>
      </font></p>
      <p>If fortran usage is not required - and you don't have Intel
MLK - just use:<br>
      </p>
      <font color="#ff0000">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;
./config/configure.py --with-cc='win32fe cl' --with-fc=0
--download-c-blas-lapack=1<br>
      </font>
      <p>If fortran usage is required [with Digital/Compaq f90
compiler] - and you don't have Intel
MLK - just use the following [assuming the path to compaq fortran
libraries is correct]:<br>
      </p>
      <font color="#ff0000">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;
./config/configure.py --with-cc='win32fe cl' --with-fc='win32fe f90'
--download-f-blas-lapack=1 LIBS="-L'/cygdrive/c/Program Files/Microsoft
Visual Studio/DF98/LIB'"</font><br>
      <br>
Note the usage of both single quotes and double quotes in the above
line. <br>
      <p><font color="#551a8b"><b>Configure</b></font><font
 color="#551a8b"><b>:</b> </font>--download-package
option does not
work with many external packages [for eg: mpich]</p>
      <p><font color="#551a8b"><b>Project</b></font><font
 color="#551a8b"><b> Files:</b> </font>We
provide
templates for Microsoft Visual Studio project files at
${PETSC_DIR}/projects. These work for us - with our configure build
[config/cygwin-ms.py with MPICH1 and Intel MKL 5], However they will
REQURE MODIFICATIONS to work with a user build of PETSc - as the
locations of packages &amp; configure options used by user could be
different from our defult build. <br>
      </p>
      <p>To get these project files working for your installation of
PETSc, please do the following:<br>
      </p>
      <ul>
        <li>try compiling the example from cygwin shell - using
makefile - for eg: <br>
cd src/ksp/ksp/examples/tutorials<br>
make ex2</li>
        <li>if the above works - then make sure all the
compiler/linker
options used by make are also present in the project file in the
correct notation.<br>
        </li>
        <li>if errors - redo the above step. [if all the options
are
correctly specified - then the example should compile from MSDev.<br>
        </li>
      </ul>
      <p> </p>
      <p><b><font color="#551a8b">Debugger:&nbsp; </font></b>Running
PETSc probrams with -start_in_debugger is not supported on this
platform, so debuggers will need to be initiated manually. Make sure
your environment is properly configured to use the appropriate debugger
for your compiler. The debuggers can be initiated using Microsoft
Visual Studio 6: <b>msdev&nbsp;ex1.exe</b>, Microsoft
Visual Studio
.NET: <b>devenv&nbsp;ex1.exe</b>, Intel Enhanced
Debugger: <b>edb&nbsp;ex1.exe</b>,
or GNU Debugger <b>gdb&nbsp;ex1.exe</b>.</p>
      <p><b><font color="#551a8b">PETSc Win32
front end - win32fe</font>:</b>&nbsp;
This tool is used as a wrapper to Microsoft/ Borland/ Intel compilers
and associated tools - to enable building PETSc libraries using make
and other UNIX tools. For additional info, run
${PETSC_DIR}/bin/win32/win32fe without any options.</p>
      <p><font color="#551a8b"><b><a href="#Docs:%20%20Installation">Return
to Installation Instructions</a>&nbsp;&nbsp;&nbsp;
&nbsp;&nbsp;&nbsp;</b></font> </p>
      <hr>
      <h3 style="font-weight: bold;"><a name="SP"><font color="#551a8b">Installing
on machine requiring job scheduler:</font></a></h3>
      <p>If one has to go through the job scheduler to use MPI on a
given machine - use the configure option <span
 style="font-weight: bold;">'--with-batch=1'</span> as follows:<br>
      </p>
      <ul>
        <li>run configure with the additional option <span
 style="font-weight: bold;">'--with-batch=1' </span>on the <span
 style="font-weight: bold;">frontend node</span> [perhpas with the
additional option <span style="font-weight: bold;">'--with-mpi-shared=0']</span><br>
        </li>
        <li>the above configure run will create a binary <span
 style="font-weight: bold;">'conftest'</span>. Run this binary
'conftest' on <span style="font-weight: bold;">one compute node</span>
using the job scheduler.</li>
        <li>The above run of conftest will create a new python script <span
 style="font-weight: bold;">'reconfigure'</span>. Run <span
 style="font-weight: bold;">'python reconfigure'</span>&nbsp; to
complete the configure process<br>
        </li>
      </ul>
      <h3 style="font-weight: bold;"><a name="SP"><font color="#551a8b">Installing
on IBM SP:</font></a></h3>
To run any code compiled with MPI on IBM SP - one has to
go
through the <span style="font-weight: bold;">job scheduler</span>.&nbsp;
[So follow the instructions from the above section 'Installing on
machine requiring job scheduler']. Alternatively check/run
config/aix5.1.0.0.py for all
configure options
required on the SP with compilers defaulting to 32bit mode, and
config/aix5.1.0.0-64.py with compilers defaulting to 64bit mode.
      <h3 style="font-weight: bold;"><a
 name="AdditionalMicrosoftWindowsNotes"><font color="#551a8b">Installing
on IBM Blue Gene:</font></a></h3>
      <p>IBM Blue Gene [as of now] requires modified compiler
script
wrappers to compile PETSc-2.3.2. Please download <a
 href="ftp://ftp.mcs.anl.gov/pub/petsc/tmp/petsc-bgl-tools.tar.gz">ftp://ftp.mcs.anl.gov/pub/petsc/tmp/petsc-bgl-tools.tar.gz</a>
and follow instructions provided in the <span
 style="font-weight: bold;">README</span> file.</p>
      <h3><a name="AdditionalMicrosoftWindowsNotes"><font
 color="#551a8b">Installing with TAU Instrumentation package:</font></a></h3>
      <p><a
 href="http://www.cs.uoregon.edu/research/paracomp/tau/tautools/">TAU</a>
package and the prerequisite <a
 href="http://www.cs.uoregon.edu/research/paracomp/pdtoolkit/">PDT</a>
packages need to be installed separately. PETSc provides a wrapper
compiler for TAU. This needs to be invoked with the correct information
for the installed TAU and PDT packages. For eg:<br>
      </p>
      <p>&nbsp;<span style="color: rgb(255, 0, 0);">./config/configure.py
--with-mpi-dir=/home/petsc/soft/linux-rh73/mpich-1.2.4 </span><span
 style="color: rgb(255, 0, 0);">--with-fc=0 --with-cxx=0
-PETSC_ARCH=linux-tau -with-cpp=cpp </span><span
 style="color: rgb(255, 0, 0);">--with-cc="`pwd`/bin/taucc.py
-cc=gcc
-pdt_parse=/homes/petsc/soft/linux-rh73/pdtoolkit-2.2b1/linux/bin/cxxparse
-tau_lib_dir=/homes/petsc/soft/linux-rh73/tau-2.11.18/i386_linux/lib"</span><br>
      </p>
      <h3><a name="PythonBindings"><font color="#551a8b">Installing
TOPS components:</font></a></h3>
      <p>To install TOPS components one has to download and
install CCA
Tools.&nbsp; [linux only]<br>
      </p>
      <ul>
        <li>Get the CCA Tools package from <a
 href="http://www.cca-forum.org/download/cca-tools/cca-tools-0.5.9.tar.gz">http://www.cca-forum.org/download/cca-tools/cca-tools-0.5.9.tar.gz</a></li>
        <li>Configure cca-tools using '-with-mpi' option
[prerequisites
might be
Java SDK, c++, mpich1]</li>
        <li>Configure PETSc with C++, babel, ccafe options.
Check config/asterix-tops.py for an example.<br>
        </li>
        <li>Build PETSc libraries &amp; TOPS components with
'make all'<br>
        </li>
        <li>To test&nbsp; do: 'cd src/tops; make examples'<br>
        </li>
      </ul>
      <h3><a name="PythonBindings"><font color="#551a8b">Installing the
Python Bindings:</font></a></h3>
      <p>Currently, the automatic Python installtion works only
for the
developer release. The first step to installing the Python bindings is
to add the following 3 options to your configuration:<br>
&nbsp;&nbsp;&nbsp;&nbsp;<span style="color: rgb(255, 0, 0);">./config/configure
--with-shared --with-dynamic --with-python</span><br>
which will download the source for the bindings into <span
 style="font-weight: bold;"><span style="color: rgb(85, 26, 139);">src/python</span>
      </span>and
make sure that
PETSc can build dynamic libraries for the Python modules. If you have
the relase version, this download can be done manually using:<br>
&nbsp;&nbsp;&nbsp;&nbsp;<span style="color: rgb(255, 0, 0);">mkdir
src/python</span><br>
&nbsp;&nbsp;&nbsp;&nbsp;<span style="color: rgb(255, 0, 0);">cd
src/python</span><br>
&nbsp;&nbsp;&nbsp;&nbsp;<span style="color: rgb(255, 0, 0);">wget
ftp://ftp.mcs.anl.gov/pub/petsc/PETScPython.tar.gz .</span><br>
&nbsp;&nbsp;&nbsp;&nbsp;<span style="color: rgb(255, 0, 0);">tar xvzf
PETScPython.tar.gz</span><br>
After building PETSc, we can build the bindings using:<br>
&nbsp;&nbsp;&nbsp;&nbsp;<span style="color: rgb(255, 0, 0);">make python</span><br>
which will create python modules stored in <span
 style="font-weight: bold;"><span style="color: rgb(85, 26, 139);">lib/PETSC_ARCH/PETSc</span>.</span>
      </p>
      <p><font color="#551a8b"><b><a
 href="installation.html#Docs:%20%20Installation">Return
to Installation Instructions</a>&nbsp;&nbsp;&nbsp; <br>
      </b></font></p>
      <hr> </td>
</body>
</html>