安装疑难解答

创建安装日志

Tableau Desktop 或 Tableau Prep Builder 可以保留安装过程的日志。默认情况下，Windows 和 Mac 的 Tableau 安装程序都启用了日志记录。默认情况下，日志文件存储在 Windows 和 Mac 的用户临时文件夹（环境变量中指定的位置）中。最好保留安装过程的日志文件，以帮助您在出现任何问题时进行故障排除。如果是这样，您可以查看日志文件并搜索包含或帮助您发现问题的条目。%temp%/private/var/logErrorFail

如果要更改日志文件的位置或名称，或者不确定是否启用了日志记录，请完成以下步骤。在开始安装之前，必须打开日志记录。

1. 下载安装程序 （ 文件）。.exe

2. 以管理员身份打开命令窗口。

3. 导航到下载安装程序文件的目录。

4. 运行以下命令：

   /log ""

   替换为 Tableau 安装程序文件的名称，并替换为要保存安装日志文件的文件的路径和名称。installerlog_file_path_and_name

   例如：

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

解决激活或打开 Tableau Desktop 或 Tableau Prep Builder 时出现的 FlexNet 许可错误

如果 Tableau 许可服务无法读取或访问产品密钥，您可能会看到以下错误之一：

• 未找到“TableauDesktop”的许可证

• 无法添加许可证

• 函数 flxActCommonLicSpcPopulateFromTS 返回错误 50030、 71521、 0

若要排查并解决该错误，请按显示的顺序尝试本节中的步骤。

1. 验证系统日期和时间

验证计算机上的日期和时间是否设置为当前日期。如果计算机上的时钟设置为当前日期之前的日期，则无法激活 Tableau。

2. 验证是否已安装 FlexNet 许可服务

安装 Tableau Desktop 时，将自动安装 FlexNet 许可服务。Tableau 需要此服务才能运行。在 Mac 上安装 Tableau Desktop 时，系统可能会提示您输入密码，以授予安装程序安装 FlexNet 的权限。对于 Windows，安装 FlexNet 的权限是从用户帐户设置中隐含的。

要检查计算机上是否正确安装了许可服务，请完成以下步骤：

窗户

1. 导航到以下文件夹：

   C:\Program Files\Common Files\Macrovision Shared\FlexNet 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 , the licensing service isn't installed. For information about how to manually install the FlexNet Licensing Service, see No such file or directoryError: "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

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

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

   

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

   /Applications/Tableau\ Desktop\

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 Files\Tableau\Tableau \bin"

   where 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 file: LicResults.txt

   custactutil -view >LicResults.txt

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

Mac

1. Start the Terminal application.

2. Navigate to the FlexNet directory:

   cd /Applications/Tableau Desktop

3. Enter the following command:

   ./custactutil -localrepair

4. Launch Tableau.

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

./custactutil -view > /users/

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

Troubleshoot activation errors using activation exit codes

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

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

/Users/>/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).

@echo off
start/wait tableau.exe -activate  if %errorlevel% EQU 536871018 (ECHO TABLEAU_ERROR_LICENSING_INVALID_KEY)
if %errorlevel% EQU 536871012 (ECHO TABLEAU_ERROR_LICENCING_GENERAL)
if %errorlevel% EQU 0 (ECHO SUCCESS)

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 . Search for "" to find entries related to license reporting.%Documents%\My Tableau Repository\Logs\log.txtlicUsageReport

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 key:ReportingServer

• Path: HKEY_LOCAL_MACHINE\SOFTWARE\Tableau\ReportingServer

• 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 file in and add a 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 file that's configured to send information every hour (3600 secons) to two servers, and .com.tableau.ReportingServer.plist/Library/PreferencesscheduleReportInterval.plisthttps://mytableau02:8010http://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.

• 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.