| Scroll Ignore | ||||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| ||||||||||||||
|
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.
| Info |
|---|
Lorsque vous modifiez les paramètres de ce module, vous devez redémarrer l'Arbiter pour les prendre en compte. |
| Warning |
|---|
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":
| Code Block | ||
|---|---|---|
| ||
define arbiter {
[...]
modules Module 1, Module 2, Module 3, synchronizer-import
[...]
} |
Pour prendre en compte le changement de configuration, redémarrez l'Arbiter :
| Code Block |
|---|
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
| Code Block | ||
|---|---|---|
| ||
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 | ||
|---|---|---|---|---|---|---|
| Texte | --- | synchronizer-import | Paramètre permettant de le différencier d'un autre module du même type. Doit être unique. | ||
| Texte | --- | synchronizer-import | Ne peut être modifié. |
Connexion au Synchronizer
| Code Block | ||
|---|---|---|
| ||
#======== 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 | ||
|---|---|---|---|---|---|---|
| Texte | URL | http://localhost:7765 | Adresse |
Voici la liste des paramètres relatifs au chargement d'une configuration:
permettant la connexion à l'API du Synchronizer. |
Les démons de l'Arbiter |
et du Synchronizer doivent être sur le même serveur. | ||||||
| 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. | ||
|
| 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. | |||
| Nombre |
| secondes | 2 | Nombre de secondes de délai entre deux tentatives de chargement de la configuration du Synchronizer. |
| Info |
|---|
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. |