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. Prepare, create, explore, or view trusted data with subscriptions to Tableau's governed self-service analytics platform. Upgrade to Tableau Creator, a subscription offering that gives you Tableau Desktop, Tableau Prep Builder, and a choice of Tableau Server or Tableau Online. Tableau Desktop and Tableau Prep is supported in both Windows and MacOS environments. In addition, all of Tableau’s products operate in virtualized environments when they are configured with the proper underlying Windows operating system and minimum hardware requirements. These virtual solutions include Citrix environments, Parallels, and VMware. Download Tableau Desktop Professional for Mac Free. Click on below button to start Tableau Desktop Professional Download for Mac OS X. This is completely Tested and Working Latest Version Mac OS App of Tableau Desktop Professional. It is offline installer and standalone setup for Tableau Desktop Professional for Apple Macbook Macintosh. Operating Systems Windows Windows 7 or newer (64-bit) 2 GB memory 1.5 GB minimum free disk space Mac iMac/MacBook computers 2009 or newer macOS High Sierra 10.13 and macOS Mojave 10.14 1.5 GB minimum free disk space.

1. Tableau For Mac Free
2. Tableau Software Download
3. Free Tableau Download

Note: If you are looking for information about how to install Tableau Server, see the Install and Configure(Link opens in a new window) section in the Tableau Server Help instead.

This topic describes how to install and activate Tableau Desktop or Tableau Prep Builder from the user interface. For information about how to install and activate your product from the command line, see Install Tableau Desktop and Tableau Prep Builder from the Command Line(Link opens in a new window).

Before you begin

To install Tableau Desktop or Tableau Prep Builder you will need two things; a Creator product key (the key number starts with the letters TC) and the installer for the version you want to install. For information about what applications are included with a Creator product key, see the Tableau Pricing(Link opens in a new window) page.

Where's the installer?

Important: Starting with version 10.5, Tableau Desktop, Tableau Reader, and Tableau Public (desktop) only run on a 64-bit operating system. Tableau Prep Builder is only available for a 64-bit operating system. If you want to install Tableau Desktop on a 32-bit operating system, open the Product Downloads and Release Notes(Link opens in a new window) page and download the installer for version 10.4 or earlier and follow the install instructions in the Tableau Desktop Deployment(Link opens in a new window) guide for that version.

For the most current version of Tableau Desktop or Tableau Prep Builder, go to the Customer Portal(Link opens in a new window) page. In the Product Downloads section, click the appropriate link to download the installer for your product and operating system.

You can also find the installers for all products and versions on the Product Downloads and Release Notes(Link opens in a new window) page.

1. Open the Product Downloads and Release Notes(Link opens in a new window) page and select Tableau Desktop or Tableau Prep Builder from the list on the left side of the page.

2. Click on the version you want to install.

3. In the Download Files section of the page, click on the installer for your operating system to download it.

Where's my product key?

You need your product key to activate Tableau Desktop and Tableau Prep Builder after the install process is finished. If you have a creator license, the same key activates both Tableau Desktop and Tableau Prep Builder. You can always view your product key in the Customer Portal(Link opens in a new window). For more information about license types, see User-Based licenses(Link opens in a new window) in the Tableau Server help.

Note: If you have trouble signing in to the Customer Portal page, or if you need help retrieving your product key, contact Customer Service(Link opens in a new window) and provide your name, company, phone number, and email address.

As a first time user

1. Sign in to the Customer Portal(Link opens in a new window) page on the Tableau website using your email address and password. The information you need to sign into the portal for the first time is sent to you in a welcome email from Tableau after you purchase(Link opens in a new window) the product.

2. At the top of the Tableau Customer Portal page, click My Keys.

3. A table opens, listing any product keys assigned to you. Copy your product key from the Key Name column in the table. Keep this key ready and secure.

   Note: This example does not show any actual keys. The highlighted area shows where your key would be listed.

As an existing user

1. Open your existing version of Tableau Desktop or Tableau Prep Builder.

2. From the top menu, click Help > Manage Product Keys.

