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, DAService, 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.

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.

See cpwd_admin config.

del <options>

Temporarily deletes a monitored process from the WatchDog database of monitored processes.

See cpwd_admin del.

detach <options>

Temporarily detaches a monitored process from the WatchDog monitoring.

See cpwd_admin detach.

exist

Checks whether the WatchDog process cpwd is alive.

See cpwd_admin exist.

flist <options>

Saves the status of all monitored processes to a $CPDIR/tmp/cpwd_list_<Epoch Timestamp>.lst file.

See cpwd_admin flist.

getpid <options>

Shows the PID of a monitored process.

See cpwd_admin getpid.

kill <options>

Terminates the WatchDog process cpwd.

See cpwd_admin kill.

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.

See cpwd_admin list.

monitor_list

Prints the status of actively monitored processes on the screen.

See cpwd_admin monitor_list.

start <options>

Starts a process as monitored by the WatchDog.

See cpwd_admin start.

start_monitor

Starts the active WatchDog monitoring - WatchDog monitors the predefined processes actively.

See cpwd_admin start_monitor.

stop <options>

Stops a monitored process.

See cpwd_admin stop.

stop_monitor

Stops the active WatchDog monitoring - WatchDog monitors all processes only passively.

See cpwd_admin stop_monitor.