-
Notifications
You must be signed in to change notification settings - Fork 7
/
INSTALL
110 lines (69 loc) · 3.79 KB
/
INSTALL
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
MRNet: A Multicast/Reduction Network
http://www.paradyn.org/mrnet/
LICENSE contains the usage terms for MRNet.
Complete documentation may be found at http://www.paradyn.org/mrnet.
1. SUPPORTED PLATFORMS
MRNet is designed to be a highly-portable system. It should build
effortlessly with recent GNU compilers, as well as native compilers.
See the README for the latest list of platforms on which we have
built and successfully tested MRNet.
2. SYSTEM REQUIREMENTS
The third party tools that MRNet needs to build properly are:
- GNU make
3. Build Configuration
MRNet uses GNU autoconf to discover the platform specific configuration
parameters. The script that does this auto-configuration is called configure.
Invoking configure as follows shows all possible options.
prompt> ./configure --help
Below, we describe the MRNet-specific options.
--enable-ltwt-threadsafe Build threasafe version of lightweight MRNet
and XPlat libraries.
--enable-verbosebuild Display commands used during build and install.
--with-boost=DIR Absolute path to installation of Boost C++ libraries.
Specify the path to the directory containing
"include" and "lib" sub-directories.
--with-startup=METHOD Tree instantiation method - "ssh" (default)
"cray_xt"
The following options are only applicable to Cray systems.
--with-alpstoolhelp-lib=DIR Absolute path to directory containing
libalps library.
--with-alpstoolhelp-inc=DIR Absolute path to directory containing
libalps.h header file.
Users may additionally specify certain compilation and linking settings by
supplying values for common make variables. For example,
prompt> ./configure CXX=g++
instructs the configure script to use g++ for the C++ compiler
4. Compilation and Installation
For this discussion, $MRNET_ROOT is the location of the top-level directory
of the MRNet distribution and $MRNET_ARCH is a string describing the platform
(OS and architecture) as discovered by autoconf. For all instructions, it is
assumed that the current working directory is $MRNET_ROOT.
* To build the MRNet toolkit:
prompt> cd build/$MRNET_ARCH
prompt> make
After a successful build, the following files will be present:
bin/mrnet_commnode : MRNet communication process
bin/mrnet_topgen : MRNet topology file generator
bin/mrnet_tests.sh : MRNet test harness
lib/libmrnet.[a,so] : MRNet API library
lib/libmrnet_lightweight.[a,so] : Lightweight MRNet backend library
lib/libmrnet_lightweight_r.[a,so] : Lightweight MRNet backend library (threadsafe)
lib/libxplat.[a,so] : Cross-Platform library
lib/libxplat_lightweight.[a,so] : Lightweight Cross-Platform library
lib/libxplat_lightweight_r.[a,so] : Lightweight Cross-Platform library (threadsafe)
* To build the standard MRNet tests:
prompt> cd build/$MRNET_ARCH
prompt> make tests
* To build the MRNet examples:
prompt> cd build/$MRNET_ARCH
prompt> make examples
* To install the MRNet toolkit:
prompt> cd build/$MRNET_ARCH
prompt> make install
prompt> make install-examples (Optional: install example programs)
prompt> make install-tests (Optional: install test programs)
5. Bugs, Questions and Comments
MRNet is maintained by the Paradyn Project, University of Wisconsin-Madison.
Comments and other feedback whether positive or negative are welcome.
Please report bugs to [email protected].
The MRNet webpage is http://www.paradyn.org/mrnet/