3. Copy your product key from the Product Key column in the table. Keep this key ready and secure.

   If you are not able to open the Manage Product Keys dialog to see your key, log into the Customer Portal(Link opens in a new window) and follow the instructions for first time users above.

If you don't have a product key, try the 14-day Free Trial(Link opens in a new window) or download the Tableau Desktop Public Edition(Link opens in a new window) instead. If you are a student or teacher, go to the Academic programs(Link opens in a new window) page to request a license and receive instructions about how to download your copy of Tableau Desktop or Tableau Prep Builder.

Install the product

Download the installer using the instructions in Where's the installer? For Mac, the installer is downloaded to your Downloads folder.

Note: The installer detects and displays the user interface based on the operating system display language setting.

If you're using a deployment tool that requires the Windows installer (.msi file) to install Tableau Desktop or Tableau Prep Builder, follow the instructions in Extract and run the Windows (MSI) installer to extract the .msi file from the Tableau installer .exe file.

Click the tab for the product you are installing to view the installation steps.

1. As an Administrator, log in to the computer where you are installing Tableau Desktop.

2. Depending on your operating system, do one of the following:

   • For Windows: Run the installer and follow the prompts.

   • For Mac: Open the Disk image file (.DMG) and double-click the installer package (.PKG) to start the installation.

   Drivers for some data sources are installed automatically when you install Tableau Desktop. See the Database drivers installed with Tableau Desktop and Tableau Prep Builder section in the Before You Install topic for specifics.

3. To enable or disable usage reporting complete the following steps for your operating system.

   This option allows us to gather usage pattern data to improve the product. For more information about this option and how to turn it off after installation, see Turn off usage reporting.

   Windows

   • To opt out of providing usage data, select the Don't send product usage data check box.

   Mac

   • On the Installation Type step, in the bottom-left of the install wizard, click Customize. To opt out of sending product usage data, select the Don't send product usage data check box.

     On the Mac you can also change the settings on this page to customize your install.

     Note: Starting in Tableau Desktop version 2019.4, only the PostgreSQL driver is installed automatically on the Mac. If you need other database drivers, you can install them from the Driver Download(Link opens in a new window) page.

4. (Optional) On Windows, to customize the install, on the Install welcome screen, click Customize and change any of the following options:

   • Install location: Specify a different location to install Tableau Desktop.

     Important: If you specify a custom directory for the install location and plan to install future releases to this same location, you need to specify a version specific sub-folder to install to. Otherwise you will need to uninstall the previous version first. Side-by-side installs of multiple versions in the same sub-directory is not supported.

   • Create a desktop shortcut: Clear the check box if you don't want to automatically create a desktop shortcut for Tableau.

   • Create a Start menu shortcut: Clear the check box if you don't want to automatically add a shortcut for Tableau to the Start menu.

   • Check for Tableau product updates: Clear the check box if you want to disable the product update feature. This feature checks for maintenance updates and installs them automatically. If you disable this option at install it also disables the menu option for users. For more information about the product update feature, see Control Product Updates for Tableau Desktop.

   • Install database drivers: Clear the check box if you don't want to automatically install the database drivers. You can also disable one or more of the drivers from the command line. For more information about this option, see Installer properties(Link opens in a new window).

5. Click Install to begin installation. If you run into any difficulties, see Troubleshoot Your Tableau Desktop or Tableau Prep Builder Installation.

After installation is complete, you will need to activate and register the product to begin using it. For more information, see Activate and register your product.

Important: Tableau Prep Builder is designed to work with Tableau Desktop. It is recommended that you install Tableau Prep Builder on the same machine as Tableau Desktop.
Do not install Tableau Prep Builder on the same computer running Tableau Server. Tableau Server Resource Manager (SRM) can't distinguish between Tableau Server protocol server process and Tableau Prep Builder protocol server process. If the computer resources are exhausted, SRM may terminate the protocol server process belonging to Tableau Prep Builder, which has no recovery mechanism.

1. As an Administrator, log in to the computer where you are installing Tableau Prep Builder.

