The P2PP version 3 Tool - Installation

Supported Platforms

In principle, P2PP 3.3.1 will work within any Java Virtual Machine whichsupports the Java Runtime Environment (JRE) 1.6.0. It should thus work on a variety of Unix platforms and Linux distributions, as well as MacOS X 10.5 and higher.
Note: the installation kit which we provide does not allow to run the tool under Windows.

At present, the official ESO integration and testing platform for P2PP is Scientific Linux 4.3.

We provide the installation kit for P2PP in the form of a tarball (see below).You should have Java 1.6 installed on your machine to run the software. As a courtesy, we also provide ready-to-use Java tarballs for some platforms.

Although ESO is not able to guarantee that P2PP will work correctly on all platforms, support is available on a best-effort basis from the ESO User Support Department.

How to Install P2PP version 3

To be able to run P2PP, you will need to unpack the installation kit, and start the P2PP executable.

Please follow these steps:

  • Change to the directory where you have downloaded P2PP. In the following, we call this directory the installation directory.
  • Run the following sequence of commands:
        gunzip -c p2pp-3.3.1.tar.gz | tar xvf -
  • If Java is already installed on your computer, skip the following step. If you have retrieved a Java package from our download page, unpack it in the same directory as P2PP, using this command:
        gunzip -c jre<version>.tar.gz | tar xvf -

    This will create a directory named jre, which P2PP will automatically find at start-up.

This completes the installation process. To run the executable, just add <installation-directory>/p2pp-3.3.1/bin to your $PATH environment variable. Possible files to update are: $HOME/.tcshrc, $HOME/.cshrc, $HOME/.login

Execute P2PP by issuing the command p2pp in a terminal window, possibly after issuing rehash or hash -r.

If the P2PP login window appears, then you have successfully installed P2PP. You can then delete the compressed TAR file.

Important: after starting P2PP for the first time, please ensure you download your observing runs and instrument packages through the "Download/Refresh Observing Runs" menu under the "File" menu.

Warning: please make sure you are really running the right version of P2PP. The P2PP version is listed at the top of the main window. Also, please note that <installation-directory>/p2pp-3.3.1/cache/ and all its subdirectories, have to be writable for every user of P2PP. This may require to change the permissions on this directory if you are installing P2PP in a system-wide location on your machine.

Note about the upgrade from version 3.2.1 to version 3.3.0 or 3.3.1

In June 2012 version 3.3.0 of the P2PP client was released. This latest version brings several improvements and bug fixes required to be able to extend its use to all telescopes of the VLT/VLTI. Because of this, it is not possible to continue using version 3.2.1 of the P2PP client. Users are kindly asked to upgrade by retrieving the latest version of P2PP from our download page.

However, users of P2PP 3.2.1 can easily transfer their local cache to the new client, and thus keep all the OBs they have prepared on their computer with that version. To do so, first login to P2PP 3.3.1, then exit, and copy the whole contents of your cache directory to the new installation: cp -r <installation-directory>/p2pp-3.2.1/cache/* <installation-directory>/p2pp-3.3.1/cache/.

Note that the same applies to transferring your cache to P2PP 3.3.0, the bugfix release of P2PP introduced on 23 July 2012.


Instrument selector

This page does not contain any XSHOOTER-specific information

This page is specific to UT2, VST and VISTA telescopes.