How to switch communication method from Multicast IP to JMS Messaging for existing cluster of TIBCO Spotfire Statistics Services (TSSS) without reinstallation

How to switch communication method from Multicast IP to JMS Messaging for existing cluster of TIBCO Spotfire Statistics Services (TSSS) without reinstallation

book

Article ID: KB0080732

calendar_today

Updated On:

Products Versions
Spotfire Statistics Services All Versions

Description

There may be scenarios where a working TIBCO Spotfire Statistics Services (TSSS) cluster using Multicast IP as the communication method stops functioning suddenly after environment specific changes done, which splits those machines to operate under multiple subnets. One of the common reasons is a change in the IP address for the Manager node machine and/or any worker node machine. The Multicast IP method only works if all the machines in the cluster are in same subnet.  

In such a case, browsing the "nodes" url (htttp://<serverhostname>:<port>/<servicename>/api/v8/nodes) for the cluster will not show the nodes from the different subnet, which will impact the overall job execution. In that example "nodes" URL, replace the following with the details from your installation:
  • <serverhostname>: Hostname or IP address of Manager node or load balancer.
  • <port>: Port being used by cluster.
  • <servicename>: Name of the service being used for cluster
This may also be required if the cluster was incorrectly installed with Multicast IP communication method while installed on a cloud. You must specify JMS Messaging if your server is running on a cloud.

The solution in this scenario would be to switch to JMS Messaging communication method from Multicast. JMS supports communication between nodes over different subnets and will allow proper cluster operation on cloud installations..
 

Issue/Introduction

This article describes detailed steps to change cluster communication method from Multicast IP to JMS (messaging) without need of reinstalling and configuring cluster again.

Resolution

Steps to switch from Multicast IP to JMS Messaging:
  1. Stop all Manager Nodes and Worker Nodes in the cluster.
  2. From the cluster shared folder path, take a backup of the existing spserver.properties file which exists in the ‘conf’ folder.
  3. Open original spserver.properties in text editor and make the following changes:
     3.1. Make sure cluster.multicast.group.address property does not contain any value. Delete existing IP address, which is ‘224.0.0.224' by default for this property.
     3.2. Delete the value for property cluster.multicast.port,  which is 5000 by default.     
     3.3. Add the following property in this file in a new line:                               
cluster.jms.port=3308
Note: 3308 is a default port for JMS communication. Make sure you have this port opened in Firewall settings and no other application is using this port. Otherwise, use any other available port on the machine.
               3.4. After this change, these mentioned settings from spserver.properties should look like the those highlighted in the red rectangle in the attached screen shot (File: Switching_to_JMS_from_Multicast.PNG)
               3.5. Save the file.
     4. Restart all Manager nodes and Worker Nodes.
     5. Browse the ‘nodes’ url and verify it shows all the nodes in the cluster.
 

Additional Information

Doc: cluster.jms.port KB: 000034778 TIBCO Spotfire Statistics Services Cluster on cloud environments must be configured with Messaging (JMS) as communication method

Attachments

How to switch communication method from Multicast IP to JMS Messaging for existing cluster of TIBCO Spotfire Statistics Services (TSSS) without reinstallation get_app