---
schema_version: "1"
id: 4e0eb45120ac7e59b0a02c547f0d7fcc59de73e29b9a4ddb412be496f7cf76c1
title: Multi-node Upgrade -- Run Upgrade Script
collection: tableau
version: next
locale: en-us
portal_url: https://docs.salesforce.com/tableau/next/en-us/server-linux/server-upgrade-baseline-multinode-run-script.md
canonical_url: https://help.tableau.com/v0.0/server-linux/en-us/server-upgrade-baseline-multinode-run-script.htm
source_site: help.tableau.com
content_type: documentation
content_hash: 7be7984ef327697c1806362eb3845db51ddfad04b75aee758533ee5a75b772c9
description: Run the upgrade script during a multi-node Tableau Server upgrade.
---
[Skip to main content](#main-content)

# Multi-node Upgrade -- Run Upgrade Script

**Important note:** For environments using Active Directory authentication, the account running the upgrade script must be a domain user. This user must also be a member of the local administrators group on the initial node. Running the script with a local account that isn't part of the domain results in an Active Directory communication error.

## 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](https://help.tableau.com/v0.0/server-linux/en-us/upgrade_know_before.htm#NoPasswordUpgrade-19-3). 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](https://help.tableau.com/v0.0/server-linux/en-us/upgrade_know_before.htm#2018-1-upgrade-tsm).
    
    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](https://help.tableau.com/v0.0/server-linux/en-us/server-upgrade-baseline-verify-ug.htm).