Init.cfg parameters

The init.cfg file is used by Network Monitor for settings that are needed before the database with the configuration is loaded. It controls which port Network Monitor starts the web server on and in which mode Network Monitor starts in (Standard, Distributed server or Distributed gateway). The init.cfg file is located in the KNM root directory.

Log

  • LOG_LEVEL = 0 - Log level, if set to other then zero Network Monitor writes debug information into the text log. Valid log level is 0, 1 and 2. If log level is set to 2 (default 1) Network Monitor starts logging detailed information to the <Kaseya_Installation_Directory>\Logs\Services\KaseyaNetworkMonitor.log file. Can be useful when debugging mail and SMS sending behavior for example. Can be changed while Network Monitor is running.

SSH2

  • SSH2_TIMEOUT=25000- SSH2 client timeout time in milliseconds. Defaults to 25000 (25 seconds). Can be changed while Network Monitor is running.
  • SSH2_TRACELEVEL=0- Tracelevel can be used to debug the ssh2 connection. Defaults to 0. A valid range is 0 to 4 (max output). Can be changed while Network Monitor is running.

Testing thread pool configuration

  • TP_INIT_SIZE - The initial size of the thread. Defaults to 20.
  • TP_MAX_AGE - The max age in seconds a thread can be unused before being deleted from the pool. Defaults to 3600 (one hour). The purpose of this parameter is to have the thread pool balance the size to a optimal size for your configuration.
  • TP_MAX_SIZE - Max size that the thread pool can grow to. Defaults to 125.

Other

  • OBJECT_IP_CACHE=1 - Network Monitor resolves all asset host names into IP addresses. This feature can be turned off if there is problems with the local DNS. Defaults to 1 (enabled). Optionally 0 (disabled). Can be changed while Network Monitor is running.
  • DELAY_TEST_START=0 - This parameter can be used to delay the start of monitor tests when Network Monitor is starting up. Defaults to 0 seconds. Useful for reducing machine boot time stress by delaying the start of Network Monitor monitor tests. Can not be changed while Network Monitor is running.
  • OPERATOR_SESSION_TIMEOUT=20 - Sets the user session timeout value, in minutes. If no timeout is wanted, set value to -1. Can be changed while Network Monitor is running.
  • SNMP_TIMEOUT=10000 - To set the timeout used by all SNMP functions (monitors, actions etc), in milliseconds. Defaults to 10 seconds. Can be changed while Network Monitor is running.
  • ENABLE_CRASHFILE=true - If enabled and Network Monitor hangs in a deadlocked state, Network Monitor produces a crash dump file called crash.now in the KNM root directory. This file is used by Network Monitor developers to analyze why the deadlock occurred. Can be changed while Network Monitor is running.
  • DISTTEST_UPDATE_INTERVAL=60 - Time between events that cause the gateway and server to exchange information. Can be set in both gateway and server init.cfg files to separate values. The default 60 seconds is recommended.
  • DISABLE_RTS - If this variable is present and set to 1 in the init.cfg file at startup, no real-time statistics are loaded for monitors. This can greatly speed up the startup time of Network Monitor.
  • NO_TESTING - If this variable is present and set to 1 in the init.cfg file at startup, no testing is performed until a user enables the testing again.
  • HOSTNAME_OVERRIDE=myhost.domain.local - When sending notifications to users a link to the monitor/asset is included in the notification e-mail. The link starts with the host name of the Network Monitor host machine. This parameter can be used to override that name. Can be changed while Network Monitor is running.
  • DISTTEST_MODE=server - This parameter tells Network Monitor to start the distributed subsystem in either “server” or “gateway” mode. This parameter is dependent on the DISTTEST_ENABLE parameter. Can be changed while Network Monitor is running.
  • DISTTEST_ENABLE=1 - This parameter tells Network Monitor to start the distributed subsystem. This parameter is dependent on the DISTTEST_MODE parameter. The parameter can be set to 1 to enable or 0 to disable. Can be changed while Network Monitor is running.