Hewlett Packard Enterprise

Readme for HPE Performance Agent (OVPA) Version 4.0-42 for OpenVMS
================================================================================
This document provides information on how to install and uninstall the 
HP Performance Agent (OVPA) kit on the OpenVMS operating 
system and cluster. This document includes the following sections:

   1.1  Verifying the prerequisites on an OpenVMS System

   1.2  Installing the HPE Performance Agent (OVPA) ver 4.0-42
        

   1.3  Installing the HPE Performance Agent (OVPA) ver 4.0-42
        on the OpenVMS Cluster  

   1.4  Uninstalling the HPE Performance Agent (OVPA) ver 4.0-42
        on the OpenVMS System

  
1.1  Verifying the prerequisites on an OpenVMS System
=====================================================

Before installing the HP Performance Agent (OVPA) kit on the 
OpenVMS operating system, you have to verify that the following OpenVMS patches 
and software have been installed on the system:
 

Ensure that the following OpenVMS patches are applied:


	For OpenVMS Alpha:
        ------------------
 

        - OpenVMS Alpha Version 8.4



	For OpenVMS Integrity servers:
	------------------------------

 	
  	- OpenVMS Integrity servers Version 8.4

The patches are available at the HP Support Center:

hp.com/go/hpsc



TCP/IP Services for OpenVMS
---------------------------
    The PORTMAPPER service must be started for OVPA components to
    function accurately. 

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

Performance Data Collector for OpenVMS
--------------------------------------
   
    You must have the Performance Data Collector (TDC) installed on your 
    OpenVMS system for OVPA to collect data. Note that the minimum version 
    of TDC supported by OVPA is TDC Version 2.3-20.

    Install only the run-time part of TDC for each version of OpenVMS that
    you want to run with OVPA.

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

HPE SSL1 for OpenVMS Version 1.0-2C 
-------------------------------------------------------

   You must have the SSL1 no lower than V1.0-2C installed on your OpenVMS system.
   
   The SSL kit can be pulled from:
   http://h71000.www7.hp.com/openvms/products/ssl/ssl.html

1.2  Installing the HP Performance Agent (OVPA) ver 4.0-42
========================================================

To install the OPVA kit for OpenVMS, follow these steps:

Note: If a previous version of OVPA is already installed, then take a backup of the 
      following files before installation of OVPA version 4.0-42
      
      SYS$SPECIFIC:[OVO.VAR.OPT.PERF]ALARMDEF.
      SYS$SPECIFIC:[OVO.VAR.OPT.PERF]PARM.
      

      
    1) To extract the PCSI kit, run OVPA-x0400-xx-AXP.EXE (for Alpha) or
    OVPA-x0400-xx-I64.EXE (for Integrity servers) by entering the
    following commands:

    For OpenVMS Alpha:

    $ RUN OVPA-x0400-xx-AXP.EXE
    HP-AXPVMS-OVPA-x0400-xx-1.PCSI$COMPRESSED
    HP-AXPVMS-OVPA-x0400-xx-1.PCSI$COMPRESSED_ESW
    HP-AXPVMS-OVPA-x0400-xx-1.PCSI$COMPRESSED_HPC
  

    For OpenVMS Integrity servers:

    $ RUN OVPA-x0400-xx-I64.EXE
    HP-I64VMS-OVPA-x0400-xx-1.PCSI$COMPRESSED
    HP-I64VMS-OVPA-x0400-xx-1.PCSI$COMPRESSED_ESW
    HP-I64VMS-OVPA-x0400-xx-1.PCSI$COMPRESSED_HPC


    2) HPE recommends that you copy the kit and corresponding manifest file
    to the SYS$UPDATE: directory.


    a) Log into the OpenVMS system using the SYSTEM account.

    b) Set the default directory to SYS$UPDATE:

       $ SET DEFAULT SYS$UPDATE

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

       $ PRODUCT INSTALL OVPA

    4) If you are installing on OpenVMS node where OVO HTTPS Agents(that are compatible with SSL1.0-2C) are installed:

	i) Configure OVO HTTPS Agents communication port to any port other than 383
           Please refer to section "Restrictions and Known Issues" in the Release notes
	ii)Run SYS$STARTUP:OVO8_OVPA$CONFIG.COM
	
    5) Restore the files in the corresponding directories if backup was taken 
       earlier as described in 'Note:' at the begining of this section.

    6) Start OVPA Agents 

     To start OVPA, log into the OpenVMS system using the SYSTEM account and enter 
     the following command:

        $ @SYS$STARTUP:OVPA$STARTUP

	Note: 
	
	This startup command procedure starts TDC, which is required
        for OVPA to function.





