Back to the list of connectors

Emulex HBAs (hbacmd)

Description

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

Connector ID: EmulexHbacmd

This connector supersedes:

Target

Typical platform: Any system with Emulex

Operating systems: Linux, Oracle Solaris

Prerequisites

Leverages: Emulex's hbacmd utility

Technology and protocols: System 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 hwsagent account:

hwsagent ALL=(root) NOPASSWD: hbacmd

Examples

CLI

hws HOSTNAME -t linux -f EmulexHbacmd --ssh -u USER --sudo-command-list hbacmd

hws-config.yaml

hosts:
- host:
    hostname: <HOSTNAME> # Change with actual host name
    type: linux
  selectedConnectors: [ EmulexHbacmd ] # Optional, to load only this connector
  ssh:
    username: <USERNAME> # Change with actual credentials
    password: <PASSWORD> # Encrypted using hws-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 (Labels)
Network Card, FC Port
  • hw.errors{hw.type="network"}
  • hw.network.bandwidth.limit
  • hw.network.bandwidth.utilization
  • 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="ok|degraded|failed"}
  • hw.status{hw.type="network",state="present"}
  • model
  • physical_address
  • vendor
No results.