---
schema_version: "1"
id: e35650a284bfeef681662c2d89abfd279e52cb58deeab875952bfbd903dbc5a1
title: Move the Messaging Service Process
collection: tableau
version: next
locale: en-gb
portal_url: https://docs.salesforce.com/tableau/next/en-gb/server-linux/distrib_msg_svc_move.md
canonical_url: https://help.tableau.com/v0.0/server-linux/en-gb/distrib_msg_svc_move.htm
source_site: help.tableau.com
content_type: documentation
content_hash: aeb21cde5b32071630a5ebd652d248eba6a6022ed36747d6712c19ff94cd1ca6
description: Move the Messaging Service process between Tableau Server nodes.
---
[Skip to main content](#main-content)

# Move the Messaging Service Process

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](https://help.tableau.com/v0.0/server-linux/en-gb/install_additional_nodes.htm).

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 terminal session.
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](https://help.tableau.com/v0.0/server-linux/en-gb/cli_pending-changes.htm#pending-changes-apply).