README File for the OpenView Performance Agent (OVPA) for OpenVMS
       =================================================================

  The OpenView Performance Agent collects, summarizes, time stamps, and detects
  alarm conditions on current and historical resource data across your system.
  It provides performance, resource, and end-to-end transaction response time
  measurements and supports network and database measurement information.

  Use OVPA in conjunction with the OpenView Performance Manager (OVPM)
  Version 5.0 or later.

  Refer to the HP OpenView Performance Agent User's Manual, Edition: 13 (for
  UNIX) and the HP OpenView Performance Manager User's Manual for additional
  information.  These manuals, and others, are available at the OpenView
  web site:

        http://www.openview.hp.com/ 
 
-------------------------------------------------------------------------------
Kit Prerequisites
-------------------------------------------------------------------------------

  First, you must verify that your OpenVMS system meets OVPA
  prerequisites. OpenView Performance Agents for OpenVMS works on OpenVMS
  Version 7.3-2 or later. Make sure that the required OpenVMS patches listed
  below have been applied.  The patches are available at the services web site:

        http://www2.itrc.hp.com/service/patch/mainPage.do


  OpenVMS Version 7.3-2
  --------------
      - VMS732_UPDATE V6.0 (or later)

  OpenVMS Version 8.2 (Alpha)
  OpenVMS Version 8.2 (Itanium)
  ----------------------
    There are no prerequisites for customers who are using OpenVMS Version 8.2.

  TCP/IP Services for OpenVMS
  ---------------------------
    You must enable the PORTMAPPER service for several OVPA components to
    function.

    The OVPA software links with the HP TCP/IP network product and therefore
    requires the HP TCP/IP product to run. OVPA will NOT work with third party
    IP products.
  

  SSL for OpenVMS
  ---------------
    You must have SSL Version 1.2 or later installed and started on your OpenVMS
    system. The SSL kits are available at:
    http://h71000.www7.hp.com/openvms/ssl/ssl.html

  The Performance Data Collector for OpenVMS
  ------------------------------------------
    You must have The Performance Data Collector (TDC) Version 2.2-105 or later
    installed on your OpenVMS system for OVPA to collect data.

    The complete TDC kit is included with the .zip kit you downloaded from the
    web. Only install the Run Time part of TDC for each version of OpenVMS that
    you want to run with OVPA.

    The kit may also be obtained from:
    http://www.hp.com/products/openvms/tdc/

-------------------------------------------------------------------------------
Installing the OpenVMS Performance Agent Software
-------------------------------------------------------------------------------

To install the kit, follow these numbered steps:

1) Copy the PCSI kit to your OpenVMS system. HP recommends that you
   copy the kit to the SYS$UPDATE: directory.

2) Log into the system account.

3) Set your default directory to SYS$UPDATE:

   $ SET DEFAULT SYS$UPDATE

4) Use the PRODUCT INSTALL command to install the kit:

NOTE: If you copied the OVPA kits from a web site, you may need to do the
following to the PCSI file after you have unzipped the kit.

$set file/attributes=(RFM:FIX,LRL:512,MRS:512) -
        HP-AXPVMS-OVPA-T0100-24-1.PCSI or
$set file/attributes=(RFM:FIX,LRL:512,MRS:512) -
        HP-I64VMS-OVPA-T0100-24-1.PCSI or

   $ PRODUCT INSTALL OVPA

-------------------------------------------------------------------------------
Using the OpenVMS Performance Agent
-------------------------------------------------------------------------------
   
   The installation procedures for the OpenVMS Performance Agent install most
   of the files in subdirectories under SYS$SPECIFIC:[OVO].  Sharable images
   are installed in SYS$SYSROOT:[SYSLIB]. Command files are installed in 
   standard system directories such as SYS$STARTUP and SYS$MANAGER.  
    
-) To start OVPA, log into the SYSTEM account and enter this command:
        
 	$ @SYS$STARTUP:OVPA$STARTUP

NOTE: This startup command procedure starts SSL and TDC, which are both required
for OVPA to function.