比较 tabadmin 和 TSM 的功能

TSM 用于管理 Tableau Server 的服务器级配置。可通过命令行界面 （CLI） 或 Web 界面访问 TSM。它取代了以前版本的 Tableau Server 中的以下工具：

• Tableau 服务器配置实用程序

• tabadmin 命令行实用程序

• Tableau Server Monitor

作为简写，本主题将这些遗留工具称为“tabadmin”。例如，在以前版本的 Windows 上的 Tableau Server 中，您使用 tabadmin 执行了现在使用 TSM 执行的以下任务：

• 安装后 Tableau 服务器的初始配置

• 持续的配置管理，包括编辑设置和更改服务器拓扑

• 运行管理任务，如备份、还原、ziplog 等

要了解有关如何与 TSM 交互和使用 TSM 的更多信息，请参阅 Tableau 服务管理器概述。

要查看旧版 tabadmin CLI 命令与 TSM 命令之间的映射，请参阅从 Tabadmin 迁移到 TSM CLI。

功能仅可从 TSM 命令行获得

本节中描述的特性和功能以前在 Tableau Server 配置实用程序中提供。下面的特性和功能未在 TSM Web UI 中公开，因此必须使用 TSM CLI 进行配置。

首选活动存储库

Tableau Server 配置实用程序有一个选项来设置首选的活动存储库。使用 TSM，您需要使用 CLI 命令 执行此操作。有关详细信息，请参阅 Tableau Server 存储库中的“首选活动存储库”。tsm configuration set -k pgsql.preferred_host

数据缓存配置

在以前的版本中，Tableau Server 配置实用程序提供了一个用于配置数据缓存的图形 UI。在 TSM 版本的 Tableau Server 中，必须使用 TSM CLI 配置缓存。请参见配置数据缓存。

初始仅安装设置

在以前的版本中，Tableau Server 配置实用程序提供了一个图形 UI 来更改网关端口和安装示例，即使在安装之后也是如此。使用 TSM 时，您仍然可以在安装期间在 Web UI 中指定这些选项，但在安装完成后，只能使用命令行工具更改它们。

请参见 Tableau 服务管理器端口和发布样本。

初始 SQL

在以前版本的 Tableau Server 中，您可以通过在 Tableau Server 配置实用程序的“数据连接”选项卡上选择“忽略所有数据源的初始 SQL 语句”选项，将服务器配置为忽略初始 SQL 语句。此配置选项不包括在 TSM Web UI 中。要将服务器配置为忽略初始 SQL 语句，请使用 tsm 配置集命令：

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

网站 SAML

虽然核心 SAML 配置选项包含在 TSM Web UI 中，但要配置站点 SAML，必须使用 TSM CLI。请参见配置特定于站点的 SAML。

SAP HANA SSO

请参阅配置 SAP HANA SSO。

重新生成搜索索引

在 2018.2 之前的 Tableau Server 版本中，Tableau Server 中的“状态”页面包含一个用于重建“搜索和浏览”索引的选项。这不是重建索引的推荐方法，并且从 2018.2 开始已删除该选项。请改用该命令。有关详细信息，请参阅 tsm 维护重新索引搜索。TSM maintenance reindex-search

功能差异

本节介绍 TSM 实施中的功能与 Windows 上旧版 Tableau Server 中的管理体验之间的差异。

主机名配置

使用 TSM 后，您无法在安装 Tableau Server 后更改主机名。

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

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

Windows 防火墙配置

安装程序不再尝试配置 Windows 防火墙。在安装 Tableau Server 之前，请验证本地防火墙上是否打开了相应的端口。请参阅本地防火墙配置。

备份和还原过程

在 Tableau Server 的 TSM 版本中，您可以更好地控制备份哪些 Tableau Server 数据。使用 TSM，您可以使用 、 和 命令来备份和恢复 Tableau Server 的安装。该命令不会备份服务器配置数据，并且该命令不会还原配置数据（即使您正在还原由 tabadmin 创建的备份）。请参见执行 Tableau 服务器的完整备份和还原。tsm maintenance backuptsm settings exporttsm settings importtsm maintenance backuptsm maintenance restore

备份和还原过程在固定位置写入和读取文件。与 Tableau Server 2018.1 及更早版本不同，您在运行该命令时无法指定文件位置。有关详细信息，请参阅下面的固定文件位置。

资产密钥

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

配置导入和导出

在旧版 tabadmin 版本的 Tableau Server 中，配置和拓扑信息作为备份和还原过程的一部分进行管理。随着 TSM 的引入，您现在可以使用 tsm 设置命令导出和导入配置和拓扑信息。

