Configuration parameters
Watcher parameters determine how the watcher starts and runs. Notes:
- If a parameter can only be set during initialization, you must restart watcher service after changing the value.
- Most of these parameters are set directly on the watcher. See Configuring watcher initialization: Windows or Configuring watcher initialization: Linux.
- Some of these parameters are set on the watched services, which pass the information to the watcher.
Parameter | Description |
---|---|
watcher.AcceptablePhysicalMemoryPercentage |
Threshold for acceptable memory usage. This is the percentage of system memory used by all processes (including those not controlled by watcher). Set at initialization or runtime. The watcher calculates memory usage every 5 seconds, and throws an alarm when this value is exceeded. Default: 96 (percent) |
watcher.DaemonBroadcastAddress |
The IP address for the watcher to broadcast its presence. Use this parameter to manage a set of watcher-daemons from a watcher-daemon. Only daemons running on the same subnet are identified. Set at initialization only. Default: 255.255.255.255 |
watcher.DaemonDatagramPort |
UDP ports to monitor watched processes. Set at initialization only. To change this port, contact NuanceProfessional Services Default: 7890 |
watcher.FailureQuiesceTimeoutMs |
The time in milliseconds for watcher to wait for a reply from a watched process that is quiescing. When the timeout is reached, watcher stops the process. Set at initialization or runtime. Default: 30000 |
watcher.MaxMissedPings |
The maximum number of pings the watcher can miss before it considers any watched process to be non-responsive. The watcher either restarts the process or stops it, depending on the setting of watcher.RestartOnFailure. Set at initialization or runtime. Default: 3 |
watcher.MaxNumRestarts |
The maximum times for watcher to attempt restarting any watched process. For each watched process, the watcher resets the counter to 0 after receiving a ping from a started process. When the maximum is reached, the watcher removes that process from the restart list. Set at initialization or runtime. Default: 3 |
watcher.ModuleQuiesceTimeoutMs |
The time for the watcher to wait for a reply from its internal communications modules when one of those modules is quiescing. When the timeout is reached, the watcher unloads the module. Set at initialization only. Default: 30000 (milliseconds) |
watcher.Modules |
Defines the port for loading the SNMP module. You can remove this parameter if not using SNMP. Set at initialization only. Default: 7161 |
watcher.PingTimeoutDelayMs |
The allowed delay for the watcher to receive a ping from any watched process. The total time the watcher waits for a ping is the sum of this parameter and watcher.PingTimeoutMs. Set at initialization or runtime. Default: 1000 (milliseconds) |
watcher.PingTimeoutMs |
Time allowed for any watched process to ping the watcher. The total time that the watcher waits for a ping is the sum of this parameter value and watcher.PingTimeoutDelayMs. Set at initialization or runtime. Default: 5000 (milliseconds) |
watcher.QuiesceTimeoutMs |
Time that the watcher waits for a reply from any watched process that is quiescing. When the timeout is reached, the watcher stops that process. Troubleshooting—If the value of this parameter is too low, it can interfere with the graceful shutdown of Speech Server (see server.manager.gracefulremoval). Set at initialization or runtime. Default: 30000 (milliseconds) |
watcher.RestartOnFailure |
Whether the watcher restarts watched processes when they fail. Note: Nuance recommends FALSE. Otherwise, the watcher restarts processes that you deliberately abort. Set at initialization or runtime. If not using Management Station, set on the startup command of each watchable service. See Starting services without Management Station. Default: TRUE |
A range of TCP ports, reserved for security purposes but not used for communication. Set at initialization. To change this port, contact NuanceProfessional Services Default: 6666-6669 |
|
watcher.SendAlarmsToWatcher |
Whether the watcher should expect alarms from watched processes. Set at initialization or runtime. If not using Management Station, set on the startup command of each watchable service. See Starting services without Management Station. Default: TRUE |
watcher.ShutdownOnDaemonQuiesce |
Shuts down watched processes when the system administrator quiesces the watcher. Set at initialization or runtime. Default: TRUE |
wm.config.Port |
Watcher listening port Set at initialization. To change this port, contact NuanceProfessional Services Default: 7120 |
Communication port for watcher's SNMP module and your SNMP manager. Nuance recommends having one SNMP manager for all hosts in the Speech Suite network. Configure all watcher's on all hosts to the same port. Set at initialization only. |
|
wm.xml.UseIP |
Relevant when using the Management Station. The IP address of the primary Network Interface Card (NIC) on the host that communicates with the Management Station. On hosts with more than one NIC, you can specify the address of any NIC. For example, you can use the primary NIC for real-time traffic, and specify another NIC to communicate with the Management Station. Default: IP address of the primary NIC. |
Note: For SNMP trap parameters, see Configuring SNMP.