Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.
Comment: Make by tools (01.00.01) - action=clean_macro_parameter
Scroll Ignore
scroll-html
scroll-viewporttrue
scroll-pdftrue
scroll-officetrue
scroll-chmtrue
scroll-htmlfalse
scroll-docbooktrue
scroll-eclipsehelptrue
scroll-epubtruefalse
Panel
titleSommaire

Table of Contents
stylenone

Description

Concept

Le fichier de configuration des paramètres du Synchronizer pouvant être modifiés par les commandes Shinken, il est préférable d'ajuster les paramètres nécessaires dans le fichier suivant :    /etc/shinken-user/configuration/daemons/synchronizers/synchronizer_cfg_overload.cfg

Les paramètres définis dans ce fichier vont écraser ceux dans les fichiers de configuration du Synchronizer ( voir la page Paramètres globaux ( synchronizer.cfg )  ).

Exemple: Surcharge de la configuration de l'interface Web

Code Block
languagejs
themeConfluence
title/etc/shinken-user/configuration/daemons/synchronizers/synchronizer_cfg_overload.cfg
#**********************************************************************************
#  This file is# the─────────────────────────────────────────────────────────────────────────────────────────────────────── overload#
 of the /etc/shinken/synchronizer.cfg file
#  IMPORTANT: You MUST editThis comment is used by Shinken to recognize this file instead of the /etc/shinken/synchronizer.cfg
#, please do not edit or remove it.
    # If done so, several parts of Shinken, like sanitize, asmay the /etc/shinken file can be overwrite by an update
#
#  To set a value, just uncomment it and it will take precedence over the
#  /etc/shinken/synchronizer.cfg one
#**********************************************************************************

#==================================================================================
#======== logging =========

# The synchronizer daemon log
#local_log=/var/log/shinken/synchronizerd.log


not work properly.
    # __OVERRIDE_TYPE__ synchronizer_cfg_overload
    # ─────────────────────────────────────────────────────────────────────────────────────────────────────── #

    # ┌─────────────────────────────────────────────────────────────────────────────────────────────────────┐ #
    # │ ──────────────────────────────────    DAEMON LOGS PARAMETERS    ─────────────────────────────────── │ #
    # └─────────────────────────────────────────────────────────────────────────────────────────────────────┘ #

    # ─── The synchronizer daemon log                                                                       ───
    # ───                                                                                                # If you disable, the timestamp will be an epoch  ───
    # local_log=/var/log/shinken/synchronizerd.log

    # ─── If you disable, the timestamp will be an epoch integer instead of a human date
#human_timestamp_log=1
#==================================================================================



#==================================================================================
#======== Listening address (daemon) =========

                    ───
    #                                                                                                       ───
    #           ...     : 0 => timestamp                                                                      ───
    # If enabled, the synchronizer daemon will listen in HTTPS instead of HTTP protocol.
 ...     : 1 => human date                                              # Note: default pem/cert and key files are for sample only. You need to generate
       ───
    # ───                                           # your own with your PKI.
                                                   ───
    # by default: 0 (disabled)
#use_ssl=0
#ca_cert=/etc/shinken/certs/ca.pem
#server_cert=/etc/shinken/certs/server.cert
#server_key=/etc/shinken/certs/server.key

     human_timestamp_log=1

    # ─── Set logging level for the Synchronizer daemon.                                                  # Should the───
 synchronizer connections will force# the HTTPS certificates name checks
                                                       # If enabled and a distant certificate is not the same as the daemon address, then
                            ───
    #           ...     : accepted values: DEBUG,INFO,WARNING,ERROR,CRITICAL    # the connection will be refused.

#hard_ssl_name_check=0

                       ───
    #           Default : INFO ( info, warning and error logs will be shown )        # Which HTTP backend to start the listening daemon with.
              ───
    # ───                                    # Currently only auto is managed
