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


NomTypeUnitéDéfautCommentaire


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



NomTypeUnitéDéfautCommentaire


url


TexteURLhttp://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


Nombresecondes2

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.