IBM HMC SSH
Monitoring Connector Assets
Monitored Objects
The Monitoring Connector IBM HMC SSH collects metrics for:
- Hardware errors
- Led status
Collected Metrics
- Hardware-errors
- Led-status
No metrics.
| Metric name | Description | Unit |
|---|---|---|
| physical status | Physical system attention led status | |
| virtuallpar status | Logical partition system attention led status |
Prerequisites
The centreon-engine user performs a SSH connection to a remote system user. This user must have enough privileges to run lssvcevents and lsled commands.
Setup
- Online License
- Offline License
- Install the Centreon Plugin on every Poller:
yum install centreon-plugin-Hardware-Servers-Ibm-Hmc-Ssh
- On the Centreon Web interface in Configuration > Monitoring Connector Manager, install the IBM HMC SSH Monitoring Connector
- Install the Centreon Plugin on every Poller:
yum install centreon-plugin-Hardware-Servers-Ibm-Hmc-Ssh
- On the Centreon Central server, install the Centreon Monitoring Connector from the RPM:
yum install centreon-pack-hardware-servers-ibm-hmc-ssh
- On the Centreon Web interface in Configuration > Monitoring Connector Manager, install the IBM HMC SSH Monitoring Connector
Configuration
- Add a new Host and apply the HW-Server-IBM-Hmc-SSH-custom Host Template
3 SSH backends are available to connect to the remote server: sshcli, plink and libssh which are detailed below.
- sshcli backend
- plink backend
- libssh backend (default)
| Mandatory | Name | Description |
|---|---|---|
| X | SSHBACKEND | Name of the backend: sshcli |
| X | SSHUSERNAME | By default, it uses the user running process centengine on your Poller |
| SSHPASSWORD | Cannot be used with backend. Only ssh key authentication | |
| SSHPORT | By default: 22 | |
| SSHEXTRAOPTIONS | Customize it with your own if needed. E.g.: --ssh-priv-key=/user/.ssh/id_rsa |
Warning With that backend, you have to validate the target server fingerprint manually (with the SSHUSERNAME used).
| Mandatory | Name | Description |
|---|---|---|
| X | SSHBACKEND | Name of the backend: plink |
| X | SSHUSERNAME | By default, it uses the user running process centengine on your Poller |
| SSHPASSWORD | Can be used. If not set, SSH key authentication is used | |
| SSHPORT | By default: 22 | |
| SSHEXTRAOPTIONS | Customize it with your own if needed. E.g.: --ssh-priv-key=/user/.ssh/id_rsa |
Warning With that backend, you have to validate the target server fingerprint manually (with the SSHUSERNAME used).
| Mandatory | Name | Description |
|---|---|---|
| X | SSHBACKEND | Name of the backend: libssh |
| X | SSHUSERNAME | By default, it uses the user running process centengine on your Poller |
| SSHPASSWORD | Can be used. If not set, SSH key authentication is used | |
| SSHPORT | By default: 22 | |
| SSHEXTRAOPTIONS | Customize it with your own if needed. E.g.: --ssh-priv-key=/user/.ssh/id_rsa |
With that backend, you do not have to validate the target server fingerprint manually.
FAQ
How to test the Plugin and what are the main options for?
Once the plugin installed, log into your Centreon Poller CLI using the centreon-engine user account and test the Plugin by running the following command:
/usr/lib/centreon/plugins/centreon_ibm_hmc_ssh.pl \
--plugin=hardware::server::ibm::hmc::ssh::plugin \
--mode=led-status \
--hostname=10.30.2.114 \
--ssh-username=centreon \
--ssh-password='centreon-password' \
--ssh-backend=libssh \
--verbose
Expected command output is shown below:
OK: System 'Server-8203-E4Z-SNE6DFXA5' physical led state : off - All virtual partition status are ok |
System 'Server-8203-E4Z-SNE6DFXA5' physical led state : off
Virtual partition 'Server-8203-E4Z-SNE6DFXA5:LPAR1' led state : off
Virtual partition 'Server-8203-E4Z-SNE6DFXA5:LPAR2' led state : off
The command above gets the led status of IBM HMC (--mode=led-status).
It uses a SSH username centreon (--ssh-username=centreon), a SSH password centreon-password (--ssh-password='centreon-password'),
uses a SSH backend libssh (--ssh-backend='libssh') and it connects to the host 10.30.2.114 (--hostname=10.30.2.114)
on the SSH default port 22 (--ssh-port=22).
All the options as well as all the available thresholds can be displayed by adding the --help
parameter to the command:
/usr/lib/centreon/plugins/centreon_ibm_hmc_ssh.pl \
--plugin=hardware::server::ibm::hmc::ssh::plugin \
--mode=led-status \
--help
Troubleshooting
I have that error message: UNKNOWN: Command error: Host key verification failed.. What does it mean ?
It means you haven't manually validated the target server fingerprint with ssh or plink on the Centreon Poller.