P2PP Application Server V.2.1.1 installation instructions

FOR ESO INTERNAL USE ONLY!

1  P2PP Application Server V.2.1.1

The latest version of P2PP Application Server is V.2.1.1. Before trying to install and run it, you should read the release notes and the the current list of known problems.

2  P2PP Application Server V.2.1.1 System Requirement

The P2PP Application Server V.2.1.1 is written in Java and it will run on all major platforms including Unix, Win32 and MacOS; but we only support Solaris at this time.
Details of memory and CPU usage are not available at this time, but we do expect the system to be quite resource-intensive.

3  Installing and running P2PP Application Server V.2.1.1

To install P2PP Application Server V.2.1.1 you will need to retrieve the distribution kits for your architecture, unpack and install them.

3.1  Solaris, HP-UX and Linux

Note: only Solaris is supported at this time.
  1. Change directory to where you want to install P2PP Application Server V.2.1.1; in the following, we'll call this directory the installation directory, or <inst-dir>.

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

  3. If the Java Runtime Environment is installed on your system and accessible from your account, skip this step.
    You can verify the JRE installation by trying to run the
        jre -help
    command -- it must correspond to V.1.1.7 or later.

    If needed, you can retrieve V.1.1.7 of the Java Runtime Environment for your architecture into the installation directory: Solaris, HP-UX or Linux.

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

  5. Run the following sequence of commands:
        gunzip -c p2pp-appserver-2.1.1.tar.gz | tar xovf -
        rm -f current-appserver
        ln -s p2pp-appserver-2.1.1 current-appserver
        cd p2pp-appserver-2.1.1
        make

  6. Add the following lines to your crontab file (see the crontab(1) man page for details):

    15          0  *  *  *  <inst-dir>/current-appserver/bin/housekeeping.sh >> <inst-dir>/logs/housekeeping.log 2>&1
    0,15,30,45  *  *  *  *  <inst-dir>/current-appserver/bin/p2pp-appserver.sh -check >> <inst-dir>/logs/check-running.log 2>&1

    The first line will run a housekeeping script script about midnight every day - to rotate logfiles, restart the server, etc.
    The second line will check every fifteen minutes if the server is actually running, and restart it if not. This completes the installation process.

    Note: P2PP Application Server V.2.1.1 is actually implemented as two concurrent processes - an RMI registry listener and the application server process itself. The processes can be controlled manually using the p2pp-appserver.sh script in the <inst-dir>/p2pp-appserver-2.1.1/bin directory.
    The script's help message is reported below:

    Usage: p2pp-appserver.sh [-v|-verbose] [-r|-restart] [-ck|-check] [-k|-kill] [-d|-debug]
            -r  -restart    kill and restart the servers
            -ck -check      restart if not already running
            -k  -kill       kill the servers
            -d  -debug      just show what would be executed
            -v  -verbose    produce verbose output
    	
    Note that exactly one of the -r, -ck or -k options must be specified.

3.2  Win32

Win32 is not supported at this time.

3.3  MacOS

The MacOS is not supported at this time.


$Revision: 1.6.2.1 $, Last modified: Mon Sep 25 14:18:25 MET DST 2000