1.3  Installing the HP Performance Agent (OVPA) ver 4.0-42
     on the OpenVMS Cluster  
=======================================================
    
To install the HP Performance Agent (OVPA) on nodes in a 
cluster, you must do as follows:

	- Install the kit on each node in the cluster. 

For more information on installing, see "Section 1.2, Installing the 
HP Performance Agent (OVPA) on the OpenVMS System".

NOTE: If the cluster is having members that boot from the
common system disk, it is required to make a note of the members on
which HP Performance Agent (OVPA) is installed. This information 
is required at the time of uninstallation.

  

1.4  Uninstalling the HP Performance Agent (OVPA) ver 4.0-42
     on the OpenVMS System
=========================================================

Uninstalling on Cluster Nodes with their Own System Disk:
-------------------------------------------------------

NOTE: STEP 4 IS NOT TO BE EXECUTED IF HP OPERATIONS MANAGER DCE 
      AGENT IS INSTALLED

To uninstall the HP Performance Agent (OVPA) 
on nodes in a cluster that do NOT have a common system disk, 

1. Enter the following command on each node separately:

     	$ @SYS$STARTUP:OVPA$SHUTDOWN
	$ PRODUCT REMOVE OVPA

2. Deassign/delete the following logicals/symbols on each node separately:

$ DEASSIGN/SYSTEM/NOLOG libOvBbcBase
$ DEASSIGN/SYSTEM/NOLOG libOvBbcHttp
$ DEASSIGN/SYSTEM/NOLOG libOvBbcIo 
$ DEASSIGN/SYSTEM/NOLOG libOvBbcNet
$ DEASSIGN/SYSTEM/NOLOG libOvBbcSsl
$ DEASSIGN/SYSTEM/NOLOG libOvBbcThread
$ DEASSIGN/SYSTEM/NOLOG OVPA$ROOT
$ DEASSIGN/SYSTEM/NOLOG OVPA$HOME

$
$! Delete the symbols created by OVO
$ DELETE/SYMBOL/GLOBAL AGSYSDB
$ DELETE/SYMBOL/GLOBAL CODAUTIL
$ DELETE/SYMBOL/GLOBAL  DSILOG
$ DELETE/SYMBOL/GLOBAL EXTRACT
$ DELETE/SYMBOL/GLOBAL MIDAEMON
$ DELETE/SYMBOL/GLOBAL SDLCOMP
$ DELETE/SYMBOL/GLOBAL SDLGENDATA
$ DELETE/SYMBOL/GLOBAL TTD
$ DELETE/SYMBOL/GLOBAL UTILENGINE
$ DELETE/SYMBOL/GLOBAL UTILITY
$ DELETE/SYMBOL/GLOBAL OVPA



3.Delete the command procedure files


  $DELETE SYS$STARTUP:OVPA$DEFINE_LOGICALS.COM;*  
  $DELETE SYS$STARTUP:OVPA$DEFINE_COMMANDS.COM;*
  $DELETE SYS$STARTUP:OVPA$SHUTDOWN.COM;*      
  $DELETE SYS$STARTUP:OVPA$STARTUP.COM;*
  $DELETE SYS$STARTUP:OVO8_OVPA$CONFIG.COM;*
  $DELETE SYS$STARTUP:OVO8_OVPA$DEFINE.COM;*



