mmlsrecoverygroupevents command

Displays the IBM Storage Scale RAID recovery group event log.

Synopsis

mmlsrecoverygroupevents RecoveryGroupName [-T] [--days Days]
                          [--long-term Codes] [--short-term Codes]

Availability

Available on all IBM Storage Scale editions.

Description

The mmlsrecoverygroupevents command displays the recovery group event log, internally divided into the following two logs:
short-term log
Contains more detail than the long-term log, but due to space limitations may not extend far back in time
long-term log
Contains only brief summaries of important events and therefore extends much further back in time
Both logs use the following severity codes:
C
Commands (or configuration)

These messages record a history of commands that changed the specified recovery group.

E
Errors
W
Warnings
I
Informational messages
D
Details
By default, mmlsrecoverygroupevents displays both long-term and short-term logs merged together in order of message time stamp. Given the --long-term option, it displays only the requested severities from the long-term log. Given the --short-term option, it displays only the requested severities from the short-term log. Given both --long-term and --short-term options, it displays the requested severities from each log, merged by time stamp.
Note: The recovery group must be active to run this command.

Parameters

RecoveryGroupName
Specifies the name of the recovery group for which the event log is to be displayed.
-T
Indicates that the time is to be shown in decimal format.
--days Days
Specifies the number of days for which events are to be displayed.

For example, --days 3 specifies that only the events of the last three days are to be displayed.

--long-term Codes
Specifies that only the indicated severity or severities from the long-term log are to be displayed. You can specify any combination of the severity codes listed in Description.

For example, --long-term EW specifies that only errors and warnings are to be displayed.

--short-term Codes
Specifies that only the indicated severity or severities from the short-term log are to be displayed. You can specify any combination of the severity codes listed in Description.

For example, --short-term EW specifies that only errors and warnings are to be displayed.

Exit status

0
Successful completion.
nonzero
A failure has occurred.

Security

You must have root authority to run the mmlsrecoverygroupevents command.

The node on which the command is issued must be able to execute remote shell commands on any other node in the cluster without the use of a password and without producing any extraneous messages. For additional details, see the following IBM Storage Scale RAID: Administration topic: Requirements for administering IBM Storage Scale RAID.

Examples

The following command example shows how to print the event logs of recovery group 000DE37BOT: 
mmlsrecoverygroupevents 000DE37BOT
The system displays output similar to the following:
Mon May 23 12:17:36.916 2011 c08ap01 ST [I] Start scrubbing tracks of 000DE37BOTDA4META.
Mon May 23 12:17:36.914 2011 c08ap01 ST [I] Finish rebalance of DA DA4 in RG 000DE37BOT.
Mon May 23 12:13:00.033 2011 c08ap01 ST [D] Pdisk c109d4 of RG 000DE37BOT state changed from noRGD to ok.
Mon May 23 12:13:00.010 2011 c08ap01 ST [D] Pdisk c109d4 of RG 000DE37BOT state changed from noRGD/noVCD to noRGD.
Mon May 23 12:11:29.676 2011 c08ap01 ST [D] Pdisk c109d4 of RG 000DE37BOT state changed from noRGD/noVCD/noData to noRGD/noVCD.
Mon May 23 12:11:29.672 2011 c08ap01 ST [I] Start rebalance of DA DA4 in RG 000DE37BOT.
Mon May 23 12:11:29.469 2011 c08ap01 ST [I] Finished repairing metadata in RG 000DE37BOT.
Mon May 23 12:11:29.409 2011 c08ap01 ST [I] Start repairing metadata in RG 000DE37BOT.
Mon May 23 12:11:29.404 2011 c08ap01 ST [I] Abort scrubbing tracks of 000DE37BOTDA4META.
Mon May 23 12:11:29.404 2011 c08ap01 ST [D] Pdisk c109d4 of RG 000DE37BOT state changed from missing/systemDrain/noRGD/noVCD/noData/noPath 
                                             to noRGD/noVCD/noData.
Mon May 23 12:11:29.401 2011 c08ap01 ST [D] Pdisk c109d4 of RG 000DE37BOT: path index 0 (/dev/rhdisk131): up.
Mon May 23 12:11:29.393 2011 c08ap01 ST [I] Path /dev/rhdisk131 of pdisk c109d4 reenabled.
Mon May 23 12:09:49.004 2011 c08ap01 ST [I] Start scrubbing tracks of 000DE37BOTDA4META.

See also

See also the following IBM Storage Scale RAID: Administration topics:

Location

/usr/lpp/mmfs/bin