Windows 版 Tableau Server 帮助

安装日志将写入正在运行安装程序的用户帐户的 \Temp 目录。大多数情况下，此目录位于 C:\Users\<user>\AppData\Local\Temp。

若要确定已登录用户的 \Temp 目录位置，请在 Windows 命令提示符中运行以下命令：ECHO %Temp%。

安装程序未提示输入安装位置

首次安装 Tableau Server 时，系统会提示您输入所需的安装位置。如果未看到此提示，则可能有以前安装中的遗留文件或目录，即使您卸载了 Tableau 也是如此。若要完全移除 Tableau 版本 2018.2 或更高版本的所有痕迹，请运行 tableau-server-obliterate.cmd 脚本，然后重新启动计算机并再次尝试安装。如果以前安装的版本早于 2018.2，请在重新运行安装程序之前手动删除所有 Tableau 相关文件夹。

重要信息：如果创建了要保留的 Tableau 的备份 (<file>.tsbak)（举例来说，用于还原到新安装），请将该文件复制到另一台计算机上的安全位置，以保证其在您清理 Tableau 计算机时不会被移除。

安装程序不会重新启动 Windows

安装 Tableau Server 时，安装程序可能会提示您在安装结束时重新启动 Windows。在某些情况下，单击“重新启动”不会重新启动计算机。 当第三方组件安装程序请求重新启动 Windows 时，可能会发生这种情况。

如果单击“重新启动”未重新启动 Windows，请通过手动重新启动 Windows 来完成安装。

TSM 安装失败，并出现“初始化失败”错误

如果尝试安装 Tableau Server，并且安装失败且出现以下错误：

Tableau server initialization failed
See install log at C:\ProgramData\Tableau\Tableau Server\logs

这可能与计算机上的一个权限问题相关。用户登录到 Windows，而安装 Tableau 必须具有对 C 驱动器、C:\Windows 和 C:\Windows\System32 文件夹以及 cmd.exe 文件的管理员权限。即使您未将 Tableau 安装在 C 驱动器上，情况也是如此。

有关详细信息，请参见 Tableau 知识库(链接在新窗口中打开)。

TSM 初始化屏幕不显示

安装或升级 Tableau Server 时，如果浏览器打开但未显示任何内容，则您可能需要将主机名添加到可信站点列表。或者，清除浏览器缓存或使用其他浏览器。有关详细信息，请参见 Tableau Server 知识库(链接在新窗口中打开)。

多次尝试安装均失败

如果尝试安装 Tableau Server 并且安装失败，则任何后续的安装尝试都可能会失败，除非您运行 tableau-server-obliterate.cmd 脚本将 Tableau 清理出计算机。

重要信息：必须从 64 位命令提示符中运行 tableau-server-obliterate.cmd 脚本。例如，在 C:\Windows\System32 文件夹中运行 cmd.exe。如果从 32 位命令提示符中运行脚本，脚本将不会完全移除 Tableau，并且后续的安装可能会失败。若要确定您是否在运行 64 位命令提示符，请在命令窗口中键入 echo %processor_architecture%。如果结果包括“64”（例如 AMD64），则命令提示符为 64 位提示符。如果结果包括“x86”，则正在运行 32 位提示符。有关详细信息，请参阅适用于您的 Windows 版本的 Microsoft 文档。

失败的安装尝试可能会使计算机处于一种会导致后续尝试也失败的状态，而错误看起来似乎并不与以前的安装尝试直接相关。

若要修复此问题，请运行 tableau-server-obliterate.cmd 脚本清理以前的安装尝试的任何遗留内容，然后重新启动计算机。有关详细信息，请参见运行 tableau-server-obliterate 脚本。

重要信息：如果创建了要保留的 Tableau 的备份 (<file>.tsbak)（举例来说，用于还原到新安装），请将该文件复制到另一台计算机上的安全位置，以保证其在您清理 Tableau 计算机时不会被移除。

Obliterate 脚本生成错误：“refresh-environment-variables.cmd”不是内部或外部命令

如果使用控制面板来卸载 Tableau Server，然后运行 tableau-server-obliterate.cmd 脚本从计算机中完全移除 Tableau，脚本可能会生成有关 refresh-environment-variables 的错误。之所以出现此错误，原因是 obliterate 脚本调用的另一个脚本未移到 temp 目录。您可以忽略此错误。

