ptx®/EES V1.0.1 Release Notes


Introduction

ptx®/EES, the Error/Event Subsystem (EES), improves the fault management, serviceability, and usability of NUMA-Q® systems by providing a single set of interfaces to report, log, and retrieve system errors and events.

These Release Notes contain the following information:


Compatibility Information

ptx/EES is compatible with the following software products running on Symmetry® and NUMA-QTM systems:


Installation

ptx/EES is installed using ptx/ADMIN® and ptx/INSTALL.


ATTENTION

We recommend that you install /var/ees on its own filesystem, otherwise the root filesystem may fill up quickly due to the size of the ptx/EES logfile. If you choose to make a new filesystem for /var/ees, we recommend that you create the new filesystem prior to installing the ptx/EES software.

The ptx/EES User's Guide contains more information about managing the size of the ptx/EES logfile.


Refer to the DYNIX/ptx and Layered Products Software Installation Release Notes for installation procedures.


Problems Fixed Since the Previous Release


Problem Reports

The number that appears in parentheses in problem report titles is the Problem Tracking System number assigned to the report. These problems will be corrected in a future release unless otherwise noted.


Clear a Log File Option of Log File Management Menu Causes ees_view Failure (237462)

The eeslog is a binary log file with header information, unlike the other log files, which are ASCII text. If you use the Log File Management menu of ptx/ADMIN to clear the log file, the eeslog is backed up and the size is set to zero, but it does not retain the header information. This causes ees_view to display an error message.

Workaround. Do not use the Log File Management menu of ptx/ADMIN to clear out the eeslog file or for any other ptx/EES task. If you want to clear out the log file:

  1. Stop the ees_notifyd and the eesd daemons by entering the following: sh /etc/init.d/ees stop

  2. Manually cp the eeslog to a backup filename.

  3. Restart the two daemons by entering the following:

    sh /etc/init.d/ees start


Filters Using ees_time Cannot Be Properly Registered (237940)

Filters that use ees_time as an attribute tag cannot be properly registered because the : separators used to separate day, month, year and so on are confused with the : separators used in the filter registry. Once such a filter is added to the registry, it is never found by the utility. These filters do not, however, corrupt the registry, so other filters will work fine.

Workaround. Do not enter filters using the ees_time attribute. If one is entered, remove it manually.


ees_get_logevent Man Page Has Incorrect Summary Description (238132)

The ees_get_logevent(3) man page has an incorrect summary description. The summary description should read "get an event from an EES log".

Workaround. None.


ees_notify Should Give Warning Message for IDs That Are Not Whole Numbers (237844)

If you execute the command ees_notify_id -remove 2.5, any action with an ees_notify_id of 2 might be removed.

Workaround. Use only whole numbers for ees_notify_ids.


ees_view -out -lang -collate Options May Not Work Correctly (239930)

ees_view -out log.3 -lang log -log "log1.log2" -collate command gives an error message indicating that log.3 is an invalid log file.

Workaround. None.


ees_close_prov Man Page Has Incorrect NAME Function (241207)

The ees_close_prov(3) man page incorrectly lists ees_open_prov in the NAME field, when it should be ees_close_prov.

Workaround. None.


Second ees_view -new Causes First To Get a Memory Fault (243001)

If you run ees_view -new in one window and then run it in another window and later kill it, a subsequent attempt to use ees_view will cause the original ees_view to fail with a memory fault.

Workaround. Do not use multiple instances of ees_view -new.


ees_logmgr Not Properly Locked For Multiple Instances (242851)

ees_logmgr does not properly lock for multiple instances and could possibly damage the ptx/EES log if the processes are trying to write to the log at the same time.

Workaround. Do not use multiple instances of ees_logmgr.


ees_severity = none Should Be a Valid Filter for ees_view (240725)

Some ptx/EES log entries can have a severity level of "none", yet this is not recognized as a valid value by the filter library.

Workaround. None.


ees_logmgr Return Value Causes Problems for CommandPoint Admin (243199)

The following two commands may return an non-zero exit code when called from the CommandPoint Admin product:ees_logmgr -compact and ees_logmgr -size. These non-zero codes may be returned even if the operation is successful.

Workaround. None.