Unix‎ > ‎Solaris‎ > ‎Solaris man pages‎ > ‎1m‎ > ‎

fmadm


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 detected
     by 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, and

         o    perform administrative tasks related to these enti-
              ties.


     The Fault Manager attempts to automate as many activities as
     possible,  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.sun.com/msg/. The web
     site might ask you to use fmadm or one of  the  other  fault
     management  utilities  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.

  SUBCOMMANDS
     fmadm accepts the following subcommands. Some of the subcom-
     mands accept or require additional options and operands:


     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  in
         any  fault  or faults that have been detected. The fmadm
         acquit subcommand should be used only at  the  direction
         of  a  documented  Sun  repair procedure. Administrators
         might need to apply additional commands to  re-enable  a
         previously faulted resource.


     fmadm acquit uuid

         Notify the Fault Manager that the fault event identified
         by  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 need
         to 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  provide
         services  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  you
                   specify  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  in
                   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  the
         same  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:

     ok

         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 has
         been 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 is
         reflected  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  for
         the  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  cache
         up-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 Fault
         Manager loads modules automatically  when  Solaris  ini-
         tially boots or as needed.


     fmadm unload module

         Unload  the  specified  Fault  Manager  module.  Specify
         module  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 configuration


     fmadm repaired fmri | label

         Notify the Fault Manager that  a  repair  procedure  has
         been  carried  out  on the specified resource. The fmadm
         repaired subcommand should be used only at the direction
         of  a  documented  Sun  repair procedure. Administrators
         might 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 automatically
         detect  the  replacement.  The fmadm replaced subcommand
         should be used only at the direction of a documented Sun
         repair  procedure.  Administrators  might  need to apply
         additional 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  reset
         within  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

         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.
         Use one of the following commands to cause the appropri-
         ate 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




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.


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                | SUNWfmd                     |
    |_____________________________|_____________________________|
    | Interface Stability         | See below.                  |
    |_____________________________|_____________________________|



     The command-line options are Committed.  The  human-readable
     output is not-an-interface.

SEE ALSO
     fmd(1M), fmdump(1M),  fmstat(1M),  logadm(1M),  syslogd(1M),
     attributes(5)


     http://www.sun.com/msg/










Man pages from Solaris 10 Update 8. See docs.sun.com and www.oracle.com for further documentation and Solaris information.
Comments