@@ -13,24 +13,26 @@ Dependent Packages
1313 Table 1. STAT Dependent Packages
1414 Package What It Does
1515 Package Web Page
16- Graphlib version 2 .0 or greater Graph creation, merging, and
16+ Graphlib version 3 .0 or greater Graph creation, merging, and
1717 export
18- https://github.com/lee218llnl/STAT /
18+ https://github.com/LLNL/graphlib /
1919 Launchmon Scalable daemon co-location
20- http ://sourceforge.net/projects/launchmon/
20+ https ://github.com/LLNL/LaunchMON
2121 Libdwarf Debug information parsing (Required by StackWalker)
22- http ://reality.sgiweb.org/davea /dwarf.html
22+ https ://www.prevanders.net /dwarf.html
2323 MRNet version 3.0 or greater Scalable multicast and reduction
2424 network
25- http ://www.paradyn.org/mrnet/
25+ https ://github.com/dyninst/mrnet
2626 StackWalker Lightweight stack trace sampling
27- http ://www.paradyn.org/html/downloads.html
27+ https ://github.com/dyninst/dyninst
2828
2929 In addition, the STAT GUI requires Python with PyGTK, both of
3030 which are commonly preinstalled with many Linux operating
3131 systems. The Pygments Python module can optionally be installed
3232 to allow the STAT GUI to perform syntax highlighting of source
33- code.
33+ code. The STAT GUI also requires SWIG to generate Python
34+ wrappers for STAT's core functionality. Another GUI requirement
35+ is the Graphviz package to render the DOT format graph files.
3436
3537 STAT can also be optionally built with the Fast Global File
3638 Status (FGFS) library. This library helps STAT identify when a
@@ -40,23 +42,30 @@ Dependent Packages
4042 STAT frontend and distribute its contents to the daemons via
4143 the MRNet communication tree. The two necessary components of
4244 FGFS can be downloaded from
43- https://github.com/dongahn /MountPointAttributes and
44- https://github.com/dongahn /FastGlobalFileStatus
45+ https://github.com/LLNL /MountPointAttributes and
46+ https://github.com/LLNL /FastGlobalFileStatus
4547 __________________________________________________________
4648
4749Installation
4850
4951 A script that downloads and installs STAT and all its
5052 dependencies for BlueGene/Q has been created and can be
5153 downloaded at
52- https://github.com/lee218llnl /STAT/blob/master/script-stat-inst
53- all or can be found in the top-level directory of the STAT
54- source. Note this script was developed for BlueGene/Q systems,
55- but can be used as guidance for other systems as well.
54+ https://github.com/LLNL /STAT/blob/master/script-stat-install or
55+ can be found in the top-level directory of the STAT source.
56+ Note this script was developed for BlueGene/Q systems, but can
57+ be used as guidance for other systems as well.
5658
5759 STAT and its dependencies can also be built via the Spack
5860 package management tool, available at
59- http://scalability-llnl.github.io/spack/index.html.
61+ https://github.com/LLNL/spack. Running spack install stat
62+ should build STAT and all of its dependencies, including those
63+ require for the STAT GUI. Note that two Spack variants exist.
64+ The first is +examples, to enable building example MPI code
65+ that STAT can be tested against. This is disabled by default to
66+ avoid requiring an MPI library, but enabling it will trigger a
67+ build of MPI. The second is +dysect to enable building of the
68+ DySectAPI.
6069
6170 When building STAT itself, first run configure. You will need
6271 to use the --with-package options to specify the install prefix
@@ -74,8 +83,9 @@ Installation
7483 --with-launchmon and --with-mrnet configure options, thus it is
7584 important to specify both of these even if they share a prefix.
7685
77- STAT will try to build the GUI by default. If you need to
78- modify your PYTHONPATH envirnment variable to search for side
86+ STAT will try to build the GUI by default. Building and running
87+ the STAT GUI requires SWIG and pygtk. If you need to modify
88+ your PYTHONPATH envirnment variable to search for side
7989 installed site-packages, you can do this by specifying
8090 STAT_PYTHONPATH=path during configure. This will add the
8191 appropriate directory to the $PYTHONPATH environment variable
@@ -98,15 +108,15 @@ Installation
98108 work out of the box, but it provides good guidance on the steps
99109 required.
100110
101- To compile on Cray systems, specify --with-cray-xt. An example
102- configure line for Cray:
111+ To compile on Cray systems runnig alps, you no longer need to
112+ specify --with-cray-alps. An example configure line for Cray:
103113
104114./configure --with-launchmon=/tmp/work/lee218/install \
105115--with-mrnet=/tmp/work/lee218/install \
106116--with-graphlib==/tmp/work/lee218/install \
107117--with-stackwalker=/tmp/work/lee218/install \
108118--with-libdwarf=/tmp/work/lee218/install \
109- --prefix=/tmp/work/lee218/install --with-cray-xt \
119+ --prefix=/tmp/work/lee218/install \
110120MPICC=cc MPICXX=CC MPIF77=ftn --enable-shared LD=/usr/bin/ld
111121
112122 Note that specifying LD=/usr/bin/ld may be required on Cray
@@ -123,13 +133,12 @@ make install
123133 Note that STAT hardcodes the paths to its daemon and filter
124134 shared object, assuming that they are in $prefix/bin and
125135 $prefix/lib respectively, thus testing should be done in the
126- install prefix after running "make install" and the
127- installation directory should not be moved. The path to these
128- components can, however, be overridden with the --daemon and
129- --filter arguments. Further, the STAT_PREFIX environment
130- variable can be defined to override the hardcoded paths in
131- STAT. STAT will also, by default, add rpaths to dependent
132- libraries. This behavior can be disabled by specifying
133- "--with-rpath=no". However, when doing so, you must be sure to
134- set LD_LIBRARY_PATH to point to the directories containing the
135- dependent libraries.
136+ install prefix after running make install and the installation
137+ directory should not be moved. The path to these components
138+ can, however, be overridden with the --daemon and --filter
139+ arguments. Further, the STAT_PREFIX environment variable can be
140+ defined to override the hardcoded paths in STAT. STAT will
141+ also, by default, add rpaths to dependent libraries. This
142+ behavior can be disabled by specifying --with-rpath=no.
143+ However, when doing so, you must be sure to set LD_LIBRARY_PATH
144+ to point to the directories containing the dependent libraries.
0 commit comments