servicelog

Use the servicelog and related utilities to manage events that require service.

The utilities described here are supported in the following Linux® distributions and virtualized environments:

Table 1. Support for servicelog utilities
Utility	Linux distributions running on a PowerVM® partition on any level of Power® processor
servicelog library and all servicelog tools	All current versions of the following distributions: Red Hat® Enterprise Linux SUSE Linux Enterprise Server

For Linux distributions currently supported on Power systems, see Linux on Power overview.

The servicelog packages provide a library for logging service-related events to the service log database, and commands for viewing the contents of the database. This database allows for the logging of serviceable and informational events, and service procedures that are performed upon the system. If an event occurs that requires a service action to repair, the event is logged in the servicelog database. Example events include hardware failures that require the replacement of a Field Replaceable Unit (FRU), or issues that require a firmware update to fix. After you repair a hardware device, run the log_repair_action command to mark all of the associated events as closed. An example of a repair action is the replacement of an FRU.

To use servicelog, run the servicelog command. The statistics that are stored in the servicelog database, similar to the following, are displayed:

# servicelog
Servicelog Statistics:

There are 3 open events requiring action.

Summary of Logged Events:

        Type   Total    Open  Closed    Info

        RTAS       5       3       2       0
             -------------------------------
                   5       3       2       0

Logged Repair Actions:         2
Registered Notification Tools: 3

Platform diagnostics (ppc64-diag) is an example of a service and productivity tool that writes to servicelog.

The servicelog library is provided by the libservicelog package.

The servicelog commands are provided by the servicelog package. The commands that are typically included are:

log_repair_action: Create a log entry to indicate that a device was repaired.
servicelog: Query and display the contents of the servicelog database.
servicelog_manage: Perform management or maintenance operations on the servicelog database.
servicelog_notify: Add, modify, view, or remove tools to be notified when events are logged in the servicelog database.

The commands that are provided by this package, and their features and usage, might vary by distribution and release. Consult the man pages on your system for the most accurate description of their features and usage. For more information about how to list and display the man pages for commands that are provided by this package, see Displaying package man pages.

For more information about the servicelog packages, see servicelog: System Service Database.