Page History

Scroll Ignore

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

Panel

title	Sommaire

Table of Contents

style	none

Description

Ce module source vous permet de détecter automatiquement des équipements réseau et des serveurs physiques dans votre infrastructure pour faciliter et accélérer leur import dans la configuration.

Cette source utilise la commande nmap pour la découverte des équipements, pour cela la commande :

Scanne les machines présentes sur le réseau et détecte les ports ouverts
Essaye de déterminer le constructeur de l'équipement en fonction de son adresse MAC
Si possible, détermine son FQDN ( Fully Qualified Domain Name ).

La source Discovery permet de définir des règles qui, suivant les valeurs remontées par la commande nmap, apportent un complément d'information sur les équipements découverts. Ce complément d'information peut être :

Des modèles d'hôtes suivant le type d'équipement.
L'ajout d'un préfixe au nom de l'équipement.

Activation du module

Vous pouvez avoir plusieurs sources de type ldap-import pour, par exemple se connecter à plusieurs serveurs Active Directory.

Par défaut, l’installation de Shinken Entreprise va mettre à disposition cette source sous le nom "discovery".

Le fichier est disponible sous /etc/shinken/sources/discovery.cfg

Pour avoir cette source disponible

Le nom "discovery" doit être présent dans le paramètre sources du fichier /etc/shinken/synchronizers/synchronizer-master.cfg.

Exemple:

Code Block

language	bash

define synchronizer { 
	...
    sources                   Source 1, Source 2, Source 3, discovery
     ...
}

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

Code Block
service shinken-synchronizer restart

Configuration

Fichier de configuration

Code Block

language	bash
title	/etc/shinken/sources/discovery.cfg

#===============================================================================
# discovery
#===============================================================================
# Daemons that can load this source:
# - synchronizer
# Mandatory source, do not edit.
#===============================================================================


define source {

    source_name                   discovery
    order                         10000000
    import_interval               5
    module_type                   discovery-import
    data_backend                  mongodb
    mongodb_uri                   mongodb://localhost/?safe=false
    mongodb_database              synchronizer
    mongodb_use_ssh_tunnel        0
    mongodb_use_ssh_retry_failure 1
    mongodb_ssh_user              shinken
    mongodb_ssh_keyfile           ~shinken/.ssh/id_rsa
    mongodb_retry_timeout         10
    rules_path                    /etc/shinken-user/configuration/daemons/synchronizers/sources/discovery/discovery_rules.json
    nmap_mac_prefixes_path        /etc/shinken-user/configuration/daemons/synchronizers/sources/discovery/nmap/nmap-mac-prefixes
}

Détails des sections composant le fichier de configuration

Identification du module

Nom

Type

Unités

Défaut

Commentaire

Code Block
source_name

Texte

---

discovery

Valeur obligatoire et non modifiable

Code Block
module_type

Texte

---

discovery-import

Valeur obligatoire et non modifiable ( permet au Synchronizer de charger le code logiciel correspondant ).

Fonctionnement de la source

Code Block

language	bash

define source { 
	...
    order              3100000
    import_interval    5
    enabled            0
    description        This source is about loading hosts from active directories
    ...
}

Nom

Type

Unités

Défaut

Commentaire

Code Block
order

Entier

---

3

L'ordre de la source dans l'interface de configuration ( A un impact dans la fusion des données lors des imports de sources ).

Un nombre
Voir la page du Synchronizer pour plus d'information au sujet des fusions.

Remarque : Si vous changez l'ordre depuis l'interface ( page d’accueil ), le fichier .cfg sera mis à jour.

Code Block
import_interval

Entier

minutes

5

Délai écoulé entre les imports automatiques de la source.

Un nombre ( en minutes )
Si 0, la source ne sera jamais exécutée automatiquement.

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---Description du module qui apparaît dans l'interface du Synchronizer

.

Options du module

Code Block

language	bash
title	/etc/shinken/sources/discovery.cfg

