Checking the configuration of the monitoring system

You can use the DSAppWatcher.sh script to check the configuration of the monitoring system.

About this task

On Unix and Linux, run DSAppWatcher.sh from the /InformationServer/Server/DSODB/bin directory.

On Windows, use MKS to run DSAppWatcher.sh from the \InformationServer\Server\DSODB\bin directory.

Procedure

Issue this command to check the configuration of the monitoring system.

DSAppWatcher.sh -test

The command shows whether each type of monitoring is enabled, and then checks if the configuration settings can be used to connect to the operations database.

For example, if configuration settings can connect to the operations database:

DSODB is ON in the DSODBConfig.cfg file.
   Link Monitoring is ON.
   Job Run Usage is ON.
   Resource Monitoring is ON.
Checking Database Connection:
   Successfully loaded the database driver.
   Successfully connected to the database.
   DB Schema version number: 1
Test Successful.

For example, if the username or password settings for the operations database are incorrectly specified:

DSODB is ON in the DSODBConfig.cfg file.
   Link Monitoring is ON.
   Job Run Usage is ON.
   Resource Monitoring is ON.
Checking Database Connection:
   Successfully loaded the database driver.
Test Failed: Invalid username or password in the DSODBConnect.cfg file.

The command returns one of these codes:

0 - everything OK
>0 – a test failed. Some failures that have specific codes:
- 1 – Unexpected error
- 2 – DSODB is off
- 3 – JDBC driver failure
- 4 – Connection failure
- 5 – Database logon failure
- 6 – DBTYPE setting in DSODBConnect.cfg invalid
- 8 – DBSchema mismatch
- 9 - Database tables incorrectly set up