安装由于硬件要求而失败

如果要进行安装的计算机未满足最低硬件要求，则 Tableau Server 无法安装。这些要求适用于您在其上安装 Tableau Server 的所有计算机。有关最低硬件要求的详细信息，请参见 Tableau Server 的最低硬件要求和推荐配置。

安装由于 CPU 要求而升级失败

从版本 2020.4.0 开始，Tableau Server 要求有支持 SSE4.2 和 POPCNT 指令集的 CPU。您无法在 CPU 不支持这些指令集的计算机上安装或升级 Tableau Server 2020.4.0 或更高版本。

在进行新安装时，或在准备升级现有安装时，可能会看到此错误消息： 

Your computer’s processor doesn’t meet the minimum requirements that Tableau requires to install the software. If you are using a VM, make sure Processor compatibility mode is off.

SSE4.2 和 POPCNT 指令集已经流行了 10 多年，大多数较新的 CPU 都支持它们，但如果您在尝试在虚拟机 (VM) 上安装或升级 Tableau Server 时遇到与处理器最低要求相关的错误，则可能会在 VM 上启用处理器兼容模式。若要在 VM 上成功安装或升级 Tableau，请确保关闭处理器兼容模式。

升级日志位置

默认情况下，升级日志 app-upgrade.log 会写入到 C:\ProgramData\Tableau\Tableau Server\logs。

错误：未能与 Active Directory 建立连接

从 Tableau 版本 2021.2 开始，Tableau Server 不再允许与 Active Directory 的不安全连接。如果您当前的 Tableau Server 实例正在通过非加密通道与 Active Directory 通信，则升级将失败。

若要解决此问题，请执行以下步骤之一：

• 调查并解决失败的安全连接。请参见 Microsoft 主题 LDAP over SSL 连接问题(链接在新窗口中打开)。

• 在升级之前，运行以下命令以允许在当前版本的 Tableau Server 上使用不安全的连接：

  tsm configuration set -k wgserver.domain.allow_insecure_connection -v true --force-keys

  tsm pending-changes apply

  升级完成后，建议您保护通道，然后将此选项设置为 false。

  注意：默认情况下（当 wgserver.domain.allow_insecure_connection 设置为 false 时），如果与 Active Directory 的通信通道未加密，则 Active Directory 组同步将失败。

升级后地图不显示或显示不完整

从 Tableau 版本 2019.2 开始，地图的 Internet 访问要求发生了变化。如果要从版本 2019.1.x 或更低版本升级到版本 2019.2.x 或更高版本，并且地图未按预期显示，请确认您的环境已配置为在端口 443 上允许 mapsconfig.tableau.com 和 api.mapbox.com。

在版本 2019.1.x 或更低版本中，需要访问 maps.tableausoftware.com。

有关 Internet 访问要求的更多详细信息，请参见与 Internet 通信。

升级脚本错误:“Tableau Server Version change validation failed.”（Tableau Server 版本更改验证失败。）

进行升级时，如果从以前版本的 scripts.<version_code> 目录中运行 upgrade-tsm 脚本，升级将会失败，并出现错误：

Tableau Server Version change validation failed.
Tableau Server <version> is already installed.

如果您遇到此错误，则更改为刚刚安装的版本的 scripts.<version_code> 目录，并从该目录中运行脚本。

升级多节点，初始化附加节点失败，并出现“再次输入您的凭据”错误

如果在升级 Tableau Server 时尝试初始化附加节点并看到以下错误：

Enter your credentials again. The credentials you enter must provide administrative access to the computer where you generated the configuration file.

这表明节点无法连接到初始节点或与之通信。发生此错误的原因有多种：

• 您输入的凭据无效或者凭据键入错误。凭据必须是在首次安装 Tableau Server 的计算机上具有管理权限的用户的凭据。您无需使用创建了引导程序的用户的凭据，但使用该凭据将确保您使用的是有效的凭据。

• 您尝试添加的计算机的本地防火墙不允许与初始节点通信。有关详细信息，请参见本地防火墙配置。

升级由于缺少磁盘空间而失败

如果磁盘空间不足，使得 Tableau Server 安装程序无法运行和执行升级，则安装将失败。所需的磁盘空间量将取决于存储库数据库的大小以及数据提取的数量和大小。

