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 安装常见问题

安装日志位置

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

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

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

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

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

多次尝试安装均失败

如果尝试安装 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 的备份 (<文件>.tsbak)(举例来说,用于还原到新安装),请将该文件复制到另一台计算机上的安全位置,以保证其在您清理 Tableau 计算机时不会被移除。

安装由于硬件要求而失败

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

Tableau Server 升级常见问题

升级日志位置

  • 升级日志 app-upgrade.log 位于 /var/opt/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 的计算机上具有管理权限的用户的凭据。您无需使用创建了引导程序的用户的凭据,但使用该凭据将确保您使用的是有效的凭据。

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

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

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

    释放磁盘空间:

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

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

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

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

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

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

    >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 中移除的配置值时,可能会发生这种情况。

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

    >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”验证错误

    启动 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

    强制再次读取产品密钥

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

    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 计算机上,以管理员身份登录并打开命令提示符。

    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 文件。

    此部分中的其他文章

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