KNOWLEDGE BASE

Upgrading Tableau Server on Linux Fails in 10.5 When Repository SSL Has Been Enabled


Published: 11 Apr 2019
Last Modified Date: 30 Nov 2019

Issue

Upgrading Tableau Server 10.5 on Linux Server fails if repository SSL is enabled, or has been enabled in the past.

Note: If you are considering upgrading from an older version of Tableau Server 10.5 on Linux to a newer 10.5 version, and repository SSL has ever been enabled, perform the workaround described under "Resolution" instead of a standard upgrade.

Environment

  • Tableau Server 10.5
  • Linux Server
  • Repository SSL

Resolution

 

To avoid the issue, consider following the upgrade alternative described below

These steps walk you through saving your existing data and settings, cleaning Tableau entirely off your computer, and then installing your new version and restoring your data and settings to that new installation. You need to do this instead of following the regular update process.

STEP 1 – Save your existing data and settings
 
  1. Create a backup and export the Tableau Server settings to a file. These commands will create a backup in the predefined location for backups, and a settings configuration file in your home directory:
    • tsm maintenance backup -f backup.tsbak
    • tsm settings export -f ~/config.json 
  2. Move the backup file to your home directory to prevent deletion during Tableau Server removal.
    • mv /var/opt/tableau/tableau_server/data/tabsvc/files/backups/backup.tsbak ~

For detailed instructions on backing up and restoring data and configuration settings, see Backup and Restore.
 
STEP 2 – Clean Tableau Server off your computer


Clean Tableau Server 10.5 off the computer. Do this by running the "obliterate script." For more information, see Remove Tableau Server from Your Computer. If you are running a multi-node cluster, run obliterate on all nodes.

STEP 3 – Install the new version of Tableau Server

Install your new version of Tableau Server 10.5.
  1. Install the Tableau Server package. For details, see Install Tableau Server Package.
  2. Activate and register. See Activate and Register Tableau Server.
  3. Configure your local firewall. (This step may not be necessary if you have done this previously.) For details, see Configure Local Firewall.
  4. Configure the initial node settings. For details, see Configure Initial Node Settings.
  5. Finalize the installation. Follow the steps in Finalize Installation up to "Create the initial admin user." Do not create an initial admin user.
  6. If you are running a multi-node cluster, generate a bootstrap file on the initial node, and use it when installing Tableau on the additional nodes. For details on installing a multi-node cluster, see Install Tableau Server on Additional Nodes.
 
STEP 4 – Restore your data and settings to Tableau Server
 
  1. Stop Tableau Server: tsm stop
  2. Move the backup file to the expected location: mv ~/backup.tsbak /var/opt/tableau/tableau_server/data/tabsvc/files/backups
  3. Restore the backup: tsm maintenance restore -f backup.tsbak
  4. Import the settings file: tsm settings import -f ~/config.json
  5. Apply the changes: tsm pending-changes apply
  6. Start Tableau: tsm start

Cause

This behavior is related to a known Issue, ID 887595, which prevents an upgrade of Tableau Server 10.5 on Linux if repository SSL is or has ever been enabled.

Additional Information

If you see the below error message, the installation has failed. The error message will appear at the end of the upgrade-tsm output. 
 
Upgrading repository.
Failed to upgrade repository.
Generic exception raised during installation.
java.lang.RuntimeException: Job failed. See tabadmincontroller log for details.
at com.tableausoftware.installer.operations.AsyncJobRunner.run(AsyncJobRunner.java:66)
at com.tableausoftware.installer.operations.AsyncJobRunner.run(AsyncJobRunner.java:46)
at com.tableausoftware.installer.operations.UpgradeRepositoryOperation.perform(UpgradeRepositoryOperation.java:59)
at com.tableausoftware.installer.AbstractInstaller.run(AbstractInstaller.java:205)
at com.tableausoftware.installer.AbstractInstaller.execute(AbstractInstaller.java:111)
at com.tableausoftware.installer.UpgraderMain.main(UpgraderMain.java:67
ERROR: Upgrade failed with exit code 10. See log file at /var/opt/tableau/tableau_server/logs/app-upgrade.log for details.



Discuss this article... Feedback Forum
Did this article resolve the issue?