Upgrade to Tableau Server 2020.4

Planning an upgrade to Tableau Server 2020.4? Start here!

Know before you upgrade

Beginning in Tableau Server 2020.4, Tableau Server configured for mutual SSL authentication will block authentication of users with client certificates that use the SHA-1 signing algorithm. Users who attempt to login with SHA-1 client certificates will encounter an "Unable to sign in" error. For more information about responding to this change, see this Knowledge Base article

For more information about why this change was implemented, see this Tableau Community post and the National Institute of Standards and Technology Policy on hash functions.


Guide to upgrading

Inform your users



Extend the value of your data across your entire organisation with Tableau Server. The Tableau Server platform is easy to deploy, scale and monitor.

What's new?

  • What's new in Tableau Server 2020.4
    • Offline map support
    • Resource Monitoring Tool available on Linux 
    • Azure external repository and key vault
    • Enable and configure Catalog or Metadata API indexing limits 

What’s changed?

New in Tableau Server 2020.4

Start by reading What's New in Tableau Server on Windows  |  What's New in Tableau Server on Linux
Make sure you check out current guidance before you upgrade:

New for server or site administrators


Enable and configure Catalog or Metadata API indexing limits

A new TSM configuration set command allows enabling and configuring Catalog or Metadata API indexing limits, also called event throttling, for new and updated content. 

Configure Tableau Server for offline maps

Beginning with version 2020.4, you can configure Tableau Server to use offline maps that are installed with Tableau. For more information, see Displaying maps in an air-gapped environment.

Turn off web page objects

To prevent web page objects in dashboards from displaying target URLs, do either of the following:
  • For a specific site, deselect Enable web page objects in the site settings.
  • For an entire server, set the vizqlserver.web_page_objects_enabled configuration key to false.

Custom sign0in note for server sign-in errors

In 2020.4, sign-in pages added to the Sign-in customisation setting will also appear when a user receives a sign-in error, such as failed attempts to log in with SSO (SAML, site SAML, and Open ID). Server administrators can use this note to help users understand how to get a licence or why they can't access a site. 

Automatic configuration of query cache size

The size of the query cache is now automatically set based on the amount of available system memory. This improves the number of query results that will fit into the cache by default. 

New for Tableau Server Add-ons


Resource Monitoring Tool for Tableau Server on Linux

Previously available only for Windows, you can now use the Resource Monitoring Tool on Linux to monitor and troubleshoot server health as part of the Server Management Add-on.



Ask Data usage and adoption admin view

The new Ask Data usage admin view shows you how users engage with Ask Data on a site. The dashboard highlights the top Ask Data users, data sources and data owners, along with headline value metrics.


Tableau Services Manager (TSM)

As of Tableau Server 2018.2, Tableau Services Manager (TSM) is now available for Windows as well as Linux, and replaces tabadmin. This new web-based server configuration and management application contains a new user experience for server administrators – a command-line interface (CLI) and a web interface (both interact with the new TSM REST API).

For more information about TSM, see the following helpful resources:

Upgrading from older versions

Upgrading Tableau Server on Windows from 2018.1 and earlier versions

Beginning with 2018.2, please note that the following administration maintenance tasks have changed for Windows:

Installation – The Installation process has changed significantly. Make sure to read the documentation before starting any installation or upgrade.

Upgrade – The upgrade process is new and differs depending on whether you are upgrading from version 2018.2.x or from a version earlier than 2018.2. Do not upgrade without first reading the specific upgrade procedures for your scenario.

Uninstall – Uninstall works differently now as well. With version 2018.2 and later, you do not need to uninstall until after you have upgraded Tableau.

Watch the video Upgrading to Tableau Server with TSM


Upgrading Tableau Server on Linux to 2018.2

  • For Tableau Server on Linux, make sure to follow the detailed instructions outlined in the following Tableau Help article: Upgrade Tableau Server on Linux from 10.5.
  • Important: Failing to follow these steps may result in warnings being displayed and your upgrade being cancelled. These extra steps only need to be followed once during the upgrade to 2018.2.

Share workbooks and data extracts with other users in your organisation using Tableau Server!

Read through the links below for advanced knowledge and details:

Troubleshooting extracts on Tableau Server

If your users experience or report any of the following behaviours while performing an extract task, they may be running into an incompatibility scenario. Please redirect them to the following Knowledge Base articles to resolve the error(s).

Get help

Technical support
Open a support case. For the fastest possible support, please include the following information:
  • Screenshots of the issue and any error messages (expanded)
  • How far you were into the upgrade process
  • Server logs
  • Note: you can take a log file snapshot and send it to Tableau Support directly from the Tableau Services Manager UI or CLI.
  • msinfo32.exe system report
  • Best times to call

Professional Services
Our consultants can accelerate your upgrade and help you unlock the value in your data.