Run Setup

Follow these steps to upgrade a single-node installation of Tableau Server version 2018.2 or later.

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

  2. Navigate to the directory where you copied the .rpm or .debTableau Server package.
  3. Use the package manager to install the Tableau Server package.

    You must install the new version to the same location as the existing version. The install location must be the same on all nodes. Do not install to a location using a symbolic link or to a directory on a Network File System (NFS) volume.

    • On RHEL-like distributions, including CentOS, you have the option to install Tableau to a non-default location.

      • Default location—To install to the default location (/opt/tableau/tableau_server), run the following commands, where <version> is formatted as major-minor-maintenance (ex: 2019-2-5):

        sudo yum update

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

      • Non-default location—To install to a non-default location, you must use rpm -i. You will also need to install all dependent packages. See the note below.

        Run the following command:

        sudo rpm -i --prefix /preferred/install/path tableau-server.rpm

      Note: When you use yum to install Tableau Server, all dependent packages are automatically downloaded and installed. This is the preferred method for installing Tableau. If you want to install to a non-default location, or your organization does not allow you to use yum and you must install using rpm -i, you must also install all dependent packages separately. For information about installing dependent packages, see Installing Tableau Server on an Air-Gapped Computer Running Linux.

    • On Ubuntu, run the following commands, where <version> is formatted as major-minor-maintenance (ex: 2019-2-5):

      sudo apt-get update
      sudo apt-get upgrade
      sudo apt-get -y install gdebi-core
      sudo gdebi -n tableau-server-<version>_amd64.deb
      
  4. Run the upgrade script.

    If Tableau Server is not stopped when you run the script, the script will let you know, and will offer to stop the server. You can also choose to stop the server before running the script using the tsm stop command. Tableau Server must be stopped to complete the upgrade.

    The options you need to include depend on the version you are upgrading to:

    • Version 2019.3 or later:

      sudo /opt/tableau/tableau_server/packages/scripts.<version_code>/upgrade-tsm --accepteula

      where <version_code> is the long form of new version you are upgrading to, for example scripts.20183.18.1128.2033.

      Starting with version 2019.3.0, when you upgrade from 2019.2.x or later, the script runs using the account you are logged in with. If you are prompted, enter your password. For more information, see What's Changed - Things to Know Before You Upgrade. You can specify a different user with administrative permissions using the -u option and specifying 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.

    • Version 2018.1 through version 2019.2.x:

      sudo /opt/tableau/tableau_server/packages/scripts.<version_code>/upgrade-tsm -u <system_admin> --accepteula

      where <version_code> is the long form of new version you are upgrading to, for example scripts.20183.18.1128.2033, 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 What's Changed - Things to Know Before You Upgrade.

    To see all the options available for the upgrade-tsm script, use the -h option. For example: 

    sudo /opt/tableau/tableau_server/packages/scripts.<version_code>/upgrade-tsm -h
  5. After the upgrade is completed, exit the terminal session and log in again. This ensures that your session will be using the updated TSM version.

  6. Start Tableau Server:

    tsm start

Continue to Verify Tableau Server Upgrade.

Thanks for your feedback!