READ THIS FILE BEFORE BEGINNING PRODUCT INSTALLATION Copyright (C) 2010 Hewlett-Packard Company Product Name: RPM Real-time Process Monitor Product Marketing ID: RPM01V1 S-series update 2 HRPM01V1 H-series update 2 QRPM01V1 J-series update 2 Component Products: T0877H01^AAC H- or J-series T0877V01^AAD S-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. Review the file USRGUIDE.PDF in the 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. You will need Adobe Acrobat Reader to read or print the IPSetup User Guide. Visit Adobe's website to download the latest Adobe Acrobat Reader: http://www.adobe.com 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. RUN RPMWIZ from TACL and follow the RPM Wizard prompts which will guide you through the post installation steps. 2. If you need additional help with RPM setup, see the detailed explanation provided in Section 2 of the HP NonStop RPM User's Guide at the NonStop Technical Library http://docs.hp.com. Install 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 Minimum OS Release: S-series - NonStop Kernel G05 or higher H-series - NonStop Kernel H06 or higher J-series - NonStop Kernel J00 or higher Required Software: T8488 any version Disk Space Requirement: ZRPM subvol 5.0 MB $SYSTEM.STSTEM 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 Communications controller allowing file transfer from PC to HP NonStop Server PC with 486 or higher processor and all of the following: CD-ROM drive VGA or higher-resolution video adapter and monitor Microsoft Mouse or similar pointing device Communications controller allowing file transfer from PC to HP NonStop Server Required Software: Microsoft Windows Vista, Microsoft Windows XP, Microsoft Windows 2000, Microsoft Windows ME, or Windows NT 4.0 or later. Microsoft TCP/IP stack and FTP client VI. Manuals for this CD: To access the documentation for this product, see the HP NonStop Technical Library at http://docs.hp.com 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 NonStop Kernel 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 ======= ** HP NonStop RPM is a Real-time Process Monitor that provides real-time analysis and display in the form of color-encoded alerts on busy processes by Cpu, Node, or super-cluster. Overview ======== [T0877AAC/AAD] - RPM provides many new ByItem process selection features including: BYBusy, ByMemory, ByInputs, ByIOs, ByOutputs, ByPFS, ByQ, BySwaps - BYBUSY show processes using the most CPU as percentage of cpu busy - BYMEMORY show processes using most memory as percent total memory - BYIN shows processes receiving the most input messages per second - BYIO show processes with the most input+output messages per second - BYOUT show processes with the most output messages sent per second - BYRCVQ shows those processes that have the longest $Receive Queue - BYPFS show processes using the most of Process File Segment space - BYSWAP shows processes that have the most page faults per second - RPM processor overhead REDUCED 10x-20x via new analysis algorithm - RPM messaging overhead REDUCED 100x using new buffering algorithm - RPM added new SET MAX.. options allowing control of normalization - RPM PB + ZOOM commands have 4 new options: ET, ETALL, ETPCT, DATE - RPM CPU command has 2 new elapsed display options: ETALL and DATE - RPM HISTORY command has been added to provide history of commands - RPM FC and ! added and accept | - RPM video is now set to normal whenever last line is high-lighted - RPM now cleans up server processes whenever an IO session is lost [T0877AAA/AAB] - RPM Wizard now finds \nodes for analysis by searching RPM*CNF files - RPM Wizard now validates if SSG T8488 version correct, and advises - RPM CI no longer hangs if $System.System.RPMCNF has CPU, PB, ZOOM - RPM CI does not delay 10 seconds when RPMLIC missing or has errors - PB, CPU, ZOOM commands now show errors in output & continue to run [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 OSS and NSK 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 allows analysis of busiest processes 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. [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 that receive the most messages as percentage 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 new 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 sets the normalization value for respective BY... item options. The is used with corresponding BY... options to determine compute the respective BY option percentage normalization. SET MaxInputs default is 100 Inputs/second SET MaxOutputs default is 100 Outputs/second SET MaxIOs default is 100 IOs/second SET MaxRcvQ default is 100 Receive Queue length SET MaxSwaps default is 100 Swaps/second Judicious choice of a max 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 thresholds do not need to be changed. (SOLN 10-091016-5432) 2. [H01^AAC/AAD] RPM Performance Enhancements - using new BY... options explained above has allowed RPM processor overhead to be REDUCED 10-20x with new RPM analysis algorithms. Also new RPM message analysis reports have allowed RPM messaging overhead to be REDUCED 100x with a 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) 3. [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 suitable for 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) 4. [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) 5. [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) 6. [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 [ | ] ! [ | ] 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 was not always able to cleanup server processes. Now RPM always cleans up server processes when TCP/IP and/or interprocesses 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 the 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