升级 Tableau Server 独立网关

本主题将引导您完成升级 Tableau Server 独立网关的过程。本主题中描述的过程适用于所有版本升级。这意味着您可以将此过程用于主要版本(例如,2022.1 至 2023.1)和维护版本(2022.1.1 至 2023.1.1)升级。

您必须使用与 Tableau Server 版本匹配的主要版本的 Tableau Server 独立网关安装程序。我们建议维护版本(例如 2022.1.1 或 2022.1.2)也匹配,但这不是必需的。如果版本和版本之间的“静态资产”更改不匹配,您可能会看到一些意想不到的映像影响。举例来说,如果独立网关的版本早于 Tableau Server,则地图可能不是最新的。-

概述

独立网关的升级过程实际上是卸载然后重新安装软件的过程。但是,通过遵循本主题中描述的过程,可以最大限度地减少配置和总体停机时间。

本主题中描述的过程假设您已经运行了 Tableau Server 和 Tableau Server 独立网关的功能部署。如果您要在升级过程中升级后端 Tableau Server 部署,我们建议您首先升级独立网关服务器,验证与 Tableau 客户端的基本连接,然后继续进行 Tableau Server 升级。

本主题中详细介绍的步骤总结如下:

  1. 复制一些现有文件以供升级时使用。
  2. 运行 obliterate 脚本以移除独立网关。
  3. 安装新版本的独立网关。
  4. 可选:用原始副本覆盖 tsighk-auth 文件。
  5. 更新 TLS 设置。
  6. 可选:更新后端 Tableau Server
  7. 重新启动独立网关服务。

步骤1:复制文件以供参考

您可能需要引用存储在以下文件中的配置设置。将这些文件复制到安全且可访问的位置(文件路径是默认位置):

  • ProgramData\Tableau\tableau_tsig\config\tsighk-auth.conf
  • ProgramData\Tableau\tableau_tsig\config\httpd.conf.stub
  • ProgramData\Tableau\tableau_tsig\config\environment.bash

步骤 2:删除独立网关

若要从服务器中移除独立网关,请运行 tableau-tsig-obliterate.cmd 脚本:

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

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

    C:\Program Files\Tableau\tableau_tsig\packages\scripts.<version_code>\tableau-tsig-obliterate.cmd -y -y -y

  3. 重新启动计算机。

步骤 3:安装独立网关

下载要升级到的独立网关版本,然后按照主题安装具有独立网关的 Tableau Server中描述的相同安装过程进行操作。

与初始安装一样,您需要在安装过程中指定初始化设置。若要使用相同的值,请引用您在步骤 1 中复制的 enviornment.bash 文件。不要用原始文件覆盖新的 bash 文件。

步骤 4:(可选)用原始副本覆盖 tsighk-auth 文件

tsighk-auth 文件是一个配置文件,它存储一个名为 authsecret 的唯一字符串。Authsecret 用于验证后端 Tableau Server 是否正在与独立网关的可信实例进行通信。当您设置独立网关的原始实例时,必须使用 authsecret 更新后端 Tableau Server 上的配置文件。

如果您的安全策略允许,您可以在独立网关上继续使用原始的 authsecret。这样做避免了用新的 authsecret 更新和重启后端 Tableau Server 的过程。

若要保留原始的 authsecret,请用您在步骤 1 中保存的副本覆盖 tsighk-auth.conf 文件(位于 ProgramData\Tableau\tableau_tsig\config\tsighk-auth.conf)。

如果您的安全策略要求您刷新 authsecret,请记下安装过程中生成的新 authsecret。在这个过程的后面,您将使用新的 authsecret 更新后端 Tableau Server。

步骤 5:更新整理 TLS 设置

如果没有为独立网关实例和后端 Tableau Server 部署之间的整理 (HK) 通信配置 TLS,则可以跳过此步骤。

如果配置了 HK TLS,则必须手动将配置从原始 httpd.conf.stub 文件复制到位于 ProgramData\Tableau\tableau_tsig\config\httpd.conf.stub 的文件中。不要用原始文件覆盖新文件,因为新文件可能包含其他设置。

  1. 更新以下块中的相关 TLS 配置设置:

    <VirtualHost *:${TSIG_HK_PORT}>
    SSLEngine on
    #TLS# SSLHonorCipherOrder on
    #TLS# SSLCompression off
    SSLCertificateFile /etc/ssl/certs/tsig-ssl.crt
    SSLCertificateKeyFile /etc/ssl/private/tsig-ssl.key
    SSLCACertificateFile /etc/ssl/certs/rootTS-CACert.pem 
    #TLS# SSLCARevocationFile /path/to/file
    </VirtualHost>

    有关这些设置的详细信息,请参见在独立网关上配置 TLS

  2. 更新完 httpd.conf.stub,将其保存。

  3. 复制 httpd.conf.stub,然后保存以覆盖同一目录中的 httpd.conf

步骤 6:(可选)更新后端 Tableau Server 部署

如果您按照步骤 4 所述将原始 authsecret 文件 (tsighk-auth.conf) 复制到独立网关的新实例中,则可以跳过此步骤。

如果在后端 Tableau Server 部署中刷新 authsecret,则必须用新的 authsecret 更新初始节点上的 tsig.json 文件。请参见安装具有独立网关的 Tableau Server。完成后,运行以下 TSM 命令:

tsm stop
tsm topology external-services gateway update -c tsig.json
tsm start

步骤 7:重新启动 tsig-httpd 服务

完成配置后,重新启动 tsig-httpd 服务。