Support Tools (logo)

DIAGNOSTIC.readme file (June 99)

This DIAGNOSTICS.readme document covers the June 1999 (IPR 9906) release of the Diagnostic/IPR Media for S800/S700 systems (all versions of HP-UX).

CAUTION: Do not load the OnlineDiag product from the June 1999 Diagnostic/IPR CD-ROM if your system includes a V-Class computer, a DLT tape library, or Predictive Support. For problem description and fix, see the customer letter (PDF)
CAUTION: You must install certain patches before loading Online Diagnostics (Support Tools). See Required and Recommended Patches below.

Overview

The Diagnostics/IPR Media, in addition to IPR software, contains a complete build of the following support tools:

The support tools are all contained in a Software Depot (SD) bundle named "OnlineDiag". This bundle is distributed in two ways:

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.

The Diagnostic Media can be:

For this June 1999 release:

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. However, these patches may be superseded by the time you do your install.

REQUIRED Patches:

For HP-UX 11.0 (S800 and S700)
      PHKL_17039:Bug fix; support 64 bit registers
      PHKL_17700:diag1 PCI support with subvendor/system info 
             (If PHKL_17770 is not in the HWCR bundle, use 
             PHKL_17040, the patch which it superseded.)
      PHKL_14426:diag2 data corruption on 64-bit sys >3.75GB

For HP-UX 10.20 (S800)
      PHKL_17590:diag1 support PCI with subvendor/subsystem info
      PHKL_17500:Fix data corruption,diaglogd prob,drvr log issue

For HP-UX 10.20 (S700)
      PHKL_17589:diag1 support PCI with subvendor/subsystem info
      PHKL_17499:Fix data corruption,diaglogd prob,drv log issue
For proper operation of the Online Diagnostics (10.20 and 11.0 versions), you must install the above patches 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.

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_16587:HP aC++ runtime libraries (aCC A.03.13)

For HP-UX 10.20 (S800 and S700):
      PHSS_16585:HP aC++ runtime library components (A.01.18)
             (PHSS_16585 has a dependency, PHSS_15391 
             (dld.sl(5) cumulative patch),
             which has been replaced by PHSS_17225,
             which should be in the HWCR bundles.)
Patches required for HP-UX 10.20 only if your system includes a DLT tape library: 
For HP-UX 10.20 (S800):
     PHSS_19076:s800 10.20 STM fix DLT library EMS dm_stape panics 

For HP-UX 10.20 (S700):
     PHSS_19075:s700 10.20 STM fix DLT library EMS dm_stape panics
These patches fix a problem with system panics that can occur if the OnlineDiag product is loaded from the June 1999 Diagnostic/IPR CD-ROM and your system includes a DLT tape library. For problem description and fix, see the customer letter (PDF) (These patches are not in the HWCR or HW bundles on the Diagnostic/IPR Media.)

Patch required for HP-UX 11.00 only if your system includes a DLT tape library or a V-Class computer:

For HP-UX 11.00 (S800 and S700):
     PHSS_19077:s700_800 11.00 STM:V Class PDC call and DLT dm_stape panics
This patch fixes a problem with system panics that can occur if the OnlineDiag product is loaded from the June 1999 Diagnostic/IPR CD-ROM and your system includes a DLT tape library or a V-Class computer. For problem description and fix, see the customer letter (PDF) (This patch is not in the HWCR or HW bundles on the Diagnostic/IPR Media.)

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 XSW800HWCR1020 for a Series 800 system running HP-UX 10.20.

The patch bundles are distributed in the same way as the OnlineDiag bundle:

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 kernal, indicated by "PHKL" in the patch name, all require a reboot).

Known Problems

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.

Problem (HP-UX 11.0, D/R-Class Only): The SCSI Multiplexer's Firmware Download Tool as supplied in the April 1999 IPR release does not work properly on D-Class and R-Class systems running HP-UX 11.0. Problems have NOT been reported with this tool in the February or June 1999 IPR releases. Therefore, if you plan to use this tool, install the June 1999 release of support tools or stay with the February 1999 release.
Problem: (N-Class Only): PCI Fibre Channel Interface Information tool will exit with an INCOMPLETE status and log the following message: 
       This card ( PCI Fibre Channel Interface ) is not 
       supported by the Information tool on N class machines.
CAUTION:Compatibility Problem with ServiceGuard and LockManager

From the February 1999 release (IPR 9902) onwards, the Support Tools (diagnostics) include EMS hardware monitors and EMS version A.03.00 on both HP-UX 10.20 and HP-UX 11.00.

This version of EMS is incompatible with ServiceGuard A.10.10, which includes version A.01.00 of EMS. It is also incompatible with ServiceGuard and LockManager versions A.11.01, A.11.02 and A.11.03, which include version A.02.00 of EMS.

