Préambule : Les fichiers de configuration principaux

Ouvrez les fichiers présenté ci-dessous et prenez connaissance de leur contenu et de leur rôle.

Ce fichier contient les variables relatives aux répertoires de travail de Shinken.

On y trouve notamment:

ETC=/etc/shinken
VAR=/var/lib/shinken/
BIN=/usr/bin
RUN=/var/run/shinken
LOG=/var/log/shinken

Tous les scripts de shinken font référence à ces variables sous la forme shell $ETC par exemple. C'est la convention que nous utiliserons dans la suite de ce document.

Le fichier $ETC/shinken.cfg liste tous les fichiers de configuration qui seront chargés au démarrage. Dans ce fichier, le mot clé cfg_dir indique l'ensemble des fichiers de configuration principaux et des sous-répertoires (contenant aussi des fichiers de configuration) qui seront pris en compte au démarrage de Shinken.

# Configuration files with common objects like commands, timeperiods,
# or templates that are used by the host/service/contacts
cfg_dir=commands
cfg_dir=timeperiods
cfg_dir=escalations
cfg_dir=dependencies

# Now templates of hosts, services and contacts
cfg_dir=templates

# notification things
cfg_dir=notificationways

# Now groups
cfg_dir=servicegroups
cfg_dir=hostgroups
cfg_dir=contactgroups

# And now real hosts, services, packs and discovered hosts
# They are directory, and we will load all .cfg file into them, and 
# their sub-directory
cfg_dir=hosts
cfg_dir=services
cfg_dir=contacts
cfg_dir=packs
cfg_dir=modules

cfg_dir=arbiters
cfg_dir=schedulers
cfg_dir=pollers
cfg_dir=reactionners
cfg_dir=brokers
cfg_dir=receivers
cfg_dir=realms
# You will find global MACROS into this file
#resource_file=resource.cfg
cfg_dir=resource.d

• Pour être pris en compte, un fichier de configuration doit appartenir à un élément pointé par ce fichier.
• Une erreur dans un des fichiers de configuration provoquera un arrêt du démarrage.
• Il faut utiliser les options check pour vérifier l'ensemble des fichiers de configuration ou debug pour tracer le démarrage ou bien encore consulter en cas d’erreur le fichier /tmp/shinken_checkconfig_result ou bien les différents logs comme par exemple le log de l’arbiter $LOG/arbiterd.log.

root@ctShinken:$ETC# service shinken check
Doing config check
. ok
root@ctShinken:$ETC# service shinken -d start
…
. ok
Starting arbiter: 
. ok
root@debianWheezy:$ETC# nano /var/log/shinken/arbiterd.log