RPM 1.3 Readme

HP NonStop Real-time Process Monitor (RPM)
Copyright (C) 2015 Hewlett-Packard Company
READ ME – READ BEFORE INSTALLATION

Product Name:
RPM 1.3 Real-time Process Monitor

Product ID:
RPM01V1  S-series update 3
HRPM01V1 H-series update 3
QRPM01V1 J-series update 3
BE153AC  L-series

Components:
T0877L01 L-series
T0877H01^AAE H/J-series

I. Basic Product Installation Instructions

1. Ensure that requirements for using
the RPM product are met (see Section
IV Product Requirements below).

2. Ensure that prerequisites for
the installation utility and any
product-specific installation
requirements are met. (See Section IV
Product Requirements below).

3. If received on CD, review USRGUIDE.PDF in
subdirectory NSK_SW on RPM CD containing
the IPSetup User Guide, which provides
instructions for using IPSetup which is a
utility provided on the CD that enables
installation of Independent Products.
If received on SUT or as PAK file, review
Readme file.

4. Decide whether you will use DSM/SCM to move
files to Installation Subvolumes (ISVs) after
files are placed on the workstation. Using
DSM/SCM is optional, but is recommended when
DSM/SCM is available.

5. Follow the pre-installation instructions in
Section II below, if any, before continuing to
Step 6.

6. Run IPSetup to place (move files from the CD to
the workstation) and install (move NonStop Kernel
files to correct ISVs) this product. If you have
problems with automatic file placement, use the
instructions in the IPSetup User Guide section
"Manual Software Placement Using the IPSetup TACL
Program" to manually place NonStop Kernel files.

7. Follow the post-installation instructions in Section
III below, after using IPSetup to place and install
this product.

II. Pre-Installation Instructions

None

III. Post-Installation Instructions

1. Once files have are placed in DSV/ISV

2. RUN RPMWIZ from TACL and follow RPM Wizard
prompts which will guide you through the post
installation steps.

3. If you need help with RPM setup, see
instructions in Section 2 of the HP NonStop
RPM User's Guide at NonStop Technical Library
http://www.hp.com/go/nonstop-docs. Install
instructions, examples, and tips are also
available on-line at the HP NonStop RPM
Technical Portal: http://www.NonstopRPM.com

IV. Product Requirements

Required Hardware:
NonStop S-series servers
NonStop H-series servers
NonStop J-series servers
NonStop L-series servers

Minimum OS Release:
S-series - NonStop Kernel G05 or higher
H-series - NonStop Kernel H06 or higher
J-series - NonStop Kernel J00 or higher
L-series - NonStop Kernel L01 or higher

Required Software:
T8488 any version

Disk Space Requirement:
ZRPM subvolume: 10.0 MB
$SYSTEM.SYSTEM run time files 5.0 MB

Memory Requirement:
16 MB per node.

V. Installation Prerequisites

Required Hardware:
NonStop K-series servers
NonStop S-series servers
NonStop H-series servers
NonStop J-series servers
NonStop L-series servers
Communications controller allowing
file transfer from PC to HP NonStop Server

Required Software:
NonStop G-series Operating system
NonStop H-series Operating system
NonStop J-series Operating system
NonStop L-series Operating system

VI. Manuals for this CD:

To access the documentation for this product, see the
HP NonStop Technical Library www.hp.com/go/nonstop-docs
or your NonStop Technical Library CD/DVD disc

VII. CD-ROM Root Directory Contents

AUTORUN.INF File containing CD AutoRun commands.

AXDIST.EXE Microsoft redistributable library files.

IPSETUP.CNT File containing help contents for the CD installation
utility IPSetup.

IPSETUP.EXE File containing the main executable for IPSetup.

IPSETUP.HLP File containing help text for IPSetup.

LICENSE.TXT File containing limited-use Software Licensing
Agreement with the licensing terms governing
this product.

README.TXT File containing product and installation information
(this file).

SETUP.EXE File containing the Launcher executable.

NSK_SW Subdirectory containing NSK component files,
including installation utilities and instructions.


WS_SW Subdirectory containing workstation component
files (if applicable to this product), including
installation utilities if any.

SOFTDOCS Subdirectory containing Product Softdocs.

____________________________________________________________________

ADDENDUM

- Summary
- Overview
- New Feature History
- Problems Corrected History

