CheckMKServer
A server that listens for incoming check_mk connection and processes incoming requests.

CheckMKServer — CheckMKServer

A server that listens for incoming check_mk connection and processes incoming requests.

Commands (executable): TODO: Add command list

Configuration (Overview):

A list of all configuration options

Path / Section Key Default value Description
/settings/check_mk/server use ssl 0 ENABLE SSL ENCRYPTION
/settings/check_mk/server port 6556 PORT NUMBER
/settings/check_mk/server/scripts     REMOTE TARGET DEFINITIONS
/settings/default cache allowed hosts 1 CACHE ALLOWED HOSTS
/settings/default bind to   BIND TO ADDRESS
/settings/default allowed hosts 127.0.0.1 ALLOWED HOSTS
/settings/default inbox inbox INBOX
/settings/default timeout 30 TIMEOUT
/settings/default password   PASSWORD

Advanced keys:

Path / Section Key Default value Description
/settings/check_mk/server cache allowed hosts 1 CACHE ALLOWED HOSTS
/settings/check_mk/server certificate key ${certificate-path}/certificate_key.pem SSL CERTIFICATE
/settings/check_mk/server certificate format PEM CERTIFICATE FORMAT
/settings/check_mk/server certificate ${certificate-path}/nrpe_dh_512.pem DH KEY
/settings/check_mk/server verify mode none VERIFY MODE
/settings/check_mk/server ca ${certificate-path}/ca.pem CA
/settings/check_mk/server bind to   BIND TO ADDRESS
/settings/check_mk/server allowed hosts 127.0.0.1 ALLOWED HOSTS
/settings/check_mk/server thread pool 10 THREAD POOL
/settings/check_mk/server allowed ciphers ALL:!ADH:!LOW:!EXP:!MD5:@STRENGTH ALLOWED CIPHERS
/settings/check_mk/server timeout 30 TIMEOUT
/settings/check_mk/server socket queue size 0 LISTEN QUEUE
/settings/default socket queue size 0 LISTEN QUEUE
/settings/default encoding   NRPE PAYLOAD ENCODING
/settings/default thread pool 10 THREAD POOL
/settings/default modern commands 1 Register modern aliases for built-in commands

Configuration

A quick reference for all avalible configuration options in the CheckMKServer module.

... / settings / default

/settings/default (CheckMKServer)
Key Default Value Description
allowed hosts 127.0.0.1 ALLOWED HOSTS
bind to   BIND TO ADDRESS
cache allowed hosts 1 CACHE ALLOWED HOSTS
inbox inbox INBOX
password   PASSWORD
timeout 30 TIMEOUT
encoding   NRPE PAYLOAD ENCODING
modern commands 1 Register modern aliases for built-in commands
socket queue size 0 LISTEN QUEUE
thread pool 10 THREAD POOL

Sample:

#
#
[/settings/default]
# CACHE ALLOWED HOSTS
# If host names (DNS entries) should be cached, improves speed and security somewhat but won't allow you to have dynamic IPs for your Nagios server.
cache allowed hosts=1
# LISTEN QUEUE
# Number of sockets to queue before starting to refuse new incoming connections. This can be used to tweak the amount of simultaneous sockets that the server accepts.
socket queue size=0
# NRPE PAYLOAD ENCODING
#
encoding=
# BIND TO ADDRESS
# Allows you to bind server to a specific local address. This has to be a dotted ip address not a host name. Leaving this blank will bind to all available IP addresses.
bind to=
# ALLOWED HOSTS
# A comaseparated list of allowed hosts. You can use netmasks (/ syntax) or * to create ranges.
allowed hosts=127.0.0.1
# THREAD POOL
#
thread pool=10
# INBOX
# The default channel to post incoming messages on
inbox=inbox
# TIMEOUT
# Timeout when reading packets on incoming sockets. If the data has not arrived within this time we will bail out.
timeout=30
# PASSWORD
# Password to use
password=
# Register modern aliases for built-in commands
# Register modern alias for commands (ccheck_xxx as opposed of CheckXXX) these are the names which will be used in future version of NSClient++
modern commands=1
cache allowed hosts (CheckMKServer, /settings/default)

