summaryrefslogtreecommitdiffstats
path: root/release_docs/INSTALL_Windows_MPICH.txt
blob: 124144010a590af54c1fdb0715f47f2454c34ec5 (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
************************************************************************
  Building instructions for HDF5 with MPICH on Windows
************************************************************************

Preconditions:
------------------------------------------------------------------------

1. Installed MPICH for Windows. These instructions assume you have MPICH in C:\MPICH

   To install MPICH for Windows see
   http://www-unix.mcs.anl.gov/mpi/mpich/mpich-nt/

2. Installed HDF5 with multi-treaded DLL support. To install HDF5 with multi-treaded DLL
   see /release_docs/INSTALL_Windows.txt
  

Build HDF5 with MPICH
------------------------------------------------------------------------

These instructions explain how to build the following projects that use the MPICH
library in HDF5:

1. testphdf5. Tests the HDF5 interface to MPICH
2. t_mpi. Tests some MPICH functions
3. ph5diff. Runs the h5diff tool in parallel mode

To run these projects in Windows do:

1. Define the following environment variable: 

        HDF5_EXT_MPICH

        as

        mpich.lib

   For instructions about defining environment variables see /release_docs/INSTALL_Windows.txt
        
2. Open the \hdf5\windows\proj\all\all.dsw workspace. 
     
3. Load each one of the above projects to the workspace. To load a project, 
   right click on the root workspace icon and menu select 'Insert Project into Workspace'
   The projects are located in \hdf5\windows\testpar

4. Add the following additional include and library directories to the Visual Studio environment

   C:\MPICH\SDK\Include
   C:\MPICH\SDK\Lib 

   This can be done either globally in the menu Tools/Options/Directories 
   or for each one of the projects hdf5dll, libtestD and toolslibD only (under the C++/Preprocessor 
   tab dialog)
        
5. Add dependencies of hdf5dll, libtestD  to each of the following projects: 

	testphdf5
	t_mpi
        ph5diff


    For ph5diff, dependencies should also include toolslibD.

6. Before building each one of those projects, hdf5/src/h5pubconf.h has to be modified 
    to have parallel on windows enabled. For this uncomment the following line
   
    #define H5_HAVE_PARALLEL 

7. Manually build hdf5dll, libtestD, toolslibD, testphdf5, t_mpi, ph5diff

Note regarding testing the projects and HDF5 multi-threaded DLL installation
------------------------------------------------------------------------

Since the hdf5dll, libtestD, toolslibD projects were rebuild in step 7 they have to be reinstalled,
that is, copied to the Windows system folder.
For more details see /release_docs/INSTALL_Windows.txt.

-----------------------------------------------------------------------

Need further assistance, email hdfhelp@ncsa.uiuc.edu