注意：从 TSM 之前的 Tableau Server 版本（2018.2.0 之前的版本）升级时，卸载 Tableau 会在数据目录中创建服务器备份文件。此备份文件具有 .tsbak 扩展名，是升级所必需的。成功升级之后，可以安全地删除此文件以释放空间（在不属于 Tableau Server 安装的计算机上创建副本，以防因任何原因需要该文件）。在完成升级并知道此文件正常工作之前，不要将其删除。

释放磁盘空间：

1. 使用 tsm maintenance ziplogs 命令创建日志存档快照。

   创建 ziplogs 文件之后，请将其保存到不是 Tableau Server 安装一部分的安全位置。

2. 使用 tsm maintenance cleanup 命令清理不必要的文件。有关详细信息，请参见移除不需要的文件。

升级在进行 RebuildSearchIndex 作业时失败

从版本 2020.1.x 开始，升级的最后一步是重新生成搜索索引。此时，所有服务都已升级，因此，如果此作业失败，可以通过运行 tsm maintenance reset-searchserver 命令手动重置搜索服务器。您无需清除并重新开始。

错误将是：

An error occurred while rebuilding search index.

重置搜索服务器：

1. 在初始节点上，以管理员身份打开命令提示符。

   这必须是一个新的命令提示，因为升级脚本针对新版本更新系统环境。

2. 使用 tsm maintenance reset-searchserver 命令重新生成搜索索引。

在 2022.1 及更高版本上升级失败

升级 Tableau Server 2022.1（或更高版本）后，在升级过程中还原 Tableau Server 备份可能会导致以下错误：

“The backup cannot be restored because Tableau Server uses the new identity service tables by default.”（无法还原备份，因为 Tableau Server 默认使用新的身份服务表。）

出现此问题的原因是 Tableau Server 2022.1（及更高版本）使用的身份架构与备份使用的身份架构不同。若要解决此问题，请参见对身份迁移问题进行故障排除。

升级在 2020.4.0 或更高版本上失败

从版本 2020.4.0 开始，“检查点升级”功能允许您重试失败的升级。通常，这对于经验丰富的服务器管理员和 IT 专业人员来说最有用，他们熟悉 Tableau Server 日志文件并愿意搜索这些文件。但是，该功能可以帮助所有失败的升级，因为它允许您重新运行 upgrade-tsm 脚本，并且该脚本会从最后一个成功步骤运行，从而节省时间。对于有经验的用户，可以识别磁盘空间问题或权限问题等问题，更正它们，并重新运行升级。

如果要升级到版本 2020.4.0 或更高版本，并且升级失败，以下步骤可以帮助您完成升级：

• 重新运行 upgrade-tsm 脚本。升级失败有时是升级过程中超时的结果，重新运行脚本可以允许升级越过间歇性或偶尔的计时问题。这也是一个安全易行的步骤。重新运行脚本不会造成任何损害，在最坏的情况下，升级将在同一点再次失败，但无需执行任何以前的步骤。

  该脚本位于 \scripts 目录中：

  默认情况下，

  C:\Program Files\Tableau\Tableau Server\packages\scripts.<version_code>\upgrade-tsm.cmd

  如果在重新运行 upgrade-tsm 脚本时 Tableau Server 升级未成功，并且您熟悉 Tableau Server 日志，您可以执行以下附加故障排除步骤：

• 在命令窗口中查看脚本的输出（如果不再有命令窗口打开，请重新运行脚本）。您需要使用管理员访问权限在命令窗口中运行脚本。有用的错误消息可以帮助您确定升级失败的原因，并为您提供一些有关如何更正问题的想法。

• 查看 app-upgrade.log 文件内容。命令行中显示的任何错误也会出现在 app-upgrade.log 文件中，通常包含更多详细信息。

• 查看 tabadmincontroller.log 文件内容。在上述两个实例中不容易识别的升级问题可能是作业中问题的结果。tabadmincontroller.log 文件可能包含有助于诊断问题的更多信息。

  注意：有关日志文件位置的信息，请参见Tableau Server 日志和日志文件位置。

由于备份/还原文件位置的权限问题，升级失败

对于 2022.1.0 之前的 Tableau Server 版本，如果备份/还原文件的文件位置没有正确的权限，升级脚本将失败，并出现无法读取备份文件或无法还原存储库的错误。

从版本 2022.1 开始，升级脚本会在开始升级之前确认备份/还原文件的文件位置权限，以便在升级到新版本 Tableau Server 期间可以在该位置写入和读取文件。

错误将类似于以下内容：

The runas user does not have permission to read the backup file: <backup/restore basefilepath>.

Repository restore failed.
An error occurred during installation.
An error occurred while restoring repository.

TSM 用于备份和还原的位置由 basefilepath.backuprestore 配置键定义，并具有安装程序使用正确权限设置的默认值，但这些可能会受到组织 IT 规则的影响，或在您将位置更改为自己创建的位置的情况下受到影响。从 2022.1 开始提供的新命令允许您在创建备份/还原文件位置后立即检查其权限，以避免任何与权限相关的问题。有关该命令的详细信息，请参见tsm maintenance validate-backup-basefilepath。

有关备份/还原文件路径的详细信息，请参见tsm File Paths。

升级成功但无法访问已发布数据源

在有限的特定情况下，将 Tableau Server 从版本 2021.3 升级到 2023.1 或 2023.3 的早期版本后，尝试连接或刷新现有的已发布数据源会失败，并出现以下错误：

java.io.FileNotFoundException: Unable to fetch data from any other host. This may indicate a lost or invalid folder.

如果满足以下条件，则可能会发生这种情况：

1. 您随时升级版本 2021.3.x 的 Tableau Server 安装（您可能正在运行 2021.3 或已从 2021.3 升级到 2022.x 版本）
   
   并且

2. 您将该安装升级到 2023.1 或 2023.3 的早期版本

无影响

以下情况均没有问题：

• 在从 2021.3 开始的所有其他升级路径中

• 在所有其他升级到 2023.1 或 2023.3 的路径中

• 在所有 2023.1 和 2023.3 的全新安装中

详细信息

截至 2024 年 9 月 16 日，所有存在问题的版本已从下载站点中移除。如果需要升级到版本 2023.1.x 或 2023.3.x，请升级到维护版本 2023.1.16 或更高版本，或者 2023.3.9 或更高版本。

有关此问题的详细信息，请参见已知问题(链接在新窗口中打开)。

常见设置导入问题

c:\Users\mytableau\Desktop>tsm settings import -f 20183-export.json

Pending topology set.
There are 1 topology validation errors/warnings.

Service 'elasticserver' is not present on any node in the cluster.
Service: Elastic Server

c:\Users\mytableau\Desktop>tsm settings import -f 20183-export.json
Configuration error: At least one configuration value you specified does not match a known configuration key. This applies to the following keys: '[features.TsmConfigFileService]'
Use this parameter to override unknown key error: --force-keys

无法连接到 TSM

如果您能够从安装了 Tableau 的计算机中连接到 TSM（举例来说，使用 https://localhost:8850），但无法（使用 https://<server-name>:8850）从另一台计算机连接，则可能需要在 Tableau Server 计算机上配置本地防火墙。

从版本 2018.2 开始，您需要手动配置防火墙。有关详细信息，请参见本地防火墙配置。

确认您能够访问许可服务器

Tableau 许可服务已于 2018 年 10 月 6 日转移到新的数据中心。这意味着，将需要更新任何需要特殊配置（例如静态 IP 允许列表）来访问 licensing.tableau.com 或 licensing.tableau.com 的环境，然后才能激活、刷新或停用 Tableau 产品密钥。

若要测试访问，请在浏览器中键入许可服务器的 URL 和端口：

https://licensing.tableau.com:443

以及

https://atr.licensing.tableau.com/_status/healthz

如果能够访问服务器，则将为第一个服务器显示“测试成功”消息，并为第二个服务器显示“正常”消息。

Tableau Server 需要连接到以下 Internet 位置来完成许可：

• atr.licensing.tableau.com:443

• licensing.tableau.com:443

• register.tableau.com:443

• o.ss2.us

• s.ss2.us

• crt.rootca1.amazontrust.com

• crt.sca1b.amazontrust.com

• crt.sca0a.amazontrust.com

• crt.sca1a.amazontrust.com

• crt.sca2a.amazontrust.com

• crt.sca3a.amazontrust.com

• crt.sca4a.amazontrust.com

• *.digicert.com

• ocsp.*.amazontrust.com

• crl.*.amazontrust.com

• crt.rootg2.amazontrust.com

必须在端口 80 或 443 上发出对以上域的请求。端口 80 用于证书验证（吊销、证书链等）。端口 443 用于 SSL 连接。

对 ocsp.*.amazontrust.com和crl.*.amazontrust.com 域的请求由 Amazon 管理，以获取证书吊销信息。请参见 ACM 证书特征(链接在新窗口中打开)了解详细信息。我们建议您在运行 Tableau 的计算机上的证书信任存储中安装 Amazon 根证书。若要下载并安装 Amazon 根证书，请参见 Amazon Trust Services 网站上的证书颁发机构(链接在新窗口中打开)。

验证日期和时间

验证初始 Tableau Server 计算机上的日期和时间是否正确。如果时钟设置为早于当前日期的时间和日期，则无法激活 Tableau Server。

验证 FlexNet Licensing Service 是否已启动

如果 Tableau Server 计算机上的日期和时间正确，请验证 FlexNet Licensing Service 是否正在初始 Tableau Server 计算机上运行。

1. 在初始计算机上，从 Windows 的“开始”菜单中打开 services.msc。

2. 在“服务”对话框中，验证 FlexNet Licensing Service 64（64 位）或 FlexNet Licensing Service（32 位）的状态是否为“已启动”。

   如果 FlexNet 未列出为“已启动”，则右键单击 FlexNet Licensing Service，然后选择“启动”。

   如果“启动”选项已变灰，则该服务可能已设置为“已禁用”。若要启用服务，请执行以下操作：

   1. 右键单击“FlexNet Licensing Service”，并选择“属性”。

   2. 从“启动类型”下拉列表中，选择“自动”。

   3. 单击“启动”按钮，然后单击“确定”。

强制再次读取产品密钥

1. 在初始 Tableau Server 计算机上，以管理员身份登录并打开命令提示符。

2. 切换到 Tableau Server bin 目录。默认情况下，此目录为：

   C:\Program Files\Tableau\Tableau Server\packages\bin.<version_code>

3. 键入以下命令：

   tsm stop
   lmreread
   
   tsm start

将受信任的存储的内容发送到 Tableau 支持部门

如果 FlexNet Licensing Services 已安装并正在运行，但您仍然看到错误，则 Tableau 产品密钥信息可能有问题。若要解决此问题，请完成以下步骤以为位于受信任存储中的密钥信息创建文件。

1. 在初始 Tableau Server 计算机上，以管理员身份登录并打开命令提示符。

2. 键入以下命令：

   serveractutil -view > <machine_name>-LicResults.txt

   这将在当前目录中创建 <machine_name>-LicResults.txt 文件。如果您没有该位置的写入权限，并看到错误，请转到您有权在其中创建文件的位置，并再次运行命令。

3. 与 Tableau 支持部门联系 (http://www.tableau.com/zh-cn/support/request(链接在新窗口中打开))，并包括您创建的 <machine_name>-LicResults.txt 文件。

单独安装 tabcmd

安装 Tableau Server 时，tabcmd 会自动安装在初始 Tableau Server 节点上，但如果要在另一台计算机上运行它，则需要单独下载和安装 tabcmd。有关详细信息，请参见安装 tabcmd。

在 Linux 上安装 tabcmd 时出现问题

tabcmd 需要 Java 11 才能正常运行。在类似 RHEL 的系统上，Java 1.8 将在安装 tabcmd 时作为依赖项安装。在类似 Debian 的系统上，如果 Java 11 尚未安装，则需要单独安装。

自 2022 年 7 月起，不再支持 Debian 发行版。有关详细信息，请参见此 Tableau 社区(链接在新窗口中打开)。

未安装 Java

如果在安装 tabcmd 时看到类似于如下的错误，请确认 Linux 计算机上安装了 Java 11：

Cannot find 'java' in your PATH. Install 'java' and make sure it is in your PATH to continue.

安装了不正确的 Java 版本

如果您看到类似于如下的错误，请确认已安装 Java 11：

Exception in thread "main" java.lang.UnsupportedClassVersionError: com/tableausoftware/tabcmd/Tabcmd : Unsupported major.minor version 52.0

或者

*** Uncaught exception NoClassDefFoundError: javax/xml/bind/JAXBException
*** See the logs for the stacktrace.