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 upgrade (for example: Windows 2019 to Windows 2022) 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:

    C:\Program Files\Tableau\Tableau Server\packages\scripts.<Build number>\stop-administrative-services.cmd

  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.

 

Back to top