CACHE ALLOWED HOSTS

If host names (DNS entries) should be cached, improves speed and security somewhat but won’t allow you to have dynamic IPs for your Nagios server.

Path: /settings/default

Key: cache allowed hosts

Default value: 1

Used by: CheckMKServer, CheckSystem, NRPEServer, NSCAServer, NSClientServer, NSCPServer

Sample:

# CACHE ALLOWED HOSTS
# If host names (DNS entries) should be cached, improves speed and security somewhat but won't allow you to have dynamic IPs for your Nagios server.
[/settings/default]
cache allowed hosts=1
socket queue size (CheckMKServer, /settings/default)

LISTEN QUEUE

Number of sockets to queue before starting to refuse new incoming connections. This can be used to tweak the amount of simultaneous sockets that the server accepts.

Advanced (means it is not commonly used)

Path: /settings/default

Key: socket queue size

Default value: 0

Used by: CheckMKServer, CheckSystem, NRPEServer, NSCAServer, NSClientServer, NSCPServer

Sample:

# LISTEN QUEUE
# Number of sockets to queue before starting to refuse new incoming connections. This can be used to tweak the amount of simultaneous sockets that the server accepts.
[/settings/default]
socket queue size=0
encoding (CheckMKServer, /settings/default)

NRPE PAYLOAD ENCODING


Advanced (means it is not commonly used)

Path: /settings/default

Key: encoding

Default value:

Used by: CheckMKServer, CheckSystem, NRPEServer, NSCAServer, NSClientServer, NSCPServer

Sample:

# NRPE PAYLOAD ENCODING
#
[/settings/default]
encoding=
bind to (CheckMKServer, /settings/default)

BIND TO ADDRESS

Allows you to bind server to a specific local address. This has to be a dotted ip address not a host name. Leaving this blank will bind to all available IP addresses.

Path: /settings/default

Key: bind to

Default value:

Used by: CheckMKServer, CheckSystem, NRPEServer, NSCAServer, NSClientServer, NSCPServer

Sample:

# BIND TO ADDRESS
# Allows you to bind server to a specific local address. This has to be a dotted ip address not a host name. Leaving this blank will bind to all available IP addresses.
[/settings/default]
bind to=
allowed hosts (CheckMKServer, /settings/default)

ALLOWED HOSTS

A comaseparated list of allowed hosts. You can use netmasks (/ syntax) or * to create ranges.

Path: /settings/default

Key: allowed hosts

Default value: 127.0.0.1

Used by: CheckMKServer, CheckSystem, NRPEServer, NSCAServer, NSClientServer, NSCPServer

Sample:

# ALLOWED HOSTS
# A comaseparated list of allowed hosts. You can use netmasks (/ syntax) or * to create ranges.
[/settings/default]
allowed hosts=127.0.0.1
thread pool (CheckMKServer, /settings/default)

THREAD POOL


Advanced (means it is not commonly used)

Path: /settings/default

Key: thread pool

Default value: 10

Used by: CheckMKServer, CheckSystem, NRPEServer, NSCAServer, NSClientServer, NSCPServer

Sample:

# THREAD POOL
#
[/settings/default]
thread pool=10
inbox (CheckMKServer, /settings/default)

INBOX

The default channel to post incoming messages on

Path: /settings/default

Key: inbox

Default value: inbox

Used by: CheckMKServer, CheckSystem, NRPEServer, NSCAServer, NSClientServer, NSCPServer

Sample:

# INBOX
# The default channel to post incoming messages on
[/settings/default]
inbox=inbox
timeout (CheckMKServer, /settings/default)

TIMEOUT

Timeout when reading packets on incoming sockets. If the data has not arrived within this time we will bail out.

