Utiliser la source pré-configurée cfg-file-nagios
Attention, encore une fois, pour une mise en production sur le long terme, il est préférable que vous utilisiez votre propre source, passez alors sur le chapitre suivant.
Pour un essai d'import de fichier cfg, l'installation ou la mise à jour de Shinken va mettre en place la source cfg-file-nagios déjà configurée :
- cfg-file-nagios. Vous pouvez la voir dans la page des sources.
Cette source utilise 2 types de configuration de fichiers
- Les fichiers de définition de la source et de ses modules : /etc/shinken/sources/cfg-file-nagios.cfg
- Les fichiers de configuration pour l'import de vos éléments via vos fichiers cfg : /etc/shinken-user/source-data/source-data-cfg-nagios/definition-source-data-cfg-nagios.cfg
- Ce fichier est pré-configuré pour pointer vers votre dossier de configuration nagios. Il vous suffit de saisir le chemin correspondant pour importer facilement et rapidement votre configuration nagios.
- Ce fichier est pré-configuré pour pointer vers votre dossier de configuration nagios. Il vous suffit de saisir le chemin correspondant pour importer facilement et rapidement votre configuration nagios.
Il vous suffira alors d'activer la source pour importer vos éléments définis dans le fichier nagios.cfg.
Le fait d'avoir plusieurs sources distinctes peut vous aider si vous avez un grand nombre de fichiers cfg et que vous souhaitez pouvoir choisir et séparer les imports. Par exemple, vous avez des fichiers cfg relatifs à l'organisation de Paris, et d'autres à l'organisation de Bordeaux (Hôtes, Utilisateurs, ..).
A un instant donné, vous pouvez avoir de besoin d'importer les fichiers de Bordeaux uniquement. Ce sera chose possible avec les deux sources distinctes.
Ce chapitre va vous permettre de configurer votre propre source depuis la source exemple : cfg-file-sample
| Tip |
|---|
A chaque fois que vous avez besoin de personnaliser Shinken, le répertoire à utiliser est /etc/shinken-user/ |
Création d'une source
Placez vous à présent dans le répertoire des sources Shinken (dans /etc/shinken/sources/) et copiez la source Nagios Sample existante (qui a le format d'une source standard sur laquelle vous pouvez vous baser pour créer une source personnalisée) :
| Code Block | ||
|---|---|---|
| ||
cd /etc/shinken/sources/ cp cfg-file-nagiossample.cfg cfg-file-ma-source.cfg |
 | Modifiez le fichier cfg-file-ma-source.cfg Supprimez les 4 lignes allant de # Shinken Enterprise à # End of Shinken Enterprise part |
Modifiez
| Code Block |
|---|
source_name cfg-file-nagiossample cfg_path /etc/nagios/nagios/shinken-user/source-data/source-data-cfg-sample/definition-source-data-cfg-sample.cfg |
avec
| Code Block |
|---|
source_name cfg-file-ma-source
cfg_path /etc/shinken-user/source-data/source-data-cfg-ma-source/definition-source-data-cfg-ma-source.cfg |
(ce chemin sera celui du répertoire de vos fichiers cfg dans le shinken-user)
En ce qui concerne les paramètres des sources, voici leurs descriptions :
| Propriété | Exemple | Description | |||||
|---|---|---|---|---|---|---|---|
| source_name | cfg-file-ma-source | Nom de la source affichée dans l'UI de configuration en page d'accueil. Doit être unique et d'une longueur inférieure à 40 caractères, sans quoi le Synchronizer ne démarrera pas. | |||||
| order | 2 | L'ordre de la source sur la page, qui a un impact dans la fusion des données lors des imports de sources. Voir la page du Synchronizer pour plus d'information au sujet des fusions. Cette propriété est éditée directement si vous changez l'ordre depuis l'interface. | |||||
| import_interval | 0 | La source sera exécutée automatiquement toutes les import_interval minutes.
| |||||
| module-type | cfg-file-import | Définition du type de module utilisé par la source. | |||||
| enabled | 1 | Activer ou désactiver la source. Cette propriété est éditée directement si vous utiliser le bouton Activer de l'interface. | |||||
| description | Cette source permet de charger mes fichiers cfg relatifs aux nouvelles commandes | Description de la source |
Pour créer son propre répertoire dans le répertoire des sources de shinken-user :
| Code Block | ||
|---|---|---|
| ||
cd /etc/shinken-user/source-data cp -r source-data-cfg-sample/ source-data-cfg-ma-source/ mv source-data-cfg-ma-source/definition-source-data-cfg-sample.cfg source-data-cfg-ma-source/definition-source-data-cfg-ma-source.cfg |
Rajouter les droits sur le répertoire :
| Code Block |
|---|
cd /etc/shinken-user/source-data
chown -R shinken:shinken source-data-cfg-ma-source/ |
| Tip | ||
|---|---|---|
| ||
Une fois le répertoire créé, les fichiers cfg pourront alors être placés directement dans le répertoire source-data-cfg-ma-source/elements ou source-data-cfg-ma-source/packs |
| Modifiez le fichier /etc/shinken/synchronizers/synchronizer-master.cfg A la fin de la ligne "sources", rajoutez votre source. |
Exemple :
| Code Block |
|---|
sources syncui,cfg-file-shinken,active-dir-example,sync-vmware,cfg-file-nagios,discovery,openldap-example,cfg-file-ma-source |
Redémarrez le synchronizer pour qu'il prenne acte de la nouvelle source :
| Code Block | ||
|---|---|---|
| ||
service shinken-synchronizer restart |
Une fois le démon redémarré, votre nouvelle source personnalisée doit apparaître :
Son paramétrage sera alors en place : son état (activée ou désactivée), son ordre, sa fréquence en automatique ou en manuel.
Depuis la page d'accueil de l'interface de configuration, vous pouvez alors utiliser le bouton "Force import" en cliquant sur le bouton 
Dans le panel des éléments, vos nouveaux éléments doivent apparaître. Vous pourrez alors les importer dans votre base.
Précisions techniques
Clés de synchronisation
Les clés de synchronisation sont des propriétés des objets utilisées pour les identifier dans les sources. Le fonctionnement et l'utilité des clés de synchronisation sont décrits de manière plus détaillée dans la page de documentation dédiée: Précision techniques sur le fonctionnement de l'import des sources.
Les propriétés suivantes sont ajoutées en tant que clés de synchronisation dans les objets Shinken:
- host_name
- address
- SE_UUID