summaryrefslogtreecommitdiffstats
path: root/EFF_INSTALL
blob: f20c6f63c72bad6ff00b85de2887720e961fe38a (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
System pre-requisites: 
	An MPI3 implementation that supports MPI_THREAD_MULTIPLE
            [i.e. MPICH3 or later - we built with MPICH 3.0.2]
	Pthread
	BOOST

build opa:
	It is located in the tarball in the 'openpa' subdirectory, OR get it
        from here: git clone git://git.mcs.anl.gov/radix/openpa.git

	./configure --prefix=/path/to/opa/install/directory
	make
        make check
	make install


build AXE:
	It is located in the tarball in the 'axe' subdirectory, OR get it from
        here: svn checkout https://svn.hdfgroup.uiuc.edu/axe/trunk

	./configure --prefix=/path/to/axe/install/directory --with-opa=/path/to/opa/install/directory
	make
        make check
	make install


build Skeletal IOD:
	It is located in the tarball in the 'iod' subdirectory.

	Copy the 'iodrc' file from the top level iod directory to /etc/iodrc or
        the top-level build directory for HDF5 (e.g. hdf5_ff, if you are
        building "in-place" from the tarball).

	make

	Note the path to the IOD install (for the HDF5 build, below) is
        actually just the path to the top source directory where you build
        IOD (i.e. /path/to/your/copy/of/fastforward/iod).


build Mercury (Function Shipper)
	The code is located in tarball in the 'mercury' directory.

	refer to the mercury build recipe in:
	mercury/README

	Note that static building and the BOOST library are both prerequisites for mercury to work in the HDF5_ff branch.


build HDF5 IOD VOL plugin:
        The code is located in the tarball in the 'hdf5_ff' subdirectory, OR
        get it from here:
            svn checkout http://svn.hdfgroup.uiuc.edu/hdf5/features/hdf5_ff

	./configure --with-iod=/path/to/iod/install/directory --with-axe=/path/to/axe/install/directory PKG_CONFIG_PATH=/path/to/mercury/install/directory/lib/pkgconfig/ --enable-parallel --enable-debug --enable-trace --enable-threadsafe --enable-unsupported --with-pthread=/usr --enable-eff
	make
        make check
	make install

build the example programs:

	The examples are located in hdf5_ff/examples/.
	The client programs are test_client.c, test_client_acg.c 
	The server is test_server.c. 

	cd into hdf5_ff/examples/
	make

	The client and server need to be launched from the same directory for now.
	Launch the server first:
 	mpiexec -n 1 ./test_server
	then launch one of the clients
 	mpiexec -n <x> ./test_client or ./test_client_acg

	The new ACG routines are also tested in the HDF5 main test suite using the native HDF5 file format.
	Those will get executed when you  run make check.
	To manually run those tests, cd into the test directory where you built the branch and run:
	./dsets
	This will run a lot of dataset tests including the append/sequence/set/get operations that we added.

END