Server Upgrade Page

First time admin? Start with Everybody's Server Install Guide.

Learn

Overview

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

What's New?

What's New in Tableau Server 2018.1
- You can now download workbooks to work with an older version of Tableau Desktop (down to Tableau 10.2)
- Visualize changes in discrete values.
- Many more improvements!
What's New in Tableau Desktop 2018.1

What's Changed?

What's Changed in Tableau Server
See the Tableau Server Tech Specs
See what we fixed: Release Notes
Make sure everything works as expected: Known Issues

Upgrade

Guide to Upgrading

The Server Upgrade Guide takes you through the entire process to make your upgrade as seamless as possible.
Download the newest maintenance release and get started!

Inform Your Users

The Server Administrator Overview page is a great starting point for letting your users know about new capabilities.
Make sure your users know about the latest released features and invite power users to test the environment and to explore What's new in Tableau Desktop 2018.1.

Troubleshooting

If your users experience or report any of the following behaviors 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).

"This workbook uses a .hyper extract and is not compatible with this version of Tableau. Open this workbook in Tableau 10.5 or later."

"Export as version" grayed out for workbooks with .hyper extract.

"The document cannot be downgraded, because it contains direct connections to .hyper extracts."

The View changes after upgrading (becomes blank, fewer marks in the view, more null values when you inspect the summary data, or the view itself has a different shape).

For more information about updating extract data sources that are published to Tableau Server, see Update Server Data Sources That Are Using Extracts in Tableau Help.

Hyper is Tableau's new in-memory Data Engine technology optimized for fast data ingest and analytical query processing on large or complex data sets. The introduction of Hyper results in a number of changes related to extracts. Beginning in Tableau 10.5, new extracts use the .hyper file format instead of the .tde file format.

The sections below explain what actions will cause a .tde extract to upgrade to a .hyper extract, common issues your users may report, and important compatibility considerations that will arise if your version of Tableau Desktop and Tableau Server are not upgraded simultaneously. Please review this content as part of your upgrade plan.

File Conversion for .hyper Extracts

We recommend that Tableau Server and all the Tableau Desktops in your organization be on the same version and be upgraded to 10.5 (or a later version) on the same schedule.

After upgrading Tableau Server, your users might notice or report that their .tde extracts have been changed to a new .hyper format; or they might receive error messages that mention this new .hyper extract format. This extract file conversion is a part of the improved data engine, it will help Tableau users create and refresh larger extracts faster.

For more information about Tableau Desktop file conversion considerations, see the Tableau Desktop Upgrade page.

To understand when extracts are upgraded from .tde to the new .hyper format, see the table below. The black circle indicates that the extract will be converted to .hyper format. More details can be found in What causes an extract upgrade? in Tableau Help.

		Tabcmd	Tableau Data Extract Command-Line Utility
Full Extract Refresh
Incremental Extract Refresh
Append Data to an Extract

Extract compatibility scenarios

If your Tableau Server users report that they are unable to perform specific actions when they are interacting with extracts; they might run into an extract compatibility issue.

The table below will give you examples of scenarios about what occurs from a user perspective and in the background of Tableau Server when performing specific actions.

		Workbook and extract are created in Tableau Desktop 10.4 and earlier	Workbook created in Tableau Desktop 10.5 or later using a 10.4 Extract	Workbook and extract are created in Tableau Desktop 10.5 and later
As a Tableau Server and/or Desktop user, you attempt to publish your workbook or extract
	To Tableau Server 10.4 and earlier	You are able to publish this workbook or extract The extract remains in a .tde format	You will receive an error, please view this Knowledge Base article for details. In Tableau Server 10.4 and earlier, it is compatible with all corresponding Tableau Server versions.	You will receive an error, please view this Knowledge Base article for details.
	To Tableau Server 10.5 and later	You are able to publish this workbook or extract The extract remains in a .tde format	You are able to publish this workbook or extract The extract remains in a .tde format	You are able to publish this workbook or extract The extract is saved in .hyper format

		Workbook and extract are created in Tableau Desktop 10.4 and earlier	Workbook created in Tableau Desktop 10.5 or later using a 10.4 Extract	Workbook and extract are created in Tableau Desktop 10.5 and later
