FACETS Performance Analysis Build Instructions

Back to the documentation home page.

This page assumes that you have already built FACETS and all dependencies according to the instructions.

Performance analysis dependencies

For performance analysis, we use the TAU package,  http://www.cs.uoregon.edu/research/tau/home.php, which requires the pdtoolkit package. We configured and built both packages in place.

pdtoolkit

wget http://tau.uoregon.edu/pdt.tgz 
tar xfvz pdt.tgz 
cd pdt
./configure -prefix=/contrib/pdtoolkit-3.12

make
make install
ln -s /contrib/pdtoolkit-3.12 /contrib/pdtoolkit

TAU

./installtau -pdt=/contrib/pdtoolkit -prefix=/contrib/tau-2.17.1 -mpi
ln -s /contrib/tau-2.17.1 /contrib/tau
./configure -LINUXTIMERS -mpi -pdt=/contrib/pdtoolkit -prefix=/contrib/tau-2.17.1 -mpi
make install
./configure -LINUXTIMERS -TRACE -mpi -pdt=/contrib/pdtoolkit -prefix=/contrib/tau-2.17.1 -mpi
make install
./configure -LINUXTIMERS -pdt=/contrib/pdtoolkit -prefix=/contrib/tau-2.17.1
make install

Configuration Examples

The FACETS build system is configured to look for all dependent software in $HOME/software, /contrib, /internal, /usr/local, in that order.

Performance analysis builds

Assuming that one has tau built and installed as above, one can also create performance analysis builds for bothe serial and parallel. The configuration commands are

Parallel

../configure --prefix=/home/research/cary/software/facets-0.0.1 --with-tau-cxx=/contrib/tau/i386_linux/bin/tau_cxx.sh --with-tau-makefile=/contrib/tau/i386_linux/lib/Makefile.tau-linuxtimers-mpi-pdt-trace

The resulting build will put out parallel trace information that, after some file conversions, which are documented in the test, glf23p-tau.sh, can be examined by JumpShot.

Serial

../configure --prefix=/home/research/cary/software/facets-0.0.1 --disable-parallel --with-tau-cxx=/contrib/tau/i386_linux/bin/tau_cxx.sh --with-tau-makefile=/contrib/tau/i386_linux/lib/Makefile.tau-linuxtimers-pdt

The resulting build will put out profile information that can be analyzed by ParaProf.

The above build commands work on

• quartic.txcorp.com, a 4-core box running openmpi-1.2.5
• multipole.txcorp.com, a heterogeneous, 7-node, dual-cpu cluster running openmpi-1.1.5

Troubleshooting

Known FACETS Build Issues?

Supported platforms

FACETS should be portable across many UNIX flavors. FACETS is known to have built and run successfully on the these platforms.