Move the File Store Process

This topic describes File Store process when configured to run locally on Tableau Server. However, File Store can be run locally as well as external to Tableau Server. For more information on Tableau Server External File Store, see Tableau Server External File Store.

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

Moving the File Store is a two-part process:

  • Adding a second instance of File Store (if there is not an existing second instance).

  • Decommissioning and removing the original instance of File Store.

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.

Adding a second instance of File Store

This procedure assumes you have added an additional node. For more information on adding nodes to Tableau Server, see Install and Configure Additional Nodes.

  1. Open TSM in a browser:

    https://<tsm-computer-name>:8850

    For more information, see Sign in to Tableau Services Manager Web UI.

  2. Click the Configuration tab.

  3. For the node you want to add an instance of File Store on, select File Store.

    Adding File Store to a node will also add an instance of Data Engine if one is not already on the node.

  4. Click Pending Changes at the top of the page:

    The Pending Changes list displays.

    A Coordination Service ensemble warning displays because you are configuring a three-node cluster. You can continue. You will deploy a Coordination Service ensemble in an upcoming step.

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

Decommissioning and removing an instance of file store

  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 File Store from, clear the File Store box.

    This will generate a warning about decommissioning the File Store before removing it. You cannot remove an instance of File Store unless it has been decommissioned. Click OK to decommission and remove the file store. Data Engine will also be removed unless an instance of one of these processes is installed on the node: VizQL Server, Application Server (Vizportal), Data Server, or Backgrounder.

  4. If you are removing File Store from a node that also has the TSM Administrative Controller (usually the initial node), a warning will caution you about impact to server backup performance.

    Click Continue to decommission File Store.

  5. Click the Status tab to see the status of the decommission. When the instance of File Store is marked "Ready for removal" you can continue.

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

    Note: If you are configuring a three- or five-node cluster, a Coordination Service ensemble warning will display. You can continue to apply pending changes and deploy a Coordination Service ensemble in a separate step. For information on deploying a Coordination Service ensemble, see Deploy a Coordination Service Ensemble .

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