2. Depending on your operating system, do one of the following:

   • For Windows: Run the installer and follow the prompts.

   • For Mac: Open the Disk image file (.DMG), and then double-click the installer package (.PKG) to start the installation.

3. When prompted, accept the licensing agreement to continue the installation.

4. To enable or disable usage reporting complete the following steps for your operating system.

   This option allows us to gather usage pattern data to improve the product. For more information about this option and how to turn it off after installation, see Turn off usage reporting.

   Windows

   • To opt out of providing usage data, select the Don't send product usage data check box.

   Mac

   • On the Installation Type step, in the bottom-left of the install wizard, click Customize. To opt out of sending product usage data, select the Don't send product usage data check box.

5. (Optional) To customize the install, on the Install welcome screen for Windows or on the Installation Type step for the Mac, click Customize and change any of the following options:

   Windows

   • Install location: Specify a different location to install Tableau Prep Builder.

   • Create a desktop shortcut: Clear the check box if you don't want to automatically create a desktop shortcut for Tableau Prep Builder.

   • Create a Start menu shortcut: Clear the check box if you don't want to automatically add a shortcut for Tableau Prep Builder to the Start menu

   • Enable error reporting : If Tableau Prep Builder has a problem and shuts down unexpectedly, crash dump files and logs are generated and placed in your My Tableau Prep Builder Repository > Logs and My Tableau Prep Builder Repository > Logs > crashdumps files.

     To turn off this option during install, clear this check box during install. To turn this option off after installation see Turn off error reporting(Link opens in a new window).

   • Install database drivers: Clear the check box if you don't want to automatically install the database drivers.

     Important:Tableau Prep Builder is only available in 64-bit and If you already have 32-bit drivers installed, you'll need to install the 64-bit version of those drivers to connect to your data with Tableau Prep Builder.

   Mac

   • Create a desktop shortcut: Select the check box to automatically create a desktop shortcut for Tableau Prep Builder.
   • Don't send product usage data Select the check box to opt out of sending product usage data.
   • Enable crash recovery (version 2020.3.3 and later): Clear the check box to turn off file recovery. In the event of a crash, flow files won't automatically be saved. For more information about managing this option post-install, see Turn off file recovery.

   • PostgreSQL database driver: Clear the check box if you don't want to automatically install the database driver.

     Note: Starting in version 2019.4.1, only the PostgreSQL driver is installed automatically on the Mac. If you need other database drivers, you can install them from the Driver Download(Link opens in a new window) page.

6. Click Install to begin the product installation.

Activate and register your product

Important: The Tableau licensing service was moved to a new data center on October 6, 2018. This means that any environments that required special configuration (static IP safe listing for example) to access licensing.tableau.com or licensing.tableau.com will need to be updated. For more information, see Tableau Community(Link opens in a new window).

After the installation process is finished, the next step is to register and activate your product. Use one of the following options:

• From the user interface: Follow the instructions in this topic. You'll need the product key that you saved earlier. If the computer where you're installing the product has internet access, the installation process walks you through activating the product.
• From the command line: For instructions, see Activate Tableau Desktop and Tableau Prep Builder(Link opens in a new window) and Register Tableau Desktop and Tableau Prep Builder(Link opens in a new window).
• Using Login-based license management: If you are using Tableau Server with a login-based license management enabled product key, you can activate Tableau Desktop and Tableau Prep Builder with one click. For more information, see Login-based License Management(Link opens in a new window).

• Install offline: If you're installing the product on a computer that doesn't have internet access, or if your company firewall or proxy restricts access to the licensing.tableau.com site, follow the additional instructions in Activate your product offline to complete the activation process. To activate Tableau Prep Builder offline, you must use Tableau Desktop.

1. After the installation process is finished, open Tableau Desktop. This launches the Tableau Registration form where you can register and activate your product.

2. Fill out the fields on the registration form and then click Activate Tableau.

   If you are activating Tableau Desktop as a trial, click Start trial now at the bottom of the screen.

3. Select one of the following options:

   • Activate with a product key: Use this option if you are activating using the user interface and have a product key.

   • Activate by signing into a server:Use this option if you are using login-based license management to activate your product.

