Page History

Scroll Ignore

scroll-viewport	true
scroll-pdf	true
scroll-office	true
scroll-chm	true
scroll-docbook	true
scroll-eclipsehelp	true
scroll-epub	true
scroll-html	false

Panel

title	Sommaire

Table of Contents

style	none

source_name

Description

Concept

Cette source permet de récupérer tous les hôtes d'une installation Shinken distante.

Certaines situations nécessitent l’existence de plusieurs Shinken Entreprise que l'on voudrait connecter ensemble :

Exemple 1: Découvrir les machines d'un sous-réseau sécurisé
- Pour utiliser le collecteur discovery ( réalisant des scans réseau via nmap ) vers ce sous-réseau sécurisé, il faudrait ouvrir les flux vers tous les équipements, ce qui créerait une faille de sécurité.
- Pour contourner cela, il est possible d'installer un Shinken dans le sous-réseau, ce dernier réalisant les scans nmap, et le connecter à un Shinken central via le synchronizer-collector-linker pour récupérer les hôtes découverts dans le sous-réseau.
Exemple 2: Donner une autonomie à un administrateur Shinken qui pourrait créer ses hôtes via un Synchronizer distant et les collecter en centrale via le synchronizer-collector-linker.

La source synchronizer-collector-linker va requêter le faire de requêtes au listener-shinken du Synchronizer distant via son listener-shinken pour y récupérer l'intégralité des hôtes, y compris ceux en nouveau/nouveaux etdifférences.

Cette page vous explique comment définir ce type de collecteur et la page Collecteur de type ( synchronizer-collector-linker ) Import depuis un autre Synchronizer vous décrit comment l'utiliser.

Activation du collecteur

Vous pouvez essayer ce type de source soit en activant le collecteur "synchronizer-collector-linker" présent par défaut ou en activant vos propres collecteurs de type synchronizer-collector-linker.

Activer le collecteur synchronizer-collector-linker livré par défaut

Par défaut, l’installation ou la mise à jour de Shinken Entreprise va mettre à disposition une définition de type synchronizer-collector-linker appelé Les collecteurs de type "synchronizer-collector-linker".

Un exemple de la configuration de ce collecteur se trouve dans le fichier : /etc/shinken-user-example/configuration/daemons/synchronizers/sources/synchronizer-collector-linker/synchronizer-collector-linker-example.cfg
Il faut copier le fichier ou créer un nouveau dans le dossier : /etc/shinken/sources
Le collecteur synchronizer-collector-linker s'active comme les autres sources, c'est-à-dire en l'ajoutant dans le fichier /etc/shinken/synchronizers/synchronizer-master.cfg ( ou le .cfg que vous utilisez pour définir les options du Synchronizer )
- Exemple :
  Code Block
  language js
  theme Confluence
  define synchronizer { [...] sources Source 1, Source 2, Source 3, synchronizer-collector-linker [...] }

Redémarrez le Synchronizer pour qu'il puisse prendre en compte cette nouvelle source

doivent être activés sur un démon Synchronizer.

L'activation du collecteur s'effectue en ajoutant le nom de ce collecteur dans le fichier de configuration du démon Synchroniser.
Pour cela, ouvrir le fichier de configuration du Synchroniser et ajouter le nom du collecteur de type "synchronizer-collector-linker" dans le paramètre sources.

Pour prendre en compte le changement de configuration, il faut redémarrer le Synchronizer :

Code Block

language	text
theme	Emacs

service shinken-synchronizer restart

Ajouter un autre collecteur de type

Activer le collecteur synchronizer-collector-linker

Vous pouvez avoir plusieurs sources du type

livré en exemple

L'exemple suivant

active la source "synchronizer-collector-linker

, pour par exemple se connecter à plusieurs serveurs Open LDAP.

Choisissez un nom pour ce nouveau collecteur.

Pour l'exemple, nous allons l'appeler "Mon-Collecteur-Synchronizer-Linker".
Remplacer dans l'exemple le mot "Mon-Collecteur-Synchronizer-Linker" par le nom que vous aurez choisi.

Pour ajouter une autre source, vous devez :

Copier le fichier de définition de la source d'exemple :

",
sur le Synchronizer,dont la configuration est dans le fichier /etc/shinken/synchronizers/synchronizer-master.cfg.

L’installation ou la mise à jour de Shinken Entreprise livre un exemple de la configuration de ce collecteur dans le fichier : /etc/shinken-user-example/configuration/daemons/synchronizers/sources/synchronizer-collector-linker/synchronizer-collector-linker-example.cfg

