Tabadmin 和 TSM 功能比较

Windows 版 Tableau Server的 2018.2 版本包括一个名为 Tableau 服务管理器 (TSM) 的更新管理工具集,该工具集替代了旧版 tabadmin CLI 和 GUI 工具集。旧版工具集附带的大多数功能已移植到 TSM。以下列表描述了未直接移植或 Tableau Server 中不再实现的旧版功能。

注意:在查找适用于较旧版本的 Windows 版 Tableau Server 的 tabadmin 或配置实用工具内容?请参见 Tableau 帮助(Link opens in a new window)页面上的存档联机帮助。

TSM 用于管理 Tableau Server 的服务器级别配置。可以使用命令行界面 (CLI) 或 Web 界面访问 TSM。它替代了以前版本的 Tableau Server 中的以下工具:

  • Tableau Server 配置实用工具
  • tabadmin 命令行实用工具
  • Tableau Server Monitor

本主题将这些旧版工具简称为“tabadmin”。在以前版本的 Windows 版 Tableau Server 中,举例来说,您使用 tabadmin 来执行以下任务,这些任务现在用 TSM 执行:

  • 安装之后 Tableau Server 的初始配置
  • 不断进行的配置管理,包括编辑设置以及更改服务器拓扑
  • 运行管理任务,例如备份、还原、压缩日志等等。

若要了解有关使用 TSM 和与之交互的详细信息,请参见Tableau 服务管理器概述

若要查看旧版 tabadmin CLI 命令与 TSM 命令之间的映射,请参见从 Tabadmin 迁移到 TSM CLI

仅可通过 TSM 命令行使用的功能

此部分中描述的特性和功能以前在 Tableau Server 配置实用工具中提供。下面的特性和功能未在 TSM Web UI 中公开,因此必须使用 TSM CLI 进行配置。

首选主动存储库

Tableau Server 配置实用工具提供了用于设置首选主动存储库的选项。对于 TSM,您需要使用 CLI 命令 tsm configuration set -k pgsql.preferred_host 来完成此操作。有关详细信息,请参见Tableau Server 存储库中的“首选主动存储库”。

数据缓存配置

在以前的版本中,Tableau Server 配置实用工具提供了用于配置数据缓存的图形界面。在 TSM 版本的 Tableau Server 中,您必须使用 TSM CLI 配置缓存。请参见配置数据缓存

初始仅安装设置

在以前的版本中,Tableau Server 配置实用工具提供了一个图形 UI,用于更改网关端口和安装示例,即使在安装之后也能更改。对于 TSM,您仍然可以在安装过程中通过 Web UI 指定这些选项,但在安装完成后,您只能使用命令行工具对其进行更改。

请参见Tableau 服务管理器端口publishsamples

初始 SQL

在以前版本的 Tableau Server 中,您可以通过在 Tableau Server 配置实用工具的“数据连接”选项卡上选择“Ignore initial SQL statements for all data sources”选项,将服务器配置为忽略初始 SQL 语句。TSM Web UI 未附带此配置选项。若要将服务器配置为忽略初始 SQL 语句,请使用 tsm configuration set 命令:

tsm configuration set -k vizqlserver.initialsql.disabled -v true

站点 SAML

尽管 TSM Web UI 中包括了核心 SAML 配置选项,但若要配置站点 SAML,您必须使用 TSM CLI。请参见配置特定于站点的 SAML

SAP HANA SSO

请参见配置 SAP HANA SSO

重建搜索索引

在 2018.2 之前的 Tableau Server 版本中,Tableau Server 中的“状态”页面包括用于重建搜索和浏览索引的选项。这不是重建索引的推荐方式,从 2018.2 开始已移除了该选项。作为替代,请使用 TSM maintenance reindex-search 命令。有关详细信息,请参见tsm maintenance reindex-search

功能中的不同之处

此部分描述与 Windows 版 Tableau Server 的旧 tabadmin 版本中的管理员体验相比,TSM 实现中的功能差异。

主机名配置

对于 TSM,您无法在 Tableau Server 安装之后更改主机名。

存档日志需要本地管理员权限