Kerberos 配置

在旧版 Tableau Server 中，Tableau Server 配置实用程序在 Kerberos 选项卡上包含一个选项，该选项生成了一个配置蝙蝠脚本，供您的域管理员运行。此脚本为运行身份服务帐户设置服务主体名称并创建密钥表文件。在 Tableau Server 的 TSM 版本中，我们记录了此 bat 脚本，以便您可以为管理员做好准备。请参见了解密钥表要求。

文件存储

在 TSM 版本的 Tableau Server 中，一个名为客户机文件服务 （CFS） 的新进程处理多节点部署中的文件分发。您必须使用 TSM CLI 或 Web 界面上载由 CFS 管理的文件。请参阅 Tableau 服务器进程。

Ziplogs 收集两天的日志文件

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

TSM 是一个批处理文件

TSM 是一个批处理文件。在命令行运行 TSM 命令时，将调用批处理文件 （TSM.cmd）。这意味着，如果要在批处理文件中编写服务器维护或配置的脚本或自动执行，则需要使用命令（例如 ，），以便将控制权返回到批处理文件。call call tsm maintenance ziplogs

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

与 tabadmin 不同，在 tabadmin 中，您只能在安装了 Tableau 的本地计算机上运行命令，而 TSM 允许您从 Web UI 或 CLI 远程运行命令。这种灵活性意味着您需要在运行任何命令之前登录到 TSM。要登录到 Web UI，请打开 TSM 网页：“，然后在出现提示时登录。要登录到 CLI，请使用 tsm login 命令。https://

清理和清除缓存

在 TSM 版本的 Tableau Server 中，清除缓存和其他可选清理操作包含在 tsm 维护清理命令中。

网络数据连接器

在旧版 tabadmin 版本的 Tableau Server 中，您既可以导入 Web 数据连接器 （WDC）， 也可以将其添加到安全列表中。在 TSM 版本的 Tableau Server 中，您可以使用 tsm 数据访问 Web 数据连接器添加命令和 Web 数据连接器设置实体将 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 不会创建数据的备份。您应该使用该命令创建备份，并将备份文件保存到不属于 Tableau 安装的计算机上的安全位置。tsm maintenance backup

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

有关卸载和删除 Tableau Server 的详细信息，请参阅卸载 Tableau Server。

Tableau Server \bin directory

目录已移动。\bin

• 在 tabadmin 安装中，缺省目录为 。\bin\Program Files\Tableau\Tableau Server\

• 在 TSM 安装中，缺省目录为 。\bin\Program Files\Tableau\Tableau Server\packages\bin.

Tableau Server 安装目录

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

• 在 tabadmin 安装中，默认安装位置为 。C:\Program Files\Tableau\Tableau Server\

• 在 TSM 安装中，缺省安装位置是每个进程或服务的版本化子文件夹。例如：\Program Files\Tableau\Tableau Server\packages\C:\Program Files\Tableau\Tableau Server\packages\bin.20182.18.1214.0751

Fixed file locations

In tabadmin you could specify a file location for files generated or used by commands such as backup, restore, and ziplogs. With TSM you cannot specify the location when running the equivalent command, but you can set the fixed file location before running the command by using a variable. For details on which commands read from or write to a fixed file location, and how to change that location, see tsm File Paths.basefilepath

Log file snapshots

The location you go to generate a log file snapshot has changed with TSM. With versions of Tableau Server on Windows prior to 2018.2, you could generate a log file snapshot and download it from the Status page of Tableau Server. With TSM you do this on the TSM Maintenance page. New in TSM is the ability to upload a log file snapshot directly to Tableau Support. For more information on how these two features work in TSM, see Log File Snapshots (Archive Logs).

Changes in high availability and distributed deployments

With TSM, we've changed the language we use to describe the Tableau Server nodes in a distributed installation. Prior to the release of TSM we referred to the first node as the "primary" node, and any additional nodes as "worker" nodes. With TSM the nodes are more similar to each other than in prior releases, so we refer to the first node as the "initial" node, and other nodes as "additional" nodes. The initial node includes some TSM-specific processes that are not installed on additional nodes, including the TSM Controller and the License Server. Tableau includes a script to move these key processes over to another node in your installation if a problem occurs on the initial node. For details, see Recover from an Initial Node Failure.

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