SUMMARY

The HP NonStop RPM software product is a
Real-time Process Monitor that provides
real-time analysis and display in the form
of color-encoded alerts for busy processes
by IPU, CPU, Node, or super-cluster.

RPM 1.3 Summary T0877L01/AAE
- RPM 1.3 adds the following commands, options, & features.
- CPU, PB, ZOOM commands have following new command options:
- CPU IPU option shows IPU Busy % for all IPUs and all CPUs
- CPU ID option shows IPU Dispatches for IPUs and all CPUs
- CPU IQ option shows IPU Queue size for IPUs and all CPUs
- CPU TYPE|TRIP shows CPU Type of CPUs in the Time column
- PB IPU option shows busiest PCB, IPU, Affinity, and more
- ZOOM command supports all of the above new command options
- ZOOM columns are now better aligned between CPU/PB output
- CHIT and DISK rates can now report higher IO rates/second
- MONITOR command now allows you to select processes to monitor:
- MONITOR $PID allows selection of processes to monitor by $PID
- MONITOR <cpu>,<pin> allows selection of processes by cpu,pin
- MONITOR shows which processes will be monitored by PB or ZOOM
- MONITOR * selects all processes to be monitored by PB or ZOOM
- RPMSEER is a new RPM report writer program in the RPM subvol:
- RpmSeer prompts for config, runs RPM, saves report to disk
- See file RPMSEER in RPM subvol for info how to run RpmSeer

RPM 1.2 Summary T0877AAC/AAD
- RPM 1.2 provides following new commands, options, and features.
- RPM provides following new ByItem process selection features:
  BYBusy, ByMemory, ByIN, ByIO, ByOUT, ByPFS, ByQ, BySwaps
- BYBUSY shows processes using most CPU as percent of cpu busy
- BYMEMORY show processes using most memory as percent of memory
- BYIN shows processes receiving most input messages per second
- BYIO show processes with most input+output messages per second
- BYOUT show processes with most output messages sent per second
- BYRCVQ shows processes that have the longest $Receive Queue
- BYPFS show processes using most of Process File Segment space
- BYSWAP shows processes with most page faults per second
- RPM processor overhead REDUCED 10x-20x with new algorithms
- RPM messaging overhead REDUCED 100x with new buffer algorithm
- RPM added new SET MAX.. options allow control of normalization
- RPM PB + ZOOM commands have new options: ET, ETALL, ETPCT, DATE
- RPM CPU command has 2 new elapsed time options: ETALL and DATE
- RPM HISTORY command was added to provide history of commands
- RPM FC and ! allow <history-number> | <history-target> options
- RPM video is now set to normal when last line is high-lighted
- RPM now cleans up server processes when an IO session is lost

RPM 1.1 Summary T0877AAA/AAB
- RPM 1.1 provides the following features and bug fixes.
- RPM Wizard finds \nodes by searching all RPM*CNF files
- RPM Wizard validates if SSG T8488 version correct, and advises
- RPM CI won't hang if $System.System.RPMCNF has CPU, PB, ZOOM
- RPM CI won't delay 10 seconds if RPMLIC missing or has errors
- PB, CPU, ZOOM commands show error in output & continue to run

RPM 1.0 Summary T0877V01/H01
- HP NonStop RPM 1.0 is a Real-Time Process Monitor (RPM)
  that provides the following features and benefits:
- Discovers busiest processes in one or more Cpus or Nodes
- RPM continuously displays busy processors and processes
- RPM can fast sample and display stats down to 1 second
- RPM can be run directly from TACL prompt to provide
  instantaneously startup and display of busy processes
- RPM is run line configurable and allows a very wide-range
  of interfaces and configurations
- RPM supports many device types such as TTY, T6530, VT100
- RPM supports "super-sized" 200 x 300 VT100 devices
- RPM monitors, analyzes, and displays both NSK/OSS processes
- RPM provides user-defined alert threholds that can highlight
  critical-RED, Warning-YELLOW, and Informative-BLUE alerts
- RPM ByCpu displays busiest processes in a particular Cpu
- RPM ByNode displays busiest processes in NonStop node/segment
- RPM expand/cluster support finds busiest processes in network
  across very large collections of NonStop nodes/segments
