P2PP Application Server V.2.6beta1 installation instructions

FOR ESO INTERNAL USE ONLY!

1  P2PP Application Server V.2.6beta1

The latest version of P2PP Application Server is V.2.6beta1. 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.6beta1 System Requirement

The P2PP Application Server V.2.6beta1 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.6beta1

To install P2PP Application Server V.2.6beta1 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.6beta1; in the following, we'll call this directory the installation directory, or <inst-dir>.

  2. Retrieve the Unix distribution kit for V.2.6beta1 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.4.0 or later.

    If needed, you can retrieve V.1.4.0 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.6beta1.tar.gz | tar xovf -
        cd p2pp-appserver-2.6beta1
        make

  6. If necessary, edit the values of the APPSERVER keywords in the config/site.cf file. See the OHS V.2.x configuration files document for more information.

  7. Start the P2PP Application Server:
        bin/p2pp-as-supervisor -restart

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

    15          0     *  *  *  /home/p2ppas/p69/p2pp-appserver-2.6beta1/bin/p2pp-as-supervisor -restart
    0,15,30,45  1-23  *  *  *  /home/p2ppas/p69/p2pp-appserver-2.6beta1/bin/p2pp-as-supervisor -check

    The first line will restart the P2PP Application Server about midnight every day, will the logfiles, 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: The P2PP Application Server V.2.6beta1 processes can be controlled manually using the p2pp-as-supervisor.sh script in the <inst-dir>/p2pp-appserver-2.6beta1/bin directory.
    The script's help message is reported below:

    usage: p2pp-as-supervisor <options>
    where <options> are:
            -help           Display this help text 
            -kill           Kill the P2PP Application Server 
            -restart        Kill and restart the P2PP Application Server 
                            rotating logfiles 
            -check          Check if the P2PP Application Server is running: 
                            if not, restart it
    	

3.2  Win32

Win32 is not supported at this time.

3.3  MacOS

The MacOS is not supported at this time.


$Revision: 1.12 $, Last modified: Wed Jul 3 17:06:02 MEST 2002