AIX SSH
Monitoring Connector Assets
Monitored Objects
The Monitoring Connector includes monitoring the AIX system commands using SSH, such as:
- Command return
- Errpt messages
- Inodes
- Group volumes
- Processes
- Storage
Collected Metrics
- Cmdreturn
- Inodes
- Process
- Storage
| Metric name | Description | Unit |
|---|---|---|
| command.exit.code.count | Number of exit code return | count |
| Metric name | Description | Unit |
|---|---|---|
| storage.inodes.usage.percentage | Inodes usage in percentage | % |
| Metric name | Description | Unit |
|---|---|---|
| processes.alerts.count | Number of alerts processes | count |
| processes.total.count | Total number of alerts processes | count |
| Metric name | Description | Unit |
|---|---|---|
| storage.space.usage.bytes | Storage space usage | B |
| storage.space.free.bytes | Storage free space usage | B |
| storageresource.space.usage.percentage | Storage percentage space usage | % |
Prerequisites
A user is required to query the OS AIX by SSH. There is no need for root or sudo privileges. There are two possible ways to perform SSH check, either by exchanging the SSH key from centreon-engine to the target server, or by setting your unique user and password directly in the host macros.
- SSH keys exchange
- User/Password Authentication
Add and generate a password for your user on the Target sever:
adduser ro_ssh_centreon
passwd ro_ssh_centreon
Switch to centreon-engine's bash environment on your Central server and Poller :
su - centreon-engine
Then, copy this key on to the Target server with the following commands:
ssh-keygen -t ed25519 -a 100
ssh-copy-id -i .ssh/id_ed25519.pub ro_ssh_centreon@<IP_TARGET_SERVER>
After setting the Name, Alias, IP, and Host Template parameters, you need to set up in the macros described in the Configuration part below.
Setup
- Online License
- Offline License
- Install the Centreon Plugin on every Poller:
yum install centreon-plugin-Operatingsystems-Aix-Local
- On the Centreon Web interface in Configuration > Monitoring Connector Manager, install the AIX SSH Monitoring Connector
- Install the Centreon Plugin on every Poller:
yum install centreon-plugin-Operatingsystems-Aix-Local
- On the Centreon Central server, install the Centreon Monitoring Connector from the RPM:
yum install centreon-pack-operatingsystems-aix-ssh
- On the Centreon Web interface in Configuration > Monitoring Connector Manager, install the AIX SSH Monitoring Connector
Configuration
- Add a new Host and apply the OS-AIX-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.
How to check in the CLI that the configuration is OK and what are the main options for ?
Once the Plugin installed, log into your Poller using the centreon-engine user account and test by running the following command :
/usr/lib/centreon/plugins/centreon_aix_local.pl \
--plugin=os::aix::local::plugin \
--mode=lvsync \
--hostname=10.30.2.81 \
--ssh-username=centreon \
--ssh-password='centreon-password' \
--ssh-backend=sshcli \
--filter-type='SVG' \
--critical-status='%{state} =~ /stale/i'\
--verbose
The above command controls the state of volumes groups mirroring (--mode=lvsync).
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.81 (--hostname=10.30.2.81).
All the options that can be used with this plugin can be found over the --help options:
/usr/lib/centreon/plugins/centreon_aix_local.pl \
--plugin=os::aix::local::plugin \
--mode=lvsync \
--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 libssh or plink on the Centreon Poller.