Agents Administration - Tests
 

Default Parameters for SqlResponseTest

The SqlResponseTest monitors the status and response time of a SQL query. This page depicts the default parameters that need to be configured for the SqlResponseTest.

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

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

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

When changing default configurations of tests, the values with "$" indicate variables that will be replaced by the eG system according to the specific server being managed - for instance, $hostName is the host/nickname of the target host, $port is the port number of the server being monitored. E.g., for a server xyz:80, $hostName will be changed automatically by the eG manager to "xyz" and $port will be changed to "80" when configuring a test.