- Reports can be on an entire cluster of Cpus/Nodes, or can
  focus on a single Node or a single Cpu
- Additional options provide sorting, filtering, and
  color-encoding of RPM statistics in real-time

NEW FEATURES HISTORY

1. [L01/AAE]

RPM CPU, Process Busy (PB), and ZOOM commands have new IPU
options to analyze and display IPU statistics on J06.16/L01
and higher operating systems. New options include:

a) CPU command IBUSY option provides color encoded IPU Busy%
statistics for all CPUs and IPUs.

b) CPU command IDISP option provides color encoded IPU Dispatch
statistics for all CPUs and IPUs.

c) CPU command IQUEUE option provides color encoded IPU Queue
length statistics for all CPUs and IPUs.

d) Process Busy (PB) command IPU option displays busy process
info including busy CPU, PIN, Affinity, IPU Number, and more.

e) ZOOM command supports all of the above new CPU/PB IPU options.

(SOLN 10-111011-0051)

2. [L01/AAE]

The RPM CPU command has 2 new options to display the CPU type.
A new TYPE option shows CPU type for all CPUs in the time column.
A new TRIP option ripples CPU type through the Time column for
a different CPU on each sample. The new TRIP option allows both
CPU Type & Time to be shown in the same column at the same time.

(SOLN 10-111011-0051)

3. [L01/AAE]

An advanced feature has been added to RPM 1.3 to allow selective
control over which processes are monitored by RPM. The MONITOR
command allows you to select only specific process(es) to be
monitored by PB and/or ZOOM commands. If one or more MONITOR
commands are specified, then only those processes are monitored
by RPM. MONITOR commands can be used either interactively, or
can be placed in an RPM*CNF file such as RPMCNF, RPM65CNF, or
RPMVTCNF on each system where you want to limit which processes
are monitored.

If no MONITOR process commands are specified, or if MONITOR * is
specified, all processes are monitored with PB or ZOOM commands.

EXAMPLES

MONITOR $A -- Monitor process named $A
MONITOR $B -- Monitor process named $B
MONITOR $C -- Monitor process named $C
MONITOR 0,0 -- Monitor cpu,pin where cpu=0 and pin=0
MONITOR 1,0 -- Monitor cpu,pin where cpu=1 and pin=0
MONITOR 9,784 -- Monitor cpu,pin where cpu=9 and pin=784
MONITOR -- Shows processes monitored by PB/ZOOM command
MONITOR * -- Tells RPM to monitor all processes on system
-- by resetting any/all prior MONITOR commands.

(SOLN 10-140630-2564)

4. [L01/AAE]

There is a new RPM report writer program named RPMSEER included in
the RPM 1.3 release subvol. RpmSeer prompts for runtime parameters
including report number, description, duration in minutes, sample
rate in seconds, then RpmSeer configures and runs one or more RPMs,
then saves reports to disk files. RpmSeer allows customization of
which processes are monitored using the new RPM MONITOR command
described above. To run RpmSeer from a TACL prompt, enter:
TACL 1> SEEVIEW CI RPMSEER

(SOLN 10-140630-2565)

5. [H01^AAC/AAD]

The RPM Process Busy command (PB) has new ByItem options that
allow sorting/selection of busy processes based on the following
criteria:

BYBUSY - shows processes that use the most CPU cycles as
percentage of Process-cpu-cycles / Elapsed-time

BYMEMORY - shows processes that use the most memory as
percentage of Process-memory-use / Total-cpu-memory

BYIN* - shows processes receiving the most messages as
percent of msgs-received-per-second/SET MaxInputs

BYIO* - shows processes that send+receive most messages as
percentage of msg-IO-per-second / SET MaxIOs

BYOUT* - shows processes that send the most messages as
percentage of msgs-sent-per-second / SET MaxOutputs

BYRCVQ/BYQ - shows processes with the longest $Receive Queue as
percentage of Process-receive-queue / SET MaxRcvQ

BYPFS - shows processes that use the most PFS space as
percentage of Process-PFS-bytes / max-PFS-bytes

BYSWAP* - shows processes with the most page faults as
percentage of Process-swaps-per-sec / SET MaxSwaps

asterisk * - If D/G-series STAT with * requires MEASURE.
If H/J-series MEASURE is NOT required at all.

