Was this page helpful?
Yes No
Tableau Help > Tableau Server on Linux Help > 

Upgrade Tableau Server on Linux

Upgrading Tableau Server on Linux from version 10.5.x (10.5.0 or later) requires special steps that are documented separately. For instructions for how to upgrade from 10.5.x, see Upgrade Tableau Server on Linux from 10.5.

The steps below describe the general process for an upgrade of Tableau Server on Linux. Upgrades from beta versions of Tableau Server on Linux are not supported. If you are a Tableau Server on Windows user and want to switch to Tableau Server on Linux, see Migrate Tableau Server from Windows to Linux.

As a best practice you should always make a full backup before upgrading any version of Tableau Server. Save this backup file to a location that is not part of your server installation. Creating and saving a backup preserves your pre-upgrade data and configuration and gives you a rollback option in the event of issues during the upgrade. For more information, see Back Up Tableau Server Data.

When upgrading Tableau Server on Linux, you do not need to uninstall the previous version. After upgrading you can uninstall the package for the previous version if you choose to do so. One reason to do this is to free up disk space used by the older version. To understand the difference between removing and uninstalling Tableau Server on Linux, see Uninstall Tableau Server.

Upgrading Tableau Server requires a stop and start the server as part of the upgrade process. During this stop/restart Tableau Server is unavailable.

Upgrading will also apply any pending changes. If you have pending changes you do not want applied, you can discard those changes using the tsm pending-changes discard command. To see what changes might be pending, use the tsm pending-changes list command.

Upgrading Tableau Server on Linux

Follow these steps on each node in your cluster to upgrade Tableau Server.

  1. On each node in your cluster:
    1. Copy the new Tableau Server .rpm or .deb package to location accessible from the computer you are upgrading.

      If you are upgrading a distributed deployment of Tableau Server, then copy the .rpm or .deb package to each node in the cluster or to a location accessible from each node.

    2. Log on as a user with sudo access to the computer you are upgrading.

    3. Navigate to the directory where you copied the .rpm or .deb Tableau Server package.

    4. Use the package manager to install the Tableau Server package.

      • On RHEL-like distributions, including CentOS, run the following command:

        sudo yum install tableau-server-<version>.x86_64.rpm

      • On Ubuntu, run the following commands:

        sudo gdebi -n tableau-server-<version>_amd64.deb

  2. After you have installed the new package on every node in your cluster, stop Tableau Server:

    tsm stop

  3. With Tableau Server stopped, run the following command on any one node. Do not run this command on multiple nodes:

    sudo /opt/tableau/tableau_server/packages/scripts.<version>/upgrade-tsm -u <tsm_system_admin> -p <tsm_system_admin_password> --accepteula

    where <version> is the new version you are upgrading to, and <system_admin> is a user with administrative permissions on the computer where the initial node is installed. You will be prompted for the password for the administrative user.

    The -u option was added as of 2018.1. For more information, see Updated upgrade-tsm script. To see all the options available for the upgrade-tsm script, use the -h option. For example: 

    upgrade-tsm -h

  4. After the upgrade is completed, exit the terminal session on the initial node and log in again. This ensures that your session will be using the updated TSM version.

  5. Start Tableau Server:

    tsm start