Path: /settings/default

Key: timeout

Default value: 30

Used by: CheckMKServer, CheckSystem, NRPEServer, NSCAServer, NSClientServer, NSCPServer

Sample:

# TIMEOUT
# Timeout when reading packets on incoming sockets. If the data has not arrived within this time we will bail out.
[/settings/default]
timeout=30
password (CheckMKServer, /settings/default)

PASSWORD

Password to use

Path: /settings/default

Key: password

Default value:

Used by: CheckMKServer, CheckSystem, NRPEServer, NSCAServer, NSClientServer, NSCPServer

Sample:

# PASSWORD
# Password to use
[/settings/default]
password=
modern commands (CheckMKServer, /settings/default)

Register modern aliases for built-in commands

Register modern alias for commands (ccheck_xxx as opposed of CheckXXX) these are the names which will be used in future version of NSClient++

Advanced (means it is not commonly used)

Path: /settings/default

Key: modern commands

Default value: 1

Used by: CheckMKServer, CheckSystem, NRPEServer, NSCAServer, NSClientServer, NSCPServer

Sample:

# Register modern aliases for built-in commands
# Register modern alias for commands (ccheck_xxx as opposed of CheckXXX) these are the names which will be used in future version of NSClient++
[/settings/default]
modern commands=1

... / settings / check_mk / server

/settings/check_mk/server (CheckMKServer)
Key Default Value Description
port 6556 PORT NUMBER
use ssl 0 ENABLE SSL ENCRYPTION
allowed ciphers ALL:!ADH:!LOW:!EXP:!MD5:@STRENGTH ALLOWED CIPHERS
allowed hosts 127.0.0.1 ALLOWED HOSTS
bind to   BIND TO ADDRESS
ca ${certificate-path}/ca.pem CA
cache allowed hosts 1 CACHE ALLOWED HOSTS
certificate ${certificate-path}/nrpe_dh_512.pem DH KEY
certificate format PEM CERTIFICATE FORMAT
certificate key ${certificate-path}/certificate_key.pem SSL CERTIFICATE
socket queue size 0 LISTEN QUEUE
thread pool 10 THREAD POOL
timeout 30 TIMEOUT
verify mode none VERIFY MODE

Sample:

# CHECK MK SERVER SECTION
# Section for check_mk (CheckMKServer.dll) protocol options.
[/settings/check_mk/server]
# CACHE ALLOWED HOSTS
# If host names (DNS entries) should be cached, improves speed and security somewhat but won't allow you to have dynamic IPs for your Nagios server. parent for this key is found under: /settings/default this is marked as advanced in favor of the parent.
cache allowed hosts=1
# SSL CERTIFICATE
#
certificate key=${certificate-path}/certificate_key.pem
# CERTIFICATE FORMAT
#
certificate format=PEM
# DH KEY
#
certificate=${certificate-path}/nrpe_dh_512.pem
# VERIFY MODE
#
verify mode=none
# CA
#
ca=${certificate-path}/ca.pem
# BIND TO ADDRESS
# Allows you to bind server to a specific local address. This has to be a dotted ip address not a host name. Leaving this blank will bind to all available IP addresses. parent for this key is found under: /settings/default this is marked as advanced in favor of the parent.
bind to=
# ALLOWED HOSTS
# A comaseparated list of allowed hosts. You can use netmasks (/ syntax) or * to create ranges. parent for this key is found under: /settings/default this is marked as advanced in favor of the parent.
allowed hosts=127.0.0.1
# THREAD POOL
#  parent for this key is found under: /settings/default this is marked as advanced in favor of the parent.
thread pool=10
# ALLOWED CIPHERS
#
allowed ciphers=ALL:!ADH:!LOW:!EXP:!MD5:@STRENGTH
# TIMEOUT
# Timeout when reading packets on incoming sockets. If the data has not arrived within this time we will bail out. parent for this key is found under: /settings/default this is marked as advanced in favor of the parent.
timeout=30
# LISTEN QUEUE
# Number of sockets to queue before starting to refuse new incoming connections. This can be used to tweak the amount of simultaneous sockets that the server accepts. parent for this key is found under: /settings/default this is marked as advanced in favor of the parent.
socket queue size=0
# ENABLE SSL ENCRYPTION
# This option controls if SSL should be enabled.
use ssl=0
# PORT NUMBER
# Port to use for check_mk.
port=6556
cache allowed hosts (CheckMKServer, /settings/check_mk/server)

