KNOWLEDGE BASE

Troubleshooting Restoring Tableau Server


Published: 09 Apr 2019
Last Modified Date: 24 Jun 2019

Question

How to troubleshoot Tableau Server restores issues.

Environment

  • Tableau Server
  • Linux
  • Windows
  • Anti-virus

Answer

 
CLICK TO EXPAND TROUBLESHOOTING STEPS

The Restore process does not have permission to the restore folder

When using the default location, the configuration of folder permission is handled by the Tableau server installation process.
 
The default location for the restore files:
 
Operating SystemDefault Location for the backup file
WindowsC:\ProgramData\Tableau\Tableau Server\data\tabsvc\files\backups\
Linux/var/opt/tableau/tableau_server/data/tabsvc/files/backups/
CLICK TO EXPAND TROUBLESHOOTING STEPS

Reapplying folder permissions

In some organizations, Group Policy or other system management solutions are used to standardize permissions and accounts on application servers. If your organization runs a such a solution, be sure to configure the system to accommodate the folder permissions required by the Run As User account. If the folder permissions for the Run As User account have been changed, you can use Tableau Configuration Utility to reapply the permissions. See Reapplying Permissions.

CLICK TO EXPAND TROUBLESHOOTING STEPS

Using a non-default location

If the restore file location has been changed, then you will need to ensure the following permissions:

Window

Principal/AccountPermissions required
NETWORK SERVICEFull control
SYSTEMFull control
CREATOR OWNERFull control


Linux

Principal/AccountPermissions required
tableaudrwxrwx---

 

CLICK TO EXPAND TROUBLESHOOTING STEPS

Anti-virus

The use of anti-virus / end point security programs typically will require an exception created for Tableau Server as they may prevent the writing of the backup file.  Not having an exception may also impact server performance.
See Improving Performance by Using Antivirus Exclusions.

Did this article resolve the issue?