Emulex HBAs (hbacmd)

Description

This connector discovers Emulex HBAs of servers running on UNIX or Linux using the hbacmd utility provided with the Emulex Drivers.

emulex hardware linux solaris

Enterprise Connector

This connector requires the Enterprise edition of MetricsHub.

Supersedes

This connector supersedes:

• CpqHBA
• SMISHBA

Target

Typical platform: Emulex

Operating systems: Linux, Oracle Solaris

Prerequisites

Leverages: Emulex's hbacmd utility

Technology and protocols: Commands

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

• hbacmd

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: hbacmd

Examples

CLI

metricshub HOSTNAME -t linux -c +EmulexHbacmd --ssh -u USER --sudo-command-list hbacmd

metricshub.yaml

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

Connector Activation Criteria

The Emulex HBAs (hbacmd) 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: hbacmd ListHBAs
  • Output contains: Port WWN (regex)

Metrics

Type	Collected Metrics	Specific Attributes
network	hw.errors{hw.type="network"} hw.network.bandwidth.limit hw.network.io{direction="receive"} hw.network.io{direction="transmit"} hw.network.packets{direction="receive"} hw.network.packets{direction="transmit"} hw.network.up hw.status{hw.type="network", state="degraded|failed|ok"} hw.status{hw.type="network", state="present"}	bandwidth device_type hw.parent.type id model name physical_address physical_address_type vendor