$Id: INSTALL,v 1.11 2010/07/28 16:27:13 mucci Exp $ papiex - PAPI Execute Quick build instructions ------------------------ Ensure PAPI and monitor are installed in the standard locations. $ make (PAPI_PREFIX, HAVE_MPI and MPI_INC_PATH may need to be set) $ make test $ make install Detailed Instructions --------------------- ** NOTE: PAPIEX REQUIRES A PAPI RELEASE LATER THAN 3.0.2 ** How to Build PapiEx: This release of PapiEx has been tested on Linux/x86/x86_64/MIPS IA64, PPC32 and PPC64. It requires 2 pieces of software. PAPI: http://icl.cs.utk.edu/papi Monitor: http://www.cs.utk.edu/~mucci Please install those pieces of software first. Then you should be able to just type 'make'. If you have installed either Monitor or PAPI in a nonstandard place, you'll need to set additional parameters on the make line. For Monitor: PapiEx looks for the 'monitor-config' program. Please make sure that this is in your path and everything will work nicely. For PAPI: If you have installed the distribution with a make install and the headers and libraries are in a non-standard place, add PAPI_PREFIX= to the make line. (Usually /usr/local) Note that this will fail on certain platforms that don't place things in /lib (like 64 bit Linux). In that case, please specify PAPI_LIB_PATH directly. You might also need to specific PAPI_INC_PATH. MPI Aggregation: PapiEx can be made aware of MPI applications and can aggregate the data for you. To enable this feature, you must add the following to the make line. HAVE_MPI=1 This is only guaranteed to work for MPICH programs, please report other cases (yes or no) to us. In addition, you must set the path to the MPI include files unless they happen to be in /usr/local/include. Add this to the make line. See the comments in the top-level Makefile. MPI_INC_PATH= How to Install PapiEx: In addition to the above flags, you also have to tell make where to install the resulting libraries. You do this with a PREFIX= option. The default is /usr/local, just like GNU configure. You can see all these settings by typing 'make show-config' Troubleshooting: If the PAPI libraries are not installed in the standard run time linker search path then you had better set the environment variable LD_LIBRARY_PATH to point to the correct places. Example: setenv LD_LIBRARY_PATH /usr/local/lib:/opt/local/lib