Back to the list of connectors

IBM AIX - usysfault


Provides the status of the System Attention LED of an IBM AIX server.

Connector ID: IBMAIXusysfault


Typical platform: IBM POWER

Operating system: IBM AIX


Leverages: IBM AIX usysfault command

Technology and protocols: System Commands

This connector requires advanced privileges on the managed host for the command below:

  • /usr/lpp/diagnostics/bin/usysfault

This connector therefore needs to run as root or you need to configure a privilege-escalation mechanism like sudo on the managed host to allow the monitoring account to run the command listed above.

Sample of /etc/sudoers to allow the above command to be run as root by the hwsagent account:

hwsagent ALL=(root) NOPASSWD: /usr/lpp/diagnostics/bin/usysfault



hws HOSTNAME -t rs6000 -f IBMAIXusysfault --ssh -u USER --sudo-command-list /usr/lpp/diagnostics/bin/usysfault


- host:
    hostname: <HOSTNAME> # Change with actual host name
    type: rs6000
  selectedConnectors: [ IBMAIXusysfault ] # Optional, to load only this connector
    username: <USERNAME> # Change with actual credentials
    password: <PASSWORD> # Encrypted using hws-encrypt
    useSudo: true
    useSudoCommands: [ "/usr/lpp/diagnostics/bin/usysfault" ]

Connector Activation Criteria

The IBM AIX - usysfault connector will be automatically activated, and its status will be reported as OK if all the below criteria are met:

  • Operating System is IBM AIX
  • The command below succeeds on the monitored host
    • Command: /usr/lpp/diagnostics/bin/usysfault
    • Output contains: ^\(normal\)\|\(fault\)$ (regex)


Type Collected Metrics Specific Attributes (Labels)
  • hw.status{hw.type="led",state="ok|degraded|failed"}
  • hw.status{hw.type="led",state="present"}
  • name
No results.