CACHE ALLOWED HOSTS

If host names (DNS entries) should be cached, improves speed and security somewhat but won’t allow you to have dynamic IPs for your Nagios server. parent for this key is found under: /settings/default this is marked as advanced in favor of the parent.

Advanced (means it is not commonly used)

Path: /settings/check_mk/server

Key: cache allowed hosts

Default value: 1

Used by: CheckMKServer

Sample:

# CACHE ALLOWED HOSTS
# If host names (DNS entries) should be cached, improves speed and security somewhat but won't allow you to have dynamic IPs for your Nagios server. parent for this key is found under: /settings/default this is marked as advanced in favor of the parent.
[/settings/check_mk/server]
cache allowed hosts=1
certificate key (CheckMKServer, /settings/check_mk/server)

SSL CERTIFICATE


Advanced (means it is not commonly used)

Path: /settings/check_mk/server

Key: certificate key

Default value: ${certificate-path}/certificate_key.pem

Used by: CheckMKServer

Sample:

# SSL CERTIFICATE
#
[/settings/check_mk/server]
certificate key=${certificate-path}/certificate_key.pem
certificate format (CheckMKServer, /settings/check_mk/server)

CERTIFICATE FORMAT


Advanced (means it is not commonly used)

Path: /settings/check_mk/server

Key: certificate format

Default value: PEM

Used by: CheckMKServer

Sample:

# CERTIFICATE FORMAT
#
[/settings/check_mk/server]
certificate format=PEM
certificate (CheckMKServer, /settings/check_mk/server)

DH KEY


Advanced (means it is not commonly used)

Path: /settings/check_mk/server

Key: certificate

Default value: ${certificate-path}/nrpe_dh_512.pem

Used by: CheckMKServer

Sample:

# DH KEY
#
[/settings/check_mk/server]
certificate=${certificate-path}/nrpe_dh_512.pem
verify mode (CheckMKServer, /settings/check_mk/server)

VERIFY MODE


Advanced (means it is not commonly used)

Path: /settings/check_mk/server

Key: verify mode

Default value: none

Used by: CheckMKServer

Sample:

# VERIFY MODE
#
[/settings/check_mk/server]
verify mode=none
ca (CheckMKServer, /settings/check_mk/server)

CA


Advanced (means it is not commonly used)

Path: /settings/check_mk/server

Key: ca

Default value: ${certificate-path}/ca.pem

Used by: CheckMKServer

Sample:

# CA
#
[/settings/check_mk/server]
ca=${certificate-path}/ca.pem
bind to (CheckMKServer, /settings/check_mk/server)

BIND TO ADDRESS

Allows you to bind server to a specific local address. This has to be a dotted ip address not a host name. Leaving this blank will bind to all available IP addresses. parent for this key is found under: /settings/default this is marked as advanced in favor of the parent.

Advanced (means it is not commonly used)

Path: /settings/check_mk/server

Key: bind to

Default value:

Used by: CheckMKServer

Sample:

# BIND TO ADDRESS
# Allows you to bind server to a specific local address. This has to be a dotted ip address not a host name. Leaving this blank will bind to all available IP addresses. parent for this key is found under: /settings/default this is marked as advanced in favor of the parent.
[/settings/check_mk/server]
bind to=
allowed hosts (CheckMKServer, /settings/check_mk/server)

ALLOWED HOSTS

