Running the WatchDog Utility

You run WatchDog from the command line with the following parameters.

Note: These commands are generated into a file named CommandLine in the installation directory.

Field or Control

Definition

no parameters

WatchDog performs the series of tests once.

-loops [number]

Specifies the number of times the tests are to be run.

If number is 0, WatchDog loops indefinitely.

If number is n, WatchDog loops n times.

-debug

Includes debugging messages in the generated log files.

If this option is not specified on the command line, WatchDog looks for a value in the WDG.config file. If no value exists in the configuration file, the default value is used. The default is NO.

To see debug information on the screen, you have to set service=NO and debug=YES.

-help

Lists the command-line options for WatchDog.

-ping

Turns on PING feature. Before launching the tests, the specified machines are pinged. At least one machine must respond for the tests to be run.

If no machines respond to the ping, an error report is sent and WatchDog continues to ping the machines. After a specified number of tries (pingMax), WatchDog sends an email and continues to ping the machines that did not answer at the end of the sleep interval.

When all the machines have answered, another email report is sent, indicating the change in status.

If this option is not specified on the command line, WatchDog looks for a value in the WDG.config file. If no value exists in the configuration file, the default value is used. The default is YES.

-qklook

When this parameter is specified, the WatchDog client attempts to obtain the current status of WatchDog by connecting through the specified qklook port.

Note: If you want to view the qklook test results in a command line window instead of reading output from log files, you can run WatchDog with the following command:

<WatchDogInstallDirectory>java com.peoplesoft.crm.omk.WatchDog.Main -qklook -cp<path to watchdog classfiles>

-service

Specifies to run WatchDog as a service.

If this option is not specified on the command line, WatchDog looks for a value in the WDG.config file. If no value exists in the WDG.config file, the default value is used. The default is YES.

-sleep [time]

Specifies the time in minutes between tests. If time is 0 or not specified, this value is taken from the Interval parameter in the WDG.config file. The default is 30 minutes.