从计算机中移除 Tableau Server

警告:下面的步骤将完全移除 Windows 版 Tableau Server,并删除所有相关数据、用户以及配置信息。这包括 \temp 中的任何文件。如果在运行下面显示的命令并且计算机连接到 Internet 时包括 -l 选项,则 Tableau Server 许可证也会被停用。

作为最佳做法,复制您想要保存到与 Tableau 不相关的位置中的任何备份文件。这样做可以在您移除 Tableau 时保留文件。为安全起见,您应将任何备份文件复制到单独的计算机,包括卸载 Tableau 时创建的备份文件。默认情况下,系统使用类似于 uninstall-2018.1.tsbak 的名称在 C:\ProgramData\Tableau\Tableau Server 中创建这些文件。将备份文件保存在单独的计算机上将允许您重新安装创建了备份的 Tableau Server 版本,并拥有备份中包含的数据,即使在运行 tableau-server-obliterate.cmd 脚本之后也是如此。

如果要卸载特定 Tableau Server 软件包以释放磁盘空间(例如,在升级之后),请参见卸载 Tableau Server

Tableau Server 的常规安装过程中会安装一个脚本,您可以利用该脚本从计算机中完全移除 Tableau 以及所有关联的文件。只有当您不在乎 Tableau 数据、配置或日志文件时,或者您与 Tableau 技术支持合作并需要在安装或升级尝试失败后重新安装 Tableau Server 时,才需要这样做。Obliterate 脚本将不会移除您单独安装的任何驱动程序,即使是安装用于 Tableau Server 的驱动程序也是如此。

tableau-server-obliterate.cmd 脚本适用于要从计算机中完全移除 Tableau Server 的情况。您可能想出于以下几种不同原因执行此操作:

  • 计算机上不再需要安装 Tableau Server。使用 tableau-server-obliterate.cmd 脚本来完全移除 Tableau Server。如果是这种情况,并且计算机连接到 Internet,您可以包括 -l 选项来停用 Tableau Server 许可证。

  • 对 Tableau Server 安装问题进行故障诊断 - 如果安装 Tableau 时遇到问题,则可能需要使用 tableau-server-obliterate.cmd 脚本从计算机上完全移除 Tableau Server,然后再重新安装。这样做将清除任何较旧的设置或状态,并允许您在“干净的”计算机上重新安装。如果这样做,您可以不再使用 -l 选项在计算机上保留许可信息。如果忽略 -l 选项,您将不需要在重新安装 Tableau Server 时激活许可证。

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

tableau-server-obliterate 脚本的作用

tableau-server-obliterate.cmd 脚本的目的是从计算机中完全移除 Tableau Server。其中包括文件、系统设置和配置,如果您指定,还包括许可信息。

运行 tableau-server-obliterate.cmd 时,将执行以下步骤:

  • 卸载 Tableau Server 的所有已安装版本(控制面板卸载)
  • 移除数据目录的大多数内容(默认情况下为 C:\ProgramData\Tableau\Tableau Server)。默认情况下会保留备份和日志文件。请参见下面的“保留 Tableau Server 备份和日志文件”部分。
  • 移除与 Tableau Server 相关的所有注册表项。
  • 如果您使用 -l 选项,并且计算机已连接到 Internet,则会停用所有服务器许可证。此选项在脱机情况下不起作用。

保留 Tableau Server 备份和日志文件

在 Tableau Server 版本 2020.1 以前,运行 tableau-server-obliterate 脚本会从数据目录中删除所有内容。从版本 2020.1 开始,tableau-server-obliterate 脚本的默认行为已发生变化:脚本会将 Tableau Server 备份和日志文件复制并保存到 logs-temp 目录中。Logs-temp 目录的默认位置为 \ProgramData\Tableau\logs-temp。您可以在脚本上设置选项以禁用此新功能。

若要更改默认行为并移除备份或日志文件,请在运行 tableau-server-obliterate.cmd 脚本时包括以下选项:

  • -k 不将备份复制到 logs-temp 目录。
  • -g 不将日志复制到 logs-temp 目录。
  • -a 不将任何内容复制到 logs-temp 目录。

