Description

This connector provides the status of the System Attention LED of an IBM AIX server.

Target

Typical platform: IBM POWER

Operating system: IBM AIX

Prerequisites

Leverages: IBM AIX usysfault command

Technology and protocols: Command Lines

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 metricshub account:

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

Examples

metricshub HOSTNAME -t aix -c +IBMAIXusysfault --ssh -u USER --sudo-command-list /usr/lpp/diagnostics/bin/usysfault

resourceGroups:
  <RESOURCE_GROUP>:
    resources:
      <HOSTNAME-ID>:
        attributes:
          host.name: <HOSTNAME> # Change with actual host name
          host.type: aix
        selectConnectors: [ IBMAIXusysfault ] # Optional, to load only this connector
        protocols:
          ssh:
            username: <USERNAME> # Change with actual credentials
            password: <PASSWORD> # Encrypted using metricshub-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)

Metrics