AIX SSH

Contenu du connecteur de supervision

Objets supervisés

Le connecteur de supervision inclut la supervision le système AIX en utilisant les commandes SSH, tel que :

• Retour de commande
• Messages errpt
• Inodes
• Volumes Groupes
• Processus
• Stockage

Métriques collectées

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 percenta	%

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	%

Prérequis

Un simple utilisateur est nécessaire pour interroger le système d'exploitation AIX par SSH. Il n'est pas nécessaire d'avoir des privilèges root ou sudo. Il y a deux façons possibles d'effectuer la vérification SSH, soit en échangeant la clé SSH de centreon-engine au serveur cible, ou en définissant votre utilisateur et votre mot de passe directement dans les macros hôtes.

Exchange des Clés SSH

Ajouter et générer un mot de passe pour votre utilisateur sur le Serveur Cible :

adduser ro_ssh_centreon
passwd ro_ssh_centreon

Basculer vers l'environnement bash de centreon-engine sur votre serveur Central et sur Poller :

su - centreon-engine

Ensuite, copier cette clé sur le Serveur cible avec les commandes suivantes :

ssh-keygen -t ed25519 -a 100
ssh-copy-id -i .ssh/id_ed25519.pub ro_ssh_centreon@<IP_TARGET_SERVER>

Autentification Utilisateur/Mot de passe

Après avoir défini les paramètres du nom, de l'alias, de l'IP et du modèle d'hôte, vous devez remplir les macros décritent dans la partie Configuration ci-dessous.

Installation

Online License

1. Installer le Plugin sur tous les Collecteurs Centreon :

yum install centreon-plugin-Operatingsystems-Aix-Local

2. Sur l'interface Web de Centreon, installer le connecteur de supervision AIX SSH depuis la page Configuration > Gestionnaire de connecteurs de supervision

Offline License

1. Installer le Plugin sur tous les Collecteurs Centreon :

yum install centreon-plugin-Operatingsystems-Aix-Local

2. Sur le serveur Central Centreon, installer le connecteur de supervision via le RPM:

yum install centreon-pack-operatingsystems-aix-ssh

3. Sur l'interface Web de Centreon, installer le connecteur de supervision AIX SSH depuis la page Configuration > Gestionnaire de connecteurs de supervision

Configuration

Ce connecteur de supervision est conçu de manière à avoir dans Centreon un hôte par serveur AIX. Lorsque vous ajoutez un hôte à Centreon, appliquez-lui le modèle OS-AIX-SSH-custom. Une fois celui-ci configuré, certaines macros doivent être renseignées:

sshcli backend

Mandatory	Name	Description
X	SSHBACKEND	Nom du backend: sshcli
X	SSHUSERNAME	Par default, il utilise l'utilisateur en cours d'exécution centengine de votre Collecteur
	SSHPASSWORD	Ne peut pas être utilisé avec le backend. Seulement avec la clé d'authentication
	SSHPORT	Par default: 22
	SSHEXTRAOPTIONS	Personnalisez-le avec le vôtre si nécessaire. E.g.: --ssh-priv-key=/user/.ssh/id_rsa

Avec ce backend, il est nécessaire d'effectuer une connexion manuelle entre l'utilisateur centreon-engine du Collecteur et l'utilisateur applicatif créé sur le serveur distant. (Macro SSHUSERNAME).

plink backend

Mandatory	Name	Description
X	SSHBACKEND	Nom du backend: plink
X	SSHUSERNAME	Par default, il utilise l'utilisateur en cours d'exécution centengine de votre Collecteur
	SSHPASSWORD	Peut être utilisé. Si aucune valeur n'est définie, l'authentification par clé ssh est utilisée
	SSHPORT	Par default: 22
	SSHEXTRAOPTIONS	Personnalisez-le avec le vôtre si nécessaire. E.g.: --ssh-priv-key=/user/.ssh/id_rsa

Avec ce backend, il est nécessaire d'effectuer une connexion manuelle entre l'utilisateur centreon-engine du Collecteur et l'utilisateur applicatif créé sur le serveur distant. (Macro SSHUSERNAME).

libssh backend (par défaut)

Mandatory	Name	Description
X	SSHBACKEND	Nom du backend: libssh
	SSHUSERNAME	Par default, il utilise l'utilisateur en cours d'exécution centengine de votre Collecteur
	SSHPASSWORD	Peut être utilisé. Si aucune valeur n'est définie, l'authentification par clé ssh est utilisée
	SSHPORT	Par default: 22
	SSHEXTRAOPTIONS	Personnalisez-le avec le vôtre si nécessaire. E.g.: --ssh-priv-key=/user/.ssh/id_rsa

Avec ce backend, vous n'avez pas à valider manuellement le fingerprint du serveur cible.

Comment puis-je tester le Plugin et que signifient les options des commandes ?

Une fois le Plugin installé, vous pouvez tester celui-ci directement en ligne de commande depuis votre Collecteur Centreon avec l'utilisateur centreon-engine

/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

La commande ci-dessus contrôle le mirroring des volumes groupes (--mode=lvsync). Le Plugin utilise le Backend sshcli (--ssh-backend='sshcli') avec l'utisateur centreon (--ssh-username=centreon --api-password='centreon-password') et il se connecte à l'hôte 10.30.2.81 (--hostname='10.30.2.81').

Toutes les options et leur utilisation peuvent être consultées avec le paramètre --help ajouté à la commande :

/usr/lib/centreon/plugins/centreon_aix_local.pl \
    --plugin=os::aix::local::plugin \
    --mode=lvsync \
    --help

Troubleshooting

J'ai ce message d'erreur : UNKNOWN: Command error: Host key verification failed.. Qu'est-ce que cela signifie ?

Cela signifie que vous n'avez pas validé manuellement la signature (fingerprint) du serveur cible avec libssh ou plink sur le Poller Centreon.