Error During Tableau Server Installation: “Setup failed to install Tableau Server. You will need to uninstall Tableau Server before you try again.”

Step 1: Backup Your Tableau Server Data

Before proceeding with uninstallation, create a full backup to prevent data loss:

tsm maintenance backup -f <backup_file_name>

• Ensure that the backup file is stored in a secure location before continuing.

Step 2: Uninstall Existing Tableau Server

1. Open Control Panel > Programs and Features.

2. Locate Tableau Server, right-click, and select Uninstall.

3. If using a multi-node (distributed) environment, uninstall Tableau Server from the primary node first.

Note: Uninstalling the application removes the software but does not delete your data or configurations.

Step 3: Manually Remove Residual Files

Even after uninstallation, some directories and settings remain on the system. Delete the following directories manually. Navigate to these locations in File Explorer and delete them manually:

• C:\Program Files\Tableau\Tableau Server

• C:\ProgramData\Tableau\Tableau Server

Important: Deleting these directories removes all existing content, preventing the new installation from attempting to reuse outdated files.

Step 4: Install the New Version of Tableau Server

1. Download the latest Tableau Server installer from here: https://www.tableau.com/support/releases/server

2. Run the installation file and follow the on-screen instructions.

3. Complete the installation process and reconfigure settings if necessary.

Step 5: Restore Your Data

Once the installation is complete, restore your previous data using the backup file created earlier:

tsm maintenance restore -f <backup_file_name>

Reference Article: https://help.tableau.com/current/server/en-us/db_restore.htm

Note: If restoring a multi-node setup, ensure that all nodes are properly configured before restoring the backup.