运行 tableau-server-obliterate 脚本

您可以从计算机中完全移除 Tableau Server,同时保留许可信息,或者将许可信息随 Tableau Server 的所有其他方面一起移除。如果将要在同一计算机上重新安装 Tableau Server,您可能需要保留许可信息。

较旧版本的 tableau-server-obliterate.cmd 可能缺少新版本 Tableau Server 中的文件。始终为计算机上安装的 Tableau Server 版本运行 obliterate 脚本。

在不移除服务器许可的情况下完全移除 Tableau Server

此过程中的示例脚本还包括用于移除 Tableau Server 备份和日志文件的 -a 选项。

注意:如果您计划重新安装 Tableau Server 并使用授权运行 (ATR) 服务激活 Tableau Server,我们建议您在使用 Server ATR 重新安装和激活 Tableau Server 之前移除许可信息。

  1. 在初始节点上,以管理员身份打开命令提示符。

  2. 运行 tableau-server-obliterate.cmd 脚本:

    默认情况下:C:\Program Files\Tableau\Tableau Server\packages\scripts.<version_code>\tableau-server-obliterate.cmd -a -y -y -y

    注意:如果已使用控制面板卸载了 Tableau Server,并且现在想要将其完全移除,则运行位于 \Tableau Server\temp 文件夹(默认情况下为 C:\Program Files\Tableau\Tableau Server\temp)中的 tableau-server-obliterate.cmd 脚本的副本。如果脚本不在该目录中,则重新安装 Tableau Server 软件包,然后从脚本文件夹 (默认情况下:C:\Program Files\Tableau\Tableau Server\packages\scripts.<version_code>\) 中运行 tableau-server-obliterate.cmd 脚本。

    您还可以从本知识库文章中获取脚本的副本:Obliterate 脚本不可用(链接在新窗口中打开)

    如果有 Tableau Server 的多节点(分布式)安装,请在群集中的每个节点上运行 tableau-server-obliterate.cmd 脚本。

  3. 重新启动在其上运行 tableau-server-obliterate.cmd 脚本的每台计算机。

完全移除 Tableau Server 和许可

此过程中的示例脚本还包括用于移除 Tableau Server 备份和日志文件的 -a 选项。

  1. 在初始节点上,以管理员身份打开命令提示符。

  2. 停用任何活动产品密钥。

    tsm licenses deactivate -k <product_key>

  3. 运行 tableau-server-obliterate.cmd 脚本:

    默认情况下:C:\Program Files\Tableau\Tableau Server\packages\scripts.<version_code>\tableau-server-obliterate.cmd -a -y -y -y -l

    如果计算机连接到 Internet,Obliterate 脚本的 -l 选项会从计算机中移除所有许可文件。脚本将首先尝试停用任何活动许可证,但不管停用是否成功,它都会移除所有许可信息。这就是我们建议您在运行 obliterate 脚本之前运行 tsm licenses deactivate 命令的原因。

    注意:如果已使用控制面板卸载了 Tableau Server,并且现在想要将其完全移除,则运行位于 \Tableau Server\temp 文件夹(默认情况下为 C:\Program Files\Tableau\Tableau Server\temp)中的 tableau-server-obliterate.cmd 脚本的副本。如果脚本不在该目录中,则重新安装 Tableau Server 软件包,然后从脚本文件夹 (默认情况下:C:\Program Files\Tableau\Tableau Server\packages\scripts.<version_code>\) 中运行 tableau-server-obliterate.cmd 脚本。

    如果有 Tableau Server 的多节点(分布式)安装,请在群集中的每个节点上运行 tableau-server-obliterate.cmd 脚本。您无需在任何其他节点上停用许可证。

  4. 重新启动在其上运行 tableau-server-obliterate.cmd 脚本的每台计算机。

感谢您的反馈!您的反馈已成功提交。谢谢!