Release Notes for STM on HP-UX 10.20 (December 2001)

• Overview
• Documentation
• Changes
  • Changes to User Interface and Platform
  • General Changes to Tools
  • Changes to Specific Tools
• Known Problems
• Defect Reporting
• SD Product Structure

These release notes cover the December 2001 release of Support Plus for HP-UX 10.20 running on S800/S700 systems.

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 10.20 and HP-UX 11.0).

Overview

The Support Tools Manager (STM) provides a complete set of online support tools for HP-UX systems, enabling you to verify and troubleshoot PA-RISC system hardware, and to examine system logs.

STM offers several tool types, including information tools, verifiers, exercisers, expert tools, firmware update tools, diagnostics and utilities.

Installed with STM (as of IPR 9902) are the EMS Hardware Monitors, an important tool for maintaining system availability. The EMS hardware 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. For more information, see /usr/sbin/stm/Rel_NOTES.HWE.

Documentation

For the latest and most complete information on STM and EMS Hardware Event Monitors, see the Web page "Diagnostics":

  http://docs.hp.com/hpux/diag/

At this site, you will find Overviews, Tutorials, Quick Reference Cards, Frequently Asked Questions (FAQs), and much other material.

Changes

The online Support Tools Manager (STM) was enhanced and updated for the current release.

Changes to User Interface and Platform

• Added support for the HP blade server bh3702 ("Powerbar 6U for HP-UX.
• JAGad72852
  Submitted a fix for a buffer overflow problem, found while porting pllib to linux.
• Fixed NEC iStorage so that it is ignored by STM and EMS HW Monitors.
• Enhanced local port configuration functionality of STM to make ALL ports used for IPC communication between elements of the STM system LOCAL only.

  In order to enable this functionality, both STM and EMS HW Monitors MUST be shutdown. Then, the file /var/stm/config/sys/local_only needs to be created. Then STM and the EMS HW Monitors should be restarted, in that order.

  In order to disable this functionality, both STM and the EMS HW Monitors MUST be shutdown. Then, the file /var/stm/config/sys/local_only needs to be removed. Then, STM and the EMS HW Monitors should be restarted, in that order.

  If both STM and the EMS HW Monitors are not shutdown, and this file is created, IPC messages will timeout and fail. This means that tools will not be startable from the UI; monitors will not be able to send events to PSM, so the state of the devices will not be updated, and set_fixed will not be able to display or update the state of devices.

  If this functionality is enabled, the STM product will no longer accept connections from remote systems. On new systems, the error message indicated below will be displayed. On older systems, the older message indicating that diagmond may be down will be displayed. In addition, the STM product will not allow connections TO remote systems. In this case, the message below will be displayed:

  MODIFIED for UI.
  

  This message will appear if the system is configured for LOCAL_ONLY, and the user attempts to connect to a remote system:

  An unexpected error was encountered while attempting to retrieve the 
  host info for hostname (XX).
  This could be due to either of the following conditions:
  
    1) The support tool daemon "diagmond" may not be running on that system.
    Use the STM Startup command (in the administration menu under the
    file menu.)
  
    2) The support tool daemon "diagmond" on that system may be configured
    to only allow local connections.  Check the value of the configuration
    parameter LOCAL_ONLY_ENABLE in the /var/stm/config/sys/diagmond.cfg
    file or for the existence of the /var/stm/config/sys/local_only file
    on that system.
  
    3) The diagnostic system on this system may be configured
    to only allow local connections.  Check for the existence of the
    /var/stm/config/sys/local_only file on this system.
  
    4) The IP address for the system may be invalid or may not be associated
    with a valid host.  Use a valid IP address.
  
    5) Networking may be incorrectly configured on one of the systems involved.
    Verify networking by comparing 'nslookup `hostname`' with the output
    of ifconfig of the LANs identified by lanscan.
  
    More details may be available in the System Activity Log and in the
    syslog on that system.
    
    It may be necessary to access these using the Local Unit Under  Test (UUT).
  

  OLD (will be displayed when attempting to connect from remote to local_only:

  An unexpected error was encountered while attempting to retrieve the 
  host info for hostname (XX).
  This could be due to either of the following conditions:
  
    1) The support tool daemon "diagmond" may not be running on that system.
    Use the STM Startup command (in the administration menu under the
    file menu.)
  
    2) The support tool daemon "diagmond" on that system may be configured
    to only allow local connections.  Check the value of the configuration
    parameter LOCAL_ONLY_ENABLE in the /var/stm/config/sys/diagmond.cfg
    file on that system.
  
    3) The IP address for the system may be invalid or may not be associated
    with a valid host.  Use a valid IP address.
  
    4) Networking may be incorrectly configured on one of the systems involved.
    Verify networking by comparing 'nslookup `hostname`' with the output
    of ifconfig of the LANs identified by lanscan.
  
    More details may be available in the System Activity Log and in the
    syslog on that system.
    
    It may be necessary to access these using the Local Unit Under  Test (UUT)
    logs (in the administration menu under the file menu).
  

  NEW for tlpthread (memlogd) and plllib for send message:

  An attempt to send an IPC message to a non-local port has been rejected.
  The port is on system name (XX) at IP address (XX) and has system port (XX).
  
  Possible Cause/Recommended Action:
  
     Diagnostic system is configured to only perform local IPC.
     To enable remote communication:
          Shutdown the EMS HW Monitors and the diagnostics system
               Run /etc/opt/resmon/lbin/monconfig and select K)ill
               Run STM and select the SystemShutdown command
          Remove the /var/stm/config/sys/local_only file
          Restart the diagnostic system and the EMS HW Monitors
               Run STM and select the SystemStartup command
               Run /etc/opt/resmon/lbin/monconfig and select E)nable
  
     Internal Application error.
  

