Set the Frequency of Dispatcher Scans for a Servlet Gateway

If you use Servlet Gateways, you can specify how often they scan dispatchers for their current status. Traffic is routed to another dispatcher if the first one fails.

Use the following parameters:

  • pingPeriod

    Specifies, in seconds, the interval between scans for the state of dispatchers.

    Valid settings are 1 to 2147483647. Settings less than 5 may consume too many resources (CPU time and network bandwidth). The default setting is 180.

  • fileCheckPeriod

    Specifies, in seconds, the interval between startup configuration file checks for new dispatchers.

    Valid settings are 1 to 2147483647. The default is 30.

For information about gateways and URIs, see the IBM Cognos Business Intelligence Installation and Configuration Guide.

Procedure

  1. Open the Servlet Gateway web.xml file, located either in c10_location/war/gateway/ or in the deployment directory of the servlet, depending on which server you are using, in an editor that supports saving files in UTF-8 format.
  2. Change the values for the parameters as required.
    <!-- The number of seconds between pings to dispatcher
    --> 
    			<param-name>pingPeriod</param-name> 
    			<!-- A non-zero positive integer --> 
    			<param-value>180</param-value> 
    		</init-param> 
    		<init-param> 
    			<!-- The number of seconds between checking the startup file
    for changed dispatchers --> 
    			<param-name>fileCheckPeriod</param-name> 
    			<!-- A non-zero positive integer --> 
      			<param-value>30</param-value> 
        		</init-param>
  3. Save the web.xml file in UTF-8 format.