#http_backend=auto

                                                       # Which address to───
 bind for the synchronizer daemon# log_level=INFO

    # ┌─────────────────────────────────────────────────────────────────────────────────────────────────────┐ #
    #  ──────────────────────────    EXTERNAL AUTHENTICATION LOGS PARAMETERS    ──────────────────────────  #
    # └─────────────────────────────────────────────────────────────────────────────────────────────────────┘ #

    # ─── Log the synchronizer authentication and Session history in a file         #    by default: 0.0.0.0 (all interfaces)
#bind_addr=0.0.0.0

#==================================================================================


#==================================================================================
#======== Listening address (Configuration interface) =========

                 ───
    #                                                                                                       ───
    #           ...     : 1 => Enable                                                                       ───
    #           Default : 0 => Disable                                                                      ───
    # ───                                                               # Http(s) port to listen the Configuration interface
#http_port=7766


                             ───
                      # synchronizer__log_users__enabled=0

    # Select─── theFile languse thatfor willlog beauthentication usedand bySession defaulthistory on the UIs
                                            ───
    # ───      # Currently managed:
                                                       # -en    (english)
                                 ───
    # synchronizer__log_users__file_path=/var/log/shinken/synchronizer/log_users.log

    # ─── Add user name to log       # -fr    (francais)
#lang=en


                                                       # set the Configuration interface into HTTPs or not (disabled by default)
#http_use_ssl=0

───
    #                                                                # Mandatory is SSL is enabled: server key and certificate
#http_ssl_cert=/etc/shinken/certs/server.cert
#http_ssl_key=/etc/shinken/certs/server.key

                              ───
    #           ...     : 1 => Enable   # Cookie secret password. Is used to crypt cookies
#auth_secret=YOUR-VALUE

                                                       # Master key for CLI access
#master_key=YOUR-VALUE


───
    #           Default : 0 => Disable                                      # Remote application authentication
                             ───
    # ───                     # if 1: allow the user to be load from a HTTP Header
#http_remote_user_enable=0

                                                       # which HTTP header to get user name if remote_user_enable is 1
#http_remote───
    # synchronizer__log_users__add_user_variable=X-Remote-Username=0

    # ─── The logs files will be daily rotated up to the number of configurated days.                       ───
    # ─── All log files older than the configured number #of if remote_user_enable is 1,
 days will be deleted automatically.             ───
    #                                     # http_remote_user_case_sensitive to 1 enable case check on remote user login
                                                                  ───
    # http_remote_user_case_sensitive to 0 disable case check on remote user login
          Default : 7 (days)                                                                  # default value : 1, login is case sensitive
#http_remote_user_case_sensitive=1

#==================================================================================


#==================================================================================
#======== INTERNAL OPTIONS =========

# On source page, some errors or warnings may concern many elements. A summary is shown
# for this error and you can set the number of message who are in this summary.
#number_of_message_in_source_summary=5


#==================================================================================




#==================================================================================
#======== Mongodb database connection =========
───
    # ───                                                                                                   ───
    # synchronizer__log_users__logs_rotation__nb_days_before_deletion=7

    # ┌─────────────────────────────────────────────────────────────────────────────────────────────────────┐ #
    # │ ────────────────────────────────────    SYSTEM AND SECURITY    ──────────────────────────────────── │ #
    # └─────────────────────────────────────────────────────────────────────────────────────────────────────┘ #

    # ──  System daemon parameters (user, group, pid, ...)  ───────────────────────────────────────────────── #

    # ─── Run or not the daemon                                                                             ───
    #                                                                                                       ───
    #           ...     : 0 => Disable                                                                      ───
    #   database   type. currently only mongodb is managed.
#data_backend=mongodb

...     : 1 => Enable                                               # mongodb uri definition for connecting to the mongodb database. You can find the mongodb uri
         ───
    #  ───                                        # syntax at https://docs.mongodb.com/manual/reference/connection-string/
#mongodb_uri=mongodb://localhost/?safe=false

                                                       # mongodb database───
 to use for this# daemon.