4.Since the PROD REMOVE doesn't delete everything, the 
  following command should be executed ONLY if 
  HP Operations Manager DCE Agent is NOT installed.
  The reason for this is HP Operations Manager DCE Agent 
  installs in the same directory as SYS$SPECIFIC:[OVO] 


   $DELETE SYS$SPECIFIC:[OVO...]*.*;*  
   $DELETE/LOG SYS$SPECIFIC:[000000]OVO.DIR;*  
 

   You may have to execute the above command multiple times
   to do a complete cleanup.     

5.If HP Operations Manager DCE Agent is installed, then delete
  the following executables.
  

  $DELETE SYS$SPECIFIC:[ovo.opt.OV.bin]coda.exe;*
  $DELETE SYS$SPECIFIC:[ovo.opt.OV.bin]codautil.exe;*
  $DELETE SYS$SPECIFIC:[ovo.opt.OV.bin]llbserver.exe;*
  $DELETE SYS$SPECIFIC:[ovo.opt.perf.bin]agsysdb.exe;*
  $DELETE SYS$SPECIFIC:[ovo.opt.perf.bin]armsample1.exe;*
  $DELETE SYS$SPECIFIC:[ovo.opt.perf.bin]armsample2.exe;*
  $DELETE SYS$SPECIFIC:[ovo.opt.perf.bin]dsilog.exe;*
  $DELETE SYS$SPECIFIC:[ovo.opt.perf.bin]extract.exe;*
  $DELETE SYS$SPECIFIC:[ovo.opt.perf.bin]midaemon.exe;*
  $DELETE SYS$SPECIFIC:[ovo.opt.perf.bin]perfalarm.exe;*
  $DELETE SYS$SPECIFIC:[ovo.opt.perf.bin]scopeux.exe;*
  $DELETE SYS$SPECIFIC:[ovo.opt.perf.bin]sdlcomp.exe;*
  $DELETE SYS$SPECIFIC:[ovo.opt.perf.bin]sdlgendata.exe;*
  $DELETE SYS$SPECIFIC:[ovo.opt.perf.bin]sdlutil.exe;*
  $DELETE SYS$SPECIFIC:[ovo.opt.perf.bin]ttd.exe;*
  $DELETE SYS$SPECIFIC:[ovo.opt.perf.bin]utilengine.exe;*
  $DELETE SYS$SPECIFIC:[ovo.opt.perf.bin]utility.exe;*
  $DELETE SYS$SPECIFIC:[ovo.opt.OV.lib]libOvBbcBase.exe;*
  $DELETE SYS$SPECIFIC:[ovo.opt.OV.lib]libOvBbcHttp.exe;*
  $DELETE SYS$SPECIFIC:[ovo.opt.OV.lib]libOvBbcIo.exe;*
  $DELETE SYS$SPECIFIC:[ovo.opt.OV.lib]libOvBbcNet.exe;*
  $DELETE SYS$SPECIFIC:[ovo.opt.OV.lib]libOvBbcSsl.exe;*
  $DELETE SYS$SPECIFIC:[ovo.opt.OV.lib]libOvBbcThread.exe;*
  $DELETE SYS$SPECIFIC:[ovo.opt.OV.lib]libOvBbcXml.exe;*
  $DELETE SYS$SPECIFIC:[ovo.opt.perf.lib]libarm.exe;*
  $DELETE SYS$SPECIFIC:[ovo.opt.perf.bin]ovpa.exe;*
  $DELETE SYS$SPECIFIC:[ovo.opt.perf.bin]ovtrap.exe;*




 Uninstalling on any One Node with Common System Disk:
-----------------------------------------------------

NOTE  : STEP 5 IS NOT TO BE EXECUTED IF HP OPERATIONS MANAGER DCE 
      AGENT IS INSTALLED


To uninstall the HP Performance Agent (OVPA) on any node in a cluster booting from a common system disk., 

1. Enter the following command on the node:

     	$ @SYS$STARTUP:OVPA$SHUTDOWN
     	