define source {
    
	...
    data_backend                  mongodb
    modemongodb_uri                   mongodb://localhost/?safe=false
    mongodb_database              synchronizer
    mongodb_use_ssh_tunnel        0
   ad
    connection_configuration_file mongodb_use_ssh_retry_failure 1
    mongodb_ssh_user              /etc/shinken-user/source-data/source-data-active-directory-sample/_configuration/active-directory-connection.jsonshinken
    mongodb_ssh_keyfile           ~shinken/.ssh/id_rsa
    mongodb_retry_timeout         10
    rules_configuration_filepath                    /etc/shinken-user/source-data/source-data-active-directory-sample/_configuration/active-directory-/configuration/daemons/synchronizers/sources/discovery/discovery_rules.json
    mappingnmap_mac_configurationprefixes_filepath        /etc/shinken-user/source-data/source-data-active-directory-sample/_configuration/active-directory-mapping.json/configuration/daemons/synchronizers/sources/discovery/nmap/nmap-mac-prefixes
}
    ...
}

Nom

Type

Unités

Défaut

Commentaire

Code Block

mode

data_backend

Texte

---

ad

Deux modes possibles :

ad : Ce mode permet de communiquer avec ad.
Lorsque ce mode est activé, cela modifie les chemins par défaut de ces paramètres :
- connection_configuration_file
- rules_configuration_file
- mapping_configuration_file
openldap : Ce mode permet de communiquer avec un openldap.
Lorsque ce mode est activé, cela modifie les chemins par défaut de ces paramètres :
- connection_configuration_file
- rules_configuration_file
- mapping_configuration_file

mongodb

Base de données où les informations de la source vont être stockées

Code Block
mongodb_uri

url

---

mongodb://localhost/?safe=false

URL d'accès à MongoDB

Code Block
mongodb_database

Texte

---

synchronizer

Base Mongo où sont stockées les données de la source

Code Block
mongodb_use_ssh_tunnel

0 ou 1

---

0

Défini si la connexion à la base de données est directe ou doit être encapsulée dans un tunnel SSH

Code Block
mongodb_use_ssh_retry_failure

Entier positif

---

1

Défini le nombre d'essais à réaliser si la connexion à la base de données est perdue

Code Block
mongodb_ssh_user

Texte

---

shinken

L'utilisateur qui sera utilisé si la connexion à la base de données est encapsulée dans un tunnel SSH

Code Block
mongodb_ssh_keyfile

Texte

---

~shinken/.ssh/id_rsa

La clé SSH qui sera utilisée si la connexion à la base de données est encapsulée dans un tunnel SSH

Code Block
mongodb_retry_timeout

Entier positif

---

10

Temps de connexion maximum avant que la connexion ne soit considérée comme trop longue et cause un échec de connexion

Code Block
rules_path

Path

---

/etc/shinken-user/configuration/daemons/synchronizers/sources/discovery/discovery_rules.jso

Fichier .json comportant vos règles de découvertes ( voir règles de découvertes )

Code Block
nmap_mac_prefixes_path

Path

---

/etc/shinken-user/configuration/daemons/synchronizers/sources/discovery/nmap/nmap-mac-prefixes

Fichier comportant vos propres nmap-mac-prefixes ( voir mécanisme de correspondance entre adresse MAC et constructeur )

Code Block
connection_configuration_file

Path---

Fichier de configuration de connexion:

Pour le mode ad : /etc/shinken/_default/sources/active-directory-source/active-directory-connection.json
Pour le mode openldap : /etc/shinken/_default/sources/openldap-source/openldap-connection.json

Code Block
rules_configuration_file

Path---

Fichier de configuration des règles d'import:

Pour le mode ad : /etc/shinken/_default/sources/active-directory-source/active-directory-rules.json
Pour le mode openldap : /etc/shinken/_default/sources/openldap-source/openldap-rules.json

Code Block
mapping_configuration_file

Path---

Fichier de configuration du mapping des fields personnalisés:

Pour le mode ad : /etc/shinken/_default/sources/active-directory-source/active-directory-mapping.json

Pour le mode openldap : /etc/shinken/_default/sources/openldap-source/openldap-mapping.json

Pour connaitre le contenu des fichiers .json voir: HIDDEN - V02.08.02 - Voir la configuration du module ( ldap-import : mode ad ) ou HIDDEN - Collecteur OpenLDAP 02.08.02

Page tree

Versions Compared

Old Version 2

New Version 3

Key

Description

Activation du module

Configuration

Fichier de configuration

Détails des sections composant le fichier de configuration

Identification du module

Fonctionnement de la source

Options du module