#mongodb_databaseenabled=synchronizer1

    # ─── Lock file (with pid) for the synchronizer daemon                                          #   If you want to secure your───
 mongodb connection you can# enable─── the ssh use_ssh_tunnel that will
                                                       # allow all mongodb to be encrypted & authenticated with SSH
                             ───
    # lock_file=/var/run/shinken/synchronizerd.pid

    # ─── User used by the synchronizer           # Should use a SSH tunnel (Default 0=False)
#mongodb_use_ssh_tunnel=0

                                                   ───
    # ───  If the SSH connection goes wrong, then retry use_ssh_retry_failure time
                                                                                 # Default: 1
#mongodb_use_ssh_retry_failure=1

       ───
    # shinken_user=shinken

    # ───                                      # SSH user/keyfile in order to connect to the mongodb server.
                                                   ───
    # Default: shinken
#mongodb_ssh_usergroup=shinken

    # ─── The path to the modules directory                                                # Default: ~shinken/.ssh/id_rsa
#mongodb_ssh_keyfile=~shinken/.ssh/id_rsa

               ───
    # ───                                   # SSH Timeout used to test if the SSH tunnel is viable or not, in seconds
                                                   ───
    # Default: 2
#mongodb_ssh_tunnel_timeout=2modules_dir=/var/lib/shinken/modules

    # ─── The path to the share files                                            # By default bailout the synchronizer if cannot contact mongodb for more than 120s
#mongodb_retry_timeout=120

              ───
    # ───                                    # The time the history will be kept for synchronizations into database (in minutes)
#sync_history_lifespan=1440

#==================================================================================

#==================================================================================
#=============== Protected fields security ====================
                                                               ───
    # share_dir=/var/lib/shinken/share

    # ─────────────  Listening address (daemon)  ──────────────────────────────────────────────────────────── #

    # ─── Which HTTP backend to start the listening daemon with.                                            ───
    # ─── Currently only auto is managed    # Encryption for protected fields
#protect_fields__activate_encryption=0

                                                       # File containing the encryption key
#protect_fields__encryption_keyfile=/etc/shinken/secrets/protected_fields_key

 ───
    # ───                                                  # List of words contained in protected fields names
                                         ───
    # http_backend=auto

    # ─── Which address to #bind Default values : PASSWORD,PASSPHRASE,PASSE,DOMAINUSER,MSSQLUSER,MYSQLUSER,ORACLE_USER,SSH_USER,LOGIN
#protect_fields__substrings_matching_fields=PASSWORD,PASSPHRASE,PASSE,DOMAINUSER,MSSQLUSER,MYSQLUSER,ORACLE_USER,SSH_USER,LOGIN
#==================================================================================