在 Tableau Server 旧的 tabadmin 版本中,站点管理员可以从 Tableau Server 管理页面中存档日志快照。在 TSM 版本的 Tableau Server 中,日志快照功能只能由具有 TSM 访问权限的管理员执行。运行 TSM Web UI 或 CLI 的帐户必须是运行 Tableau Server 的 Windows 计算机上的本地管理员组的成员。请参见日志文件快照(将日志存档)

Windows 防火墙配置

安装程序不再会尝试配置 Windows 防火墙。在安装 Tableau Server 之前,请验证相应的端口是否已在本地防火墙中打开。请参见本地防火墙配置

备份和还原过程

在 TSM 版本的 Tableau Server 中,您可以对备份什么 Tableau Server 数据进行更多控制。对于 TSM,您可以使用 tsm maintenance backuptsm settings exporttsm settings import 命令来备份还原您安装的 Tableau Servertsm maintenance backup 命令将不会备份服务器配置数据,而 tsm maintenance restore 命令将不会还原配置数据(即使您在还原通过 tabadmin 创建的备份)。请参见执行 Tableau Server 的完整备份和还原

备份和还原过程会将文件写入固定位置并从中进行读取。与 Tableau Server 2018.1 及更低版本不同,您无法在运行命令时指定文件位置。有关详细信息,请参见下面的固定文件位置

资产密钥

备份文件现在附带资产密钥。如果您还原的备份包括在旧版 tabadmin 中重新生成的资产密钥,则需要在 TSM 还原过程中导入该 .yml 文件。请参见执行 Tableau Server 的完整备份和还原

配置导入和导出

在 Tableau Server 的旧版 tabadmin 版本中,配置和拓扑信息是在备份和还原过程中管理的。随着 TSM 的引入 ,您现在可以使用tsm settings命令导出和导入配置和拓扑信息。

Kerberos 配置

在旧版 Tableau Server 中,Tableau Server 配置实用工具在“Kerberos”选项卡上包括一个选项,用于生成一个供域管理员运行的配置批处理脚本。此脚本为运行身份服务帐户设置服务主体名称并创建密钥表文件。在 TSM 版本的 Tableau Server 中,我们提供了此脚本的相关文档,以便您能为管理员准备该脚本。请参见了解密钥表要求

文件存储

在 TSM 版本的 Tableau Server 中,一个名为客户端文件服务 (CFS) 的新进程负责处理在多节点部署中分发文件。您必须使用 TSM CLI 或 Web 界面上载 CFS 管理的文件。请参见Tableau Server 进程

Ziplogs 收集两天的日志文件

默认情况下,tsm maintenance ziplogs 命令最多收集两天的日志文件,而不是 tabadmin ziplogs 收集的最多七天的日志文件。您可以使用命令的命令行开关更改此行为。请参见tsm maintenance ziplogs

TSM 是批处理文件

TSM 是一个批处理文件。在命令行中运行 TSM 命令时,您是在调用一个批处理文件 (TSM.cmd)。这意味着,如果您在批处理文件中以脚本形式执行或自动执行服务器维护或配置,您需要使用 call 命令(例如,call tsm maintenance ziplogs),以便将控制权交还给批处理文件。

需要进行身份验证才能使用 TSM

与只能在安装了 Tableau 的本地计算机上运行命令的 tabadmin 不同,TSM 允许您以远程方式通过 Web UI 或 CLI 运行命令。这种灵活性意味着您需要在运行任何命令之前登录到 TSM。若要登录到 Web UI,请打开 TSM 网页:https://<tsm_computer>:8850,并在出现提示时登录。若要登录到 CLI,请使用 tsm login 命令。

清理和清除缓存

在 TSM 版本的 Tableau Server 中,清除缓存及其他可选清理操作包括在tsm maintenance cleanup命令中。

Web 数据连接器

在旧版 tabadmin 版本的 Tableau Server 中,您可以导入 Web 数据连接器 (WDC) 并将它们添加到安全列表。在 TSM 版本的 Tableau Server 中,您可以使用 tsm data-access web-data-connectors add 命令和Web-data-connector-settings 实体将 WDC 添加到安全列表。若要详细了解 Tableau Server 中的 WDC 支持,请参见Tableau Server 中的 Web 数据连接器

卸载和移除 Tableau Server

