Page History

#===============================================================================
# ARBITER
#===============================================================================
# Description: The Arbiter is responsible for:
# - Loading, manipulating and dispatching the configuration
# - Validating the health of all other Shinken daemons

#==========================================================================================
# IMPORTANT: If you use a spare arbiter you MUST set the host_name on each
# servers to its real DNS name ('hostname' command).
#===============================================
# IMPORTANT: If you use a spare arbiter you MUST set the host_name on each
# servers to its real DNS name ('hostname' command).
#===============================================================================

define arbiter {

    #======== Daemon name and address =========
    # Daemon name. Must be unique
    arbiter_name      arbiter-master

    # Hostname used by the Arbiter daemon to distinguish master and slave Arbiters (when having multiple Arbiters).
    # If not defined, the Arbiter daemon will use its server name, but it can be used with only one Arbiter in the
    # Shinken architecture.
    #host_name        HOSTNAME

    # IP/fqdn of this daemon
    address           localhost   ; DNS name or IP

    # Port (HTTP/HTTPS) exposed by this daemon
    port              7770

    # 0 = use HTTP, 1 = use HTTPS
    use_ssl	          0


    #======== Daemon connection timeout and down state limit =========================

define arbiter 

    #======== Daemon name and address =========
    # Daemon name. Must be unique
    arbiter_name      arbiter-master

    # Parameters used by Arbiter-master and Arbiter-spare to put respectively the other demon as not available.
 
    #---------------
    # timeout: value specific to each arbiter. When trying to PING this Arbiter, any daemon / healtcheck / shinken checks will consider it as unreachable after this timeout
    # All cases:
    # Hostname used by the- Arbiter daemonmaster towait distinguishthe masterarbiter andspare slavefor Arbitersthis (when having multiple Arbiters).timeout duration
    # If not defined, the Arbiter daemon- shinken-healtcheck/shinken check will use itsit serverto name,wait butfor it canthe bearbiter usedmaster withor onlyspare
 one Arbiter in the
#   ( #default Shinken3 architecture.)
    #host_name# NOTE: this parameter is NOT used by HOSTNAME

the arbiter spare to #wait IP/fqdn of this daemonfor master's death before
    address#        take over the localhostconfiguration. For this, ;look DNS name or IP
at max_check_attempts & check_interval
    # Port (HTTP/HTTPS) exposed by this daemon
timeout         port     3
 
    #---------------
    7770

    # 0 = use HTTP, 1 = use HTTPS
    use_ssl	# data_timeout: how many second to consider a configuration transfert to be failed to the arbiter spare
    #   - to be 0


defined on   #======== Daemon connection timeout and down state limit =========the Arbiter-spare
    #   - Used by the Arbiter-master
    # Parameters used by Arbiter-master and Arbiter-spare to put respectively the other demon as not available.
   ( default 120 )
    data_timeout         120
 
    #---------------
    # timeout: value specific to each arbiter. When trying to PING this Arbiter, any daemon / tools will consider it as unreachable after this timeout
    # Exemplemax_check_attempts: how many fail check to consider this daemon as DEAD
    #   Defined on the Arbiter-spare 
	#     -> Used by the Arbiter-master to declare the spare as DEAD ( so after a wait of X max_check_attempts * check_interval seconds )
    #
   - Arbiter# master wait theor arbiter spare
 for this timeout duration#
    #   Defined on the Arbiter- shinken-healtcheck will use it to wait for the arbiter master or spare
    #	( default 3 )
    timeout           master
	#     -> Used by the Arbiter-spare to take over the role of arbiter-master ( so after a wait of X max_check_attempts * check_interval seconds )
    #
    max_check_attempts   3

    #---------------
    # datacheck_timeout: how many secondinterval: check every X seconds or use to considerknow ahow configurationmany transfertseconds to bewait failed tofor the arbiter sparemaster
    #   - to be definedDefined on the Arbiter-spare 
	#     -> Used by the Arbiter-master
 to declare the #	(spare defaultas 120DEAD )
( so after a data_timeoutwait of X max_check_attempts      120

    #---------------* check_interval seconds )
    # max_check_attempts: how many fail check to consider this daemon as DEAD
    #   or 
    #
    #   Defined on the Arbiter-spare master
	#     -> Used by the Arbiter-masterspare to take declareover the sparerole asof DEADarbiter-master ( so after a wait of X retrymax_check_attempts * check_interval seconds )
    #
    #check_interval   or 
    #60


    #======== Master or Definedspare on the Arbiter-master
	#selection =========
    # ->1 Used= byis thea Arbiter-spare to take over the role of arbiter-master ( so after a wait of X retry * check_interval seconds )
spare, 0 = is not a spare
    spare      #
    max_check_attempts   30


    #---------------
    # Check======== Modules to enable for this daemon every X seconds
    check_interval=========
    # Available:
    # - synchronizer-import  60


    #======== Master or spare selection =========: [mandatory] will allow to get configuration from the synchronizer
    # 1 = is a spare, 0 = is not a spare
    spare    - architecture-export : will open a socket that listens for Shinken architecture descriptions to generate corresponding hosts and NagVis maps
    modules    	      0synchronizer-import


    #======== Modules toEnable enableor fornot this daemon =========
    # Available:
 1 = is enabled, 0 = is disabled
    enabled      # - synchronizer-import : [mandatory] will allow to get configuration from the synchronizer1 


    #======== Enable or not this daemon =========
    # -1 architecture-export= :is willenabled, open0 a= socketis thatdisabled
 listens for Shinken architecture# descriptionsenabled: to generateif correspondingthe hostsversion andbetween NagVisthe maps
arbiter and daemons  modulesmismatch, daemons refuse the 	arbiter configuration and an error  synchronizer-import


is reported
    #======== Enable or not this daemon =========
    # 1 = is enabled, 0 = is disabled
    enabled       disabled: if the version between the arbiter and daemons mismatch, daemons accept the arbiter configuration and a warning is reported.
    mismatch_version_error 1
}