2. Deassign/delete the following logicals/symbols.

        
	$ DEASSIGN/SYSTEM/NOLOG libOvBbcBase
	$ DEASSIGN/SYSTEM/NOLOG libOvBbcHttp
	$ DEASSIGN/SYSTEM/NOLOG libOvBbcIo 
	$ DEASSIGN/SYSTEM/NOLOG libOvBbcNet
	$ DEASSIGN/SYSTEM/NOLOG libOvBbcSsl
	$ DEASSIGN/SYSTEM/NOLOG libOvBbcThread
	$ DEASSIGN/SYSTEM/NOLOG OVPA$ROOT
	$ DEASSIGN/SYSTEM/NOLOG OVPA$HOME
	
	$
	$! Delete the symbols created by OVPA
	$ DELETE/SYMBOL/GLOBAL AGSYSDB
	$ DELETE/SYMBOL/GLOBAL CODAUTIL
	$ DELETE/SYMBOL/GLOBAL DSILOG
	$ DELETE/SYMBOL/GLOBAL EXTRACT
	$ DELETE/SYMBOL/GLOBAL MIDAEMON
	$ DELETE/SYMBOL/GLOBAL SDLCOMP
	$ DELETE/SYMBOL/GLOBAL SDLGENDATA
	$ DELETE/SYMBOL/GLOBAL TTD
	$ DELETE/SYMBOL/GLOBAL UTILENGINE
	$ DELETE/SYMBOL/GLOBAL UTILITY
	$ DELETE/SYMBOL/GLOBAL OVPA
	
3.Delete the command procedure files

	
	  $DELETE SYS$STARTUP:OVPA$DEFINE_LOGICALS.COM;*  
	  $DELETE SYS$STARTUP:OVPA$DEFINE_COMMANDS.COM;*
	  $DELETE SYS$STARTUP:OVPA$SHUTDOWN.COM;*      
	  $DELETE SYS$STARTUP:OVPA$STARTUP.COM;*
	  $DELETE SYS$STARTUP:OVO8_OVPA$CONFIG.COM;*
	  $DELETE SYS$STARTUP:OVO8_OVPA$DEFINE.COM;*

4.The following command should be executed ONLY if 
  HP Operations Manager DCE Agent is NOT installed.
  The reason for this is HP Operations Manager DCE Agent 
  installs in the same directory as SYS$SPECIFIC:[OVO] 


   $DELETE SYS$SPECIFIC:[OVO...]*.*;*  
   $DELETE/LOG SYS$SPECIFIC:[000000]OVO.DIR;*
 

   You may have to execute the above command multiple times
   to do a complete cleanup.     
   
5.If HP Operations Manager DCE Agent is installed, then delete
  the following executables.
  

  $DELETE SYS$SPECIFIC:[ovo.opt.OV.bin]coda.exe;*
  $DELETE SYS$SPECIFIC:[ovo.opt.OV.bin]codautil.exe;*
  $DELETE SYS$SPECIFIC:[ovo.opt.OV.bin]llbserver.exe;*
  $DELETE SYS$SPECIFIC:[ovo.opt.perf.bin]agsysdb.exe;*
  $DELETE SYS$SPECIFIC:[ovo.opt.perf.bin]armsample1.exe;*
  $DELETE SYS$SPECIFIC:[ovo.opt.perf.bin]armsample2.exe;*
  $DELETE SYS$SPECIFIC:[ovo.opt.perf.bin]dsilog.exe;*
  $DELETE SYS$SPECIFIC:[ovo.opt.perf.bin]extract.exe;*
  $DELETE SYS$SPECIFIC:[ovo.opt.perf.bin]midaemon.exe;*
  $DELETE SYS$SPECIFIC:[ovo.opt.perf.bin]perfalarm.exe;*
  $DELETE SYS$SPECIFIC:[ovo.opt.perf.bin]scopeux.exe;*
  $DELETE SYS$SPECIFIC:[ovo.opt.perf.bin]sdlcomp.exe;*
  $DELETE SYS$SPECIFIC:[ovo.opt.perf.bin]sdlgendata.exe;*
  $DELETE SYS$SPECIFIC:[ovo.opt.perf.bin]sdlutil.exe;*
  $DELETE SYS$SPECIFIC:[ovo.opt.perf.bin]ttd.exe;*
  $DELETE SYS$SPECIFIC:[ovo.opt.perf.bin]utilengine.exe;*
  $DELETE SYS$SPECIFIC:[ovo.opt.perf.bin]utility.exe;*
  $DELETE SYS$SPECIFIC:[ovo.opt.OV.lib]libOvBbcBase.exe;*
  $DELETE SYS$SPECIFIC:[ovo.opt.OV.lib]libOvBbcHttp.exe;*
  $DELETE SYS$SPECIFIC:[ovo.opt.OV.lib]libOvBbcIo.exe;*
  $DELETE SYS$SPECIFIC:[ovo.opt.OV.lib]libOvBbcNet.exe;*
  $DELETE SYS$SPECIFIC:[ovo.opt.OV.lib]libOvBbcSsl.exe;*
  $DELETE SYS$SPECIFIC:[ovo.opt.OV.lib]libOvBbcThread.exe;*
  $DELETE SYS$SPECIFIC:[ovo.opt.OV.lib]libOvBbcXml.exe;*
  $DELETE SYS$SPECIFIC:[ovo.opt.perf.lib]libarm.exe;*
  $DELETE SYS$SPECIFIC:[ovo.opt.perf.bin]ovpa.exe;*
  $DELETE SYS$SPECIFIC:[ovo.opt.perf.bin]ovtrap.exe;*

