READ THIS FILE COMPLETELY BEFORE BEGINNING PRODUCT INSTALLATION Copyright 2001 Compaq Computer Corporation Product Name: Compaq ASAP Extension (ASAPX) Marketing Product ID: SE31V2.1 Component Products: T0403AAA I. Basic Product Installation Instructions 1. Ensure that requirements for using this 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 V Installation Prerequisites below). 3. Review the file USRGUIDE.PDF (in the subdirectory NSK_SW on this CD) containing the IPSetup User Guide, which provides instructions for using IPSetup, a utility provided on the CD that enables installation of Independent Products. You need Adobe Acrobat Reader (available on this CD) to read or print the IPSetup User Guide. 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 TCP/IP and FTP are unavailable, or 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, if any, after using IPSetup to place and install this product. II. Pre-Installation Instructions 1. Stop all running copies of ASAP. III. Post-Installation Instructions 1. Modify the ASAP configuration file (ASAPCONF) to include the SET APP ON command. 2. If ASAP and ASAPX are not running from $SYSTEM.SYSTEM, modify the ASAP configuration file (ASAPCONF) to include the SET APP PARAM command identifying the location of the ASAPX configuration file (ASAPXCNF). 3. Create and edit the ASAPX configuration file (ASAPXCNF) to include SET commands to tailor ASAPX to your environment and applications. See the ASAPX manual for a description of all ASAPX SET commands. Note you may execute the INSTALL macro in the ASAPX ISV to re-install ASAPX and automatically create an initial ASAPXCNF file the first time you install ASAPX. 4. If you are migrating from release 1 of ASAPX read the comments and examples on release 1 to release 2 migration in the ASAPX Manual and perform the tasks described therein. 5. Restart ASAP to start the ASAPX environment. Note at this point ASAPX has been started without any custom entity definitions to describe your application. 6. Modify your applications to use ASAPX as described in the Programmers Guide section of the ASAPX manual. 7. Create custom ASAP EDL files to describe your application. 8. Restart all parts of ASAP after distributing the new EDL to all NSK servers and ASAP Clients. IV. Product Requirements Required Hardware: NonStop RISC-based servers Minimum OS Release: NonStop Kernel release D42 NonStop Kernel release G03 Required Software: T0402V01 - Availability, Stats and Performance (ASAP) Server Disk Space Requirement: ISV Subvolume: 3.9mb Install Subvolume: 3.1mb APPDB Database: 556 bytes * num domains * intervals per day Memory Requirement: Approximately 4k bytes per registered domain V. Installation Prerequisites Required Hardware: Tandem NonStop server Communications controller allowing file transfer from PC to Tandem 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 Tandem Required Software: T9550D30 SOCKET LIBRARY or higher version T9552D30 TCP/IP FTP with IPM ABG or superseding IPM (for releases D31.00 to D40.00) T9552D40 TCP/IP FTP with IPM ABJ or superseding IPM (for releases D40.01 and higher) Microsoft Windows 95, or Windows NT 4.0 or later Microsoft TCP/IP stack and FTP client VI. Manuals Included On this CD Compaq ASAP Extension Manual VII. CD-ROM Root Directory Contents AUTORUN.INF File containing CD AutoRun commands AXDIST.EXE Microsoft redistributable libraries file. 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. CD_DOCS Subdirectory containing product documentation. PDF_DOCS Subdirectory of CD_DOCS containing: 1. Product manuals in PDF format for viewing with Adobe Acrobat Reader 2. ACROBAT_VIEWERS subdirectory containing Adobe Acrobat Reader for DOS, OS/2, Windows, Windows NT, MacOS, Sun OS, Solaris, HP-UX, IBM AIX, and SGI IRIX. ADDENDUM Overview: ========= The Compaq ASAP Extension (ASAPX) enables customer applications for monitoring by the Availability, Stats and Performance (ASAP) product. ASAPX provides a direct view into an application so a customer can always know if an application is meeting its service level objectives. ASAPX executes on D42.00/G03.00 onward. New Feature History: ==================== 2.0 [V02] ASAPX now supports multiple application definitions using the ASAP Entity Definition Language. Each EDL entity has its own set of DataItem and Metric(EDL Attribute) definitions. 2.0 [V02] The ASAPX host-based objectives concept has been extended to all components of ASAP Server as Discrete Object Thresholds (DOTs). The ACTIVATE, ADD, ALTER, ASSUME, COMMIT, DEACTIVATE, DELETE, INFO, LIST, OPEN and REMOVE commands have been replaced by the ASAP MONITOR and RANK commands. Many ASAPX SET commands have also been deleted or replaced with ASAP SET commands. Due to the DOTs conversion the objectives database in the Release 1 version of ASAPX is obsolete. All objectives from Release 1 databases should be saved to an edit file using the ASAPX INFO, OBEYFORM command. They can then be edited into ASAP RANK commands. 2.0 [V02] Operational Status and State. Each ASAPX Entity now includes the operational status and state of the process that registered the domain. Both the 15-byte operational status and the resulting OEM state can also be set directly by an application using a new ASAPX API procedure called ASAP_OPSTATE_. 2.0 [V02] Each ASAPXMON process can now be configured to write detail records directly to the ASAP Collector, bypassing the ASAPXSGP process. Note the ASAP ID must not exceed 2 characters if the ASAP Collector resides on a remote node. For example, change $ZOO to $ZO. 2.0 [V02] ASAPX now computes and displays aggregate data for any of the 4 possible levels within a domain name. For example if Atm\West\SanFran\Loc23 is a typical domain then ASAPX can compute aggregate totals for Atm, Atm\West and Atm\West\Sanfran. 2.0 [V02] The NAK and UNAVAIL metrics from Release 1 have been added to a set of 11 optional metrics that ASAPX will compute on behalf of the application. Each optional metric, except Registration Time, also has an associated OEM state. The built-in metrics are: Nak Negative acknowledgement counter. UnAvail The unavailability of the registering process during the interval. Cpu The primary processor of the registering process. Pri The priority of the registering process. Busy Percent CPU busy for the registering process. PState The process state of the registering process. WState The wait state of the registering process. RegTime The registration date and time the domain was registered. DownTime Total downtime (in seconds) for the registering process. Avail The overall availability of the registering process. Version The application version supplied to ASAP_REGISTER_, or a default version supplied by ASAP. 2.0 [V02] ASAPX supports 1024 domains per processor and a maximum of approximately 90 user-defined application entities. Problems Corrected History: =========================== 2.1 [AAA] ASAPX failed to write EMS alerts for Status/operational state changes when configured to do so using the RANK command. For example, the command "RANK ATM, STATUS CRITICAL", did not cause ASAPX to generate a critical event when the Status attribute produced an alert condition. (SOLN 10-010803-1955) 2.1 [AAA] ASAPX would not allow definition of more than 11 (approximately) user-defined entities even though the ASAP maximum entity count is much greater. (SOLN 10-010809-2101) 2.1 [AAA] ASAPX reported invalid Busy percentages for the first interval after a process registered a domain in a CPU. ASAPX now reports 0.00 for the first interval and reports the actual Busy percent for the 2nd sample after establishing its baseline measurement. (SOLN 10-010820-2310) 2.1 [AAA] Invalid elapsed times were computed when SET TEST ON was specified in the ASAPXCNF configuration file and ASAPX missed at least one sample. The ASAP RATE value was multiplied by 60 seconds, not taking into account the extra time caused by the missed sample. ASAPX now rounds to the nearest minute and takes the difference between samples instead of using the ASAP RATE value. (SOLN 10-010822-2427) 2.1 [AAA] The command "MONITOR APP [], REMOVE" failed to remove the specified APP domain, and failed to remove all APP domains when no domain was specified. (SOLN 10-010823-2481) 2.1 [AAA] ASAPX computed DownTime, Avail and UnAvail incorrectly for the interval where a domain failed. It also failed to preserve the contents of those 3 built-in attributes when a domain stopped and restarted. (SOLN 10-010823-2487) 2.1 [AAA] ASAPX computed DownTime incorrectly when a domain re-registered in a different CPU after at least one sample interval had passed since it stopped processing in the original CPU. (SOLN 10-010830-2759) 2.1 [AAA] ASAPX would incorrectly return a domain name error to callers of the ASAP_REGISTER_ procedure when the domain name being registered contained the name of an ASAP entity at a lower level of domain name. For example, the domain name "Atm\Disk" would produce an error even though it is a valid domain name. (SOLN 10-010919-3206) 2.1 [AAA] ASAPX would write duplicate records to the ASAP collector under certain conditions. If several hundred aggregate domains were processed in a single CPU, ASAPX occassionally wrote duplicate records for one or more of the aggregate domains. (SOLN 10-011002-3507) 2.1 [AAA] ASAPXMON processes mysteriously stopped and restarted without notification. The 3rd I/O error encountered over any span of time caused the ASAPXSGP process to mistakenly stop and restart an ASAPXMON. The ASAPXSGP process now stops and restarts an ASAPXMON only after 3 consecutive I/O errors. (SOLN 10-011002-3508) 2.0 [V02] To limit data flow to ASAP Client and still show pertinent information, the APP command now supports the MINSTATE and COUNT options. MINSTATE and COUNT are intended for use with EDL DETAIL commands in user-defined entity definitions. (No SOLN) 2.0 [V02] For large domain populations the AGGREGATEONLY option now processes fewer records resulting in improved response time. (No SOLN) 2.0 [V02] ASAPXMON no longer abends on problems with MONITOR, LIST, DETAIL commands when the length of a dataitem exceeds 20 bytes. (No SOLN) 2.0 [V02] ASAPXMON now outputs the exponent sign correctly in large floating point numbers. (No SOLN) 2.0 [V02] The list insertion algorithm in ASAPXSGP is modified for better performance with large domain populations. (No SOLN) 2.0 [V02] The APP command no longer returns invalid records when Entity names exceed 8 characters. (No SOLN) 2.0 [V02] The EDL compile process now enforces the following for user-defined EDL files: 1. The Dataitems Entity property must be defined. 2. The MetricRule Attribute property must be defined for all user-defined attributes except ASAPX header and builtin attributes. (No SOLN) 2.0 [V02] In ASAPX 1.0 the ASAPXMON processes attempted to use shared memory and the domain table to reconstruct the environment after a restart. Under some cases the contents of shared memory are not valid after a restart, which causes ASAPXMON to mistakenly register multiple domains with no name into slot 0. This is known as the 0-domain problem. ASAP 2.0 removes the reliance on shared memory at restart time. ASAPXMON now uses only the contents of the domain table to reconstruct its environment after a restart. (SOLN 10-001229-8182) Known Problems Remaining: ========================= None.