Best Practices for Updating Your Tableau Server Computer

This topic provides the steps for doing minor version upgrades or patches on a computer running Tableau Server.

Important: Any major version operating system or Linux system kernel update Major upgrades (for example: RHEL 7.x to RHEL 8.x) must be done using Blue/Green guidelines. Do not do a major version upgrade directly on a machine already running Tableau Server. Even if you follow the steps below, Tableau Server will be in an unstable state if it starts at all. For details on Blue/Green upgrades, see Using a Blue/Green approach for upgrading Tableau Server.

To do a minor version update or patch of the operating system or Linux kernel of a computer running Tableau Server:

  1. Use TSM to stop the Tableau Server:

    At a command prompt, type: tsm stop and wait until all services are completely stopped.

  2. Stop the TSM administrative services by running the stop-administrative-services script, by default:

    /opt/tableau/tableau_server/packages/scripts.<version_code>/stop-administrative-services

  3. Patch the operating system as instructed by your IT Team or operating system vendor for all nodes in the cluster.

  4. If the patch requires a reboot of the operating system, make sure that all hosts in the Tableau Server cluster complete the reboot before restarting Tableau Server.

  5. Start Tableau Server with TSM:

    At a command prompt, type: tsm start and wait until all services are completely started.