• JAGad56779
  Fixed a timing problem, when STM data files are NFS mounted from a different system. If the /var/stm/data files are actually on a different system from the one on which the diagmond daemon is running, there are race conditions where tools appear to run indefinitely, meaning they never go into a completed state (SUCCESSFUL, INCOMPLETE, etc.). The tools have actually completed, but the UI doesn't update the map. If the user exits the UI, and re-enters, the tools show a completed state. If the user changes the timestamp on the /var/stm/data/uut_status file on the remote system, the UI will update the map, and the tools will go into a completed state.
• Support tools are no longer available for the EMC Array.
• Fixed bug which caused xstm to crash if an invalid value was discovered in the libdiagux routine, which obtains information from X-Windows.
• Fixed psmctd to consider a missing HWE_SHUTDOWN file as monitoring enabled, not disabled. If this file was removed, the monitors and monconfig would consider monitoring enabled, but psmctd would not. So it would shutdown and log an error, indicating that monitoring needed to be enabled.
• Added tool support for HPCD-Writer+ for SCSI Disk/Disk CDROM.

General Changes to Tools

• Added ID support for the igelan driver for the PCI 1000 Base-T Adapter.
• Added ID support for the igelan driver.

• Information tools:
  • JAGad72970
    
  • Fixed Info tool on ATAPI CD Writer 9500. The Info tool would not run without this fix. This is a customer visible fix.
• Exerciser tools:
  • N/A
• Verifier tools:
  • N/A
• Diagnose tools:
  • N/A
• Firmware update tools:
  • N/A
• Expert tools:
  • N/A
• Logtool:
  • N/A
• Utilities:
  • N/A

: 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 diaglogd 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.

Defect Reporting

Use CHART to report defects in STM. The project name is diag.stm.tools.hpux for individual tools, and diag.stm.ui.hpux for the user interface. If you don't have access to CHART, contact an HP representative to enter a defect for you.

SD Product Structure

The product number for STM is B4708AA.

SD PRODUCT: Sup-Tool-Mgr
   Description: On-line Diagnostic System (Series 800/700)

   SD SUB-PRODUCT: Manuals
   Description: Support Tools Manager Manual Pages

      FILESET: STM-MAN
         Description: S800/S700 STM Manual Pages

      FILESET: STM-SHLIBS
         Description: S800/S700 STM Shared Libraries

      FILESET: STM-UI-RUN Corequisite Filesets: STM-SHLIBS
         Description: S800/S700 STM User Interface
         
      FILESET: STM-UUT-RUN  Corequisite Filesets: STM-SHLIBS
         Description: S800/700 STM Unit Under Test Runtime 

/ Diagnostics HOME