================================================================ File last modified: Thu Jan 17 11:45:36 PDT 2002 Latest version: http://docs.hp.com/hpux/onlinedocs/diag/st/st_read.htm ================================================================ Readme for Diagnostics (Support Tools) Support Plus March 2002 CONTENTS Overview Required and Recommended Patches Loading Patches Known Problems Removing Diagnostics Getting More Information EMS Hardware Monitors This DIAGNOSTICS.readme document covers the March 2002 release of Support Plus for S800/S700 systems (HP-UX 11i and 11.00). ============================================================================== NOTE: As of the March 2002 release, HP-UX 10.20 is no longer included on Support Plus. ============================================================================== NOTE: As of the September 1999 release, the name of the Diagnostic/IPR Media has been changed to Support Plus. In addition, the format has changed so that there is a separate CD-ROM for each version of the operating system: HP-UX 11i (11.11) and HP-UX 11.00. ============================================================================== CAUTION: You must install certain patches before loading Online Diagnostics (Support Tools). See "Required and Recommended Patches" below. ============================================================================== Overview -------- Support Plus contains a complete build of the following support tools: - Support Tool Manager (STM) for online diagnostics - ODE (offline diagnostics) / LIFLOAD - EMS hardware monitors (HP-UX 11i and 11.00) - EMS Kernel resource monitors (HP-UX 11.x only) - Predictive Support (HP-UX 11.00/S800 only) - (Support Plus no longer contains File System Recovery. The 11.X releases have File System Recovery on the Core/Install Media. This is included in your HP-UX media kits.) The support tools are all contained in a Software Depot (SD) bundle named "OnlineDiag". This bundle is distributed in two ways: - Support Plus media - HP Software Depot website This is the generic command line for listing various content levels of the depot: swlist -l -s //DIAGNOSTICS/ where = bundle Bundle level listing = product Product level listing = subproduct Sub-product level listing = fileset File set listing Location where the CD file system is mounted. The OS contents of the depot. = B.11.00 = B.11.11 ============================================================================== The following is a live examples for the IPR0109 11.00 Support+ CD media: For the 11.00 media... > swlist -l bundle -s /cdr/DIAGNOSTICS/B.11.00 # Initializing... # Contacting target "hpdst4"... # # Target: hpdst4:/cdr/DIAGNOSTICS/B.11.00 # B9073AA B.04.00 HP-UX iCOD-purchase (Instant Capacity on Demand OnlineDiag B.11.00.18.09 HPUX 11.0 Support Tools Bundle, Sep 2001 T1322AA B.04.00 HP-UX iCOD-utility (Instant Capacity on Demand - swlist -l product -s /cdr/DIAGNOSTICS/B.11.00 # Initializing... # Contacting target "hpdst4"... # # Target: hpdst4:/cdr/DIAGNOSTICS/B.11.00 # Contrib-Tools B.11.00.18.09 Contributed Tools EMS-Config A.03.20 EMS Config EMS-Core A.03.20 EMS Core Product EMS-KRMonitor A.11.00.04 EMS Kernel Resource Monitor LIF-LOAD B.11.00.18.09 HP LIF LOAD Tools Predictive C.11.00.18.07 HP Predictive Support Sup-Tool-Mgr B.11.00.18.09 Support Tools Manager for HPUX systems iCOD-purchase B.04.00 Instant Capacity On Demand - purchase iCOD-utility B.04.00 Instant Capacity On Demand - utility The Support Tools Manager, ODE/LIFLOAD, and (optionally) Predictive Support must be loaded after the Operating System is installed. The EMS Hardware Monitors are installed automatically when STM is installed. Support Plus can be: - Mounted and used to install online diagnostics and support tools via swinstall(1m). - Booted to ISL and used to load and run offline diagnostics. For this March 2002 release: - All diagnostic defect repairs and enhancements as of March 1, 2002, are included. Any future patches dated after March must be loaded after Support Plus is loaded. - Support for the new hardware in all active releases as of March 1, 2002. ============================================================================== NOTE: SCAN software not in Support Plus (Sept 2001) As of the September 2001 release, the SCAN software for Superdome is longer be delivered on the HP-UX 11i version of the Support Plus CD-ROM. Instead, the SCAN software will be available on the SMS Media. The FWUU bundle which was previously included in the SCAN software will still be delivered on Support Plus, but it will be in the OnlineDiag depot B.11.11. ============================================================================== Required and Recommended Patches -------------------------------- ============================================================================== CAUTION: You must install certain patches before loading Online Diagnostics (Support Tools). ============================================================================== This document lists the required and recommended patches at the time of writing. Patch REQUIRED for HP-UX 11.0 (S800 and S700): For HP-UX 11.0 (S800 and S700): PHKL_18543: s700_800 11.00 PM/VM/UFS/async/scsi/io/DMAPI/JFS/perf patch For proper operation of the Online Diagnostics (HP-UX 11.0 version only), you must install the above patch BEFORE installing Online Diagnostics. Otherwise, you may see error messages about the missing patches during the installation of Online Diagnostics; you can get further information by reviewing the swagent.log file. This is a large patch which can take a while to load (for example 30 minutes). It also has the following dependencies (other patches that must be loaded): PHKL_20016 (for G70,H70,I70 systems only) PHKL_25999 (supercedes PHKL_22589) PHKL_24027 (supercedes PHKL_22432, PHKL_21392, PHKL_20674, PHKL_20079, PHKL_19169) PHKL_25906 (supercedes PHKL_25210, PHKL_24273, PHKL_23813, PHKL_23628, PHKL_23183, PHKL_22744, PHKL_22380, PHKL_21532, PHKL_21024, PHKL_17038) PHCO_23651 (supercedes PHCO_22453, PHCO_20882, PHCO_17556, PHCO_13411) PHCO_23876 (supercedes PHCO_22269, PHCO_21627, PHCO_21187, PHCO_19047, PHCO_17792, PHCO_17058) Patch REQUIRED for multiple CPUs (HP-UX 11.00) PHKL_26001 (supercedes PHKL_21420: s700_800 11.00 specify diag2 as MP-safe) Patch PHKL_26001, replacing PHKL_21420, is required to fix a problem with the CPU Info tool that occurred on Multiple-Processor (MP) systems on HP-UX 11.00 only. The CPU Info tool was causing numerous warning messages to be logged to the file /var/adm/syslog/syslog.log. The messages logged were similar to: mpc_bindlwp: Migrating process 3269 from processor 30 to processor 0! mpc_bindlwp: Overriding conflicting mandatory binding! This problem was due to non-MP-safe calls being made when one of the CPUs above 0 was selected. PHKL_21420 is a kernel patch and requires a reboot. PHKL_21420 has a dependency on PHKL_18543. PHKL_21420 is included in the 11.00 HW CR patch bundle XSWHWCR1100. Patch recommended (but not required) for older systems with HP-PB bus (HP-UX 11.0/S800 only): For HP-UX 11.0 (S800): PHKL_21569: s700_800 11.00 diag0 cumulative patch (replaces PHKL_19321) (this patch is included in the 11.00 HW CR patch bundle XSWHWCR1100) Patch required only if you intend to run the EMS hardware monitors for the Fibre Channel Arbitrated Loop Hub Monitor or the Fibre Channel Switch Monitor: For HP-UX 11.0 (S800 and S700): PHSS_24627: s700_800 11.x HP aC++ -AA runtime libraries (aCC A.03.30) (replaces PHSS_22543, PHSS_21906, PHSS_16587) (PHSS_22543 is included in the 11.00 HW CR patch bundle XSWHWCR1100) Patch required only if your system includes a HP SureStore E Disk Array FC60. This patch is required to to run the EMS hardware monitor (fc60mon) or STM tools for this device. For HP-UX 11.0 PHCO_23149: s700_800 11.X HP Array Manager/60 cumulative patch (supercedes PHCO_22628, PHCO_22196) (this patch is included in the 11.00 HW CR patch bundle XSWHWCR1100) Loading Patches --------------- You can load the patches in one of three different ways: Method 1: Entire patch bundle. Install the entire HW or HWCR patch bundle for your system. Advantages: simple and tested process. Disadvantages: the bundle can be many megabytes in size. Choose the Hardware Critical (HWCR) or Hardware (HW) patch bundle appropriate for your system. For example, choose XSWHWCR1100 for a Series 800 system running HP-UX 11.00. The patch bundles are distributed in the same way as the OnlineDiag bundle: - The Support Plus media - The HP Software Depot website The procedure for using swinstall to load the patches is described in Chapter 5 of the "Support Plus: Diagnostics Users Manual." Method 2: Individual patches from bundle. Install ONLY the individual patches required for your system from the HW or HWCR patch bundle described above. Advantages: Small number of patches. Disadvantages: Requires knowledge of SD (swinstall) to select patches (interactive selection or command line selection). Method 3: Individual patches from website. You can also obtain the patches through the HP IT Resource Center (http://us.itrc.hp.com). A problem with loading individual patches from this website is that a system reboot is required for every patch that requires a reboot (patches to the kernel, indicated by "PHKL" in the patch name, all require a reboot). Known Problems -------------- ============================================================================== CAUTION: Info Tool Causes HPMCs on K- and T-Class (HP-UX 11i only) K-Class and T-Class computers running HP-UX 11i will experience HPMCs or Data Page Faults if you run the STM Info Tool to retrieve configuration information from HP-PB SE SCSI adapters (JAGad88317, JAGad97126). The root cause is a problem in the HP-UX 11i kernel, which is exposed when the Info Tool is run as described above. To correct the problem and avoid potential HPMCs, load patch PHKL_25552 or its successor. This is a kernel patch and requires a system reboot. STM only exposes this problem if the Info Tool is run on HP-PB SE SCSI adapters. STM does not expose the problem if the Info Tool is run against other I/O devices. ============================================================================== ============================================================================== CAUTION: UPS Monitor May Need a Patch In some cases, the UPS monitor (dm_ups) will not function and will instead generate event 45 (formerly event 42) with the text: Probable Cause / Recommended Action: The monitor was unable to locate the fifo pipe that should have been created by ups_mond. Therefore, information about the ups cannot be sent to the monitor. You need version (80.1.2.3) of ups_mond or greater. To update your system with the correct version of ups_mond, install one of the following patches: HPUX 11.00 : PHCO_24172 (supercedes PHCO_23831) HPUX 11.11 : PHCO_24173 (supercedes PHCO_23832) To fix the problem, load the indicated patch or load the HWE patch bundle which contains this patch. For HP-UX 11i, the ups_mond patch PHCO_23832 is also distributed on the Sept 01 OE. This problem will affect most systems with a UPS when the September 2001 diagnostics are installed. The only systems not affected will be those which are being updating from certain versions of the diagnostics (September 2000 through March 2001) and which do not have patch PHCO_19040 (HP-UX 11.00) installed. ============================================================================== CAUTION: Monitoring Changes for disc30, sdisk and disk array devices As of IPR 9902 (Feb 99 release), there has been a change to the way that monitoring is done for disc30, sdisk and the HA Disk Array Models 10, 20, and 30FC. Formerly, the "diaglogd exec" programs (pdisc30_exec, pharaymon_exec, and psdisk_exec) handled driver error entries for these devices. As of IPR 9902, these programs have been deleted and their functionality is now provided by the EMS Hardware Monitors. If you had customized the configuration files for the dialogd exec programs (disk30_exec.cfg, sdisk_exec.cfg, and haraymon_exec.cfg) you may wish to re-configure the EMS Hardware Monitors to achieve the same results. ============================================================================== ============================================================================== CAUTION: Compatibility Problem with EMS-Related Products (ServiceGuard, HA Monitors, etc.) If you install the OnlineDiag bundle (Dec 99 or later) onto a computer running older revisions of EMS-related products, these products may experience compatibility problems Affected products include MC/ServiceGuard, ServiceGuard OPS Edition and High Availability Monitors. The only critical problems occur with the following versions: MC/ServiceGuard A.10.10, A.11.01, A.11.03 ServiceGuard OPS Edition A.11.02, A.11.03 Support Tools and the EMS hardware monitors are not affected. For complete information, see "EMS Incompatibility Problem" at http://docs.hp.com/hpux/onlinedocs/diag/st/st_ems.htm ============================================================================== ============================================================================== Removing Diagnostics -------------------- If you wish to remove the STM online diagnostic system after it has already been installed, type: swremove OnlineDiag ============================================================================== NOTE: Executing the "swremove OnlineDiag" command also removes the Predictive Support package. ============================================================================== Getting More Information ------------------------ You can get more information on Diagnostics (Support Tools) in the following ways: 1) Once you install a specific stream (e.g., HP-UX 10.20), the Release Notes for that stream are available: Support Tools Manager (STM): /usr/sbin/stm/Rel_NOTES.STM EMS hardware monitors: /usr/sbin/stm/Rel_NOTES.HWE Predictive Support: /opt/pred/bin/Rel_NOTES.PRED 2) For the latest information on hardware support tools, such as STM and EMS Hardware Monitors, refer to the "Diagnostics" section of Hewlett-Packard's online documentation Web site at: http://docs.hp.com/hpux/diag/ This site provides manuals, tutorials, FAQs, and other reference material. Two complete manuals ("Support Plus: Diagnostics User's Guide" and "EMS Hardware Monitors User's Guide") appear on the Web site and in the two following locations: 3) In the DIAGNOSTICS directory under your mount point for the CD-ROM (e.g., /diagtemp/DIAGNOSTICS ). The files are named DIAG_USR.PDF and EMS_USR.PDF and can be read with the Adobe Acrobat viewer which can be downloaded from the Adobe Web site. EMS Hardware Monitors --------------------- Included on the Support Plus CD-ROM are the EMS Hardware Monitors which are an important tool for maintaining system availability. The EMS monitors allow you to monitor the operation of a wide variety of hardware products and be alerted immediately if any failure or other unusual event occurs. Hardware event monitoring is available to users running HP-UX 10.20 or 11.X (IPR February 1999 and later). Hardware event monitoring provides a high level of protection against system hardware failure. By using hardware event monitoring, you can virtually eliminate undetected hardware failures that could interrupt system operation or cause data loss. For complete information on installing and using EMS hardware event monitors, as well as a list of supported hardware, refer to the documents listed in "Getting More Information" earlier in this file. The EMS Hardware Monitors are installed at the same time as the Support Tools Manager. Once the monitoring software is installed, monitoring is automatically enabled. By default, messages regarding major warning, serious and critical events that occur on hardware being monitored will be: - Written to /var/adm/syslog/syslog.log - Sent to EMAIL address root All events will be stored in /var/opt/resmon/log/event.log. To configure, enable, or disable hardware event monitoring, run the monitoring request manager: /etc/opt/resmon/lbin/monconfig . ------------------------END---------------------------------------------------