在旧版 tabadmin 版本的 Tableau Server 中,您将使用 Windows 控制面板进行卸载,并且卸载过程会保留文件及其他 Tableau Server 配置。

对于 TSM,卸载 Tableau Server 会有以下方面的不同:

  • 在从 TSM 版本(2018.2.x 或更高版本)升级到 TSM 版本时,不应卸载 Tableau Server。完成升级后,您可以使用 Windows 控制面板卸载以前的版本。

  • 如果您的安装或升级尝试失败,请不要使用 Windows 控制面板卸载 Tableau Server。在这些情况下,请使用下面介绍的 tableau-server-obliterate 脚本从计算机中完全移除 Tableau Server。

  • 使用 Windows 控制面板卸载 Tableau Server 时将不会创建数据的备份。您应使用 tsm maintenance backup 命令创建备份,并将备份文件保存到不是 Tableau 安装一部分的计算机上的安全位置。

  • 若要完全移除 Tableau Server,请使用 tableau-server-obliterate.bat 脚本。这将移除所有 Tableau Server 文件和配置。作为最佳做法,您应在运行 obliterate 脚本后重新启动计算机。

有关卸载和移除 Tableau Server 的详细信息,请参见卸载 Tableau Server

Tableau Server \bin 目录

\bin 目录已移动。

  • 在 tabadmin 安装中,默认 \bin 目录为 \Program Files\Tableau\Tableau Server\<version>\bin

  • 在 TSM 安装中,默认 \bin 目录为 \Program Files\Tableau\Tableau Server\packages\bin.<version_code>

Tableau Server 安装目录

Tableau 现在安装到 \packages 文件夹中。

  • 在 tabadmin 安装中,默认安装位置为 C:\Program Files\Tableau\Tableau Server\<version>

  • 在 TSM 安装中,默认安装位置为 \Program Files\Tableau\Tableau Server\packages\(带有每个进程或服务的版本控制子文件夹)。例如:C:\Program Files\Tableau\Tableau Server\packages\bin.20182.18.1214.0751

固定文件位置

在 tabadmin 中,您可以为诸如 backup、restore 和 ziplogs 等命令生成或使用的文件指定文件位置。对于 TSM,您无法在运行等效命令时指定位置,但可以在运行命令之前通过使用 basefilepath 变量设置固定文件位置。有关哪些命令从固定文件位置读取或写入到其中,以及如何更改该位置的详细信息,请参见tsm File Paths

日志文件快照

对于 TSM,您将在其中生成日志文件快照的位置已改变。对于 2018.2 之前的 Windows 版 Tableau Server 版本,您可以生成日志文件快照,并通过 Tableau Server 的“状态”页面下载该快照。对于 TSM,您将在“TSM 维护”页面上执行此操作。TSM 提供了将日志文件快照直接上载到 Tableau 支持的新功能。有关 TSM 中这两个功能的工作方式的详细信息,请参见日志文件快照(将日志存档)

高可用性和分布式部署的更改

对于 TSM,我们更改了用于描述分布式安装中的 Tableau Server 节点的语言。在 TSM 版本之前,我们将第一个节点称为“主”节点,并将任何其他节点称为“工作服务器”节点。对于 TSM,节点与以前版本中相比彼此更加相似,因此我们将第一个节点称为“初始”节点,并将其他节点称为“附加”节点。初始节点包括一些未安装在附加节点上的 TSM 特定进程,其中包括 TSM 控制器和许可证服务器。Tableau 包括一个脚本,用于初始节点上出现问题的情况下将这些关键进程转移到安装中的另一个节点。有关详细信息,请参见从初始节点故障中恢复

