Sommaire

Présentation

Le module scheduler--module-last-configuration-recorder  est par défaut accroché sur les Schedulers :

  • Il permet d'enregistrer la dernière configuration reçue de l'Arbiter :
    • Il permet un redémarrage du démon même si l'Arbiter ne peut pas joindre le démon ( ex : coupure réseau  ),
    • Cela permet aussi de rendre le redémarrage du démon plus rapide, dans le cas où l'Arbiter n'a pas changé de version de configuration.
  • Point important : sans configuration, le module sera automatiquement activé, car il étend le fonctionnement de base de Shinken.
    • Le module est alors chargé et utilise la configuration par défaut.
    • Pour modifier le comportement du module ( où est sauvegardée la configuration par exemple ), il suffira de copier le fichier cfg d'exemple et de l'adapter au besoin.

Modification du comportement par défaut du module

Prise en compte de votre modification de configuration

Ce module est automatiquement activé avec une configuration par défaut.


Pour changer le paramétrage du module, ou le désactiver, il faut :

  • Copier le fichier /etc/shinken-user-example/configuration/daemons/schedulers/modules/scheduler--module-last-configuration-recorder/scheduler--module-last-configuration-recorder.cfg
  • Coller avec un nouveau nom dans /etc/shinken/modules
    • exemple : /etc/shinken/modules/scheduler--module-last-configuration-recorder-autre.cfg
  • Attribuer l'utilisateur shinken
    • exemple : chown shinken:shinken /etc/shinken/modules/scheduler--module-last-configuration-recorder-autre.cfg
  • Modifier le paramètre module_name pour définir le nom du module modifié à accrocher aux démons
    • exemple :  scheduler-last-configuration-recorder-autre
  • Modifier les paramètres à changer.


Dans le fichier de configuration du ou des démons pour lesquels on veut modifier le paramétrage de ce module, modifier la ligne modules pour y ajouter le nom du module.

Exemple :
define scheduler {
    [...]
    modules                   Module 1, Module 2, Module 3, scheduler-last-configuration-recorder-autre
    [...]
}

Redémarrez l'Arbiter:

service-shinken-arbiter restart

Configuration

Un exemple de configuration du module se trouve par défaut dans le fichier /etc/shinken-user-example/configuration/daemons/schedulers/modules/scheduler--module-last-configuration-recorder/scheduler--module-last-configuration-recorder-example.cfg

Exemple de fichier de configuration

# CFG_FORMAT_VERSION 1 ( SHINKEN : DON'T TOUCH THIS LINE )

#================================================================================
# Last Configuration Recorder
#================================================================================
# Daemons that can load this module:
# - scheduler
# This module saves last configuration received from Arbiter to a file, allowing a faster restart of its daemon
#================================================================================

define module {

    # ┌─────────────────────────────────────────────────────────────────────────────────────────────────────┐ #
    # │ ──────────────────────────────────────    MODULE IDENTITY    ────────────────────────────────────── │ #
    # └─────────────────────────────────────────────────────────────────────────────────────────────────────┘ #

    # ─── Module name [ Must be unique ]                                                      [ MANDATORY ] ───
    # ───                                                                                                   ───
    module_name                                         scheduler--module-last-configuration-recorder-example

    # ─── Module type [ Do not edit ]                                                         [ MANDATORY ] ───
    # ───                                                                                                   ───
    module_type                                         scheduler__module_last_configuration_recorder

    # ┌─────────────────────────────────────────────────────────────────────────────────────────────────────┐ #
    # │ ──────────────────────────────────    RETENTION FILE STORAGE    ─────────────────────────────────── │ #
    # └─────────────────────────────────────────────────────────────────────────────────────────────────────┘ #

    # ─── Configuration retention file storage directory                                                    ───
    #                                                                                                       ───
    #           Default : /var/lib/shinken/persistent_data/last_configuration_recorder/daemons              ───
    # ───                                                                                                   ───
    # scheduler__module_last_configuration_recorder__directory /var/lib/shinken/persistent_data/last_configuration_recorder/daemons

    # ┌─────────────────────────────────────────────────────────────────────────────────────────────────────┐ #
    # │ ─────────────────────────────────────    MODULE ACTIVATION    ───────────────────────────────────── │ #
    # └─────────────────────────────────────────────────────────────────────────────────────────────────────┘ #

    # ─── Activate or disable this module                                                                   ───
    #                                                                                                       ───
    #           Default : Enable  => 1                                                                      ───
    #           ...     : Disable => 0                                                                      ───
    # ───                                                                                                   ───
    # scheduler__module_last_configuration_recorder__enable 1

}

Détails des sections composant le fichier de configuration

Identification du module
NomTypeUnitéDéfautCommentaire
module_name
Text------

Il est possible de définir plusieurs instances de module de type "last_configuration_recorder" dans une architecture Shinken.

Chaque instance devra avoir un nom unique.




Dossier d'enregistrement de la configuration
NomTypeUnitéDéfautCommentaire
scheduler__module_last_configuration_recorder__directory
Texte--- /var/lib/shinken/persistent_data/last_configuration_recorder/daemons

Dossier ou seront stockées les données de configuration reçues de l'Arbiter.

Chaque démon écrira ses informations dans un sous dossier scheduler/ID_DU_DÉMON






Désactivation du module
NomTypeUnitéDéfautCommentaire
scheduler__module_last_configuration_recorder__enable
Booléen--- 1

Ce module étant actif par défaut, pour le désactiver, passer la valeur de ce paramètre à 0 

Les valeurs possibles sont 

  • ( désactivé )
  • 1 ( activé )