Tableau Server 安装和升级疑难解答

按照本主题中的建议来解决 Tableau Server 的常见问题。有关基于在“状态”页面上查看的进程状态的其他疑难解答步骤,请参见服务器进程疑难解答

 

一般疑难解答步骤

许多 Tableau Server 问题可通过某些基本步骤解决:

  1. 确保运行 Tableau Server 的每台计算机上都有足够的磁盘空间。有限的磁盘空间可能会导致安装失败、升级失败或运行 Tableau Server 时出现问题。

  2. 重新启动 Tableau Server。与未完全启动的进程相关的问题可通过以受控方式重新启动 Tableau Server 解决。若要重新启动 Tableau Server,请使用 tsm restart 命令。这将停止与 Tableau Server 关联的所有进程,然后重新启动这些进程。

  3. 重建 Tableau Server 索引。与索引相关的问题可通过重建 Tableau Server 索引解决。若要重建 Tableau Server 索引,请使用 tsm maintenance reindex-search 命令。有关详细信息,请参见下面的重建 Tableau Server 搜索和浏览索引

  4. 重新启动 Tableau Server 正在其上运行的计算机。可以通过重新启动服务器计算机来解决某些问题(例如与数据源连接相关的问题)。

Tableau Server 安装常见问题

安装日志位置

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

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

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

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

