Upgrade to Tableau Server 2018.2

Planning an upgrade to Tableau Server 2018.2? Start here!

Starting from 2018.2, please note that the following administration maintenance tasks have changed for Windows:

  • Installation - This includes the installation of TSM; depending on your environment, you may also need to follow other specific instructions (for example, Air-Gapped, cluster) and other changes.
  • Upgrade - Changes include the uninstallation of pre-TSM versions of Tableau Server, or instructions to run an upgrade script, etc.
  • Uninstallation - Ensure to read the Tableau Help documentation, this will help you run obliterate script or address diffferent scenarios (for example, what to do if you have already uninstalled Tableau Server using Control Panel).
  • Upgrade

    Guide to Upgrading

    Inform Your Users



    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 Changed?

    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:

  • Tableau Services Manager Overview
  • Comparing Functionality of tabadmin and TSM
  • Migrate from Tabadmin to the TSM CLI
  • TSM web interface
  • Log File Snapshots (Archive Logs)
  • Tableau Server on Linux Upgrade information

    Are you upgrading Tableau Server on Linux to 2018.2?

  • For Tableau Server on Linux, be 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 display warnings and cancel your upgrade. These extra steps only need to be done once during the upgrade to 2018.2.
  • Share workbooks and data extracts with other users in your organization using Tableau Server!

    Read through the links below for advanced knowledge and details:

  • Tech Specs
  • Tableau Server on Linux Requirements (Sudo / static address / drivers)
  • Migrate from Windows to Linux
  • Troubleshoot Tableau Server on Linux
  • Linux: Troubleshoot Tableau Server Install and Upgrade
  • Tableau Services Manager replaces the following tools from previous versions of Tableau Server:
    • Tableau Server Configuration utility
    • tabadmin command line utility
    • Tableau Server Monitor
  • Troubleshooting Extracts on Tableau Server

    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.
  • 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
  • Complimentary Server Upgrade Assistance
    Complimentary service is available at no charge to current customers with Maintenance.
    Professional Services
    Our consultants can accelerate your upgrade and help you unlock the value in your data.