How to change Gateway Sender attributes in GemFire

Products

• VMware Tanzu Gemfire

Issue/Introduction

Introduction

Many gateway sender attributes can be changed one node at a time. Others, however, must be consistent across all hosting members.

Attempting to change such attributes on only a single node will result in an IllegalStateException. For instance, trying to change the “manual-start” attribute on one node at a time would cause an error similar to the following:

java.lang.IllegalStateException: Cannot create Gateway Sender with manual start "true" because another cache has the same Gateway Sender defined with manual start "false"

Resolution

Here are the recommended steps to change such Gateway Sender attributes in the cache.xml file, while avoiding the exception:

1. STOP the gateway sender using the gfsh command "stop gateway-sender". Once you stop the gateway sender, the events are not queued.

2. Confirm that no Gateway senders are running using the gfsh “list gateways” command. The gfsh "list gateways" command displays the gateway senders and receivers for a member or members.

3. Comment out the existing gateway sender definition in the Cache server XML. 

4. Do a rolling restart of one Cache server at a time. The rolling restart will avoid downtime for the cluster.

5. Make the desired changes to, and uncomment, the previously commented gateway sender definition in the XML to enable the new configuration after the restart.

6. Do a rolling restart of one Cache server at a time again. The nodes will now startup with the new gateway sender configuration.
 

References

• Configuring a Multi-site (WAN) System
• list gateways
• stop gateway-sender