Was this page helpful?
Yes No
Tableau Help > Tableau Server for Windows Help > 
Deploy > Move Tableau Server to Another Drive

Move Tableau Server to Another Drive

By default Tableau Server is installed to the system drive (usually C:\). This means that all program and data files are installed to that drive. If you need to move Tableau Server to a different drive (if you are running out of space on the original drive, for example), you can do this by following the procedure below. The steps are intended as an example for moving Tableau Server from one drive to another drive on the same computer, and may not exactly reflect your installation and configuration.

Before you start

Before starting, make sure you:

  • Have administrative credentials to the primary Tableau Server computer. This is where you will be working and you need to be logged on to the computer as an administrator.
  • Have a copy of the installation program for the version of Tableau Server you are moving. You need this to install Tableau Server to the new drive.
  • Know what authentication methods your current installation is using. If Tableau Server is configured for SSL, SAML, or Kerberos, you will need to back up the related certificate or keytab files separately, and then copy them to the new drive after you reinstall Tableau Server.

When you are ready to move Tableau Server to another drive:

  1. Open a command prompt as an administrator on the primary Tableau Server computer.

  2. Navigate to the Tableau Server \bin directory. By default this is:

    C:\Program Files\Tableau\Tableau Server\<version>\bin
  3. Stop Tableau Server:

    tabadmin stop
  4. Back up your Tableau Server data:

    tabadmin backup <filename>

    Where <filename> is the name of the backup file. The file will have a .tsbak extension.

    Save the backup file to a safe location. You need this to restore your server after installing it to the new drive.

  5. If Tableau Server is configured for SSL, SAML, or Kerberos, make a copy of the folder that contains the related certificate or keytab files and save it to a location that is not part of the Tableau Server install path (for example, C:\TServer-hold). Find the location of the related files by opening the Tableau Server Configuration utility and clicking the appropriate tab.

  6. Uninstall Tableau Server u using Control Panel and Add/Remove programs. You should also rename the \ProgramData\Tableau\Tableau Server and \Program Files\Tableau\Tableau Server\<version> directories so your new installation does not find them. By default the \ProgramData directory is hidden, so you may need to configure Windows to display hidden files and directories to find it. Later, once you have installed Tableau Server to the new location and verify that everything is working, you can delete the directories.

  7. Install Tableau Server to the new drive.

    At the end of the install process a browser window will open and you will be prompted to create an initial administrative user. Close this without creating the user.

  8. Open a command prompt as an administrator.

  9. Navigate to the Tableau Server \bin directory in your new install location.

  10. Restore your Tableau Server data backup from Step 4 above using the --no-config option:

    tabadmin restore --no-config <filename>

    Where <filename> is the name of the .tsbak file you created when you backed up your original installation.

  11. If you had SSL, SAML, or Kerberos configured, copy the folder with your certificates to the new drive. For example:

    1. If you are using SSL and installed Tableau Server to D:\Tableau\Tableau Server, copy the SSL folder to D:\Tableau\Tableau Server\SSL.

    2. Run the Tableau Server Configuration utility and on the SSL tab, update the paths to the new location for the certificate files.

    3. Click OK to close the Configuration utility.

  12. Start Tableau Server.