Versions Compared

Old Version 6

changes.mady.by.user clément Roussy

Saved on

compared with

New Version Current

changes.mady.by.user clément Roussy

Saved on

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.


Scroll Ignore
scroll-pdftrue
scroll-officetrue
scroll-chmtrue
scroll-docbooktrue
scroll-eclipsehelptrue
scroll-epubtrue
scroll-htmltrue


Panel
titleSommaire

Table of Contents
stylenone



Description

Introduction

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.

Configuration du module


Info

Lorsque vous modifiez les paramètres de ce module, vous devez redémarrer l'Arbiter pour les prendre en compte.

Dans /etc/shinken/modules/synchronizer-import.cfg :



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
languagejs
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
languagejs
define module{
Code Block
define module{

# Shinken Enterprise. Lines added by import core. Do not remove it, it's used by Shinken Enterprise to update your objects if you re-import them.
    _SE_UUID             core-module-452425c65adc11e5bea8080027f08538
    _SE_UUID_HASH        930e49ec2248db5e798e3c28de4e886f
# End of Shinken Enterprise part

    #======== 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


Code Block
module_name


Texte---synchronizer-import

Paramètre permettant de le différencier d'un autre module du même type.

Doit être unique.


Code Block
module_type


Texte---synchronizer-import

Ne peut être modifié.


Connexion au Synchronizer


Code Block
languagejs
#======== 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


Code Block
url


TexteURLhttp://localhost:7765​

Adresse

Voici la liste des paramètres relatifs au chargement d'une configuration:

Nom du paramètreDescriptionValeur par défaut?uriURL

permettant la connexion à l'API du

Synchronizer?. Pour un meilleur fonctionnement, le Synchronizer et

Synchronizer​. Les démons de l'Arbiter et du Synchronizer doivent

se trouver

être sur le même serveur

http://localhost:7765?max_tryCe paramètre permet

.


Code Block
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.


Code Block
max_try


Nombre---90

Permet de spécifier le nombre maximum de tentatives de chargement de la configuration

a réaliser, lorsque le module essaie de télécharger la configuration du Synchronizer, ce dernier

du Synchronizer en cas d'échec.

Le Synchronizer peut ne pas être prêt

(

à fournir sa configuration, par exemple

: il

s’il n'a pas

terminé son processus de démarrage)90

fini de démarrer.


Code Block
sleep_time


Nombre
de seconde
secondes2

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.