The articles in this section help you upgrade an existing installation of Tableau Server
Note: Use Tableau Release Navigator to search for features in Tableau Desktop, Server and Prep or to see a full list of features when comparing your current version of Tableau to a later one.
Looking for Tableau Server on Linux? See Upgrade Tableau Server on Linux(Link opens in a new window).
Choose your upgrade path
Blue/Green upgrades
Blue/green upgrades are a special type of upgrade approach that provides minimal downtime, but requires a knowledgeable IT team and resources to implement. These are not for every organisation, but for those who are equipped to handle them, they can be the right upgrade solution. For more information, see Using a Blue/Green approach for upgrading Tableau Server.
Upgrading in place
Your upgrade steps depend on the version of Tableau Server on Windows you are upgrading from, the version you are upgrading to, and the install location of your existing version. Use the table below to find a link to the steps that apply to your upgrade situation.
Upgrade Type
Note: Special steps are required if you have a pre-TSM version installed in a non-default location and are upgrading to version 2019.4.0 through 2019.4.4 or 2020.1.0 through 2020.1.1.
Current version | Upgrading to version | Install location | Upgrade procedure |
---|---|---|---|
What version are you upgrading from? |
If you aren't sure how to find your version, see Determine your Tableau Server version below. |
If you do not know where Tableau Server is installed, see Determine your Tableau Server install location below. |
Upgrade steps to use
|
pre-TSM to TSM | |||
10.0 through 2018.1.x
|
2018.2.0 through 2019.3.x |
default location or non-default location | Upgrade from Tableau Server 2018.1.x or Earlier to 2019.3.x (Windows)(Link opens in a new window) (opens 2019.3 Server Help) |
2019.4.0 or later |
default location | Upgrade from Tableau Server 2018.1.x or Earlier (Windows) | |
2019.4.0 through 2019.4.4 |
non-default location | Upgrade from Tableau Server 2018.1.x or Earlier in a Non-Default Location (Windows) | |
2019.4.5 or later |
default or non-default location | Upgrade from Tableau Server 2018.1.x or Earlier (Windows) | |
TSM to TSM | |||
2018.2.x or later |
2018.2.x or later |
default or non-default location | Upgrading from 2018.2 and Later (Windows) |
TSM to TSM | |||
2018.2.x or later |
2018.2.x or later |
default or non-default location | Upgrading from 2018.2 and Later (Windows) |
Determine your Tableau Server version
To see what version of Tableau Server you are running, sign in to Tableau Server and click the information icon ( or
) at the upper right of the Tableau Server window, then click About Tableau Server. Your server version is listed in the About Tableau Server dialog.
Determine your Tableau Server install location
Knowing where your current version of Tableau Server is installed is a key aspect of choosing the right upgrade path. By default Tableau Server versions 2018.1.x or earlier install to C:\Program Files\Tableau\Tableau Server\<version>
. When you uninstall version 2018.1.x or earlier, a backup is automatically created and saved in the data directory. Non-default location installs of Tableau Server version 2018.1.x or earlier use the same location for both the install directory and the data directory. Locate the backup and you have identified both the data directory and the install directory.