Agents Administration - Tests
 

Configuration of HttpPostTest

The 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 web page(s) that is being accessed has to be provided in the URL text box. While multiple URLs (separated by commas) can be provided, each URL should be of the format URL name:URL value. URL name is a unique name assigned to the URL, and the URL value is the value of the URL. For example, a URL can be specified as HomePage:http://192.168.10.12:7077/, where HomePage is the URL name and http://192.168.10.12:7077/ is the URL value. Parameters that have to be posted must be specified as arguments with the URL. For example, to access the Login Page, the URL should be http://192.168.10.12:7077/Login.jsp?user=demo&pass=demo. In this case, the name:value pairs "user=demo" and "pass=demo" will be posted (i.e. sent in the HTTP body) by the test to the server. 
  • In the HOST text box, the host name of the server for which the test is to be configured has to be specified.
  • The port number to which the web server is listening to has to be mentioned in the PORT text box.

  • Certain cookies that need to be returned by the web server on subsequent requests have to be saved locally. This has to be specified in the COOKIEFILE text box.

  • The host on which a web proxy server is running (in case a proxy server is to be used) has to be mentioned in the PROXYHOST text box.

  • The port number on which the web proxy server is listening has to be provided in the PROXYPORT text box.

  • The user name and the password of the proxy server have to be specified in the PROXYUSERNAME and PROXYPASSWORD text boxes respectively.

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

  • In the CONTENT text box, specify a set of instruction:value pairs. that are used to validate the content being returned by the test. If the CONTENT value is none:none, no validation is performed. The number of pairs specified in this text box, must be equal to the number of URLs being monitored. The instruction should be one of Inc or Exc. Inc tells the test that for the content returned by the web server to be valid, the content must include the specified value (a simple string search is done in this case). An instruction of Exc instructs the test that the server's output is valid if it does not contain the specified value. 

  • The HttpTest supports HTTP authentication. The CREDENTIALS parameter is to be set if a specific user name / password has to be specified to login to a page. This parameter is a comma separated list of user name:password pairs, one pair for each URL being monitored. A value of none:none indicates that user authorization is not required. Please be sure to check if your web site requires HTTP authentication while configuring this parameter. HTTP authentication typically involves a separate pop-up window when you try to access the page. Many sites uses HTTP POST for obtaining the user name and password and validating the user login. In such cases, the username and password have to be provided as part of the POST information and NOT as part of the CREDENTIALS specification for the HTTP test. 

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