Concept

Il est possible d’ajouter le suffixe [FORCE] ( sans espace ) à une clé d’import dans Shinken afin d’imposer la valeur associée lors du mélange des sources.

Lorsqu’une clé est marquée avec [FORCE], elle est traitée de manière spécifique lors du mélange des sources ( voir la page Le mélange des sources & les clés de synchronisation (sync-key) ) :

• La valeur définie est considérée comme prioritaire par rapport à celles provenant d’autres sources.
• Si une autre source importe le même objet avec une valeur différente, celle-ci est ignorée.
• En cas de conflit entre plusieurs valeurs forcées, c’est la priorité des sources qui détermine la valeur retenue.

Dans le cas d’une clé contenant une liste ( comme la propriété "members" servant à définir les membres d'un groupe d'utilisateurs ) l’ajout de [FORCE] entraîne le remplacement complet des valeurs.

Toutes les clés ne peuvent pas être forcées.

Seules les sources permettant de définir explicitement le mapping des propriétés Shinken peuvent utiliser le suffixe [FORCE] ( voir le chapitre Sources pouvant forcer des clés d'import et les clés forçables ).

Exemple de valeur forcée dans un fichier d'import que pourrait importer un collecteur de type "cfg-file-import" :

define host {
	host_name[FORCE]    Test host
	address				192.168.1.42
	use					modele1, modele2
}

Forcer une propriété à la valeur par défaut

Pour forcer une propriété d'un objet à sa valeur par défaut, on peut utiliser la valeur "null".

Exemple de valeur forcée à null dans un fichier d'import que pourrait importer un collecteur de type cfg-file-import :

define host {
	host_name 		mon_hote
	parents[FORCE]	null
}

Exemple

Résolution de conflits entre plusieurs [FORCE]

Lorsque le suffixe [FORCE] est utilisé dans plusieurs sources, la valeur provenant de la source avec le plus petit numéro d'ordre est retenue.

Par exemple, les trois sources suivantes utilisent l'adresse comme clé de synchronisation ( voir la page Le mélange des sources & les clés de synchronisation (sync-key) ) :

Et importent chacune un hôte ayant :

• la même adresse ( clé d'import address )
• et un nom différent ( clé d'import host_name ).

Les objets sont en conflit car le mélange des sources veut les regrouper ( même clé de synchronisation ).

Sources pouvant forcer des clés d'import et les clés forçables

Tous les écouteurs permettent de forcer des clés d'import.

Seuls les types de collecteurs suivants permettent l'utilisation du [FORCE] :

• cfg-file-import
• ldap-import
  • depuis un serveur Active Directory
  • depuis un serveur OpenLDAP
• synchronizer-collector-vmware
• synchronizer-collector-excel

Les clés d'import suivantes peuvent être forcées :