In conjunction with BY items shown above, RPM has new SET MAX..
options that correspond to each rate/second BY item above. These
SET MAX... values allow user control of normalization values so
that displays can be tuned to system and application performance
characteristics of a customer's environment. The following is an
explanation of each SET MAX.. value:

SET MAXINPUTS | MAXOUTPUTS | MAXIO | MAXRCVQ | MAXSWAPS <value>
sets the normalization value for respective BY... item options.
The <value> is used with corresponding BY... options to determine
compute the respective BY option percentage normalization.
SET MaxInputs <value> default is 100 Inputs/second
SET MaxOutputs <value> default is 100 Outputs/second
SET MaxIOs <value> default is 100 IOs/second
SET MaxRcvQ <value> default is 100 Receive Queue length
SET MaxSwaps <value> default is 100 Swaps/second

Judicious choice of a max <value> provides numerous advantages:
EXAMPLE 1: SET MaxInputs 100 shows 99 inputs/sec as 99.00%
EXAMPLE 2: SET MaxInputs 10000 shows 9001 inputs/sec as 90.01%
In both cases above, digits in the percentage represent the
actual count of Inputs, IOs, Outputs, RcvQ, or Swaps because
of the way that RPM calculates and normalizes these statistics.
Also note that by normalizing these values; SET INFO, WARN, and
CRIT <percent> thresholds do not need to be changed.

(SOLN 10-091016-5432)

6. [H01^AAC/AAD]

RPM Performance Enhancements - using the new BY... options above
has REDUCED RPM processor overhead by a factor of 10-20x with
new RPM analysis algorithms. New RPM message analysis reports
have also allowed RPM messaging overhead to be REDUCED 100x
with new stats retrieval techniques. Previously, typical RPM
overhead was on the order of %1 or less of a CPU in a typical
system environment. Now typical RPM CPU overhead is one-tenth
of one percent or less.

(SOLN 10-091018-5457)

7. [H01^AAC/AAD]

The RPM PB command has 4 new elapsed time display options.
Syntax and semantics of these new options are as follows.
ET | ETALL | ETPCT - shows Elapsed-Time and Total-CPU-cycles
consumed for each process since it was started (as hhhhh:mm:ss).

ET - shows CPU used and Elapsed time for 80-column wide devices.

ETPCT - shows total CPU/ET = %ET, and total Elapsed time over
each process life-time and is useful on 80-column wide devices.

