Multi-node Upgrade -- Run Upgrade Script

Run Upgrade script

  1. After you have installed the new version on every node in the cluster, run the upgrade script on the initial node.

    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 to 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

  2. 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.

  3. Start Tableau Server:

    tsm start

Continue to Verify Tableau Server Upgrade.

Thanks for your feedback!Your feedback has been successfully submitted. Thank you!