4. If you are activating with a product key, delete any existing text in the Enter product key field, copy your product key (from the location that you saved it to from the Where's my product key? procedure) and paste it into the text box, then click Activate.

   A second screen appears to complete the activation process. Click Continue to finish the process.

   If Tableau can't connect to the site that authenticates that product key, it can't complete the activation and you must activate the product offline. Follow the instructions in Activate your product offline to complete the activation process.

5. If you are activating using login-based license management enter the URL for your server and click Connect.

   Sign into your server, then complete the registration page if needed, and click Register.

Tableau For Mac Free

1. Launch Tableau Prep Builder.

2. In the Activation page, select one of the following options:

   • Start a trial: Select this option if you don't have a product key but want to try Tableau Prep Builder.
   • Activate with a product key: Use this option if you are activating using the user interface and have a product key.
   • Activate by signing in to a server: Use this option if you are using login-based license management to activate your product.
   • Purchase a license: Select this option to navigate to the Tableau website to purchase a license.

3. If you are activating with a product key, delete any existing text in the Enter product key field, copy your product key (from the location that you saved it to from the Where's my product key? procedure) and paste it into the text box, then click Activate.

4. Complete the registration form, and then click Register.

5. If you are activating using login-based license management enter the URL for your server and click Connect.

   Sign into your server, then complete the registration page if needed, and click Register.

When your registration is complete, Tableau Prep Builder opens and you can start preparing your data.

New to Tableau Prep Builder? Try the Get Started tutorial(Link opens in a new window) to learn how to build your first flow.

Activate your product offline

Note: If you're upgrading versions and you've paid your maintenance (Tableau Desktop only) since the last time offline activation was completed, contact Tableau Customer Service(Link opens in a new window) via email to get an updated product key before continuing with offline activation.

If you're installing the product on a computer that doesn't have internet access, or if your company firewall or proxy restricts access to the licensing.tableau.com site, then you must complete the steps below to finish activating your product. You will need access to another computer that has internet access to complete all the steps in this procedure.

To activate Tableau Prep Builder offline, you will need your product key and Tableau Desktop version 2018.1 or later installed on the same computer that is offline.

1. In the Activate Tableau dialog, click Activate.

2. Tableau prompts you to save a file that you can use for offline activation. Click Save.

   Note: If you're performing the offline activation process because of firewall or proxy restrictions, you might not be prompted to save the activation file. In that case, manually disconnect the computer from the network and then restart this procedure so that you can be prompted to save the activation file.

3. Save the file to a location that you can reach from a computer that does have internet access. Use the default file name (offline.tlq).

4. Click Exit.

5. From a computer that has internet access, open a web browser and go to the Activation(Link opens in a new window) page on the Tableau website.

6. Complete the instructions for Offline Activation to submit your offline.tlq file and create a activation.tlf file.

7. Save the activation.tlf file and then copy it to the computer where you installed Tableau Desktop.

8. On the offline computer, double-click the activation.tlf file to perform the offline activation.

1. Launch Tableau Desktop.

2. From the top menu, select Help > Manage Product Keys.

3. In the Manage Product Keys dialog, click Activate.

4. Enter your Tableau Prep Builder product key and then click Activate.

5. Tableau Desktop detects that you are offline and shows the following message. Click Save to create an activation file.

6. Save the file to a location that you can access from the offline computer. Use the default file name (offline.tlq).

7. From a computer that has internet access, open a web browser and go to the Activation(Link opens in a new window) page on the Tableau website.

8. Follow the instructions and select the (offline.tlq) file that you just created and upload it to create a create a activation.tlf file. You will need this file to activate Tableau Prep Builder.

9. Click Upload Activation File. You should receive a confirmation dialog that the upload was successful.

10. In the confirmation dialog click the link to download the activation file to complete the activation process.

11. Copy the activation.tlf file to the computer where you installed Tableau Prep Builder.

12. On the offline computer, double-click the activation.tlf file to perform the offline activation.

13. Close Tableau Desktop.

14. Launch Tableau Prep Builder. You will be prompted to complete the registration process form to register the product. If you have previously registered a Tableau product, the fields may be populated automatically.

Change default settings

During installation, Tableau configures default settings for your display language and repository location. If you want to change those settings you can do this after install is complete.

Tableau also enables certain features for you by default such as usage reporting or automated product updates (Tableau Desktop only). For information about how to turn off these features and more, see Change Installation Settings after Installation(Link opens in a new window).

Set your display language (optional)

When you first run Tableau Desktop or Tableau Prep Builder, it recognizes your computer locale using the User Locale setting and uses the appropriate language if it is supported. If you are using an unsupported language, the application defaults to English.

You can configure Tableau Desktop or Tableau Prep Builder to display the user interface (menus, messages, etc.) in a different language by selecting Help > Choose Language from the top menu. Restart the application to apply the change.

For Tableau Prep Builder, the display format for numbers and dates is based on the locale of the operating system on the machine where the application is installed. For Tableau Desktop you can configure date and number formatting for your workbooks. For more information see Language and Locale(Link opens in a new window) in the Tableau User help.

Change your My Tableau Repository location (optional)

During install, Tableau Desktop and Tableau Prep Builder automatically creates a My Tableau <application> Repository folder structure in your documents folder on your computer. If you need to move this repository to another location, for example because you are required to have your data on a network server instead of on your local machine, you can specify a new location and point Tableau Desktop or Tableau Prep Builder to the new folder.

When setting a new location for your repository, the following rules apply:

• The new folder must be a directory.

• You must have permissions to write to the new folder.

• The new folder can't be located in the existing My Tableau Repository folder structure.

Note: Changing the repository location does not move the files contained in the original repository. Instead, Tableau creates a new repository where you can store your files.

1. Open Tableau Desktop or Tableau Prep Builder.

2. From the top menu, select File >Repository Location.

3. In the Select Repository Folder dialog, select a new folder that will act as the new repository location.

4. Restart the application to use the new repository.

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 create a log file to help you troubleshoot, as well as a list of issues you might encounter and suggestions for how to resolve them.

Create an installation log

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.

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-2019-1-0.exe /log 'C:UsershenrywDesktopinstall.txt'.

Resolve FlexNet licensing errors when activating or opening Tableau Desktop or Tableau Prep Builder

If the Tableau licensing service can't read or access the product key, you might see one of the following errors:

• No license found for 'TableauDesktop'

• Unable to add license

• Function flxActCommonLicSpcPopulateFromTS returned error 50030, 71521, 0

To troubleshoot the error and resolve it, try the steps in this section in the order shown.

1. Verify the system date and time

Verify that the date and time on your computer is set to the current date. If the clock on your computer is set to a date prior to the current date, Tableau can't be activated.

2. Verify that the FlexNet Licensing Service is installed

When you install Tableau Desktop, the FlexNet Licensing Service is installed automatically. Tableau requires this service to run. When you install Tableau Desktop on the Mac, you might be prompted to enter your password to give the installer permission to install FlexNet. For Windows, permission to install FlexNet is implied from the user account settings.

To check whether the licensing service is properly installed on your computer, complete the following steps:

Windows

1. Navigate to the following folder:

   C:Program FilesCommon FilesMacrovision SharedFlexNet Publisher

2. Verify that the FNPLicensingService application is in the folder.

   If the FlexNet licensing Service is not installed, try reinstalling Tableau Desktop or check your user account permissions settings.

Mac

1. Start the Terminal application.

2. Type the following command to list the contents of the FlexNet directory:

   ls '/Library/Application Support/FLEXnet Publisher/Service/11.16.2/FNPLicensingService'

   If the command doesn't return anything, or if it returns the message No such file or directory, the licensing service isn't installed. For information about how to manually install the FlexNet Licensing Service, see Error: 'The FlexNet licensing service is not present on the system' Activating on Mac(Link opens in a new window) in the Tableau Knowledgebase.

3. Verify that the FlexNet Licensing Service is running

If you have verified that the FlexNet Licensing Service is installed, verify that the licensing service is running. If it isn't, you might need to manually start the service. To start the service, complete the steps below based on your operating system, and then restart Tableau Desktop.

Windows

1. From the Windows Start menu, open services.msc.

2. In the Services dialog box, verify that the status for the FlexNet Licensing Service is Started.

   If the Start option is grayed out, right-click FlexNet Licensing Service in the list and select Properties. On the General tab, click Start, then click OK to close the dialog box.

Mac

1. Start the Terminal application.

2. Navigate to the FlexNet directory:

   '/Applications/Tableau Desktop <Tableau version.app>/Contents/Frameworks/FlexNet/'custactutil -view

   For example '/Applications/Tableau Desktop 2019.1.app/Contents/Frameworks/FlexNet/'custactutil -view

3. Verify that the FlexNet Licensing Service is running. You should see Trust Flags = FULLY TRUSTEDand Status = ENABLED.

4. Then use the following command to save the output to a file on your desktop:

   /Applications/Tableau Desktop <Tableau version.app>/Contents/Frameworks/FlexNet/custactutil -view > /users/$(whoami)/Desktop/licresults.txt

4. Repair trusted storage

If FlexNet Licensing Services is installed and running but you're still seeing an error, there might be a problem with the Tableau product key information. To resolve this issue, complete the following steps to repair the key information that is located and saved in trusted storage.

Note: You will need access to the Customer Activation Utility located in the bin folder to perform these steps.

Windows

1. Open a command window and navigate to the directory where the Customer Activation Utility is. For example:

   cd 'C:Program FilesTableauTableau <version>bin'

   where <version> is the Tableau product version that you installed.

2. Type the following command:

   custactutil –localrepair

3. Launch Tableau.

   If the repair is not successful, type the following command to create a LicResults.txt file:

   custactutil -view >LicResults.txt

   Contact Technical Support(Link opens in a new window) and include the LicResults.txt file that you created.

Mac

1. Start the Terminal application.

2. Navigate to the FlexNet directory:

   cd /Applications/Tableau.app/Contents/Frameworks/Flexnet

3. Enter the following command:

   ./custactutil -localrepair

4. Launch Tableau.

If the repair is not successful, type the following command to create a LicResults.txt file:

./custactutil -view > licresults.txt

Contact Technical Support(Link opens in a new window) and include the LicResults.txt file that you created.

Troubleshoot activation errors using activation exit codes

When you start Tableau and include the -activate option, the activation process returns status information by setting the ERRORLEVEL environment variable to an exit code. If activation was successful, the Tableau application exit code is 0 (zero). The table below lists exit codes from the activation process and what they mean.

If activation fails, you can also find error information in the Tableau log file. Log files are located in the Logs folder in the My Tableau Repository folder under the current user’s Documents folder. For example:

/Users/<user>/Documents/My Tableau Repository/Logs

The following example script shows how to activate Tableau Desktop for Windows and check for specific errors, such as an invalid product key (536871018) and general licensing issues (536871012).

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 license requests. If you encounter one of the following errors, the administrator for the organization'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 Internet Access Requirements.

Troubleshoot accessing the licensing server

The Tableau licensing service was moved to a new data center on October 6, 2018. This means that any environments that required special configuration (static IP safe listing for example) to access licensing.tableau.com or licensing.tableau.com will need to be updated before you can activate, refresh, or deactivate a Tableau product key.

To check whether this is the problem:

1. In a web browser, navigate to the following addresses:

   • https://licensing.tableau.com

   • https://licensing.tableau.com

     You should see a 'Test success.' page.

2. If you don't see the success page, you may need to update your local environment to access the licensing services. For more details, see the Tableau Community(Link opens in a new window).

Troubleshoot license reporting (Tableau Desktop only)

When Tableau Server and Tableau Desktop instances are properly configured, Tableau Desktop license usage information is available in two administrative views, Desktop License Usage(Link opens in a new window) and Desktop License Expiration(Link opens in a new window). If you can't see these views, or if there's no data in them, there might be a problem with license reporting. The sections below can help you troubleshoot the cause.

For information about how to configure Tableau Desktop reporting, see Manage Tableau Desktop License Usage.

Administrative views aren't available

The Desktop License Reporting administrative views are available only to Tableau Server administrators. If you don't see links to the Desktop License Usage and Desktop License Expiration views on the Server Status page (select Manage All Sites from the Sites menu), verify the following:

• You are signed in as a Tableau Server administrator.

• You are running a version of Tableau Server 10.0 or later, and users are running Tableau Desktop version 10.0 or later. Tableau Desktop license reporting is available beginning with version 10.0 of Tableau Server and Tableau Desktop.

• License reporting is enabled in Tableau Server. (The feature is disabled by default.) For more information, see the procedure for enabling license reporting on Tableau Server in the Manage Tableau Desktop License Usage article in this guide.

Administrative views don't include expected content

If you aren't seeing the data you expect, it could be for one of the reasons listed here.

Tableau Desktop was configured less than eight hours ago

By default Tableau Desktop reports licensing data at an eight hour interval. You might not see usage data in the administrative views if it has been less than eight hours since instances of Tableau Desktop were configured for reporting. Tableau Desktop reports every eight hours while running with the count of hours beginning when you start a properly configured instance of Tableau Desktop.

If Tableau Desktop is not still running when the eight hour time is reached, a report is sent the next time Tableau Desktop is started. Wait a minimum of eight hours after Tableau Desktop instances are configured before you look for those licenses in the Desktop License Reporting views.

The following events force an immediate report from a properly configured Tableau Desktop instance to Tableau Server:

• Activating Tableau Desktop version 10.0 or later.

• Deactivating Tableau Desktop version 10.0 or later.

• Renewing maintenance on a license for Tableau Desktop version 10.0 or later.

Tableau Desktop has not been restarted since license reporting was configured

If Tableau Desktop was already running when license reporting was configured with a server address to report to, Tableau Desktop must be restarted.

Tableau Desktop has not been opened since being configured for license reporting

If Tableau Desktop has not been opened since being configured for reporting, you might not see usage data in the administrative views. License information is reported only when Tableau Desktop is running.

Tableau Desktop is incorrectly configured for license reporting

Verify that instances of Tableau Desktop are configured correctly with the address of the Tableau Server to report to.

Use log files on the Tableau Desktop computer to help determine if the instance is configured correctly. Find the log file %Documents%My Tableau RepositoryLogslog.txt. Search for 'licUsageReport' to find entries related to license reporting.

Error messages for license reporting

The following table lists log messages that can help identify issues with license reporting.

Changing the default reporting interval

By default, when configured for Desktop License Reporting, Tableau Desktop reports to the configured server or servers every eight hours. You can modify the registry or .plist file on Tableau Desktop computers to change this interval. This is especially useful for troubleshooting.

Windows

To change the frequency that Tableau Desktop reports to the server from a Windows computer, edit the registry to add a string value to the ReportingServer key:

• Path: HKEY_LOCAL_MACHINESOFTWARETableauReportingServer

• Name: add a string value named scheduleReportInterval.

• Data: The amount of time, in seconds, between reports sent by Tableau Desktop to the server. By default this is 8 hours and if there is no entry the default is used. Increase this for troubleshooting if necessary, but keep in mind that the more frequent the interval, the more network traffic generated.

  For example, the following image shows a registry configured so Tableau Desktop reports to the configured Tableau Servers every hour (3600 seconds):

Mac

To change the frequency that Tableau Desktop reports to the server for Mac, edit the com.tableau.ReportingServer.plist file in /Library/Preferences and add a scheduleReportInterval key. Set this to the length of time, in seconds, between reports from Tableau Desktop to the configured Tableau Server. The following example shows the contents of a .plist file that's configured to send information every hour (3600 secons) to two servers, https://mytableau02:8010 and http://mytableau.

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.

Tableau Software Download

• 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 analyzing. 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 optimize your workbook performance, see Optimize 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.

Free Tableau Download