Release Notes for STM on HP-UX 11i (11.11) (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 11i (11.11) running on S800/S700 systems.

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

• There is a new product called Processor Sets (pset) from http://software.hp.com/. This product allows processors to be grouped and restricted to run only a given set of processes. The CPU tools will not run correctly on machines which have this tool installed AND one or more processors assigned to one or more processor set(s). Therefore, the CPU tools are not supported on machines which have pset installed. The pset support will start with the HWE0203 release.
• Added support for the HP blade server bh3702 ("Powerbar 6U for HP-UX.
• JAGad91737
  An enhancement was made to support of SuperDome and Keystone chassis codes, and support for Matterhorn and Caribe chassis codes in the chassis code monitor was enabled.
• JAGad65918
  Fix for the final message being displayed, when assignment of a pid to a processor was incorrect, if an invalid pid was specified.
• JAGad87941
  Fix to JAGad87941 (only applies to Superdome-class systems):

  Here's an example of the problem before the fix:

  There is a Superdome PD which has two cells. The first cell has two memory errors logged and the second cell has ten memory errors logged. When an user removed the second cell in this PD (when the system was down) and then brought the system back up and viewed the contents of the memlog file (via logtool), there are still entries in the memlog file pertaining to the second cell, which was already removed. Hence, this information in the memlog file can be very misleading to the user.

  After the fix:

  The memlogd on Superdome-class systems will correctly remove the memlog file whenever memory configuration was changed. In this content when I mean by memory configuration has changed, I mean at a cell level (adding, removing of cells and not just memory within an existing cell).

• 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.
  

• Added support for Tachyon drive (HP6795A).
• JAGad89725
  Added support for 2 Gigabyte Fibre Channel Adapter.
• JAGad71506
  Increased the maximum number of devices that a system can have and still use the graphical xstm map.
• JAGad83819
  A customer requested STM support for shadow passwords. This version of STM is modified to allow a remote user to connect to a system which is protected by use of shadow passwords.
• 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 would need 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.
• Added support for the 2 Gigabyte Fibre Channel Adapter.
• Verify graphics tool: Customer visible change. A dialog box was added, that pops up when the verify tool is selected for a graphics device. The dialog information box instructs the user to run the graphdiag program. This new box appears for newer OEM graphics cards.

  ID and Info graphics tool: Newer OEM graphics cards should now be identified, and the information tool can be run successfully.

  Lego library: A fix for the bug that causes a bus error, when the Verify tool is selected for an FX5/10 (Rockwood) graphics device.

• JAGad81674
  Fixed a text formatting problem in the library. Formatting of the physical location resulted in some "!"s being displayed. Also, the text has been reworded for chassis codes not found in the database.

Changes to Specific Tools

• Information tools:
  • JAGad89725
    Added support for 2 Gigabyte Fibre Channel Adapter.
  • JAGad90318
    Fixed CPU Info tool so that it now correctly identifies the pdc version of Cantata machines.
  • 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:
  • JAGad82244
    
  • c8xx driver was added to the supported device list in the Verify tool. It is customer visible. Running Verify tool on Ultra 160 SCSI card would result in an incomplete message withou this fix.
• Diagnose tools:
  • JAGad89725
    Added support for 2 Gigabyte Fibre Channel Adapter.
• Firmware update tools:
  • N/A
• Expert tools:
  • JAGad76539
    Fixed a problem which caused the following error statement to appear when running the exerciser on the CPU expert tool:

    Cannot remove shared memory.  Shmctl system
    call failed with errno (2) when attempting to
    remove a shared memory segment.
    
    ENOENT (2) errno returned from the shmctl call
    indicates that the calling process could not
    get shared memory.
    

• Logtool:
  • N/A
• Utilities:
  • N/A

Known Problems

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.

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