Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.
Scroll Ignore
scroll-viewporttrue
scroll-pdftrue
scroll-officetrue
scroll-chmtrue
scroll-docbooktrue
scroll-eclipsehelptrue
scroll-epubtrue
scroll-htmlfalse
Panel
titleSommaire

Table of Contents

Présentation

Le module receiver--module-last-configuration-recorder  est par défaut accroché sur les Receivers :

Il permet d'enregistrer la dernière configuration reçue de l'Arbiter, et de permettre un redémarrage plus rapide des démons, quand l'Arbiter met du temps à les contacter pour leur délivrer la configuration.

Activation

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/receivers/modules/receiver--module-last-configuration-recorder/receiver--module-last-configuration-recorder.cfg
  • Coller avec un nouveau nom dans /etc/shinken/modules
    • exemple: /etc/shinken/modules/receiver--module-last-configuration-recorder-autre.cfg
  • Attribuer l'utilisateur shinken
    • exemple: chown shinken:shinken /etc/shinken/modules/receiver--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:  receiver-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

Code Block
languagejs
themeConfluence
titleExemple :
define receiver {
    [...]
    modules                   Module 1, Module 2, Module 3, receiver-last-configuration-recorder-autre
    [...]
}

Redémarrez l'Arbiter:

Code Block
languagetext
themeEmacs
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/receivers/modules/receiver--module-last-configuration-recorder/receiver--module-last-configuration-recorder-example.cfg

Exemple de fichier de configuration

Code Block
languagejs
themeConfluence
# CFG_FORMAT_VERSION 1 ( SHINKEN : DON'T TOUCH THIS LINE )

#================================================================================
# Last Configuration Recorder
#================================================================================
# Daemons that can load this module:
# - receiver
# 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                                         receiver--module-last-configuration-recorder-example

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

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

    # ─── Configuration retention file storage directory                                                    ───
    #                                                                                                       ───
    #           Default : /var/lib/shinken/persistent_data/last_configuration_recorder/daemons              ───
    # ───                                                                                                   ───
    # receiver__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                                                                      ───
    # ───                                                                                                   ───
    # receiver__module_last_configuration_recorder__enable 1

}

Détails des sections composant le fichier de configuration

Identification du module
NomTypeUnitéDéfautCommentaire
No Format
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
No Format
receiver__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 receiver/ID_DU_DÉMON






Désactivation du module
NomTypeUnitéDéfautCommentaire
No Format
receiver__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é )