You can manually configure the maintenance utility by editing the configuration file for the utility.
To configure the maintenance utility, you edit the file
/usr/local/ctccap/etc/runtime.conf, and add lines that assign values to variables.
Lines that contain a pound sign ("#") at the beginning of the line are comments and are ignored by the maintenance utility.
A variable assignment must be a single line in the following format:
The following list documents the configuration variables, their default values (if unspecified in
runtime.conf), and their meanings.
Several are Boolean values that must either be
Capture health check
If the capture statistics
Packets dropped in output is above this value, capture
is unhealthy. This value is high when capture cannot reassemble hits as fast as they are captured
off the network interfaces.
Enables capture health checks. This check is enabled by default to monitor the health of the capture processes.
If the hit reassembly process uses more than 90% of the CPU, capture is unhealthy.
If the hit reassembly process uses more than the specified number of kilobytes (1,024,000 kilobytes is approximately 1 gigabyte), capture is unhealthy.
The number of minutes between health checks.
Forces capture to restart at a specific time each day or weekly, on a specified day of the week.
This check is disabled by default because the utility does not know a safe or low traffic volume
time to force a restart. To enable it, assign it a value of
YES and set the capture
restart time in the following property.
Restart capture at the specified local time (by using a 24-hour clock). If you want to restart capture at 11:30 PM, use value "23:40". Do not include the leading zero if the hours is less than 10. For example, to specify 6:30 AM, use value "6:30".
capture_restart_weekday_local (no default)
Restart capture on the specified day of the week at the time that is specified by variable
capture_restart_time_local. The value must be one of the following (all
Restart capture on the specified day of the week at the time that is specified by variable capture_restart_time_local. If you specify this value, then the forced restart occurs on the specified day at the specified time. If you do not set this variable (the default), forced restarts occurs every day at the time specified.
Enables verbose logging of settings and execution. This option exists to help diagnose the
behavior of the maintenance utility. It results in lots of output in the
maintenance.log file and must be used only when needed.
Log file cleanup
Enables log file cleanup.
- Keep log files for the specified number of days. Log files older than the specified number of days is deleted.
- The log files that are monitored by the maintenance utility contain a date in the file name in
the format <Year><Month><Day>, such as
20050601for June 1, 2005.
- The utility uses the date that is extracted from the file name, not the date, and time of the file that is maintained by the operating system.
- Keep log files smaller than the specified number of kilobytes. The default value keeps log files
smaller than approximately
- Files larger than this size are deleted. The goal of this setting is to prevent large files from accumulating on the Passive Capture host machine.
The number of minutes between checks for cleaning up log files.
Enables statistics logging. When enabled, the maintenance utility creates CSV files in directory
/usr/local/ctccap/logs with the name
YYYYMMDD is the current year, month, and day, such as
The number of minutes between statistics logging.
- Enables time synchronization with a Experience Analytics CX server that is running the Transport Service.
- The configuration values for the host and port of the Transport Service in file
/usr/local/ctccap/etc/ctc-conf.xmland are normally assigned through the Delivery tab on the web console.
- When the configuration values for the host and port are specified, the maintenance utility enables this feature by default. Otherwise, the maintenance utility disables time synchronization.
The number of minutes between time synchronizations.