用于分布式部署的安装过程也已更改。

  • 通用安装程序文件 — 在版本 2018.1 及更低版本中,部署需要两个单独的安装程序。对于 2018.2 和 TSM,您将为所有节点运行相同安装程序,并指明是在初始节点还是附加节点上进行安装。

  • 不会自动发现节点 — 对于 2018.2 之前的 Tableau Server 版本,在安装了所有节点之后,您将运行服务器配置实用工具并向主服务器中添加工作服务器节点。对于 TSM,在安装初始节点之后,您将生成引导程序配置文件,并在安装所有附加节点时使用此文件。有关安装多节点群集的详细信息,请参见分布式和高可用性 Tableau Server 安装

  • 协调服务安装 — 在配置 Tableau Server 的多节点安装时,您还需要将协调服务整体部署到附加节点。在 2018.2 之前的 Windows 版 Tableau Server 版本中,在您添加总数为三个或五个的节点时,会自动添加协调服务的附加实例。现在,您需要手动部署协调服务。有关如何执行该操作的详细信息,请参见部署协调服务整体

  • 无“备份主服务器”— 不再需要“备份主服务器”节点,并且 TSM 不支持为初始节点创建备份。对于 TSM,如果您的初始节点遇到问题,您可以使用脚本将关键进程从该节点转移到群集的另一个节点。有关如何执行此操作的详细信息,请参见从初始节点故障中恢复

升级过程更改

升级步骤取决于您从中升级的版本。从旧版 tabadmin Tableau Server(2018.1.x 或更低版本)升级到 TSM 版本的(2018.2 或更高版本)需要特殊步骤。

- 从版本 2018.1 或更低版本升级:如果从 Windows 版 Tableau Server 版本 2018.1 或更低版本升级到 Windows 版 Tableau Server 版本 2018.2 或更高版本,请阅读下面的关键方面,然后参见从 Tableau Server 2018.1.x 或更低版本升级 (Windows),了解详细的升级说明。

- 从版本 2018.2 或更高版本升级:如果从 Windows 版 Tableau Server 版本 2018.2 或更高版本升级,请阅读从 2018.2 及更高版本升级 (Windows)。不要按照这些步骤来进行 TSM 之前的版本到 TSM 版本的升级。

下面是将 Tableau Server 从版本 2018.1 或更低版本升级到版本 2018.2 或更高版本的一些关键方面,您需要加以注意。

所有升级:

  • 本地管理员 — 以本地管理员身份登录。您需要以“本地管理员”身份登录到 Tableau Server 计算机来运行 Tableau Server 安装程序,以及运行与升级相关的脚本。“本地管理员”用户是 Windows 的“本地用户和组”管理控制台中的“管理员”组的成员。

  • 本地安全策略 — 验证您的本地安全策略是否将为“运行身份”服务帐户允许“以服务方式登录”和“以本地方式登录”权限。有关详细信息,请参见验证本地安全策略

  • 运行身份 — 阅读并了解这些运行身份服务帐户的要求:所需的运行身份服务帐户设置

  • Windows 帐户和权限 — 阅读并了解这些 Windows 帐户要求:Windows 帐户和权限

  • 端口 — 升级之前,请阅读并了解端口的要求:Tableau 服务管理器端口

  • 许可证

    • 试用产品密钥 — 您无法将运行试用产品密钥的服务器从一个主要版本直接升级到另一个主要版本(例如,从版本 10.5.x 升级到版本 2018.x)。若要使用试用产品密钥从另一个主要版本升级到另一个主要版本,请在单独的计算机上安装新版本的 Tableau Server,在该计算机上激活试用密钥,然后还原来自现有版本的备份。有关详细信息,请参见服务器升级 - 验证许可状态

    • 过期的维护 — 对于其维护已过期或过期日期早于所升级到的版本的发布日期的产品密钥,您无法使用该产品密钥来升级服务器。如果尝试在这种状态下进行升级,服务器将变为未许可,并且升级可能会失败。如果您的维护已过期或太旧,请使用“管理产品密钥”应用程序刷新产品密钥,之后再卸载原始版本。有关在低于 2018.2.0 的版本中刷新产品密钥的详细信息,请参见刷新产品密钥的维护日期(Link opens in a new window)。如果密钥刷新操作未将维护更新为有效日期,请在 Tableau 客户门户中检查是否有具有最新维护的 Tableau Server 密钥。

  • 卸载 — 在升级之前,使用 Windows 控制面板卸载现有 TSM 之前的 Tableau Server 版本。这种特殊情况的升级与早期版本中的升级不同,后者会自动卸载以前版本的 Tableau Server。从版本 2018.1 或更低版本升级到版本 2018.2 或更高版本时,您必须自行卸载更低版本。如果未卸载更低版本,当您尝试安装新版本时,系统将提示您这样做。此情况特定于从 2018.1 或更低版本到 2018.2 或更高版本的升级。

  • 备份 — 将更低版本的备份保存到其他计算机上的一个安全位置。卸载以前版本的 Tableau Server 时,将会在 Tableau 数据目录(默认情况下为 C:\ProgramData\Tableau\Tableau Server)中创建一个备份。我们强烈建议您在升级之前将此备份复制到不是 Tableau Server 安装一部分的计算机。这可以为您提供数据的最新版本,如果您需要返回到更低版本的 Tableau Server,您可以使用该数据。有关正确准备升级的详细信息,请参见准备升级

    不能将版本 9.x 之前的 Tableau Server 版本中的备份与版本 2018.2.x 或更高版本结合使用。如果运行的是较旧版本的 Server,则可能需要先升级到版本 9.x 至 10.x,然后再升级到版本 2018.2 或更高版本。

  • 防火墙管理 — 防火墙管理是手动进行的。与更低版本的 Tableau Server 不同,您必须在运行 Tableau Server 的任何计算机上管理本地防火墙。有关详细信息,请参见本地防火墙配置

  • 升级脚本 — 安装新版本之后,通过运行 upgrade-tsm.cmd 脚本完成升级并切换到新版本。该脚本安装在刚安装的新版本的 \scripts.<version_code> 文件夹中。默认情况下:C:\Program Files\Tableau\Tableau Server\packages\scripts.<version_code>\

    必须停止 Tableau Server 才能完成升级。如果在运行脚本时 Tableau Server 未停止,脚本将告知您,并建议停止服务器。您还可以选择在运行脚本之前使用 tsm stop 命令停止服务器。

  • 防病毒软件 — 对 Tableau Server 使用的目录进行扫描的防病毒软件可能会影响 Tableau Server 的安装和持续使用。在某些情况下,这可能会导致安装失败、启动 Tableau Server 时出现问题或影响性能。如果您计划在运行 Tableau Server 的计算机上运行防病毒软件,请按照知识库(Link opens in a new window)中的建议进行操作。

