Agents Administration - Tests
 

Configuration of SmServicesTest

The SmServicesTest measures the availability of the Siteminder Policy Server services (Authentication, Authorization, Accounting, and Administration), and the time taken by the policy server for performing authentication and authorization checks. 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.

  • 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 selected server is listening has to be specified in the PORT text box. 

  • The port number of the Authentication Service of the Policy server has to be specified in the AUTHENTICATIONPORT text box. To know the authentication port, open the "SiteMinder Policy Server Management Console" (using the Start -> Programs -> Site Minder -> SiteMinder Policy Server Management Console menu sequence), and select the Settings tab within. The Authentication port displayed in the Agent TCP Ports section of the Settings tab should be specified against the AUTHENTICATIONPORT parameter.

  • In the AUTHORIZATIONPORT text box, specify the port number of the Authorization Service of the Policy server. To know the authorization port, open the "SiteMinder Policy Server Management Console" (using the Start -> Programs -> Site Minder -> SiteMinder Policy Server Management Console menu sequence), and select the Settings tab within. The Authorization port displayed in the Agent TCP Ports section of the Settings tab should be specified against the AUTHORIZATIONPORT parameter.

  • Enter the port number of the Accounting service of the Policy server in the ACCOUNTINGPORT text box. To know the accounting port, open the "SiteMinder Policy Server Management Console" (using the Start -> Programs -> Site Minder -> SiteMinder Policy Server Management Console menu sequence), and select the Settings tab within. The Accounting port displayed in the Agent TCP Ports section of the Settings tab should be specified against the ACCOUNTINGPORT parameter.

  • Specify the port number of the Administration service of the Policy server in the ADMINPORT text box. To know the admin port, open the "SiteMinder Policy Server Management Console" (using the Start -> Programs -> Site Minder -> SiteMinder Policy Server Management Console menu sequence), and select the Settings tab within. The TCP Port displayed in the Administration section of the Settings tab should be specified against the ADMINPORT parameter.

  • The resource, which is protected by the above configured web agent and requires username and password for authentication, needs to be specified in the RESOURCE text box. Example: "/transpolar/inventory/3inventorysignon.htm". While specifying the resource value, ensure that it does not contain the IP address of the host machine. An example for a wrong resource value would be: "http://192.168.10.47/transpolar/inventory/3inventorysignon.htm"

  • Specify the ACTION that needs to be checked. Example: "GET".

  • A valid USERNAME having permissions for the specified resource and configured action has to be specified.

  • Specify the PASSWORD for the above user.

  • In the AGENTNAME text box, enter the name of the configured webagent in the policy server user interface.

  • The shared secreat assigned to the specified web agent has to be mentioned in the SHAREDSECREAT text box.

  • The full path to the directory in which the "smjavaagentapi.jar" file is present has to be entered in the JARFILEPATH text box. For example, "D:\Progra~1\Netegrity\SiteMinder\SDK\java". This file is part of a SiteMinder installation.

  • In the TIMEOUT text box, specify the duration (in seconds) for which the test should wait for a response from the policy server services.

  • To make diagnosis more efficient and accurate, the eG system 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 component, choose the Onoption against DETAILED DIAGNOSIS. 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 requencies configured for the detailed diagnosis measures should not be 0.

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