ETALL - adds total CPU/ET=ET%, plus Cpu usage, plus Elapsed time
stats to the default PB output resulting in output suitable for
wide-screen devices (emulators with 120 chars/line or more).
The format of elapsed time data is in hours, minutes, secs and
is formatted as hhhhh:mm:ss (supporting ET's up to 11.4 years).

DATE indicates show date the PROCESS was run instead of its ET.

(SOLN 10-090820-4011)

8. [H01^AAC/AAD]

The RPM ZOOM command has 4 new elapsed time options named
ET, ETALL, ETPCT, DATE. The ZOOM command provides a blended
display of CPU and PROCESS stats. For an explanation of the
ET | ETALL | ETPCT | DATE options, see HELP PB or HELP CPU.

(SOLN 10-090820-4011)

9. [H01^AAC/AAD]

The RPM CPU command has added 2 new elapsed time options named
ETALL and DATE.

ETALL shows total CPU-cycles/elapsed-time as ET% percentage,
plus Total CPU usage time, plus total Elapsed time since each
CPU was re/loaded. ETALL output is suitable for wide-screen
devices, eg emulators supporting 120 chars per line or more.
The format of elapsed time data is in hours, minutes, secs and
is formatted as hhhhh:mm:ss (supporting ET's up to 11.4 years).

DATE indicates show date when CPU was loaded/run instead of ET.

(SOLN 10-090820-4011)

10. [H01^AAC/AAD]

A HISTORY command is now supported in RPM. HISTORY or just HI
lists the history of commands entered into RPM. Commands can
be fixed or executed as follows:

FC [ <number> | <target> ]
! [ <number> | <target> ]

Enter HELP HISTORY for more information.

(SOLN 10-091016-5433)


PROBLEMS CORRECTED HISTORY

1. [H01^AAC/AAD]

Previously when a TCP/IP terminal session was lost RPM did not
always cleanup server processes. Now RPM always cleans up
processes if TCP/IP or inter-process sessions are lost.

(SOLN 10-091002-5081)

2. [H01^AAC/AAD]

Previously if the very last line of output for a ZOOM command
were highlighted, the screen area from that last line to the
end of screen might be highlighted. RPM now always sets video
to normal after last line highlighted.

(SOLN 10-091002-5082)

3. [H01^AAC/AAD]

Previously the ZOOM DETAIL option only showed detail for CPUs
but did not display details for the PROCESS entity. Now when
ZOOM .. DETAIL is specified details are shown for both the
CPU and PROCESS entity.

(SOLN 10-090922-4773)

4. [H01^AAC/AAD]

Previously the RAW option for the CPU, PB, and ZOOM commands
was ON by default resulting in less readible displays. Now
the RAW option is always OFF so that zero values are always
suppressed to all blanks (unless the RAW option is specified).

(SOLN 10-090922-4774)

5. [H01^AAC/AAD]

Previously the Dispatches/second rate displayed in the CPU and
ZOOM commands supported dispatch rates up to 32767 dispatches
per second. This limit has been removed.

(SOLN 10-091110-6217)

6. [H01^AAA/AAB]

SYMPTOMS:

Previously RPM Wizard only searched RPMCNF file for the list
of ADD \nodes to be analyzed. If other RPM*CNF files existed
such as RPMVTCNF or RPM65CNF and RPMCNF did not exist, or if
RPMCNF did not contain any ADD \node commands, then RPM would
issue a message that it had no nodes to analyze.

IMPACT:

Wizard would not find list of node(s) for analysis unless
the RPMCNF file existed and contained ADD \node commands.
Thus Wizard would not install or analyze nodes if ADD \node
commands only existed in RPMVTCNF or RPM65CNF files.
These problems are corrected by this SPR.

(SOLN 10-081014-6533)

6. [H01^AAA/AAB]

SYMPTOMS:

Previously RPM wizard could return the following error message:

PROMPT "CONFIG | SAVE | INSTALL | RUN | EXIT > ",#z,err;
--^--
Error unknown command "PROMPT "" 1248(25,4)

whenever product T8488/T6965 did not include a PROMPT command.
This SPR detects and advises how to correct this issue with
a message similar to the following:

RPM WIZARD requires product T6965D40^AAH(12AUG2005) or later.
Your system has old version T6965D40^AAG. To update your system
you should install SSG T8488D40^AAH or later.

IMPACT:

RPM Wizard would not run.

(SOLN 10-081014-6534)

8. [H01^AAA/AAB]

SYMPTOMS:

Previously whenever the $System.System.RPMCNF file contained
display commands such as the CPU, PB, or ZOOM commands then
RPM servers would not respond to RPM client requests, and the
following message would be displayed by the RPM CI:
\SYSNAME SSG_SendPrivate_Parse => Missing Header Line #2 SSG=21

IMPACT:

RPM would not display stats for any node that contained
display commands in their $SYSTEM.SYSTEM.RPMCNF file.
Display commands are CPU, PB, and ZOOM commands. To be sure,
display commands ARE permitted in other RPM*CNF files, just
not in the $SYSTEM.SYSTEM.RPMCNF file.

SIDE-EFFECTS:

RPM on local or remote nodes would appear to hang.

(SOLN 10-081014-6536)

9. [H01^AAA/AAB]

SYMPTOMS:

Previously if the RPMLIC file was missing or had errors, then
RPM clients would encounter 10 second display delays for data
returned by RPM servers. RPM clients could appear to be
"sluggish" or slow, when in fact they where just delaying and
displaying error messages. This issue has been addressed by
displaying errors in real-time in the real-time displays.

SIDE-EFFECTS:

RPM on local or remote nodes would appear to hang.

(SOLN 10-081014-6537)

10. [H01^AAA/AAB]

SYMPTOMS:

Previously routine exceptions in PB, CPU, ZOOM command output
could interrupt command output, and cause command execution to
terminate. Now routine exceptions are displayed as part of the
standard command output, and the commands continue to operate.

IMPACT:

Commands which previously would terminate operation,
now continue to operate even across multiple nodes.

(SOLN 10-081014-6538)

Known Problems Remaining:

NONE

Questions or comments - Support@NonStopRPM.Com
Last modified: October 25, 2014