Agents Administration - Tests
 

Configuration of SqlResponseTest

The SqlResponseTest monitors the status and response time of a SQL query. The default parameters associated with this test are as follows:

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

  • The HOST text box, indicates the variable name of the host for which the test is to be configured.

  • The PORT number through which the Ms Sql server communicates. The default port is 1433.  

  • In the JDBC_DRIVER text box, specify the JDBC driver that is used to access the database. The table below lists the JDBC drivers that correspond to some of the most popular database servers that are monitored by eG Enterprise. Refer to this table whenever in need.

    Database Driver
    Oracle oracle.jdbc.driver.OracleDriver
    MS SQL net.sourceforge.jtds.jdbc.Driver
    Informix com.informix.jdbc.IfxDriver
    Sybase com.sybase.jdbc2.jdbc.SybDriver
    MySql org.gjt.mm.mysql.Driver

  • In the CONNECTION_URL, specify the JDBC URL for the database. The URL format is JDBC driver specific. The table below lists the JDBC URLs for some of the most popular database servers that are monitored by eG Enterprise. While configuring this test for any of the database servers in this table, you can specify a URL of the corresponding format.

    Database URL Format
    Oracle jdbc:oracle:thin:@{host}:{port}:{instance}
    MS SQL jdbc:jtds:sqlserver://{host}:{port}/{database}
    Informix jdbc:informix-sqli://{host}:{port}/{database}:informixserver={instance}
    Sybase jdbc:sybase:Tds:{host}:{port}/{database}
    MySql jdbc:mysql://{host}:{port}/{database}

    If the target database is not in the above list, then follow the steps given below:

    1. Download the JDBC driver of the new database from the database vendor.
    2. Copy the relevant java package files (jar or zip) into the {EG_AGENT_INSTALL_DIR}\lib directory (on Windows; on Unix, this will be the opt/egurkha/lib directory).
    3. If a Unix agent is executing this test, then simply proceed to restart the eG agent. In case of a Windows agent however, edit the debugoff.bat file in the {EG_AGENT_INSTALL_DIR}\lib directory to manually set the classpath value. Then, execute debugoff.bat so that the agent service is reinstalled on Windows with the new classpath settings.
    4. Next, login to the eG administrative interface and configure this test with the JDBC_DRIVER and CONNECTION_URL that corresponds to the new database.

  • Next, specify the name of the USER who is vested with the privilege to execute the configured query.

  • Enter the PASSWORD of the USER.

  • Confirm the password by retyping it in the CONFIRM PASSWORD text box.

  • In the QUERY text box, specify the query to be executed and monitored.

  • 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.