System Administration Commands fmadm(1M)
NAME
fmadm - fault management configuration tool
SYNOPSIS
fmadm [-q] [subcommand [arguments]]
DESCRIPTION
The fmadm utility can be used by administrators and service
personnel to view and modify system configuration parameters maintained by the Solaris Fault Manager, fmd(1M). fmd receives telemetry information relating to problems detectedby the system software, diagnoses these problems, and ini-
tiates proactive self-healing activities such as disabling
faulty components.fmadm can be used to:
o view the set of diagnosis engines and agents that are currently participating in fault management, o view the list of system components that have been diagnosed as faulty, ando perform administrative tasks related to these enti-
ties. The Fault Manager attempts to automate as many activities aspossible, so use of fmadm is typically not required. When
the Fault Manager needs help from a human administrator, service repair technician, or Sun, it produces a message indicating its needs. It also refers you to a knowledge article on Sun's web site, http://www.oracle.com/us/sun/msg/. The web site might askyou to use fmadm or one of the other fault management utili-
ties to gather more information or perform additional tasks. The documentation for fmd(1M), fmdump(1M), and fmstat(1M) describe more about tools to observe fault management activities.The fmadm utility requires the user to possess the
SYS_CONFIG privilege. Refer to the for more information
about how to configure Solaris privileges. The fmadm load
subcommand requires that the user possess all privileges. SUBCOMMANDSfmadm accepts the following subcommands. Some of the subcom-
mands accept or require additional options and operands. The load, unload, reset, and rotate subcommands are intended forSunOS 5.11 Last change: 24 Sep 2010 1
System Administration Commands fmadm(1M)
trained technical personnel. We recommend against use of these subcommands without the specific guidance of, for example, a Knowledge Base article.fmadm acquit fmri | label [uuid]
Notify the Fault Manager that the specified resource is not to be considered to be a suspect in the fault event identified by uuid, or if no UUID is specified, then inany fault or faults that have been detected. The fmadm
acquit subcommand should be used only at the direction of a documented Sun repair procedure. Administratorsmight need to apply additional commands to re-enable a
previously faulted resource.fmadm acquit uuid
Notify the Fault Manager that the fault event identifiedby uuid can be safely ignored. The fmadm acquit subcom-
mand should be used only at the direction of a docu-
mented Sun repair procedure. Administrators might needto apply additional commands to re-enable any previously
faulted resources.fmadm config
Display the configuration of the Fault Manager itself, including the module name, version, and description of each component module. Fault Manager modules provideservices such as automated diagnosis, self-healing, and
messaging for hardware and software present on the sys-
tem.fmadm faulty [-afgiprsv] [-n max] [-u uid]
Display status information for resources that the Fault Manager currently believes to be faulty. The following options are supported:-a Display all faults. By default, the fmadm
faulty command only lists output for resources that are currently present and faulty. If youspecify the -a option, all resource informa-
tion cached by the Fault Manager is listed, including faults which have been automatically corrected or where no recovery action is needed. The listing includes information for resources that might no longer be present inSunOS 5.11 Last change: 24 Sep 2010 2
System Administration Commands fmadm(1M)
the system.-f Display faulty fru's (Field replaceable
units).-g Group together faults which have the same fru,
class and fault message.-i Display persistent cache identifier for each
resource in the Fault Manager.-n max If faults or resources are grouped together
with the -a or -g options, limit the output to
max entries.-p Pipe output through pager with form feed
between each fault.-r Display Fault Management Resource with their
Identifier (FMRI) and their fault management state.-s Display 1 line fault summary for each fault
event.-u uid Only display fault with given uid.
-v Display full output.
The percentage certainty is displayed if a fault has multiple suspects, either of different classes or on different fru's. If more than one resource is on thesame fru and it is not 100% certain that the fault is
associated with the fru, the maximum percentage cer-
tainty of the possible suspects on the fru is displayed. The Fault Manager associates the following states with every resource for which telemetry information has been received: okSunOS 5.11 Last change: 24 Sep 2010 3
System Administration Commands fmadm(1M)
The resource is present and in use and has no known problems so far as the Fault Manager is concerned. unknown The resource is not present or not usable but has no known problems. This might indicate the resource hasbeen disabled or deconfigured by an administrator. Con-
sult appropriate management tools for more information. faulted The resource is present but is not usable because one or more problems have been diagnosed by the Fault Manager. The resource has been disabled to prevent further damage to the system. degraded The resource is present and usable, but one or more problems have been diagnosed in the resource by the Fault Manager. If all affected resources are in the same state, this isreflected in the message at the end of the list. Other-
wise the state is given after each affected resource.fmadm flush fmri
Flush the information cached by the Fault Manager forthe specified resource, named by its FMRI. This subcom-
mand should only be used when indicated by a documented Sun repair procedure. Typically, the use of this command is not necessary as the Fault Manager keeps its cacheup-to-date automatically. If a faulty resource is
flushed from the cache, administrators might need to apply additional commands to enable the specified resource.fmadm load path
Load the specified Fault Manager module. path must be an absolute path and must refer to a module present in one of the defined directories for modules. Typically, the use of this command is not necessary as the FaultManager loads modules automatically when Solaris ini-
tially boots or as needed.SunOS 5.11 Last change: 24 Sep 2010 4
System Administration Commands fmadm(1M)
fmadm unload module
Unload the specified Fault Manager module. Specifymodule using the basename listed in the fmadm config
output. Typically, the use of this command is not neces-
sary as the Fault Manager loads and unloads modules automatically based on the system configurationfmadm repaired fmri | label
Notify the Fault Manager that a repair procedure hasbeen carried out on the specified resource. The fmadm
repaired subcommand should be used only at the direction of a documented Sun repair procedure. Administratorsmight need to apply additional commands to re-enable a
previously faulted resource.fmadm replaced fmri | label
Notify the Fault Manager that the specified resource has been replaced. This command should be used in those cases where the Fault Manager is unable to automaticallydetect the replacement. The fmadm replaced subcommand
should be used only at the direction of a documented Sun repair procedure. Administrators might need to applyadditional commands to re-enable a previously faulted
resource.fmadm reset [-s serd] module
Reset the specified Fault Manager module or module sub-
component. If the -s option is present, the specified
Soft Error Rate Discrimination (SERD) engine is resetwithin the module. If the -s option is not present, the
entire module is reset and all persistent state associ-
ated with the module is deleted. The fmadm reset subcom-
mand should only be used at the direction of a docu-
mented Sun repair procedure. The use of this command is typically not necessary as the Fault Manager manages its modules automatically.fmadm rotate errlog | fltlog | infolog | infolog_hival
The rotate subcommand is a helper command for logadm(1M), so that logadm can rotate live log files correctly. It is not intended to be invoked directly(and invoking it directly is likely to lose log his-
tory). Use one of the following commands to cause theSunOS 5.11 Last change: 24 Sep 2010 5
System Administration Commands fmadm(1M)
appropriate logfile to be rotated, if the current one is not zero in size:# logadm -p now -s 1b /var/fm/fmd/errlog
# logadm -p now -s 1b /var/fm/fmd/fltlog
# logadm -p now -s 1b /var/fm/fmd/infolog
# logadm -p now -s 1b /var/fm/fmd/infolog_hival
OPTIONS The following options are supported:-q Set quiet mode. fmadm does not produce messages indi-
cating the result of successful operations to standard output. OPERANDS The following operands are supported: cmd The name of a subcommand listed in SUBCOMMANDS. args One or more options or arguments appropriate for the selected subcommand, as described in SUBCOMMANDS. Among these arguments are fmri, uuid, and label. These identify resources that are the objects offmadm subcommands. Use fmadm faulty to obtain the
fmri, uuid, and label for a targeted resource. SeeEXAMPLES. In general, label is the most user-
friendly of these operands.EXAMPLES
Example 1 Invoking faulty Subcommand The following command invokes the faulty subcommand, which displays the uuid, label, and fmri for a component.# fmadm faulty
------------ ------------------------------------ ------------ ---------
TIME EVENT-ID MSG-ID SEVERITY
------------ ------------------------------------ ------------ ---------
Sep 09 16:15 96609fae-113c-e48c-b1cf-ebf4b0902d72 DISK-8000-3E Critical
injectedHost : x4170-brm-02
Platform : SUN-FIRE-X4170-SERVER Chassis_id : 0920XF508B
SunOS 5.11 Last change: 24 Sep 2010 6
System Administration Commands fmadm(1M)
Product_sn:
Fault class: fault.io.scsi.cmd.disk.dev.rqs.derrAffects : dev:///:devid=id1,sd@n5000c5000940edbb//scsi_vhci/disk@g5000c\
5000940edbb out of service, but associated components no longer faulty FRU : "DISK 11"(hc://:product-id=SUN-Storage-J4410:server-id=:chassis-id=:serial=000930\
G01CN4----3SJ01CN4:part=SEAGATE-ST330057SSUN300G:revision=0205/\
ses-enclosure=0/bay=11/disk=0)
replaced ... ... In the preceding output, the uuid is the first item in theEVENT-ID column, 96609fae-113c-e48c-b1cf-ebf4b0902d72. The
label is in the FRU row, DISK 11. The fmris are:dev:///:devid=id1,sd@n5000c5000940edbb//scsi_vhci/disk@g5000c\
5000940edbbhc://:product-id=SUN-Storage-J4410:server-id=:chassis-id=:serial=000930\
G01CN4--------3SJ01CN4:part=SEAGATE-ST330057SSUN300G:revision=0205/\
ses-enclosure=0/bay=11/disk=0)
The same values are available with fmdump -v:
# fmdump -v
Sep 09 16:15:36.9252 96609fae-113c-e48c-b1cf-ebf4b0902d72 DISK-8000-3E \
Diagnosed 100% fault.io.scsi.cmd.disk.dev.rqs.derr
Problem in: hc://:scheme=:product-id=SUN-Storage-J4410:chassis-id=:\
server-id=/ses-enclosure=0/bay=11/disk=0
Affects: dev:///:devid=id1,sd@n5000c5000940edbb//\scsi_vhci/disk@g5000c5000940edbb
FRU: hc://:product-id=SUN-Storage-J4410:server-id=:chassis-id=:\
serial=000930G01CN4--------3SJ01CN4:part=SEAGATE-ST330057SSUN300G:\
revision=0205/ses-enclosure=0/bay=11/disk=0
Location: DISK 11SunOS 5.11 Last change: 24 Sep 2010 7
System Administration Commands fmadm(1M)
Note that label is the easiest-to-use identifier.
Example 2 Obtaining Module NameThe following command displays the module name for each com-
ponent. The module name is specified as input to the fmadm
unload command.# fmadm config
MODULE VERSION STATUS DESCRIPTION
cpumem-retire 1.1 active CPU/Memory Retire Agent
disk-transport 1.0 active Disk Transport Agent
eft 1.16 active eft diagnosis engine .. EXIT STATUS The following exit values are returned: 0 Successful completion.1 An error occurred. Errors include a failure to communi-
cate with fmd or insufficient privileges to perform the requested operation.2 Invalid command-line options were specified.
ATTRIBUTES
See attributes(5) for descriptions of the following attri-
butes:____________________________________________________________
| ATTRIBUTE TYPE | ATTRIBUTE VALUE |
|_____________________________|_____________________________|
| Availability | service/fault-management |
|_____________________________|_____________________________|
| Interface Stability | See below. ||_____________________________|_____________________________|
The command-line options are Committed. The human-readable
output is not-an-interface.
SunOS 5.11 Last change: 24 Sep 2010 8
System Administration Commands fmadm(1M)
SEE ALSO
fmd(1M), fmdump(1M), fmstat(1M), logadm(1M), syslogd(1M), attributes(5) System Administration Guide: Advanced AdministrationSunOS 5.11 Last change: 24 Sep 2010 9