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

Metric name	Description	Unit
command.exit.code.count	Number of exit code return	count

Inodes

Metric name	Description	Unit
storage.inodes.usage.percentage	Inodes usage in percentage	%

Process

Metric name	Description	Unit
processes.alerts.count	Number of alerts processes	count
processes.total.count	Total number of alerts processes	count

Storage

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

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>

User/Password Authentication

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

1. Install the Centreon Plugin on every Poller:

yum install centreon-plugin-Operatingsystems-Aix-Local

2. On the Centreon Web interface in Configuration > Monitoring Connector Manager, install the AIX SSH Monitoring Connector

Offline License

1. Install the Centreon Plugin on every Poller:

yum install centreon-plugin-Operatingsystems-Aix-Local

2. On the Centreon Central server, install the Centreon Monitoring Connector from the RPM:

yum install centreon-pack-operatingsystems-aix-ssh

3. 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

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).

plink backend

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).

libssh backend (default)

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.