KNOWLEDGE BASE

Rolling Back to an Earlier Installation of Tableau Server


Published: 08 Mar 2017
Last modified date: 16 Jan 2024

Question

How to roll back to an earlier installed version of Tableau Server. 

Environment

Tableau Server

Answer

Before you start

You'll need the installer package for your previous version of Tableau Server, and a Tableau backup file (.tsbak) from that same version you are rolling back to. 

    Tableau Server 2018.2 or Later (Windows):

    Run obliterate script. The script will be applied to one of the following paths:
    • If Tableau Server has not been uninstalled yet:

    C:\Program Files\Tableau\Tableau Server\packages\scripts.<version_code>\tableau-server-obliterate.cmd -y -y -y

    • If Tableau server is uninstalled in Control Panel:

    C:\Program Files\Tableau\Tableau Server\temp\tableau-server-obliterate.cmd -y -y -y

    The obliterate script will do the following:
    • All contents in the data directory will be removed (by default C:\ProgramData\Tableau\Tableau Server).
    • All registry entries related to Tableau Server will be removed.
    Download desired version of Tableau Server, install and restore from backup as described above.

    Note: If the rolled back version of Tableau Server does not use the same licence, obliterate script can be used with -l to deactivate licence and remove all licensing files from the computer.  
     

    Tableau Server 2018.1.x or Earlier (Windows): Rolling Back the Installation

    1. Uninstall Tableau Server using the Programs and Features option in the Control Panel. 
    2. Manually delete the Tableau Server folder in Program Files. For example, 

      C:\Program Files\Tableau\Tableau Server

    3. Manually delete the Tableau Server data folder.
      • If you installed Tableau Server to the default location, delete 

        C:\ProgramData\Tableau\Tableau Server\

      • If you installed Tableau Server to a non-default location, delete the \data folder in the location where you installed Tableau Server, for example,

        D:\Tableau\Tableau Server\data

      Note: The \ProgramData folder is hidden by default. You may need to configure Windows to show hidden folders.

    4. Run the installer you downloaded in Before you start and follow the on-screen instructions. 
    5. When the Tableau Server Configuration dialogue box opens, accept the default values. do not specify a Run As user. These settings will be set when you restore your backup file. 
    6. When prompted, complete registration. 
    7. After the installation completes, restore from the backup (.tsbak) file for the previous version. For more information, see Restore from a Backup.
    Did this article resolve the issue?