\new;poff 8;text off;join off;justify off;head " ";subhead " " \sect "ASAP SRVR EXTENSION T0403V02 01OCT2003 Page "1;center SOFTWARE RELEASE DOCUMENT ADDENDUM Product Name: ASAP SRVR EXTENSION Product Number: T0403V02 Date: 01OCT2003 PVU Number: T0403AAD Copyright Notice: HP CONFIDENTIAL: NEED TO KNOW ONLY Copyright 2003 Hewlett Packard Development Company, L.P. Protected as an unpublished work. The computer program listings, specifications and documentation herein are the property of Compaq Computer Corporation and successor entities such as Hewlett Packard Development Company, L.P., or a third party supplier and shall not be reproduced, copied, disclosed, or used in whole or in part for any reason without the prior express written permission of Hewlett Packard Development Company, L.P. Summary: This PVU introduces support for super-scalar ZLE systems with tens of thousands of monitored domains. It also corrects problems with duplicate domains in the domain table, excessive opens against the domain table, ENFORM's inability to read attributes defined as TYPEDATA REAL64 and constant restarting of failed ASAPXMON processes. This PVU also provides improved startup time and better aggregation of certain ASAPX built-in attributes. Finally, the ASAP_REGISTER_ procedure now returns error -6 when statistics collection has been disabled. Superseded PVUs: T0403AAA T0403AAB T0403AAC Requisite PVUs: T0402AAD Required Hardware: NonStop RISC-based server Communications controller allowing file transfer from PC to 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 Required Firmware: NONE Required Software: T0402V02 T9050D42 if using D4x.xx T9050G06 if using G0x.xx T9550D40 T9552D40 Microsoft Windows 95, or Windows NT 4.0 Microsoft TCP/IP stack and FTP client Manuals: 425265-003 ASAP Extension Manual Installation Considerations: Subsystem interruption required - Perform these pre-installation steps: 1. If you are migrating from release 1 of ASAPX, read the comments and examples on release 1 to release 2 migration in the ASAP Extension Manual and perform the tasks described there. 2. Ensure that requirements for using this SPR are met (see Req't PVUs, Req'd HW, and Req'd SW). 3. Review the IPSetup User Guide (file USRGUIDE.PDF in the NSK_SW subdirectory on the ASAPX CD). IPSetup is provided on the CD to facilitate installation of Independent Products. Use Adobe Acrobat Reader (available on the CD) to read or print the IPSetup User Guide. 4. Decide whether you will use DSM/SCM to move the SPR's files to the Installation Subvolumes (ISVs) after they are placed on the NonStop server. Using DSM/SCM is optional, but recommended when DSM/SCM is available. - Perform these installation-related steps: 1. Run IPSetup to place (move files from the CD to the NonStop server) and optionally install (move files to correct ISVs) this SPR. If TCP/IP and FTP are unavailable, or if you have problems with automatic file placement, follow the instructions in the IPSetup User's Guide section "Manual Software Placement Using the IPSetup TACL Program" to manually place the files. 2. If you are using DSM/SCM to install this SPR: - COPY the SPR to a new revision of the software configuration you want to update. - BUILD and APPLY the configuration revision. - Run ZPHIRNM to perform the RENAME step. - Perform these post-installation steps: 1. Run ASAP Extension INSTALL to update the ASAPX subsystem: a. TACL 1 > VOLUME $.ZASAPX b. TACL 2 > RUN INSTALL c. Fill in the source and destination subvolumes. To install to a remote node, fully qualify the destination subvolume name. For example, \remote.$system.system. New Features: 1. [AAD] ASPAX ZLE. ASAPX now provides support for super-scalar ZLE systems with tens of thousands of monitored domains. The domain per CPU limit is now user-defined with a new upper limit of 10,000 domains per CPU. Use the new SET MAXDOMAINS configuration command to increase the 1,024 domain per CPU default. The aggregate domain per CPU limit is now user-defined with a new upper limit of 10,000 aggregate domains per CPU. Use the new SET MAXAGGREGATES congiguration command to increase the 1,024 aggregate domain per CPU default. The SET AGGREGATE ONLY option is made into a viable method to reduce disk I/O to the historical database. A new MEMORY option on the APP command allows ASAP to retrieve detail domain data directly from ASAP memory. This lets a user write only aggregate records to the database, but still view detail records when domains alert. Set the following as the EDL DETAIL command in all user-defined EDL files: DETAIL "APP ^, DE, ST, MEM, MIN, COUNT 20" When the command defined by the EDL DETAIL property string is set as shown above, a user can right-mouse on an aggregate domain that is alerting and then choose "Show Object Details" to see alerting detail domains. Next, the user is given complete control over the content of aggregate domain records with the addition of aggregation syntax to the EDL MetricRule formula. The new MetricRule syntax is: is: # [SUM|AVG|MIN|MAX|CNT] (default SUM) C S [SUM|AVG] (default varies) is: +, -, / or * - arithmetic operators Examples: METRICRULE "#0 SUM/S SUM" METRICRULE "#0 MIN/S AVG" METRICRULE "#0 MIN" METRICRULE "C100*((#0 MIN + #1 MAX)/#2 AVG)" Finally, because the APP command's AGGREGATEONLY option is more frequently used, it has been abbreviated to "AGGONLY" and "AO" in addition to the complete spelling. In summary, ASAPX ZLE lets a user monitor tens of thousands of detail domains while reducing disk I/O to the historical database by writing only aggregate records to disk. Please see the new version of the ASAP Extension Manual that ships with this release for more information on the ASAPX ZLE enhancement. (SOLN 10-030822-9092) Problems Corrected: 1. [AAD] SYMPTOMS: Duplicate domains in domain table. CONDITIONS: When access errors prevent ASAPX from updating the domain table for a domain remove operation. LIKELIHOOD: Likely FIX-INFO: ASAPX no longer removes a domain from memory if it cannot first remove it from the domain table. It will re-try failed removals at each interval until successful. (SOLN 10-030822-6067) 2. [AAD] SYMPTOMS: Excessive opens against domain table. CONDITIONS: When many domains are in the down state. LIKELIHOOD: Likely FIX-INFO: ASAPX now keeps the domain table open until the end of the statistics interval if it opens the table during the interval to check the ownership of a down domain. (SOLN 10-030822-9087) 3. [AAD] SYMPTOMS: ASAPXMON startup time is noticeable. CONDITIONS: When many domains are defined. LIKELIHOOD: Likely FIX-INFO: ASAPXMON restart time is dramatically improved by improvements to its list insertion algorithm. (SOLN 10-030822-9088) 4. [AAD] SYMPTOMS: Constant restart of failed ASAPXMON processes. CONDITIONS: When ASAPXMON fails due to configuration or resource problems. LIKELIHOOD: Likely FIX-INFO: ASAPXMON restarts are throttled to once per interval until 3 failures when it becomes the maximum of once per interval or once per hour. (SOLN 10-030822-9089) 5. [AAD] SYMPTOMS: Meaningless aggregation for CPU, Pri, PState, WState and Version built-in attributes. CONDITIONS: When SET AGGREGATE is defined for an entity and the entity uses one of the aforementioned attributes. LIKELIHOOD: Certain FIX-INFO: ASAPX now propagates the value associated with the worst state for each of these attributes. For example, if there are 10 domains that make up the aggregate and one of the domains has a critical alert on the CPU attribute, then that CPU attribute value and state will be propagated to the aggregate record. (SOLN 10-030822-9090) 6. [AAD] SYMPTOMS: ENFORM cannot read attributes defined as floating point (REAL64). CONDITIONS: When attempting to read the ASAP database using ENFORM. LIKELIHOOD: Certain FIX-INFO: ASAPX now supports implied decimal points so attributes can be defined as TYPEDATA INT64 and still output decimal values using the fixed format option, for example FORMAT "Fx.y". ASAPX stores the value as FIXED(y) in the APP record. (SOLN 10-030822-9096) 7. [AAD] SYMPTOMS: Cannot access ASAPX from PIC applications. CONDITIONS: On G06.20 and beyond when running PIC applications. LIKELIHOOD: Certain FIX-INFO: ASAPX now provides a DLL for the API library (ASAPXDLL) for use with G06.20 and beyond. HP recommends use of the ASAPXDLL instead of the older libraries. (SOLN 10-030822-9093) 8. [AAD] SYMPTOMS: Slower performance. CONDITIONS: When large domain populations are registered. LIKELIHOOD: Certain FIX-INFO: ASAPX modules are now accelerated. (SOLN 10-030822-9091) 9. [AAD] SYMPTOMS: ASAP_REGISTER_ allows registrations even though statistics collection has been disabled. CONDITIONS: When the ASAPX DISABLE STATS command is entered. LIKELIHOOD: Certain FIX-INFO: ASAP_REGISTER_ now returns error -6 when statistics collection has been disabled. (SOLN 10-030912-9607) Known Problems Remaining: 1. SYMPTOMS: Corrupted ASCII text when supplied as the replace value (math 1) for a constant DataItem. CONDITIONS: NONE LIKELIHOOD: Certain WORKAROUNDS: As of T0403AAB, use math 2 to replace a constant DataItem with 8 bytes of printable ASCII text. As of T0403AAD define text DataItems as type "T". (SOLN 10-020207-6531) 2. SYMPTOMS: Delayed response from ASAP_REGISTER_ call. CONDITIONS: Can only occur when ASAPX is running in "write-to-collector" mode on a very busy system with queueing on the disk process. LIKELIHOOD: Unlikely WORKAROUNDS: As of T0403AAB, use the ASAP_REGISTER_ Timeout parameter to set a lower timeout value for calls to ASAP_REGISTER_. (SOLN 10-020222-6886)