• 通用安装程序文件 - 在版本 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 版本 2018.1 或更早版本的 Tableau Server 升级到 Windows 版本 2018.2 或更高版本的 Tableau Server，请阅读以下关键方面，然后参阅从 Tableau Server 2018.1.x 或更早版本 （Windows） 升级以获取详细的升级说明。

- 从版本 2018.2 或更高版本升级：如果要从 Windows 版本 2018.2 或更高版本的 Tableau Server 升级，请阅读从 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，在其中激活试用密钥，然后从现有版本还原备份。有关详细信息，请参阅服务器升级 - 验证授权状态。

• 过期的维护 - 不能使用维护已过期或在早于要升级到的版本的发布日期的日期到期的产品密钥升级服务器。如果尝试升级处于此状态的服务器，则服务器将被取消许可，并且升级可能会失败。如果维护已过期或太旧，请在卸载原始版本之前使用“管理产品密钥”应用程序刷新产品密钥。如果刷新密钥不会将维护更新到有效日期，请在 Tableau 客户门户中查看具有当前维护的 Tableau Server 密钥。

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

• 备份 - 将早期版本的备份保存到其他计算机上的安全位置。卸载以前版本的 Tableau Server 将在 Tableau 数据目录中创建一个备份（默认情况下：）。强烈建议您在升级之前将此备份复制到不属于 Tableau Server 安装范围的计算机。这为您提供了最新版本的数据，如果您需要返回到早期版本的 Tableau Server，则可以使用该版本。有关正确准备升级的详细信息，请参阅准备升级。C:\ProgramData\Tableau\Tableau Server

  来自早于 9.x 版的 Tableau Server 版本的备份不能与版本 2018.2.x 或更高版本一起使用。如果您运行的是较旧版本的 Server，则可能需要先执行到版本 9.x 到 10.x 的中间升级，然后再升级到版本 2018.2 或更高版本。

• 防火墙管理 - 防火墙管理是手动的。与早期版本的 Tableau Server 不同，您必须在运行 Tableau Server 的任何计算机上管理本地防火墙。有关详细信息，请参阅本地防火墙配置。

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

  必须停止 Tableau 服务器才能完成升级。如果在运行脚本时 Tableau Server 未停止，则该脚本将通知您，并提供停止服务器的功能。您还可以选择在使用该命令运行脚本之前停止服务器。tsm stop

• 防病毒软件 - 扫描 Tableau Server 使用的目录的防病毒软件可能会干扰 Tableau Server 的安装和持续使用。在某些情况下，这可能会导致安装失败、启动 Tableau Server 时出现问题或影响性能。如果您计划在运行 Tableau Server 的计算机上运行防病毒软件，请按照知识库（链接将在新窗口中打开）.

多节点升级：

• 多节点术语 — 借助 TSM，我们更改了用于描述分布式安装中的 Tableau Server 节点的语言。在 TSM 发布之前，我们将第一个节点称为“主”节点，将任何其他节点称为“工作”节点。使用 TSM 时，节点更紧密地对等节点，因此我们将第一个节点称为“初始”节点，将其他节点称为“附加”节点。

• Uninstall—Use Windows Control Panel to uninstall your existing pre-TSM version of Tableau Server from all nodes before upgrading. If you have not uninstalled your earlier version, you will be prompted to do so when you attempt to install your new version.

• Node installation—Run the Setup program on all nodes in a cluster. Unlike some distributed installation upgrades in versions prior to 2018.2.0, there is no automatic upgrade of any additional nodes.

• Single installer—Use the same Setup program on all nodes. Starting with 2018.2.0 you use the same installer on all nodes, and specify when prompted whether you are upgrading the initial (primary) node, or an additional (worker) node. There is no separate installer for the additional nodes.

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

  必须停止 Tableau 服务器才能完成升级。如果在运行脚本时 Tableau Server 未停止，则该脚本将通知您，并提供停止服务器的功能。您还可以选择在使用该命令运行脚本之前停止服务器。tsm stop

未在 TSM 中实现的功能

• 从备份文件 （.tsbak） 还原配置文件。默认情况下，tabadmin 备份的旧版本包含配置数据。类似的 TSM 命令 不包括配置数据。要备份和恢复 TSM 中的配置数据，请使用 tsm 设置命令。tsm maintenance backup

• 随着 Tableau Services Manager （TSM） 的引入，您无法再将存储库移出双节点群集中的初始（主）节点。在版本 2018.1 及更早版本中，您可以将第二个存储库添加到第二个节点，然后删除第一个存储库。使用 TSM，您无法在双节点集群上添加第二个存储库，这意味着您无法将存储库移出初始节点。