dans le répertoire de définition des sources Copier le fichier/etc/shinken-user-example/sources/.
( Exemple : /etc/shinkenconfiguration/daemons/synchronizers/sources/collector__synchronizer-collector-linker__Mon-Collecteur-Synchronizer-Linker.cfg )/synchronizer-collector-linker-example.cfg
Code Block
language text
theme Emacs
cp Coller avec un nouveau nom dans /etc/shinken-user-example/configuration/daemons/synchronizers/sources/synchronizer-collector-linker/sources
- exemple :/etc/shinken/sources/synchronizer-collector-linker
-example.cfg
- .cfg
Attribuer l'utilisateur shinken et lui attribuer les droits d'écritures :
- exemple : chown shinken:shinken /etc/shinken/sources/
collector__
- synchronizer-collector-linker
__Mon-Collecteur-Synchronizer-Linkercollector__
- .cfg
Ouvrer ce fichier (
- exemple : chmod u+w /etc/shinken/sources/synchronizer-collector-linker
__Mon-Collecteur-Synchronizer-Linker
- .cfg
) :
modifier la ligne Modifier le paramètresource_name pour définir le nom du module modifié à accrocher aux démons
- en remplaçant le nom par défaut "exemple : synchronizer-collector-linker" par le nom que vous avez choisi "Mon-Collecteur-Synchronizer-Linker".
  Code BlocklanguagejsthemeConfluence
```
define  source {
    [...]
    source_name         Mon-Collecteur-Synchronizer-Linker
    [...]
}
```

Ajouter le nom de la

nouvelle source au Synchronizer en modifiant le paramètre sources du fichier

source, synchronizer-collector-linker, dans le fichier du Synchronizer /etc/shinken/synchronizers/synchronizer-master.cfg ( ou le .cfg que utilisé pour définir les options du Synchronizer ).

Code Block

language	js
theme	Confluence

define synchronizer {
    [...]
    sources                   Source 1, Source 2, Source 3,

Mon

synchronizer-

Collecteur

collector-

Synchronizer-Linker

linker
    [...]
}

Redémarrez

Puis redémarrer le Synchronizer

pour qu'il puisse prendre en compte cette nouvelle source.

Code Block

language	text
theme	Emacs

service shinken-synchronizer restart

Configuration

Voici le détail du fichier de configuration de la source qui se trouve ( suivant la procédure choisie ) :

Soit dans le fichier que vous venez de créer en ajoutant le module ( par exemple /etc/shinken/sources/collector__

Il est possible d'avoir plusieurs collecteurs de type "synchronizer-collector-linker

__Mon-Collecteur-Synchronizer-Linker.cfg ).

Soit dans le fichier /etc/shinken/sources/synchronizer-collector-linker.cfg.

Exemple de fichier de configuration

". Il faut alors répéter les étapes précédents, et donner un nom différent à chaque collecteur.

Configuration

Un exemple de configuration est également disponible Vous trouverez aussi systématiquement un exemple dans /etc/shinken-user-example/configuration/daemons/synchronizers/sources/synchronizer-collector-linker/synchronizer-collector-linker-example.cfg.

Exemple de fichier de configuration

Code Block

language	js
theme	Confluence

#===============================================================================
# synchronizer-collector-linker
#===============================================================================
# Daemons that can load this source:
# - synchronizer
# This source is about loading remote synchronizers configurations
#===============================================================================

define source {


    #======== source identity =========
    # Source name. Must be unique
    source_name         synchronizer-collector-linker-example

    # Module type (to load module code). Do not edit.
    module_type         synchronizer-collector-linker-example

    # order: source order for a source imply if a source is before another source when merging data
    order               2

    # import_interval:  in minutes, what is the schedule import interval for this source.
    # 5
note: 0 =  module_type             don't schedule this source, will run only if an administrator launch it from the interface
    import_interval     synchronizer-collector-linker5

    description# enabled: is this source enabled or not
    enabled           This source is1

 about loading remote synchronizers# configurations
description: display a description enabledon the interface for this source
    description         This source is about loading remote synchronizers 1
configurations

    #======== Properties not stored ========
    # Do not remove _SE_UUID from this property unless you want hosts retrieved from remote sites to keep their _SE_UUID
    # in the main Shinken (where synchronizer-collector-linker is present)
    not_stored_properties           _SE_UUID

    #======== Synchronization keys =========
    # The list of properties to be used as sync_keys in addition to the item name and SE_UUID. Properties not managed by Shinken can be added here.
    #properties# properties_used_as_synckey       PROPERTY1, PROPERTY2
}