多节点升级:

  • 多节点术语 — 对于 TSM,我们已经更改了用于在分布式安装中描述 Tableau Server 节点的语言。在 TSM 发布之前,我们将第一个节点称为“主”节点,并将任何其他节点称为“工作服务器”节点。对于 TSM,各个节点具备更加紧密的对等关系,因此我们将第一个节点称为“初始”节点,并将其他节点称为“附加”节点。

  • 卸载 — 在升级之前,使用 Windows 控制面板从所有节点中卸载现有 TSM 之前的 Tableau Server 版本。如果未卸载更低版本,当您尝试安装新版本时,系统将提示您这样做。

  • 节点安装 — 在群集中的所有节点上运行安装程序。与 2018.2.0 之前版本中的某些分布式安装升级不同,将不会自动升级任何附加节点。

  • 单一安装程序 — 在所有节点上使用同一安装程序。从 2018.2.0 开始,您可以在所有节点上使用同一安装程序,并在出现提示时指定您是要升级初始(主)节点还是附加(工作服务器)节点。没有用于附加节点的单独安装程序。

  • 升级脚本 — 在群集中的所有节点上安装新版本之后,通过在群集中的初始节点上运行 upgrade-tsm.cmd 脚本完成升级并切换到新版本。

    必须停止 Tableau Server 才能完成升级。如果在运行脚本时 Tableau Server 未停止,脚本将告知您,并建议停止服务器。您还可以选择在运行脚本之前使用 tsm stop 命令停止服务器。

TSM 中未实现的功能

  • 从备份文件 (.tsbak) 中还原配置文件。旧版 tabadmin backup 默认情况下包括配置数据。类似的 TSM 命令 tsm maintenance backup 不包括配置数据。若要在 TSM 中备份和还原配置数据,请使用 tsm settings 命令。

  • 随着 Tableau 服务管理器 (TSM) 的引入,您不再能够将存储库从双节点群集内的初始(主)节点中移除。在版本 2018.1 及更低版本中,您可以向第二个节点中添加第二个存储库,然后移除第一个存储库。对于 TSM,您无法在双节点群集上添加第二个存储库,而这意味着您无法将存储库从初始节点中移走。

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