#=============== Synchronizer Authentication and Session External Log ====================
                  for the synchronizer daemon.                                                ───
    #                                                                                                       ───
    #           Default : 0.0.0.0 => (all interfaces)                                                       ───
    # ───                                                                                                   ───
    # bind_addr=0.0.0.0

    # ─── Enable HTTPS.                                                                                     ───
    #                                                                                                       ───
    #           ...     : 1 => Use HTTPS                                                                    ───
    #           Default : 0 => Use HTTP                                                                     ───
    # ───                                                                                                   ───
    # use_ssl=0

    # ─── Paths to pem/cert and key files                                                                   ───
    # ─── Note: default pem/cert and key files are for sample only. You need to generate                    ───
    # ─── your own with your PKI.                                                                           ───
    # ───                                                                                                   ───
    # ca_cert=/etc/shinken/certs/ca.pem

    # ───                                                                                                   ───
    # server_cert=/etc/shinken/certs/server.cert

    # ───                                                                                                   ───
    # server_key=/etc/shinken/certs/server.key

    # ─── Force the HTTPS certificates name checks by the synchronizer connections                          ───
    # ─── If enabled and a distant certificate is not the same as the daemon address, then                  ───
    # ─── the connection will be refused.                                                                   ───
    #                                                                                                       ───
    #           ...     : 0 => Disable                                                                      ───
    #           Default : 1 => Enable                                                                       ───
    # ───                                                                                                   ───
    # hard_ssl_name_check=0

    # ┌─────────────────────────────────────────────────────────────────────────────────────────────────────┐ #
    # │ ────────────────────────────────    MONGODB DATABASE CONNECTION    ──────────────────────────────── │ #
    # └─────────────────────────────────────────────────────────────────────────────────────────────────────┘ #

    # ─── Database type. currently only mongodb is managed.                                                 ───
    # ───                                                                                                   ───
    # data_backend=mongodb

    # ─── mongodb uri definition for connecting to the mongodb database. You can find the mongodb uri       ───
    # ─── syntax at https://docs.mongodb.com/manual/reference/connection-string/                            ───
    # ───                                                                                                   ───
    # mongodb_uri=mongodb://localhost/?safe=false

    # ─── Mongodb database to use for this daemon.                                                          ───
    # ───                                                                                                   ───
    # mongodb_database=synchronizer      

	# ─── username/password to authenticate to MongoDB.                                                     ───
    # ─── Both parameters must be provided for authentication to function correctly.                        ───
    # ───                                                                                                   ───
    # synchronizer__database__username=

    # ───                                                                                                   ───
    # synchronizer__database__password=      
	
	# ─── Secure your mongodb connection                                                                    ───
    # ─── enable the ssh that will                                                                          ───
    # ─── allow all mongodb to be encrypted & authenticated with SSH                                        ───
    #                                                                                                       ───
    #           ...     : 1 => Enable                                                                       ───
    #           Default : 0 => Disable                                                                      ───
    # ───                                                                                                   ───
    # mongodb_use_ssh_tunnel=0

    # ─── If the SSH connection goes wrong,                                                                 ───
    # ─── then retry use_ssh_retry_failure time                                                             ───
    #                                                                                                       ───
    #           ...     : 0 => Disable                                                                      ───
    #           Default : 1 => Enable                                                                       ───
    # ───                                                                                                   ───
    # mongodb_use_ssh_retry_failure=1

    # ─── SSH user/keyfile in order to connect to the mongodb server                                        ───
    # ───                                                                                                   ───
    # mongodb_ssh_user=shinken

    # ───                                                                                                   ───
    # mongodb_ssh_keyfile=~shinken/.ssh/id_rsa

    # ─── SSH Timeout used to test if the SSH tunnel is viable or not, in seconds                           ───
    #                                                                                                       ───
    #           Default : 2 (in seconds)                                                                    ───
    # ───                                                                                                   ───
    # mongodb_ssh_tunnel_timeout=2

    # ─── By default bailout the synchronizer if cannot contact mongodb for more than 120s                  ───
    #                                                                                                       ───
    #           Default : 120 (in seconds)                                                                  ───
    # ───                                                                                                   ───
    # mongodb_retry_timeout=120

    # ─── Each database request will be tried X times before considering it as an error and abort           ───
    #                                                                                                       ───
    #           Default : 15 (in seconds)                                                                   ───
    # ───                                                                                                   ───
    # synchronizer__database__retry_connection_X_times_before_considering_an_error=15

    # ─── We will wait X seconds between each try or any database request                                   ───
    #                                                                                                       ───
    #           Default : 5 (in seconds)                                                                    ───
    # ───                                                                                                   ───
    # synchronizer__database__wait_X_seconds_before_reconnect=5

    # ─── The time the history will be kept for synchronizations into database                              ───
    #                                                                                                       ───
    #           Default : 1440 (in minutes)                                                                 ───
    # ───                                                                                                   ───
    # sync_history_lifespan=1440

    # ┌─────────────────────────────────────────────────────────────────────────────────────────────────────┐ #
    # │ ───────────────────────────────────    ADDRESS AND SECURITY    ──────────────────────────────────── │ #
    # └─────────────────────────────────────────────────────────────────────────────────────────────────────┘ #

    # ────  Listening address (Configuration interface)  ──────────────────────────────────────────────────── #

    # ─── Http(s) port to listen the Configuration interface.                                               ───
    # ───                                                                                                   ───
    # http_port=7766

    # ─── set the Configuration interface into HTTPs or not (disabled by default).                          ───
    #                                                                                                       ───
    #           ...     : 1 => Use HTTPS                                                                    ───
    #           Default : 0 => Use HTTP                                                                     ───
    # ───                                                                                                   ───
    # http_use_ssl=0

    # ─── Mandatory is SSL is enabled: server key and certificate.                                          ───
    # ───                                                                                                   ───
    # http_ssl_cert=/etc/shinken/certs/server.cert

    # ───                                                                                                   ───
    # http_ssl_key=/etc/shinken/certs/server.key

    # ────────────────────  Cypher keys  ──────────────────────────────────────────────────────────────────── #

    # ─── Cookie secret password. Is used to crypt cookies.                                                 ───
    # ───                                                                                                   ───
    # auth_secret=TO_CHANGE

    # ─── Master key for CLI access.                                                                        ───
    # ───                                                                                                   ───
    # master_key=TO_CHANGE

    # ─────────────────  SSO authentication  ──────────────────────────────────────────────────────────────── #

    # ─── Remote application authentication.                                                                ───
    #                                                                                                       ───
    #           ...     : 1 => allow the user to be load from a HTTP Header                                 ───
    #           Default : 0 => Disable                                                                      ───
    # ───                                                                                                   ───
    # http_remote_user_enable=0

    # ─── From which HTTP header get user name if remote_user_enable is 1.                                  ───
    # ───                                                                                                   ───
    # http_remote_user_variable=X-Remote-User

    # ─── Case sensitivity of login if remote_user_enable is 1.                                             ───
    #                                                                                                       ───
    #           ...     : 0 => disable case check on remote user login                                      ───
    #           Default : 1 => enable case check on remote user login                                       ───
    # ───                                                                                                   ───
    # http_remote_user_case_sensitive=1

    # ┌─────────────────────────────────────────────────────────────────────────────────────────────────────┐ #
    # │ ────────────────────────────    INTERFACE CONFIGURATION PARAMETERS    ───────────────────────────── │ #
    # └─────────────────────────────────────────────────────────────────────────────────────────────────────┘ #

    # ──────────────────────  Language  ───────────────────────────────────────────────────────────────────── #

    # ─── Select the lang that will be used by default on the UIs.                                          ───
    # ───       Currently managed:                                                                          ───
    #                                                                                                       ───
    #           ...     : en => (english)                                                                   ───
    #           ...     : fr => (francais)                                                                  ───
    # ───                                                                                                   ───
    # lang=fr

    # ──────────────────────  Sources  ────────────────────────────────────────────────────────────────────── #

    # ─── On source page, some errors or warnings may concern many elements.                                ───
     # Log─── theA synchronizersummary authenticationis andshown sessionfor historythis inerror aand file
you 
can set the number                                      ───
    # ─── of message who are in this  summary. # Enable authentication and session log or not.
                                                       #───
 by default: 0 (disabled)
# /!\───  Need be change in the file: /etc/shinken-user/configuration/daemons/synchronizers/synchronizer_cfg_overload.cfg
# synchronizer__log_users__enabled=0
 
                                                       # File use for log authentication and session history
# /!\ Need be change in the file: /etc/shinken-user/configuration/daemons/synchronizers/synchronizer_cfg_overload.cfg
# synchronizer__log_users__file_path=/var/log/shinken/synchronizer/log_users.log
 
                ───
    # number_of_message_in_source_summary=5

    # ──────────────────  Production page  ────────────────────────────────────────────────────────────────── #

    # ─── Timeout for the Arbiter to load a new configuration         # Add user name to log.
                                 ───
    # ───                 # by default: 0 (disabled)
# /!\ Need be change in the file: /etc/shinken-user/configuration/daemons/synchronizers/synchronizer_cfg_overload.cfg
# synchronizer__log_users__add_user_name=0


#======== Production page =========
                                                          # Timeout for the Arbiter to load a new configuration
#synchronizer───
    # synchronizer__production__apply_new_configuration_timeout=30

#==================================================================================