Back to the list of connectors

Emulex HBAs (hbacmd)


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:


Typical platform: Any system with Emulex

Operating systems: Linux, Oracle Solaris


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



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


- host:
    hostname: <HOSTNAME> # Change with actual host name
    type: linux
  selectedConnectors: [ EmulexHbacmd ] # Optional, to load only this connector
    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)


Type Collected Metrics Specific Attributes (Labels)
Network Card, FC Port
  • hw.errors{hw.type="network"}
  • hw.status{hw.type="network",state="ok|degraded|failed"}
  • hw.status{hw.type="network",state="present"}
  • model
  • physical_address
  • vendor
No results.