A comaseparated list of allowed hosts. You can use netmasks (/ syntax) or * to create ranges. parent for this key is found under: /settings/default this is marked as advanced in favor of the parent.

Advanced (means it is not commonly used)

Path: /settings/check_mk/server

Key: allowed hosts

Default value: 127.0.0.1

Used by: CheckMKServer

Sample:

# ALLOWED HOSTS
# A comaseparated list of allowed hosts. You can use netmasks (/ syntax) or * to create ranges. parent for this key is found under: /settings/default this is marked as advanced in favor of the parent.
[/settings/check_mk/server]
allowed hosts=127.0.0.1
thread pool (CheckMKServer, /settings/check_mk/server)

THREAD POOL

parent for this key is found under: /settings/default this is marked as advanced in favor of the parent.

Advanced (means it is not commonly used)

Path: /settings/check_mk/server

Key: thread pool

Default value: 10

Used by: CheckMKServer

Sample:

# THREAD POOL
#  parent for this key is found under: /settings/default this is marked as advanced in favor of the parent.
[/settings/check_mk/server]
thread pool=10
allowed ciphers (CheckMKServer, /settings/check_mk/server)

ALLOWED CIPHERS


Advanced (means it is not commonly used)

Path: /settings/check_mk/server

Key: allowed ciphers

Default value: ALL:!ADH:!LOW:!EXP:!MD5:@STRENGTH

Used by: CheckMKServer

Sample:

# ALLOWED CIPHERS
#
[/settings/check_mk/server]
allowed ciphers=ALL:!ADH:!LOW:!EXP:!MD5:@STRENGTH
timeout (CheckMKServer, /settings/check_mk/server)

TIMEOUT

Timeout when reading packets on incoming sockets. If the data has not arrived within this time we will bail out. parent for this key is found under: /settings/default this is marked as advanced in favor of the parent.

Advanced (means it is not commonly used)

Path: /settings/check_mk/server

Key: timeout

Default value: 30

Used by: CheckMKServer

Sample:

# TIMEOUT
# Timeout when reading packets on incoming sockets. If the data has not arrived within this time we will bail out. parent for this key is found under: /settings/default this is marked as advanced in favor of the parent.
[/settings/check_mk/server]
timeout=30
socket queue size (CheckMKServer, /settings/check_mk/server)

LISTEN QUEUE

Number of sockets to queue before starting to refuse new incoming connections. This can be used to tweak the amount of simultaneous sockets that the server accepts. parent for this key is found under: /settings/default this is marked as advanced in favor of the parent.

Advanced (means it is not commonly used)

Path: /settings/check_mk/server

Key: socket queue size

Default value: 0

Used by: CheckMKServer

Sample:

# LISTEN QUEUE
# Number of sockets to queue before starting to refuse new incoming connections. This can be used to tweak the amount of simultaneous sockets that the server accepts. parent for this key is found under: /settings/default this is marked as advanced in favor of the parent.
[/settings/check_mk/server]
socket queue size=0
use ssl (CheckMKServer, /settings/check_mk/server)

ENABLE SSL ENCRYPTION

This option controls if SSL should be enabled.

Path: /settings/check_mk/server

Key: use ssl

Default value: 0

Used by: CheckMKServer

Sample:

# ENABLE SSL ENCRYPTION
# This option controls if SSL should be enabled.
[/settings/check_mk/server]
use ssl=0
port (CheckMKServer, /settings/check_mk/server)

PORT NUMBER

Port to use for check_mk.

Path: /settings/check_mk/server

Key: port

Default value: 6556

Used by: CheckMKServer

Sample:

# PORT NUMBER
# Port to use for check_mk.
[/settings/check_mk/server]
port=6556

... / settings / check_mk / server / scripts

/settings/check_mk/server/scripts (CheckMKServer)

Sample:

# REMOTE TARGET DEFINITIONS
#
[/settings/check_mk/server/scripts]
comments powered by Disqus