Détails des sections composant le fichier de configuration

Identification de la source

Code Block

language	js
theme	Confluence

    #======== source identity =========
    # Source name. Must be unique
    source_name         synchronizer-collector-linker-example

    # Module type (to load module code). Do not edit.
    module_type         synchronizer-collector-linker

Il est possible de définir plusieurs instances de

module

collecteur de type "synchronizer-collector-linker

dans votre

" dans une architecture Shinken.

Chaque instance devra collecteur doit avoir un nom uniquedifférent.

Scroll Title

anchor	parameter_cfg
title

Nom

Type

Unité

Défaut

Commentaire

No Format
source_name

Texte

---

synchronizer-collector-linker

Nous vous conseillons Il est conseillé de choisir un nom en fonction de l'utilisation du module pour que votre la configuration soit simple à maintenir.

Chaîne de caractères composée de Caractères autorisés : lettres, de chiffres et des caractères _ et - ., underscore ( _ ), et trait d'uniont ( - )

Doit être unique.
Doit commencer par une lettre.
D'une longueur maximum à 40 caractères.
Ne doit pas contenir le caractère "$".

No Format
module_type

Texte

---

synchronizer-collector-linker

Ne peut pas être modifié.

Interval d'import et ordre de la source

Code Block

language	js
theme	Confluence

define source { 
	...
    order              3
    import_interval    5
    enabled            1
    description        This source is about loading remote Synchronizers configurations
    ...
}

Scroll Title

anchor	parameter_cfg
title

Nom

Type

Unité

Défaut

Commentaire

No Format

import_interval

Entier positif

minute

0

Délai écoulé entre les imports automatiques de la source.
Si 0, l'import de la source ne sera jamais exécuté automatiquement. ( uniquement manuellement )

No Format

order

Entier positif

---

2

L'ordre de la source dans l'interface de configuration

( A un impact dans la fusion des données lors des imports de sources ).Voir

et dans le mélange des sources( voir la pageLe mélange des sources & les clés de synchronisation (sync-key

) pour plus d'information au sujet des fusions.

) ).

Info

icon	false
title	Remarque

Si

vous changez

l'ordre est changé depuis l'interface

( page d’accueil )

, le fichier .cfg sera mis à jour.

No Format
import_interval

Entier positif

minute

0

Délai écoulé entre les imports automatiques de la source.
Si 0, l'import de la source ne sera jamais exécuté automatiquement ( uniquement manuellement ).

Code Block
enabled

Booléen

---

0

Permets d'activer ou désactiver la source ( 1 pour activer, 0 pour désactiver ).

Code Block
description

Texte

---

This source is about loading remote Synchronizers configurations

Description du module qui apparaît dans l'interface du Synchronizer.

Propriétés non récupérées

Code Block

language	js
theme	Confluence

...     
    #======== Properties not stored ========
    # Properties which can be defined in the items from the source but which Shinken will not import.
    #Do not remove _SE_UUID from this property unless you want hosts retrieved from remote sites to keep their _SE_UUID
    # in the main Shinken (where synchronizer-collector-linker is present)
    not_stored_properties           _SE_UUID 

...

Scroll Title

anchor	parameter_cfg
title

Nom

Type

Unité

Défaut

Commentaire

No Format
not_stored_properties

Texte

---

_SE_UUID

Empêche la récupération de certaines propriétés des hôtes récoltés

Il est possible de définir des propriétés que la source ne devra pas récupérer. Ceci est utile si vos instances Shinken distantes utilisent des propriétés propres à leur fonctionnement.

Info
Nous vous conseillons Il est conseillé de laisser la valeur "_SE_UUID" et d'en rajouter d'autres si vous le souhaiteznécessaire. Si vous supprimez la valeur "_SE_UUID" est supprimée, vos les hôtes posséderont les mêmes "_SE_UUID" que sur le Shinken sur lesquels ils ont été récupérés.

Page tree

Versions Compared

Old Version 13

New Version 14

Key

Concept

Activation du collecteur

Activer le collecteur synchronizer-collector-linker livré par défaut

Activer le collecteur synchronizer-collector-linker

livré en exemple

Configuration

Exemple de fichier de configuration

Configuration

Exemple de fichier de configuration

Détails des sections composant le fichier de configuration

Identification de la source

Interval d'import et ordre de la source

Propriétés non récupérées