NOTE  :  When OVPA is removed from any one node with common system disk using above method, PRODUCT SHOW PRODUCT OVPA command still shows OVPA as installed. 
This can be ignored as the system is booted from common system disk and OVPA might be still notremoved from other nodes booted from common system disk. 


      
Uninstalling on Cluster Nodes with Common System Disk:
----------------------------------------------------

NOTE 1: REMOVING OVPA FROM ANY NODE IN A COMMON SYSTEM DISK CLUSTER
        ENVIRONMENT RENDERS OVPA UNUSABLE ON OTHER NODES IN THE 
        SAME COMMON SYSTEM DISK CLUSTER ENVIRONMENT
 

NOTE 2: STEP 5 IS NOT TO BE EXECUTED IF HP OPERATIONS MANAGER DCE 
      AGENT IS INSTALLED


1. Enter the following command on each node separately:

     	$ @SYS$STARTUP:OVPA$SHUTDOWN


2. Remove the product on ANY ONE of the cluster members booting from
   a common system disk.

	$ PRODUCT REMOVE OVPA


The following steps are to be excuted on EACH member in a cluster that boots 
from a common system disk.(Please refer to NOTE in section 1.3. 
You would have marked the members at the time of installation)


3. Deassign/delete the following logicals/symbols:

$ DEASSIGN/SYSTEM/NOLOG libOvBbcBase
$ DEASSIGN/SYSTEM/NOLOG libOvBbcHttp
$ DEASSIGN/SYSTEM/NOLOG libOvBbcIo 
$ DEASSIGN/SYSTEM/NOLOG libOvBbcNet
$ DEASSIGN/SYSTEM/NOLOG libOvBbcSsl
$ DEASSIGN/SYSTEM/NOLOG libOvBbcThread
$ DEASSIGN/SYSTEM/NOLOG OVPA$ROOT
$ DEASSIGN/SYSTEM/NOLOG OVPA$HOME

$
$! Delete the symbols created by OVO
$ DELETE/SYMBOL/GLOBAL AGSYSDB
$ DELETE/SYMBOL/GLOBAL CODAUTIL
$ DELETE/SYMBOL/GLOBAL  DSILOG
$ DELETE/SYMBOL/GLOBAL EXTRACT
$ DELETE/SYMBOL/GLOBAL MIDAEMON
$ DELETE/SYMBOL/GLOBAL SDLCOMP
$ DELETE/SYMBOL/GLOBAL SDLGENDATA
$ DELETE/SYMBOL/GLOBAL TTD
$ DELETE/SYMBOL/GLOBAL UTILENGINE
$ DELETE/SYMBOL/GLOBAL UTILITY
$ DELETE/SYMBOL/GLOBAL OVPA



