Agents Administration - Tests
 

Configuration of CBWorkQueueTest

The job queue contains Connection Broker processes that are independent of the Web interface. If you think your Connection Broker is not functioning correctly, you can use the job queue as a diagnostics tool. For instance, if you requested an action and it has not taken place, check if the action is pending in the job queue. The CBWorkQueueTest monitors the job queues and reports the status of jobs queued on the Connection Broker.The default parameters associated with this test are:

  • The TEST PERIOD list box helps the user to decide how often this test needs to be executed.

  • In the HOST text box, the host name of the server for which the test is to be configured has to be specified.
  • In the PORT text box, specify the port number at which the host listens.
  • By default, SSL flag is set to No, indicating that by default, the test connects to the Connection Broker via HTTP. If the Connection Broker is SSL-enabled, then set this flag to Yes.

  • To enable the test to log into the Connection Broker and extract statistics of interest from it, specify the login name of a user in the USER textbox on the Connection Broker who is assigned the Administrator role. If need be, you can even create a special Administrator user on the Connection Broker for this purpose, and pass the credentials of that user to the test.

  • Specify the password of the USER in the PASSWORD textbox.

  • Confirm the PASSWORD by retyping it in the CONFIRM PASSWORD .

  • This test also reports the number of jobs in the queue that were recently completed. The detailed diagnosis of this measure, if enabled, will provide the details of all the newly finished jobs. In some environments, the count of the newly finished jobs could run to a thousand. In such environments naturally, the detailed diagnosis data for this measure, if available, will consume a considerable amount of database space, and can sometimes even choke the database. To reduce the strain on the database, the eG agent, by default, does not collect detailed diagnosis information for the New finished jobs measure. Accordingly, the SHOWFINISHEDDDflag is set to No, by default. If you want to view the detailed diagnosis for this measure, then set this flag to Yes.

  • In the TIMEOUT text box specify the duration (in seconds) within which the SNMP query executed by this test should time out. The default is 30 seconds.

  • If multiple components of the same component type are awaiting configuration, then an APPLY TO OTHER COMPONENTS check box will appear in this page. Clicking on this check box will allow you to apply the configuration to all/selected components of that type.

  • Once the necessary values have been provided, clicking on the Update button will register the changes made.

When changing the configuration for specific servers, a “*” beside the text box corresponding to the parameter signifies that these values have to be manually configured by the user. The parameter values that require to be configured will typically be prefixed with a “$” or contain a series of “*”. A value of "none" in the parameter value indicates that the corresponding parameter value can be changed if required.