Db2 Service Test

This test monitors the availability and response time of each database on the target DB2 UDB server.

Target of the test : A DB2 database server

Agent deploying the test : An external/remote agent; if you are running this test using the external agent on the eG manager box, then make sure that this external agent is able to communicate with the port on which the target DB2 server is listening. Alternatively, you can deploy the external agent that will be running this test on a host that can access the port on which the target DB2 server is listening. In case of the agentless approach, the remote agent used to monitor the DB2 DPF server should be deployed on a remote Windows host in the environment.

Outputs of the test : One set of results for each database instance on the target DB2 database server being monitored

Configurable parameters for the test
  1. TEST PERIOD – How often should the test be executed
  2. Host – The IP address of the DB2 server
  3. Port – The port number through which the DB2 server communicates. The default port is 50000.
  4. user - Specify the name of the user who has any of the following privileges to the specified DATABASE: SYSADM or SYSCTRL or SYSMAINT or SYSMON. You can create a separate user on the OS hosting the DB2 server for this purpose, and assign any of the aforesaid privileges to that user. The steps for the same are detailed in the Creating a Special User for Monitoring DB2.
  5. password - Enter the password of the specified USER in the PASSWORD text box.
  6. confirm password – Confirm the password by retyping it here.
  7. database - Specify the name of the database on the monitored DB2 server to be used by this test
  8. query - The test emulates a user executing a query on the specified DATABASE, and thus determines the availability and responsiveness of the database server. In the QUERY text box, specify the select query to execute.
  9. ADDITIONAL DATABASES - By default, this parameter is set to none. This implies that the test will report the availability and responsiveness of the database specified against the DATABASE parameter. If you wish to monitor the availability and responsiveness of other databases in the target DB2 server, then, you can specify those databases as a comma-separated list against this parameter. This will ensure that the availability and responsiveness of the specified databases will be reported by this test apart from the database specified against the DATABASE parameter. The databases specified will be the descriptors of this test in this case.
  10. DD FREQUENCY - Refers to the frequency with which detailed diagnosis measures are to be generated for this test. The default is 1:1. This indicates that, detailed measures will be generated every time this test runs, and also every time the test detects a problem. You can modify this frequency, if you desire. Also, if you intend to disable the detailed diagnosis capability for this test, you can do so by specifying none against DD frequency.
  11. SSL- If the target database server is SSL-enabled, then set the SSL flag to Yes. If not, then set the SSL flag to No.
  12. Trust Store file name- The trust store file contains certificates from trusted Certificate Authorities (CAs). These certificates are used by eG agent to verify the authenticity of servers hosting DB2 UDB and establish a secure connection with the server using SSL. Specify the filename for Trust store file in Trust Store file name text box.
  13. Trust Store Password- The trust store password is the passphrase or key used to encrypt and decrypt the trust store file. This password is required by the eG Agent when it needs to access the trust store file to establish secure connections. Specify the password in Trust Store password text box.
  14. Confirm Password- Confirm the Password by retyping it in the Confirm Password text box.

  15. DETAILED DIAGNOSIS - To make diagnosis more efficient and accurate, the eG Enterprise embeds an optional detailed diagnostic capability. With this capability, the eG agents can be configured to run detailed, more elaborate tests as and when specific problems are detected. To enable the detailed diagnosis capability of this test for a particular server, choose the On option. To disable the capability, click on the Off option.The option to selectively enable/disable the detailed diagnosis capability will be available only if the following conditions are fulfilled:

  • The eG manager license should allow the detailed diagnosis capability

  • Both the normal and abnormal frequencies configured for the detailed diagnosis measures should not be 0.
Measurements made by the test:
Measurement Description Measurement Unit Interpretation

Availability

Indicates the availability of this database.

Percent

The availability is 100% when the database is responding to a request and 0% when it is not. Availability problems may be caused by a misconfiguration/malfunctioning of the database server, or if the database has not been started.

Response Time

Indicates the time taken by this database to respond to a user query.

Secs

A sudden increase in response time is indicative of a bottleneck at the database server.