cpwd_admin

Description

The Check Point WatchDog (cpwd) is a process that invokes and monitors critical processes such as Check Point daemons on the local computer, and attempts to restart them if they fail. Among the processes monitored by Watchdog are fwm, fwd, cpd, cpm, DAService, java_solr, log_indexer, and others. The list of monitored processes depends on the installed and configured Check Point products and Software Blades.

The Check Point WatchDog writes monitoring information to the $CPDIR/log/cpwd.elg log file.

The cpwd_admin utility shows the status of the monitored processes, and configures the Check Point WatchDog.

There are two types of Check Point WatchDog monitoring

Monitoring	Description
Passive	WatchDog restarts the process only when the process terminates abnormally. In the output of the `cpwd_admin list` command, the `MON` column shows `N` for passively monitored processes.
Active	WatchDog checks the process status every predefined interval. WatchDog makes sure the process is alive, as well as properly functioning (not stuck on deadlocks, frozen, and so on). In the output of the `cpwd_admin list` command, the `MON` column shows `Y` for actively monitored processes. The list of actively monitored processes is predefined by Check Point. Users cannot change or configure it.

Monitoring

Description

Passive

WatchDog restarts the process only when the process terminates abnormally.

In the output of the cpwd_admin list command, the MON column shows N for passively monitored processes.

Active

WatchDog checks the process status every predefined interval.

WatchDog makes sure the process is alive, as well as properly functioning (not stuck on deadlocks, frozen, and so on).

In the output of the cpwd_admin list command, the MON column shows Y for actively monitored processes.

The list of actively monitored processes is predefined by Check Point. Users cannot change or configure it.

Syntax

cpwd_admin

config <options>

del <options>

detach <options>

exist

flist <options>

getpid <options>

kill

list <options>

monitor_list

start <options>

start_monitor

stop <options>

stop_monitor

Parameters

Parameter	Description
`config` <options>	Configures the Check Point WatchDog.
`del` <options>	Temporarily deletes a monitored process from the WatchDog database of monitored processes.
`detach` <options>	Temporarily detaches a monitored process from the WatchDog monitoring.
`exist`	Checks whether the WatchDog process `cpwd` is alive.
`flist` <options>	Saves the status of all monitored processes to a `$CPDIR/tmp/cpwd_list_<Epoch Timestamp>.lst` file.
`getpid` <options>	Shows the PID of a monitored process.
`kill` <options>	Terminates the WatchDog process `cpwd`. Important - Do not run this command unless explicitly instructed by Check Point Support or R&D to do so.
`list`	Prints the status of all monitored processes on the screen.
`monitor_list`	Prints the status of actively monitored processes on the screen.
`start` <options>	Starts a process as monitored by the WatchDog. See sk97638.
`start_monitor`	Starts the active WatchDog monitoring - WatchDog monitors the predefined processes actively.
`stop` <options>	Stops a monitored process. See sk97638.
`stop_monitor`	Stops the active WatchDog monitoring - WatchDog monitors all processes only passively.