Exporter et importer la configuration Centreon avec AWIE

Reproduire des hôtes, des modèles et des contacts d'une plateforme Centreon à une autre sans tout ressaisir : c'est le rôle d'AWIE, à condition de connaître ses angles morts.

AWIE (Centreon Web Import/Export) est un module qui copie des objets de configuration d'une plateforme Centreon source vers une plateforme cible : collecteurs, hôtes, services, modèles, contacts, périodes. Selon la documentation Centreon, il repose sur les commandes CLAPI, mais permet de passer par l'interface web plutôt que par la ligne de commande. Il faut être administrateur pour l'utiliser.

Cette page suit la documentation de Centreon 25.10. Travaillez d'abord vers une plateforme de test, et sauvegardez la cible avant tout import : AWIE crée des objets, il ne fusionne pas des configurations avec discernement.

PlateformeRôleAdresse
centreon-recettesource, configuration validée192.168.10.20
centreon-prodcible192.168.20.20

Installer le module

Installez le paquet sur chaque plateforme, source et cible :

dnf install centreon-awie

Sur Debian 12 :

apt install centreon-awie

Puis, dans l'interface, ouvrez Administration > Extensions > Manager, cherchez « awie » et cliquez sur Install selection. Le menu Configuration > Import/Export apparaît, avec la page Export par défaut.

Exporter : choisir les objets

Chaque famille d'objets a sa case à cocher, et souvent un champ Filter qui n'accepte qu'une seule valeur exacte, sans suggestion. Les comportements à connaître :

ObjetComportement documenté
Pollerscase All : tous les collecteurs avec leurs fichiers de configuration ; sinon un seul par son nom
Hosts (tous)hôtes, modèles d'hôte et de service liés, mais sans leurs services
Hosts (filtre)un seul hôte, créé avec tous ses services
Services (filtre)crée tous les services liés au premier hôte du service filtré
Host / service categoriestoutes, pas de filtre
Contactstous les contacts sans leurs groupes, ou tous les groupes avec leurs utilisateurs
Commandspar type : Check, Notification, Miscellaneous, Discovery
ACLobjets exportés, mais liens entre eux non recréés à l'import
LDAP, Timeperiodstoute la configuration, pas de filtre

Deux pièges reviennent souvent. Exporter « tous les hôtes » ne transporte pas les services : sur la cible, il faut activer pour chaque hôte l'option de création des services liés au modèle (« Create Services linked to… »), enregistrer et exporter la configuration. Et la documentation signale comme problème connu que les commandes de notification en ligne de commande ne sont pas exportées entièrement : vérifiez-les à la main.

Un clic sur Export télécharge une archive zip. Ne la renommez pas : Centreon prévient qu'une archive renommée ne s'importe plus si son nom diffère de celui du fichier qu'elle contient.

Importer sur la plateforme cible

  1. Ouvrez Configuration > Import/Export > Import.
  2. Sélectionnez l'archive centreon-clapi-export et cliquez sur Import.
  3. Attendez le message « Import successful ».
  4. Contrôlez les objets dans les pages de configuration habituelles.
  5. Générez, testez et exportez la configuration des collecteurs.

La dernière étape est obligatoire : tant que la configuration n'est pas déployée, les objets importés existent en base mais ne sont pas supervisés. Si des connecteurs sont utilisés par les modèles importés, installez-les aussi sur la cible, avec leurs plugins sur les collecteurs, comme décrit dans la page sur l'installation et la mise à jour des connecteurs Centreon.

L'équivalent en ligne de commande avec CLAPI

AWIE n'est qu'une interface sur CLAPI. Pour automatiser, la documentation CLAPI donne l'export complet vers un fichier texte, puis son import :

centreon -u admin -p '<mot-de-passe>' -e > /tmp/clapi-export.txt
centreon -u admin -p '<mot-de-passe>' -i /tmp/clapi-export.txt

L'export CLAPI exclut les escalades, les ACL, les paramètres LDAP et les paramètres globaux de Centreon. Pour un sous-ensemble, l'option --select cible un hôte ou des services précis, avec --filter-type. En cas d'erreur, CLAPI affiche le numéro de ligne fautif : redirigez la sortie vers un fichier pour un gros import.

Évitez de laisser un mot de passe administrateur dans l'historique du shell ou dans un script versionné.

AWIE ne remplace pas une sauvegarde

AWIE déplace des objets ; il ne sauvegarde ni les données de supervision, ni les bases, ni les fichiers système. Pour cela, Centreon fournit son propre script de sauvegarde, réglé dans Administration > Parameters > Backup. AWIE ne copie que les objets décrits dans la page sur la supervision avec Centreon : hôtes, services, modèles, commandes. Les tableaux de bord et rapports MBI ne font pas partie des objets listés par AWIE : voyez la page sur les tableaux de bord et rapports Centreon. Pour des modèles complexes, comme ceux de la supervision d'Exchange, vérifiez chaque macro après l'import. La rubrique Centreon regroupe les autres procédures.

Questions fréquentes

Qu'est-ce que Centreon AWIE ?

Un module de Centreon qui exporte des objets de configuration d'une plateforme et les importe sur une autre, par l'interface web. Il s'appuie sur les commandes CLAPI.

Pourquoi mes hôtes arrivent-ils sans services ?

Parce que l'export de tous les hôtes n'inclut pas les services. Activez sur chaque hôte de la cible l'option de création des services liés au modèle, ou exportez un hôte par filtre, qui arrive avec ses services.

Les ACL sont-elles importées correctement ?

Les objets ACL sont importés, mais la documentation précise que les liens entre ces objets ne sont pas recréés. Reliez-les à la main sur la cible.

Peut-on renommer l'archive exportée ?

Non. Centreon prévient qu'une archive dont le nom diffère du fichier qu'elle contient ne peut plus être importée.

AWIE peut-il servir de sauvegarde ?

Non. Il copie des objets de configuration, pas les bases ni les données collectées. Utilisez le mécanisme de sauvegarde de Centreon pour cela.