4.Delete the command procedure files


  $DELETE SYS$STARTUP:OVPA$DEFINE_LOGICALS.COM;*  
  $DELETE SYS$STARTUP:OVPA$DEFINE_COMMANDS.COM;*
  $DELETE SYS$STARTUP:OVPA$SHUTDOWN.COM;*      
  $DELETE SYS$STARTUP:OVPA$STARTUP.COM;*
  $DELETE SYS$STARTUP:OVO8_OVPA$CONFIG.COM;*
  $DELETE SYS$STARTUP:OVO8_OVPA$DEFINE.COM;*



5.Since the PROD REMOVE doesn't delete everything, the 
  following command should be executed ONLY if 
  HP Operations Manager DCE Agent is NOT installed.
  The reason for this is HP Operations Manager DCE Agent 
  installs in the same directory as SYS$SPECIFIC:[OVO] 


   $DELETE SYS$SPECIFIC:[OVO...]*.*;*  
   $DELETE/LOG SYS$SPECIFIC:[000000]OVO.DIR;*
 

   You may have to execute the above command multiple times
   to do a complete cleanup.     

6.If HP Operations Manager DCE Agent is installed, then delete
  the following executables.
  

  $DELETE SYS$SPECIFIC:[ovo.opt.OV.bin]coda.exe;*
  $DELETE SYS$SPECIFIC:[ovo.opt.OV.bin]codautil.exe;*
  $DELETE SYS$SPECIFIC:[ovo.opt.OV.bin]llbserver.exe;*
  $DELETE SYS$SPECIFIC:[ovo.opt.perf.bin]agsysdb.exe;*
  $DELETE SYS$SPECIFIC:[ovo.opt.perf.bin]armsample1.exe;*
  $DELETE SYS$SPECIFIC:[ovo.opt.perf.bin]armsample2.exe;*
  $DELETE SYS$SPECIFIC:[ovo.opt.perf.bin]dsilog.exe;*
  $DELETE SYS$SPECIFIC:[ovo.opt.perf.bin]extract.exe;*
  $DELETE SYS$SPECIFIC:[ovo.opt.perf.bin]midaemon.exe;*
  $DELETE SYS$SPECIFIC:[ovo.opt.perf.bin]perfalarm.exe;*
  $DELETE SYS$SPECIFIC:[ovo.opt.perf.bin]scopeux.exe;*
  $DELETE SYS$SPECIFIC:[ovo.opt.perf.bin]sdlcomp.exe;*
  $DELETE SYS$SPECIFIC:[ovo.opt.perf.bin]sdlgendata.exe;*
  $DELETE SYS$SPECIFIC:[ovo.opt.perf.bin]sdlutil.exe;*
  $DELETE SYS$SPECIFIC:[ovo.opt.perf.bin]ttd.exe;*
  $DELETE SYS$SPECIFIC:[ovo.opt.perf.bin]utilengine.exe;*
  $DELETE SYS$SPECIFIC:[ovo.opt.perf.bin]utility.exe;*
  $DELETE SYS$SPECIFIC:[ovo.opt.OV.lib]libOvBbcBase.exe;*
  $DELETE SYS$SPECIFIC:[ovo.opt.OV.lib]libOvBbcHttp.exe;*
  $DELETE SYS$SPECIFIC:[ovo.opt.OV.lib]libOvBbcIo.exe;*
  $DELETE SYS$SPECIFIC:[ovo.opt.OV.lib]libOvBbcNet.exe;*
  $DELETE SYS$SPECIFIC:[ovo.opt.OV.lib]libOvBbcSsl.exe;*
  $DELETE SYS$SPECIFIC:[ovo.opt.OV.lib]libOvBbcThread.exe;*
  $DELETE SYS$SPECIFIC:[ovo.opt.OV.lib]libOvBbcXml.exe;*
  $DELETE SYS$SPECIFIC:[ovo.opt.perf.lib]libarm.exe;*
  $DELETE SYS$SPECIFIC:[ovo.opt.perf.bin]ovpa.exe;*
  $DELETE SYS$SPECIFIC:[ovo.opt.perf.bin]ovtrap.exe;*