重要信息:如果创建了要保留的 Tableau 的备份 (<文件>.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 知识库(Link opens in a new window)

TSM 初始化屏幕不显示

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

无法登录到 TSM 或 Tableau Server(登录屏幕在输入凭据后重新显示)

在使用 Internet Explorer 或 Edge 的情况下,如果您在 TSM 或 Tableau Server 登录屏幕中输入凭据,并且页面在未将您登录的情况下重新显示,请验证 URL 中的主机名或域是否未包括下划线 (_)。如果 Tableau Server 计算机的主机名或域包括下划线 (_),Internet Explorer 或 Edge 浏览器将不会设置 Cookie,因此页面会在未将您登录的情况下重新显示。若要解决此问题,请在 URL 中使用“localhost”或计算机的 IP 地址。例如:https://localhost:8850

注意:如果为 Tableau Server 身份存储使用 AD,在尝试登录太多次的情况下,您可能无法进入 Active Directory。

有关详细信息,请参见 Tableau Server 知识库(Link opens in a new window)

多次尝试安装均失败

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

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

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

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

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

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

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

安装由于硬件要求而失败

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

Tableau Server 升级常见问题

升级日志位置

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

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

如果在升级 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 的计算机上具有管理权限的用户的凭据。您无需使用创建了引导程序的用户的凭据,但使用该凭据将确保您使用的是有效的凭据。

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

升级在 12%、78% 或 92% 处停止或失败

在某些情况下,upgrade-tsm.cmd 脚本可能会在中途停止或失败。此错误的原因取决于脚本的停止位置。

  • 如果脚本在 12% 或 78% 处停止,这可能是与在启用 SSL 时升级相关的一个已知问题(已在版本 2018.2.1 中修复)导致的。有关详细信息,请参见 Tableau 知识库(Link opens in a new window)

  • 如果脚本在 92% 处执行“启用建立索引所需的服务”步骤时停止,这可能是启动 Tableau 服务时的问题导致的。您可以手动重新启动 Tableau Server 服务管理器来解决此问题。有关详细信息,请参见 Tableau 社区(Link opens in a new window)

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

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

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

释放磁盘空间:

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

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

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

导入设置文件由于缺少服务而导致“not present”验证错误

如果要通过安装新版本的 Tableau Server 和从早期版本导入设置文件进行升级,则在运行 tsm settings import 命令时可能会遇到拓扑验证错误。

错误将类似于如下(特定服务可能不同):

                                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

若要解决此问题,请将任何缺少的服务添加到 Tableau Server:

  1. 对于产生了验证错误的任何服务,请添加实例计数为 1 的服务。

    举例来说,如果群集中不存在消息服务:

    使用验证错误消息中显示的服务名称的第一个版本将进程实例计数设置为 1:

    tsm topology set-process -n node1 -pr elasticserver -c 1

    为导致错误的每个服务重复此步骤。

  2. 当不再有警告或错误时,应用未完成的更改:

    tsm pending-changes apply

您的设置应成功导入。

导入设置文件会导致“configuration value you specified does not match”错误

如果要安装新版本的 Tableau Server 和从早期版本导入设置文件,则在运行 tsm settings import 命令时可能会遇到配置验证错误。当设置文件包含已从 Tableau 中移除的配置值时,可能会发生这种情况。

错误将类似于如下(配置键可能不同):

                                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

若要解决此问题,请编辑要导入的设置文件以移除对错误中一个或多个配置键的引用:

  1. 复制 JSON 设置文件并保存备份副本。

  2. 在纯文本编辑器中打开 JSON 设置文件。

  3. 找到并删除包含该键的整个行。此示例中为 features.TsmConfigFileService

    "configKeys" : {
      "config.version" : 19,
      "tabadmincontroller.port" : "8850",
      "endpoints.enabled" : false,
      "endpoints.health.enabled" : true,
      "features.TsmConfigFileService" : true,
      "tableau_projects.language" : "en",

    以上是导出设置文件的一小部分的示例,并不表示文件的全部内容。

  4. 保存设置文件并再次导入。

您可能会遇到与拓扑验证相关的其他错误。有关解决这些错误的信息,请参见导入设置文件由于缺少服务而导致“not present”验证错误

TSM 连接疑难解答

无法连接到 TSM

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

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

启动 Tableau Server

Tableau Server 无法确定其是否已完全启动

在某些情况下,Tableau Server 可能会报告它无法确定所有组件在启动时是否已正常启动。一条消息将显示:"无法确定所有服务组件是否已正常启动。”

如果在启动后看到此消息,请通过使用 tsm status -v 命令验证 Tableau Server 是否按预期方式运行。

如果状态显示为正在运行(“Status: RUNNING”),则服务器已成功启动,您可以忽略该消息。如果状态为 DEGRADED STOPPED,请参见下一节中的“Tableau Server 未启动”。

Tableau Server 未启动

如果 Tableau Server 未启动或在降级的状态下运行,请从命令提示符中运行 tsm restart 命令。这将关闭正在运行的任何进程,并重新启动 Tableau Server。

重建 Tableau Server 搜索和浏览索引

可以通过重建“搜索与浏览”索引来解决的问题

需要重建索引的症状包括:

  • 用户尝试登录时出现空白站点列表
  • 用户尝试选择项目时出现空白项目列表
  • 缺少内容(工作簿、视图、仪表板)
  • 意外或不准确的通知(例如,未包括数据提取的工作簿上的“刷新失败”通知)

如果看到任何这些行为,请使用 tsm maintenance reset-searchserver 命令来重置和重建“搜索与浏览”索引。

激活 Tableau Server

Tableau Server 许可证激活失败

在某些情况下, Tableau Server 许可证激活可能会失败。错误消息可能从一个非常一般化的消息:

  • An error has occurred

至更具体的消息:

  • Function flxActCommonLicSpcPopulateFromTS returned error 50030, 71521,
  • No license found for 'Tableau Server'

若要解决此问题,请按照下面列出的顺序尝试这些解决方案:

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

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 位置来完成许可:

  • licensing.tableau.com:443

  • atr.licensing.tableau.com:443

  • s.ss2.us

  • ocsp.rootg2.amazontrust.com

  • ocsp.rootca1.amazontrust.com

  • ocsp.sca1b.amazontrust.com

  • crt.sca1b.amazontrust.com

  • crt.rootca1.amazontrust.com

  • ocsp.sca0a.amazontrust.com

  • crt.sca0a.amazontrust.com

  • ocsp.sca1a.amazontrust.com

  • crt.sca1a.amazontrust.com

  • ocsp.sca2a.amazontrust.com

  • crt.sca2a.amazontrust.com

  • ocsp.sca3a.amazontrust.com

  • crt.sca3a.amazontrust.com

  • ocsp.sca4a.amazontrust.com

  • crt.sca4a.amazontrust.com

  • crl.rootca1.amazontrust.com

  • crl.rootg2.amazontrust.com

  • crl.sca1b.amazontrust.com

必须在端口 80 或 443 上发出对以上域的请求。

验证日期和时间

验证初始 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(Link opens in a new window)),并包括您创建的 <machine_name>-LicResults.txt 文件。

感谢您的反馈! 提交反馈时出错。请重试,或向我们发送消息