Back to the list of connectors

Oracle/Sun Solaris - mpathadm

Description

This connector provides the monitoring of LUNs on all Solaris 10.2 or later systems through the mpathadm utility.

Connector ID: SunMpathadm

Target

Typical platform: Any system with mpathadm

Operating system: Oracle Solaris

Prerequisites

Leverages: Solaris Mpathadm utility

Technology and protocols: System Commands

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

  • /usr/sbin/mpathadm

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: /usr/sbin/mpathadm

Examples

CLI

hws HOSTNAME -t solaris -f SunMpathadm --ssh -u USER --sudo-command-list /usr/sbin/mpathadm

hws-config.yaml

hosts:
- host:
    hostname: <HOSTNAME> # Change with actual host name
    type: solaris
  selectedConnectors: [ SunMpathadm ] # Optional, to load only this connector
  ssh:
    username: <USERNAME> # Change with actual credentials
    password: <PASSWORD> # Encrypted using hws-encrypt
    useSudo: true
    useSudoCommands: [ "/usr/sbin/mpathadm" ]

Connector Activation Criteria

The Oracle/Sun Solaris - mpathadm 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: /usr/sbin/mpathadm list lu
    • Output contains: /dev/rdsk (regex)

Metrics

Type Collected Metrics Specific Attributes (Labels)
LUN
  • hw.lun.paths{type="available"}
  • hw.status{hw.type="lun",state="present"}
  • array_name
  • local_device_name
No results.