Setting up a cluster of Spotfire Servers

Some deployments that include clustered Spotfire Servers are very complex, and their installation and configuration are best left to a Spotfire consultant. However, if you plan to do it yourself, follow these guidelines.


  • The Spotfire database has been set up on your Oracle or SQL Server database; for instructions, see Preparation.
  • If you plan on adding a load balancer in front of the servers, you have purchased a load balancer that supports session affinity; this means that after a session has been established, the load balancer continues to route all requests from a particular client to a particular server.

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


  1. Install Spotfire Server on each computer; for instructions, see Installation.
    Note: For reasons of security and performance, do not install a Spotfire Server on the same computer as the database. (This is true for non-clustered systems as well.)
    1. Ensure that all the clustered Spotfire Servers have the same:
      • Version number
      • Database
      • Database drivers
      • Encryption password. This is an optional setting on the Bootstrap page of the configuration tool.
  2. Apply any available hotfix to each server. For instructions, see Applying hotfixes to the server.
  3. Start at least one server to verify that it is working.
  4. Optional: If you want to change the clustering port, follow these steps on only one of the servers to modify the shared Spotfire Server configuration.
    Important: Make sure that none of the servers are running before you change the clustering configuration. For instructions, see Start or stop Spotfire Server.
    Note: These instructions are for using the configuration tool. Alternatively you can use the config-cluster command on the command line. For more information, see Executing commands on the command line.
    1. If the configuration tool is not open, open it; for instructions see Opening the configuration tool.
    2. On the Configuration page, at the bottom of the left pane, click Clustering.
    3. Next to Port, enter the TCP/IP port that you want to use for clustering. This port is the same for all servers in the cluster. (The default is 5701.)
      Note: Apache Ignite uses two ports. For information about how the ports are numbered, see the "Ports" section of Clustered server deployments. Make sure that on all the servers, these ports are not protected by a firewall.
    4. At the bottom of the page, click Save configuration.
  5. Start all the servers in the cluster.
Related reference