Increasing the Idle Connection Time-outs

Using a configurable polling time, administrators can control the frequency of messages that keep a connection to Interactive Reporting Web Client active. This feature allows queries of varied lengths to process from when running behind a proxy or firewall with finite idle-connection time-outs. By default there is no polling and this feature needs to be explicitly enabled.

  To increase the idle connection time-outs:

  1. Open the ws.conf file from the <SERVLETS DEPLOYMENT>/config folder in your favorite editor.

  2. Add the line:

    WebClient.Applications.DAServlet.PollingTimeSec=0

  3. Change the PollingTimeSec parameter value from 0 to the desired value.

    • The Default value is 0 for the PollingTimeSec parameter value indicating there is no polling mechanism in place to keep the connection active.

    • The PollingTimeSec parameter value is in seconds.

    • The PollingTimeSec parameter value is less than the proxy and firewall timeout value (otherwise this configuration change would have no effect).

    • Setting the PollingTimeSec parameter value too low increases network traffic. For example: if a firewall is set for a 15 min idle timeout, set the polling time to be 720 sec (== 12 min). There is no need to set the value to 10 seconds in a case like this, as it creates unnecessary network overhead.

      Once this entry is added to the ws.conf file, the Servlet Configurator (<INSTALL_HOME/servlets/bin, servletconfig.bat for Windows and servletconfig.sh for UNIX can be used to manipulate the value.

  4. Save the file.