Description
Ce module permet à l'Arbiter de communiquer avec le Synchronizer pour obtenir la configuration des éléments à superviser. Il est donc indispensable au bon fonctionnement d'une installation Shinken Entreprise.
Lorsque vous modifiez les paramètres de ce module, vous devez redémarrer l'Arbiter pour les prendre en compte.
Il ne faut pas enlever ce module. Dans le cas contraire, l'Arbiter ne pourra plus récupérer de données du Synchronizer.
Ni mettre plusieurs modules de type synchronizer-import sur l'Arbiter.
Activation du module
Le module synchronizer-import est un module qui peut être activé seulement sur le démon Arbiter.
- L'activation du module s'effectue en ajoutant le nom de ce module dans le fichier de configuration du démon Arbiter.
- Le module ne doit pas être enlevé de la liste des modules de l'Arbiter.
Exemple: par défaut, nous livrons un module dont le nom est "synchronizer-import":
define arbiter {
[...]
modules Module 1, Module 2, Module 3, synchronizer-import
[...]
}
Pour prendre en compte le changement de configuration, redémarrez l'Arbiter :
service shinken-arbiter restart
Configuration
La configuration du module se trouve par défaut dans le fichier /etc/shinken/modules/synchronizer-import.cfg
- Vous trouverez aussi systématiquement un exemple dans /etc/shinken-user-example/configuration/daemons/arbiters/modules/synchronizer-import/synchronizer-import-example.cfg
Exemple de fichier de configuration
define module{
#======== Module identity =========
# Module name. Must be unique
module_name synchronizer-import
# Module type (to load module code). Do not edit.
module_type synchronizer-import
#======== synchronizer connection =========
# url: http(s) uri for connecting to the synchronizer internal API (by default the 7765 port)
url http://localhost:7765
# master-key : The master_key is an identification key generated at installation time on the Synchronizer,
# which allows daemons to identify themselves to the configuration interface as part of the same installation.
# This allows a daemon or module to request the configuration interface.
# Its value must be the master key in /etc/shinken/synchronizer.cfg
master_key MASTERKEY-KUMi_DY49LtZTLI3XMiabDT5f_OyErn-8oH1Ew0z7kv86y5zNjm2bJ-Wf50cfy5Hwc1BTMBhA747p0_sKwd-YAtbD2D9mmBY8ecBAvMmXIqRCaAe86GyBrQzQRaLz6_x38rjBT1ImAcwZwwE1U1tiI3qhLS4cRsRZHCP_DcKJ2XTDbYL7eoeBdc9FRUApTmP6S5xdonY6_lteiBiUgceuJQkbCy94l6Es5yTzCH3PDqj11hy86hE9yekAmkgZkJz
# Maximum number of tries for loading the synchronizer configuration before reporting a failure
#max_try 90
# Sleep time (in seconds) between two successive tries of loading the synchronizer configuration
#sleep_time 2
}
Détails des sections composant le fichier de configuration
Identification du module
| Nom | Type | Unité | Défaut | Commentaire |
|---|---|---|---|---|
module_name | Texte | --- | synchronizer-import | Paramètre permettant de le différencier d'un autre module du même type. Doit être unique. |
module_type | Texte | --- | synchronizer-import | Ne peut être modifié. |
Connexion au Synchronizer
#======== synchronizer connection ========= # url: http(s) uri for connecting to the synchronizer internal API (by default the 7765 port) url http://localhost:7765 # master-key : The master_key is an identification key generated at installation time on the Synchronizer, # which allows daemons to identify themselves to the configuration interface as part of the same installation. # This allows a daemon or module to request the configuration interface even though it belongs to a different installation. # Its value must be the master key in /etc/shinken/synchronizer.cfg master_key MASTERKEY-KUMi_DY49LtZTLI3XMiabDT5f_OyErn-8oH1Ew0z7kv86y5zNjm2bJ-Wf50cfy5Hwc1BTMBhA747p0_sKwd-YAtbD2D9mmBY8ecBAvMmXIqRCaAe86GyBrQzQRaLz6_x38rjBT1ImAcwZwwE1U1tiI3qhLS4cRsRZHCP_DcKJ2XTDbYL7eoeBdc9FRUApTmP6S5xdonY6_lteiBiUgceuJQkbCy94l6Es5yTzCH3PDqj11hy86hE9yekAmkgZkJz # Maximum number of tries for loading the synchronizer configuration before reporting a failure #max_try 90 # Sleep time (in seconds) between two successive tries of loading the synchronizer configuration #sleep_time 2
| Nom | Type | Unité | Défaut | Commentaire |
|---|---|---|---|---|
url | Texte | URL | http://localhost:7765 | Adresse permettant la connexion à l'API du Synchronizer. Les démons de l'Arbiter et du Synchronizer doivent être sur le même serveur. |
master_key | Texte | --- | généré à l'installation | La masterkey est une clé d'identification générée à l'installation sur le Synchronizer, qui permet aux démons de s'identifier auprès de l'interface de configuration comme faisant partie de la même installation. Cela permet qu'un démon ou un module requête l'interface de configuration. Ce champ doit avoir la valeur présente dans le fichier /etc/shinken/synchronizer.cfg, sinon le module ne pourra pas s'identifier et importer les éléments. |
max_try | Nombre | --- | 90 | Permet de spécifier le nombre maximum de tentatives de chargement de la configuration du Synchronizer en cas d'échec. Le Synchronizer peut ne pas être prêt à fournir sa configuration, par exemple s’il n'a pas fini de démarrer. |
sleep_time | Nombre | secondes | 2 | Nombre de secondes de délai entre deux tentatives de chargement de la configuration du Synchronizer. |
sleep_time * max_try ( par défaut 90 * 2 = 180 secondes ) doit toujours être plus grand que le temps de démarrage et chargement du Synchronizer ( jusqu'à l'arrivée de l'interface ). Sinon l'Arbiter ne démarrera pas.