P2PP version 2 — Installation
In principle, P2PP 2.13.2 will work within any Java Virtual Machine which supports the Java Runtime Environment (JRE) 1.6.0 or newer. It has been reported to work on a variety of Unix platforms and Linux distributions, as well as MacOS X.
Note: the installation kit which we provide does not allow the tool to run under Windows.
The official ESO integration and testing platform for P2PP 2.13.2 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 or newer 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
To install P2PP, you will need to unpack the installation kit, and start the P2PP executable.
Please follow these steps:
- Previous Users of P2PP 2.X
- Backup your Local Cache folder!
- Caution! If you are not using a personal Local Cache folder, move the central Local Cache folder from the central P2PP installation directory to a new location or you risk losing all your OBs when you do a new P2PP installation.
- New Users of P2PP
- Create a .p2pp.cf file and specify a personal Local Cache folder
- 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-2.13.2.tar.gz | tar xvf -
- Since P2PP is a Java application, you need to have it installed on your machine:
- make sure that a Java 6 (aka Java 1.6) or newer Runtime Environment (JRE) is installed on your computer.
- For Linux machines: define the JAVA_HOME environment variable to point to its installation directory (example command: "export JAVA_HOME=<path-to-Java-install-dir>"). The JAVA_HOME directory must contain the "bin" subdirectory where the Java executable can be found. 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.
- For MacOSX machines: You can install either just the Java Runtime Environment (JRE - ~55MB) or the full Java Development Kit (JDK - ~220MB), both the JRE and the JDK are available from here. If you install/have installed a standard JDK, the command "/usr/libexec/java_home" will return the path to your Java 1.7+ JDK installation, no further step is required. Otherwise define the JAVA_HOME variable as descrbied just above. If you have a standard JRE installed JAVA_HOME will need to be set to something like
This completes the installation process.To run the executable, just add
<installation-directory>/p2pp-2.13.2/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-2.13.2/cache/instruments/ 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.
For a list of the changes in this release, see the RELEASE-NOTES file in the P2PP installation directory.