IBM AIX - sissasraidmgr Disk Controllers

Description

This connector enables hardware monitoring for RAID controllers in IBM AIX servers through the syssasraidmgr command line utility.

aix hardware ibm raid

Enterprise Connector

This connector requires the Enterprise edition of MetricsHub.

Target

Typical platform: IBM POWER

Operating system: IBM AIX

Prerequisites

Leverages: sissasraidmgr managed RAID card

Technology and protocols: Commands

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

• /usr/bin/sissasraidmgr

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/bin/sissasraidmgr

Examples

CLI

metricshub HOSTNAME -t linux -c +IBMAIXSissasraidmgr --ssh -u USER --sudo-command-list /usr/bin/sissasraidmgr

metricshub.yaml

resourceGroups:
  <RESOURCE_GROUP>:
    resources:
      <HOSTNAME-ID>:
        attributes:
          host.name: <HOSTNAME> # Change with actual host name
          host.type: linux
        connectors: [ +IBMAIXSissasraidmgr ] # Optional, to load only this connector
        protocols:
          ssh:
            username: <USERNAME> # Change with actual credentials
            password: <PASSWORD> # Encrypted using metricshub-encrypt
            useSudo: true
            useSudoCommands: [ "/usr/bin/sissasraidmgr" ]

Connector Activation Criteria

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

• The command below succeeds on the monitored host:
  • Command: cd /etc/objrepos;/usr/bin/sissasraidmgr
  • Output contains: 0940-002 Invalid or no command specified (regex)
• The command below succeeds on the monitored host:
  • Command: ls /dev/sissas*
  • Output contains: /dev/sissas[0-9] (regex)
• The command below succeeds on the monitored host:
  • Command: for CTRL in ls /dev/sissas* | sed s:/dev/::;do cd /etc/objrepos; /usr/bin/sissasraidmgr -Ll $CTRL;done;
  • Output contains: hdisk[0-9] (regex)

Metrics

Type	Collected Metrics	Specific Attributes
battery	hw.status{hw.type="battery", state="degraded|failed|ok"} hw.status{hw.type="battery", state="present"}	hw.parent.id hw.parent.type id name
disk_controller	hw.status{hw.type="disk_controller", state="present"}	controller_number hw.parent.type id info model name
logical_disk	hw.logical_disk.limit hw.status{hw.type="logical_disk", state="degraded|failed|ok"}	hw.parent.id hw.parent.type id info name
physical_disk	hw.physical_disk.size hw.status{hw.type="physical_disk", state="degraded|failed|ok"} hw.status{hw.type="physical_disk", state="present"}	hw.parent.id hw.parent.type id info name