This article assumes you have installed Tableau Server on an initial node and at least one additional node. For more information on adding nodes to Tableau Server, see Install and Configure Additional Nodes.

You cannot remove an instance of the Messaging Service if it is the only instance on the server. You cannot run Tableau Server without one instance of the Messaging Service. This means if you need to move the Messaging Service, or if you are deleting a server node that is hosting the Messaging Service, you must first move the service to another node.

Moving the Messaging Service is straightforward process of three steps:

  • Remove the original instance of the Messaging Service.

  • Add a new instance of the Messaging Service.

  • Apply the pending changes.

Moving the Messaging Service

  1. In TSM, on the Status tab, verify that all processes are active.

  2. Click the Configuration tab.

  3. For the node you're removing the Messaging Service from, clear the Messaging Service box.

    This will activate the Pending Changes button, but in Pending Changes an error will tell you that the Messaging Service (activemqserver) is not on any node. Until you add it to another node, you cannot apply pending changes.

  4. For the node you are adding the Messaging Service to, select the Messaging Service box.

  5. Click Pending Changes at the top of the page.

  6. Click Apply Changes and Restart and Confirm to confirm a restart of Tableau Server.

Moving the Messaging Service

  1. On the initial node, open a command prompt as administrator.

  2. Find the node ID for the nodes you are changing:

    tsm topology list-nodes -v

  3. Remove the Messaging Service from one node:

    tsm topology set-process -n <nodeID> -pr activemqserver -c 0
  4. Add the Messaging Service to another node:

    tsm topology set-process -n <nodeID> -pr activemqserver -c 1
  5. Apply the configuration changes:

    tsm pending-changes apply

    If the pending changes require a server restart, the pending-changes apply command will display a prompt to let you know a restart will occur. This prompt displays even if the server is stopped, but in that case, there is no restart. You can suppress the prompt using the --ignore-prompt option, but this does not change the restart behaviour. If the changes do not require a restart, the changes are applied without a prompt. For more information, see tsm pending-changes apply.

Thanks for your feedback!