TIBCO Spotfire® Server and Environment - Installation and Administration

Streaming and WebSockets for load balanced servers

The WebSocket connections may be closed prematurely when using a load balancer in front of a Spotfire Server cluster, depending on the load balancer's idle connection timeout. In that case, either the load balancer's timeout setting or the Spotfire Server heartbeat settings must be adjusted.

About this task

Some load balancers might require special handling of the WebSocket protocol upgrade mechanism. Spotfire web client WebSockets are established on /spotfire/wp/ws.

The Spotfire Server configuration property services.webplayer.websockets.client-heartbeat-interval-seconds is by default set to 25 seconds.

For general information about Spotfire Server clusters, see Clustered server deployments.

Procedure

  1. Open a command-line interface and export the active configuration by using the export-config command. (For details on using the Spotfire command line, see Executing commands on the command line.)
  2. On the command line, enter the following command:
    config set-config-prop --name=services.webplayer.websockets.client-heartbeat-interval-seconds --value=XX
    where XX is an integer and represents the heartbeat interval in seconds, the value 0 disables heartbeats.

    For information about the command options, see set-config-prop.

  3. Import the configuration file back to the Spotfire database by using the import-config command.
  4. Restart the Spotfire Servers in the cluster.