As a Tableau Server and/or Desktop user, you try to web-edit/save to Tableau Server (after publishing it to Tableau Server)
	No refresh or append in Tableau Server	You are able to web-edit this workbook. In all Tableau Server versions, the extract remains in a .tde format.	You are able to web-edit this workbook. In Tableau Server 10.5 and later, the extract remains in a .tde format	You are able to web-edit this workbook. The extract is saved in .hyper format
	Refresh or append the extract in Tableau Server	You are able to web-edit this workbook. In Tableau Server 10.4 and earlier, the extract remains in a .tde format. In Tableau Server 10.5 and later, after editing the workbook or appending the extract, the extract is converted to the new .hyper format.	You are able to web-edit this workbook. In Tableau Server 10.5 and later, the extract changes to the new .hyper format.	You are able to web-edit this workbook. The extract is saved in .hyper format

		Workbook and extract are created in Tableau Desktop 10.4 and earlier	Workbook created in Tableau Desktop 10.5 or later using a 10.4 Extract	Workbook and extract are created in Tableau Desktop 10.5 and later
As a Tableau Server and Desktop user, you attempt to Download and open the workbook and the extract
	Using Tableau Desktop 10.4 (and earlier)	You are able to download and open this workbook. In Tableau Server 10.4 and earlier, it is compatible with all corresponding Tableau Server versions. In Tableau Server 10.5 and later, you can open workbook but you will be unable to use the extract. See this target="_blank">Knowledge Base article for details	In all Tableau Server versions, you will receive an error message, see this Knowledge Base article for details.	In all Tableau Server versions, you will receive an error, see this Knowledge Base article for details.
	Using Tableau Desktop 10.5 and later	You are able to download and open this workbook.	Since the extract was published as a .hyper extract, you are able to download and open this workbook from Tableau Server 10.5 and later versions.	Since the extract was published as a .hyper extract, you are able to download and open this workbook from Tableau Server 10.5.

	Workbook and extract are created in Tableau Desktop 10.4 and earlier	Workbook created in Tableau Desktop 10.5 using a 10.4 Extract	Workbook and extract are created in Tableau Desktop 10.5 and later
As a Tableau Server user, you use the "Export as Version..." in Tableau Desktop and open the workbook in the corresponding Tableau version (or higher)
	If the workbook is using a .tde extract, you can export and open this workbook and extract in the corresponding Tableau version (or higher). After the workbook was edited and saved in Tableau Server 10.5 (or later), you can download this workbook and extract and open it in the corresponding tableau version (or higher).	If the workbook is using a .tde extract, you can export and open this workbook and extract in the corresponding Tableau version (or higher).	Since this data source is using a .hyper format extract you cannot export the workbook to an older version of Tableau. See this Knowledge Base article for details.

Attempting any action in Tableau Desktop 10.4 and earlier versions with an extract that was created in Tableau Desktop 10.5 or later will result in an error message. Please view this target="_blank">Knowledge Base article for details.

Tableau Server on Linux

Are you upgrading Tableau Server on Linux from 10.5 (or 10.5.x versions) to 2018.1?

Ensure 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 display warnings and cancel your upgrade. Such extra steps only need to be done once during the upgrade to 2018.1.

Share workbooks and data extracts with other users in your organization using Tableau Server on Linux!

Read through the links below for advanced knowledge and details:

Tech Specs

Requirements (Sudo / static address / drivers)

Migrate from Windows to Linux

Troubleshoot

Future Upgrades

More resources

Tableau Services Manager replaces the following tools from previous versions of Tableau Server and is only available with Tableau Server on Linux: