Linux 版 Tableau Server 帮助

安装日志 app-install.log 位于 /var/opt/tableau/tableau_server/logs 中。

升级日志 app-upgrade.log 位于 /var/opt/tableau/tableau_server/logs 中。

多次尝试安装均失败

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

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

Enabling and starting all services
+ services=(appzookeeper* tabadmincontroller* tabsvc* licenseservice* fnplicenseservice* tabadminagent* clientfileservice*)
+ systemctl_user enable appzookeeper_0.service 'tabadmincontroller*' 'tabsvc*' 'licenseservice*' fnplicenseservice_0.service 'tabadminagent*' 'clientfileservice*'
++ id -ru a_tabadminpoc
+ local unprivileged_uid=222954
+ su -l a_tabadminpoc -c 'XDG_RUNTIME_DIR=/run/user/222954 systemctl --user enable appzookeeper_0.service tabadmincontroller* tabsvc* licenseservice* fnplicenseservice_0.service tabadminagent* clientfileservice*'
Failed to execute operation: No such file or directory

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

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

安装由于硬件要求而失败

如果要进行安装的计算机未满足最低硬件要求，则 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，请确保关闭处理器兼容模式。

升级日志位置

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

从 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 安装程序无法运行和执行升级，则安装将失败。所需的磁盘空间量将取决于存储库数据库的大小以及数据提取的数量和大小。

释放磁盘空间：

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 目录中：

  opt/tableau/tableau_server/packages/scripts.<version_code>/upgrade-tsm

  如果在重新运行 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 tableau 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 或更高版本。

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

常见设置导入问题

>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

>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

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

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。

强制再次读取产品密钥

1. 在初始 Tableau Server 计算机上，以具有 sudo 访问权限的用户身份登录。

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

   /opt/tableau/tableau_server/packages/bin.<version_code>/

3. 键入以下命令：

   tsm stop
   
   ./lmreread
   tsm start

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

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

1. 在初始 Tableau Server 计算机上，以具有 sudo 访问权限的用户身份登录。

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.