If you run these releases of ServiceGuard or LockManager, you must upgrade them before installing the Support Tools on the February 1999 (IPR 9902) or newer releases.

On HP-UX 10.20 you should upgrade ServiceGuard to A.10.11 and on HP-UX 11.00 you should upgrade ServiceGuard or LockManager to release A.11.04 or newer.

If you do not upgrade, EMS will silently be upgraded to version A.03.00 when you install the diagnostics; ServiceGuard and LockManager will fail to work if you have any monitored resources. In this case, if you execute swverify or other SD-UX commands, you will see error messages like:

     The corequisite
     "EMS-Core.EMS-CORE,r=A.01.00,a=HP-UX_B.10.20_800,v=HP" for
     fileset "Cluster-Monitor.CM-CORE,l=/,r=A.10.10" cannot be
     successfully resolved.
If you have already loaded the diagnostics and therefore upgraded to EMS A.03.00 and are still running an incompatible release of ServiceGuard or LockManager, you should now upgrade to get your system into a supported and working state.

There is no functional difference between ServiceGuard A.10.10 and ServiceGuard A.10.11, other than support for the new version of EMS and bug fixes. Functional differences for the 11.00 releases of ServiceGuard and LockManager can be found in the release notes.

Older versions of ServiceGuard and LockManager, for example A.10.06 and A.10.07.01, do not provide any support for EMS, and so are not affected by this issue.

Problem with Tools for SCSI Devices (Older Systems Only)

Support tools for SCSI devices may terminate with a status of INCOMPLETE, if you loaded Diagnostics from the June 99 (IPR 9906) or September 99 (IPR 9909) releases onto an older system, such as T-Class or "Nova" (F,G,H,I Class; xx7 Family). The problem does not occur on newer systems such as D-Class, K-Class, N-Class or V-Class. The problem has been reported on both HP-UX 10.20 and 11.00.

If the system has Predictive Support, you you may see "SCSISCAN 500" errors reported.

To fix the problem, issue the following commands (as root):

  cd /dev
  insf -e           # re-creates the diagnostic device files
The problem may occur when an Information, Expert or Firmware Download Tools is run on SCSI devices on systems with the SIO bus. An entry in the tool's Activity Log will report the error "/dev/diag/diag0 not found."

The problem is caused by an error in a SCSI library which removes /dev/diag/diag0 if a call to get access to the SIO passthru driver fails. The error will be fixed in a future release.

Removing Diagnostics

If you wish to remove the STM online diagnostic system after it has already been installed, type:

           swremove OnlineDiag
Problem with Removing Diagnostics (HP-UX 10.20): There is a problem removing Diagnostics and associated patches once they have been installed on systems running HP-UX 10.20. This problem occurs if you try to remove the patch for diag1: 
  (S800) PHKL_17590: diag1 support PCI with subvendor/subsystem info
  (S700) PHKL_17589: diag1 support PCI with subvendor/subsystem info
These patches are contained in XR43/IPR9902, XR44/IPR9904 XR45/IPR9906 and are required to be installed before installing the Diagnostics.

When you try to remove the diag1 patch, there will be an attempt to rebuild the kernel (required after removing a kernel patch). This kernel rebuild will fail, leaving an entry in the /var/adm/sw/swagent.log file that contains this text (and more):

      /usr/ccs/bin/ld: Unsatisfied symbols:
          diag1_install (code)
This problem will occur even if you remove the Diagnostics first.

FIX: Avoid the problem entirely -- DO NOT REMOVE THE PATCHES. Instead, just remove the Diagnostics (if desired) by using swremove.

Removing the diag1 and diag2 patches is not recommended. The patches are small, their functionality is limited to the diagnostics and OS error logging, removal and installation require that the system be rebooted, and they are required for versions of STM starting with A.14.00 (IPR 9902). In addition, one of them corrects a potential system panic and data corruption problem.

If you feel you must remove the patches associated with diagnostics on HP-UX 10.20 (not recommended), here is the procedure:

  1. Edit the file /stand/system and remove the line containing the word "diag1"
  2. Remove the Diagnostics using swremove.
  3. Now you can remove the diag1 and other patches. (again, this is not recommended).

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 ("Diagnostic/IPR Media User's Guide" and "EMS Hardware Monitors User's Guide") appear on the Web site and in the two following locations:
  3. In the Documentation directory under your mount point for the CD-ROM (e.g. /diagtemp/Documentation ). 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.
  4. On the Instant Information CD-ROM.
EMS Hardware Monitors

Included on the Diagnostic/IPR Media CD-ROM are the EMS Hardware Monitors which are an important new 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:

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 .

Top of Page

/ Diagnostics HOME

URL: http://docs.hp.com/hpux/onlinedocs/diag/st/str_9906.htm
Last updated: Thu Oct 26 15:42:55 PDT 2000