Agent Zabbix sur IBM AIX

Vue d’ensemble

Les binaires précompilés de l’agent Zabbix pour IBM AIX sont disponibles au téléchargement sous forme d’archive .tar.gz. Cette page décrit comment installer l’agent à partir de l’archive, l’exécuter manuellement ou avec le System Resource Controller (SRC), le démarrer au démarrage du système et le supprimer du SRC.

Installation de l'agent

La commande tar d'AIX ne prend pas en charge l'option -z. Décompressez donc l'archive avec gunzip. Utilisez l'option -o de tar afin que les fichiers extraits appartiennent à l'utilisateur qui les extrait, et non aux identifiants numériques de l'utilisateur et du groupe stockés dans l'archive. Par exemple, pour installer l'agent dans /opt/zabbix (à exécuter en tant que root ; /opt/zabbix ne doit pas encore exister) :

gunzip -c zabbix_agent-7.4.7-aix-7.2-powerpc-openssl.tar.gz | tar -xof -
mv zabbix_agent-7.4.7-aix-7.2-powerpc-openssl /opt/zabbix

Dans l'archive AIX, le binaire de l'agent se trouve dans usr/sbin/ et le fichier de configuration dans etc/zabbix/. Avant de démarrer l'agent, ajustez /opt/zabbix/etc/zabbix/zabbix_agentd.conf si nécessaire (au minimum les paramètres Server, ServerActive et Hostname).

S'il est démarré en tant que root, l'agent bascule vers l'utilisateur zabbix (ou vers l'utilisateur indiqué par le paramètre User), sauf si AllowRoot=1 est défini dans le fichier de configuration. Cet utilisateur doit exister sur le système ; sinon, l'agent ne démarre pas. Si l'utilisateur zabbix n'existe pas encore, créez-le avec un groupe du même nom :

mkgroup zabbix
mkuser pgrp=zabbix login=false rlogin=false zabbix

Les attributs login=false et rlogin=false empêchent l'utilisation du compte pour se connecter ; l'agent peut néanmoins s'exécuter avec cet utilisateur.

Démarrer l'agent manuellement

L'agent peut être démarré manuellement :

/opt/zabbix/usr/sbin/zabbix_agentd -c /opt/zabbix/etc/zabbix/zabbix_agentd.conf

Exécution de l'agent avec SRC

Enregistrement de l'agent

L'agent peut également être enregistré auprès du System Resource Controller (SRC). Lorsqu'il est démarré via le SRC, l'agent doit s'exécuter en mode premier plan (option -f). Dans le cas contraire, le SRC perd le suivi du processus de l'agent et ne peut pas l'arrêter. Par exemple (à exécuter en tant que root) :

mkssys \
  -s zabbix_agentd \
  -p /opt/zabbix/usr/sbin/zabbix_agentd \
  -a "-c /opt/zabbix/etc/zabbix/zabbix_agentd.conf -f" \
  -u zabbix \
  -G tcpip \
  -S -n 15 -f 9 \
  -R

Dans cet exemple :

  • -s définit le nom du sous-système utilisé avec les commandes SRC ;
  • -p définit le chemin complet vers le binaire de l'agent ;
  • -a définit les arguments de ligne de commande de l'agent sous la forme d'une chaîne entre guillemets ; le SRC divise cette chaîne en arguments distincts lorsqu'il démarre l'agent (une seule option -a est acceptée) ;
  • -u définit l'utilisateur sous lequel l'agent s'exécute ; le nom d'utilisateur est converti en identifiant utilisateur numérique lors de la création du sous-système. L'utilisateur doit donc déjà exister ;
  • -G ajoute l'agent au groupe de sous-systèmes tcpip, afin que les commandes de groupe s'appliquent également à celui-ci (par exemple, stopsrc -g tcpip arrête également l'agent) ;
  • -S -n 15 -f 9 configure le SRC pour contrôler l'agent au moyen de signaux : stopsrc envoie SIGTERM (15) pour un arrêt normal et SIGKILL (9) pour un arrêt forcé (stopsrc -f) ;
  • -R configure le SRC pour redémarrer l'agent s'il se termine anormalement (par exemple, si l'un de ses processus se termine de manière inattendue) ; l'agent n'est pas redémarré après l'exécution de stopsrc.

Comme l'identifiant utilisateur est enregistré dans la définition du sous-système, mettez à jour cette définition si l'utilisateur zabbix est recréé avec un autre identifiant utilisateur :

chssys -s zabbix_agentd -u zabbix
Démarrage et arrêt de l'agent

L'agent peut être démarré, interrogé et arrêté avec startsrc, lssrc et stopsrc :

startsrc -s zabbix_agentd
lssrc -s zabbix_agentd
stopsrc -s zabbix_agentd

Évitez l'arrêt forcé (stopsrc -f). Il tue uniquement le processus principal de l'agent ; les autres processus de l'agent continuent de s'exécuter et gardent le port d'écoute ouvert. L'agent ne peut donc pas être redémarré tant qu'ils n'ont pas été arrêtés manuellement (par exemple avec kill -9).

Démarrage de l'agent au démarrage du système

L'enregistrement de l'agent auprès de SRC ne le fait pas démarrer au démarrage du système. Pour démarrer automatiquement l'agent au démarrage, ajoutez une entrée à /etc/inittab :

mkitab "zabbix_agentd:2:once:/usr/bin/startsrc -s zabbix_agentd >/dev/console 2>&1"

Suppression de l'agent de SRC

Pour supprimer l'agent du démarrage du système et de SRC :

stopsrc -s zabbix_agentd
rmitab zabbix_agentd
rmssys -s zabbix_agentd