---
schema_version: "1"
id: 9b0682da0bbfd693448eafbb1b8275ed60c50d3a8491c866dd4b1ef7b3195a84
title: Move the Messaging Service Process
collection: tableau
version: next
locale: en-us
portal_url: https://docs.salesforce.com/tableau/next/en-us/server-linux/distrib_msg_svc_move.md
canonical_url: https://help.tableau.com/v0.0/server-linux/en-us/distrib_msg_svc_move.htm
source_site: help.tableau.com
content_type: documentation
content_hash: 92449573cd9d9e06514dfc1573fdf03d52fb484ac7fdbaad7b33236c4817e889
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-us/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 behavior. 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-us/cli_pending-changes.htm#pending-changes-apply).