Tableau Deployment Guide

When you install Tableau Desktop or Tableau Prep Builder, the installation might not always go exactly as planned. In this article, you can find information about how to troubleshoot issues you might encounter and suggestions for how to resolve them.

Search the Support Knowledge Base

To help you find the answer to your questions quickly, you can search the Tableau Knowledge Base. The Knowledge Base contains troubleshooting techniques you can use to fix issues, describes known issues that have been resolved and provides answers to frequently asked questions.

1. To search for troubleshooting articles, go to Knowledge Base.
2. Type in a description.
3. On the Support page, choose Knowledge Base from the Source tab.

Repair an installation (Windows only)

A repair of an installation is the process of installing a new build of the same version over the existing installation. Repairing an installation keeps the software in a working state by overwriting changed files and reinstalling missing files.

To run a repair of an installation:

1. Go to Control Panel > Programs > Programs and Features.
2. Select the Tableau program from the list.
3. Right-click Uninstall/Change.
4. In the Modify Setup window that appears, click Repair and allow the repair process to finish.

Create an installation log

If you are working with Tableau Support, they may request log files from your installation. Tableau Desktop or Tableau Prep Builder can keep a log of the installation process. Logging is on by default for the Tableau installer for both Windows and Mac. By default, the log files are stored in the user's temporary folder (the location specified in the %temp% environment variable) for Windows and in /private/var/log for the Mac. It's a good idea to keep the log files for the installation process to help you troubleshoot in case anything goes wrong. If so, you can review the log file and search for entries that include Error or Fail to help you spot the problem.

Note: When logging at the DEBUG level, full environment information is gathered when Tableau starts. This means that if you have any sensitive information in an environment variable, it may be included in a log. Logging at the default INFO level only gathers safe environment information.

If you want to change the location or name of the log files, or if you're not sure if logging is enabled, complete the following steps. Logging must be turned on before you start installation.

1. Download the installer (.exe file).

2. Open a command window as an administrator.

3. Navigate to the directory where you downloaded the installer file.

4. Run the following command:

   <installer> /log "<log_file_path_and_name>"

   Replace installer with the name of the Tableau installer file and replace log_file_path_and_name with the path and name of the file where you want the installation log file to be saved.

   For example:

   tableauDesktop-64bit-2021-3-1.exe /log "C:\Users\henryw\Desktop\install.txt".

Troubleshoot internet errors

Tableau Desktop and Tableau Prep Builder require certain firewall and proxy settings to load map views, to load web pages and to process licence requests. If you encounter one of the following errors, the administrator for the organisation's network needs to make changes to the network web proxy and firewall configuration settings.

• The licensing process requests offline activation.

• Map views appear blank in Tableau Desktop.

• Web pages in dashboards fail to load.

• The online map can't be loaded.

For information about how to configure internet access for Tableau Desktop, see Required Addresses, Proxies and Ports

Resolve memory errors

If Tableau runs out of memory on the computer, it displays an out-of-memory error. The following factors can impact memory when using Tableau Desktop or Tableau Prep Builder.

• The Tableau Desktop version.

  • If you install 64-bit Tableau Desktop on a 64-bit Windows operating system, Tableau can access up to 8 TB of system memory.

• The size and type of data you're analysing. For example, a large crosstab with many columns and millions of rows of values, or a view that shows many marks, can quickly exhaust memory.

• Other applications running on the computer.

• The operating system on the computer.

Possible resolutions

To address out-of-memory issues, consider upgrading your operating system or Tableau version to a 64-bit computer. This lets Tableau access a larger amount of system memory.

You can also review the data in your workbooks and how you're aggregating that data when you display it in views. Instead of displaying many rows of values, which might require lots of scrolling to review the data, consider displaying summary data. Tableau Desktop is more effective and uses less memory when the data in the view presents the bigger picture, and instead allows you and others to drill down into specific areas to view the details.

For more information about how to optimise your workbook performance, see Optimise Workbook Performance(Link opens in a new window) in the Tableau Help.

Troubleshoot opening or saving files on a Dell computer (Tableau Desktop only)

If you installed Tableau Desktop on a Dell computer and that computer has an older version of the Dell Backup and Recovery (DBAR) application installed, Tableau might close unexpectedly when you try to open or save a workbook or try to access a data source. This is because the Dell Backup and Recovery software interferes with the open and save operations for the 64-bit version of Tableau Desktop. For information about how to resolve this issue, see the Error "Tableau has stopped working" Opening or Saving a File on a Dell Computer(Link opens in a new window) article in the Tableau Knowledge Base.

Troubleshoot maintenance updates (Tableau Desktop only)

Tableau provides maintenance updates at regular intervals for all currently supported versions of Tableau Desktop. The following table lists reasons why maintenance updates might not be installed on a specific installed version of Tableau Desktop.