P2PP V.2.3 installation instructions

FOR ESO INTERNAL USE ONLY!

1  P2PP V.2.3

The latest version of P2PP is V.2.3. Before trying to install and run it, you should read the release notes.

2  P2PP V.2.3 System Requirements

P2PP V.2.3 is written in Java and it will run on all major platforms including Unix, Win32 and MacOS.
Details of memory and CPU usage are not available at this time, but we do expect the system to be pretty resource-intensive.

3  Installing and running P2PP V.2.3

To install P2PP V.2.3 you will need to retrieve the distribution kits for your architecture, unpack and install them, and start the p2pp executable.
Note
In order to retrieve the distribution kits, you may need to configure your Web browser so that it knows how to deal with the files we distribute -- either gzipped tar files (.tar.gz filename extension; Unix, Linux) or zip files (.zip extension; Windows).

If you click on one of the links below, your browser should display a file selection panel; if you end up instead with a page full of strange characters, you definitely need to configure your browser.

Alternatively, try clicking on the link while holding the Shift key down.

3.1  Solaris, HP-UX and Linux

  1. Change directory to where you want to install P2PP V.2.3 -- in the following, we'll call this directory the installation directory.

  2. Retrieve the Unix distribution kit for V.2.3 into the installation directory:

  3. It is recommended that you retrieve the Java Runtime Environment for your architecture into the installation directory:

    Alternatively, if the Java Runtime Environment is already installed on your system and accessible from your account, you should verify the local JRE installation by trying to run the
        jre -help
    command -- it must correspond to V.1.1.8.
    Also, please make make sure that your $JAVA_HOME and $SWING_HOME environment variables are correctly set.

  4. Retrieve into the installation directory all the needed Instrument Packages. See the USG Instrument Packages Web page for more information.

  5. Run the following sequence of commands:
        gunzip -c p2pp-2.3.tar.gz | tar xvf -
        cd p2pp-2.3
        make     This completes the installation process.
To run the executable, just add <installation-directory>/p2pp-2.3/bin to your $PATH environment variable, then give the
    p2pp
command, possibly after issuing rehash.

Beware of possible conflicts with P2PP V.1.x installations: if that is the case, you can use the jp2pp alias instead of p2pp.

Important notes

  1. the environment variable $JAVA_HOME must be correctly set in order for the Unix version of P2PP to run. When in doubt, one should best unset it and let the system choose the default value.

  2. make sure no Unix 'alias' is defined for p2pp; this is especially important for former users of P2PP 1.x

3.2  Win32

TBD

3.3  MacOS

TBD

$Revision: 1.16 $,  Last modified: Fri Aug 24 18:12:47 MET DST 2001