1. Installation & Configuration

1.1. Requirements and Supported Platforms

Because PAPI is written mostly in Python and ANSI C, it can run on any platform that has the required Python modules and GCC compilier. However, it has been developed and deeply tested under openSuSE 12.x/13.x x86_64 Linux OS. Python 2.7.x or higher and the following packages are required:

Additional packages are optionally required:
  • sphinx to build the documentation

Note

If you are using a SCAMP version <= 2.0.4 (lastest stable version), then you need to install the CDSClient. Otherwise, if you are using SCAMP version > 2.0.4, then you need libcurl.

Anycase, if you are behind a proxy, you need to set the proxy server in your system:

http_proxy=http//your_proxy:your_port; export http_proxy

1.2. Download

The latest stable version of PAPI can be downloaded from GitHub repository .

1.3. Building and Installation

PAPI installation is thought to be done as a ‘personal user’ (non-root), however it should work under any system directory (ie., /usr/local/).

  1. To install PAPI as a “personal user” (non-root), follow the next steps:

Once you have installed the required packages described above, you are ready to install PAPI; for this, follow the next steps:

$ git clone https://github.com/ppmim/PAPI.git ~/papi
$ cd papi
$ ./papi_setup.sh
  1. To install PAPI as root on your system, follow the next steps:

    $ cd /usr/local
    $ git clone https://github.com/ppmim/PAPI.git papi
    $ cd papi
    
    Edit the papi_setup.sh and set the right values to PAPI_HOME and PAPI_BIN variables, and then run the script as an user:
    
    $ ./papi_setup.sh
    

Warning

The script papi_setup.sh is currently implemented only for the Bash shell, and will modify your .bashrc file adding a new line at the end.

1.4. Building the documentation

The PAPI documentation is base on sphinx. With the package installed, the html documentation can be built from the doc directory:

$ cd papi/doc
$ make html

The documentation will be copied to a directory under build/sphinx.

The documentation can be built in different formats. The complete list will appear if you type make.

1.5. Bug reports

Please submit issues with the issue tracker on github.

1.6. Release Notes

  • 1.2.x
    • Support for new MEF structure (Qi); old format (SGi_1) also supported
    • Bug Fixes
  • 1.0.x
    • First version