---
schema_version: "1"
id: 6588861b89fd77a754690f164070f2b922fbaa09db4098e9e1a881f6b8b68811
title: Migrate to New Hardware
collection: tableau
version: current
locale: en-gb
portal_url: https://docs.salesforce.com/tableau/current/en-gb/server/upgrade_migrate.md
canonical_url: https://help.tableau.com/current/server/en-gb/upgrade_migrate.htm
source_site: help.tableau.com
content_type: documentation
content_hash: 0d66515f2a20f28ffa53643d1d9e29600b6ebdd06922af844f822f3f9bf8d693
description: Migrate Tableau Server to new hardware.
---
[Skip to main content](#main-content)

# Migrate to New Hardware

Use the following procedure to migrate Tableau Server from one computer to another. You might do this if you are upgrading the computer hardware that Tableau is running on.

Specifically, these steps describe how to move Tableau Server data from your in-production computer to a new computer where Tableau Server is installed. Before you start, make sure you have followed the steps in [Preparing for Upgrade](https://help.tableau.com/current/server/en-gb/server-upgrade-prepare.htm), including creating a backup and gathering any assets that require manual actions. For details, see [Perform a Full Backup and Restore of Tableau Server](https://help.tableau.com/current/server/en-gb/backup_restore.htm). You'll need these to restore your Tableau Server data and configuration.

You can only restore from a backup that has the same type of identity store as the running server. For example, a backup from a server using local authentication can be restored to a Tableau Server initialised with local authentication, but a backup from a server using Active Directory authentication cannot be restored to a server initialised with local authentication.

**Note:** This operation includes steps that you may need to perform using the TSM command line. To use the TSM CLI, you need administrator access to the command line on one of the nodes in your installation and TSM administrator credentials to run TSM commands.

1. Deactivate your product key on your original installation of Tableau Server. You need to do this so you can activate it on the new computer. For more information, see "Tableau Server product key activation" below.
2. Install Tableau Server on the new computer, activate your licence, configure initial settings and create your admin user. For details, see [Install and Configure Tableau Server](https://help.tableau.com/current/server/en-gb/install_config_top.htm).
3. Copy your backup file _.tsbak_ to the folder location specified by the `basefilepath.backuprestore` variable. By default, this is: `C:\ProgramData\Tableau\Tableau Server\data\tabsvc\files\backups\`.
    
    **Note:** You can change the location for the backup file. For more information, see [tsm File Paths](https://help.tableau.com/current/server/en-gb/cli_default_filepaths_tsm.htm).
4. Next, stop Tableau Server:
    
    `tsm stop`
5. Restore your in-production data to your new Tableau Server installation using the `[tsm maintenance restore](https://help.tableau.com/current/server/en-gb/cli_maintenance_tsm.htm#tsm3)` command:
    
    `tsm maintenance restore -f <filename>`
    
    where `<filename>` is the name of the _.tsbak_ file you copied in step 3.
    
    For more information about restoring Tableau Server data, see [Restore from a Backup](https://help.tableau.com/current/server/en-gb/db_restore.htm).
6. Start the server:
    
    `tsm start`
7. **Distributed installations only**: Install Tableau Server on the new computers you want to add to your new Tableau Server cluster. See [Install and Configure Additional Nodes](https://help.tableau.com/current/server/en-gb/install_additional_nodes.htm) for steps.
8. If you have not deactivated your product key on the old computer, do that after you test your new Tableau Server installation and confirm that it's ready for production. For details, see "Tableau Server product key activation" below.
    
    **Note**: If you do not have an internet connection, you are prompted to create an offline activation file to complete the deactivation process. See [Activate Tableau Server Offline](https://help.tableau.com/current/server/en-gb/activate_off.htm) for steps.

## Tableau Server product key activation

You can activate the same Tableau Server product key up to three times. This allows you to test Tableau Server (in a sandbox or QA environments, for example), as well as use Tableau in production. To maximise your activations, you should deactivate your product key when you remove Tableau Server from a computer, unless you will be reinstalling Tableau on the same computer. Doing this gives you the opportunity to use the activation on a different computer. For example, if you move Tableau Server from one computer or VM to another, deactivate the product key, then remove Tableau from the original computer. When you install Tableau on the new computer, you can activate the key there without any conflict. If you use role-based licensing, be sure to activate a Creator or Explorer key or you may lose administrator access to Tableau. If you are removing Tableau Server to reinstall it on the same computer, you don't need to deactivate the key. Tableau will use the key when reinstalled. For example, if you are moving Tableau from one drive on a computer to a different drive on the same computer. For information on how to deactivate a product key, see [tsm licences deactivate](https://help.tableau.com/current/server/en-gb/cli_licenses_tsm.htm#TSMDeactivate).