Install Tableau Content Migration Tool

Installing Tableau Content Migration Tool is straightforward and easy.

Installation requirements

The Content Migration Tool tool is run from a Windows computer and can connect to Tableau Cloud sites and Tableau Server 19.3 and later with a valid Advanced Management licence. For more information about compatible versions, see Getting Started with Tableau Content Migration Tool.

The computer that you install Content Migration Tool on must meet the requirements below:

  • Microsoft Windows 10 or newer (x64)
  • Intel Core i3 or AMD Ryzen 3 (Dual Core)
  • 4 GB memory or larger
  • Can connect to the source and destination sites. Both sites must have a valid Advanced Management licence to migrate content.
  • 2 GB HDD or larger. The drive where the \temp folder resides must have enough disk space to hold a copy of all content being migrated in a single migration. All content is stored locally on the disk and deleted when the migration is complete.
  • Have enough free disk space to hold the application and its logs.

In addition, confirm that the REST API is enabled on Tableau Server (this is the default). Use the tsm configuration get -k api.server.enabled command to confirm this. A return value of true means the REST API is enabled. To enable the REST API, use the tsm configuration set command. For more information, see api.server.enabled.

Install Content Migration Tool

To install the Content Migration Tool:

  1. Download the Content Migration Tool installer (Tabcmt-64bit-<version>.exe) for your version of Tableau Server from the Tableau Advanced Management(Link opens in a new window) downloads page.
  2. Run the Content Migration Tool Setup program.

    Note: Running the Content Migration Tool Setup program overwrites the previous version.

  3. After reading the EULA, select I agree to the license terms and conditions and click Install.
  4. If the User Account Control dialog opens, click Yes to allow the installer to make changes.

Upgrade Content Migration Tool

Upgrading to the latest version of Content Migration Tool ensures that you can take advantage of the latest features and fixes included with each new version.

Important:

  • Running the Content Migration Tool Setup program overwrites the previous version.
  • Content Migration Tool doesn’t support side-by-side installation of previous versions.

To upgrade Content Migration Tool:

  1. Log on to the machine where Content Migration Tool is installed. If there are instances of Content Migration Tool open, save your migration plan and exit the application.
  2. Follow the steps listed in Install Content Migration Tool to download the latest installer and complete the upgrade.

Install Content Migration Tool from the command line

You can install Content Migration Tool from the command line if you're a local administrator on the machine.

Install switches

Specify one or more switches in the command line for the installer. For example:

Tabcmt-64bit-2022-3-0.exe /quiet /norestart

SwitchDescriptionComments
/install | /repair | /uninstall | /layout "<directory>"

Run Setup to either install, repair or uninstall Content Migration Tool, or with /layout, create a complete local copy of the installation bundle in the directory specified.

Default is to install, displaying UI and all prompts. If no directory is specified on a fresh install, C:\Program Files\Tableau\Tableau Content Migration Tool is assumed. If Content Migration Tool is already installed, Setup assumes the same location as the current installation.
/passive

Run Setup with minimal UI and no prompts.

Content Migration Tool doesn’t start automatically when installed in /passive mode. To start Content Migration Tool, open the application manually.
/quiet | /silent

Run Setup in unattended, fully silent mode. No UI or prompts are displayed.

Content Migration Tool doesn’t start automatically when installed in /silent or /quiet mode. To start Content Migration Tool, open the application manually.

Note: Use either /silent or /quiet, not both.

/norestart

Run Setup without restarting Windows, even if a restart is necessary.

Note: In certain rare cases, a restart cannot be suppressed, even when this option is used. This is most likely when an earlier system restart was skipped, for example, during installation of other software.

Who can do this

A user with Administrator access on the machine.

Thanks for your feedback!Your feedback has been successfully submitted. Thank you!