---
schema_version: "1"
id: 5622615751d79a3a5d05d8efaaf71f2498638d83fd62c1a4c99ce2de71fce18f
title: 升级 Tableau Server 独立网关
collection: tableau
version: next
locale: zh-cn
portal_url: https://docs.salesforce.com/tableau/next/zh-cn/server-linux/server_tsig_upgrade.md
canonical_url: https://help.tableau.com/v0.0/server-linux/zh-cn/server_tsig_upgrade.htm
source_site: help.tableau.com
content_type: documentation
content_hash: 1b431429fec4ec3fa11e9146f21882726a7a1eddb76c6219ed656828bc2fa420
description: Upgrade Tableau Server Independent Gateway.
---
[跳转到主要内容](#main-content)

# 升级 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. 使用 Windows 卸载程序卸载已安装的独立网关版本。
3. 安装新版本的独立网关。
4. 可选：用原始副本覆盖 tsighk-auth 文件。
5. 更新 TLS 设置。
6. 可选：更新后端 Tableau Server
7. 重新启动独立网关服务。

## 步骤1：复制文件以供参考

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

- /var/opt/tableau/tableau\_tsig/config/tsighk-auth.conf
- /var/opt/tableau/tableau\_tsig/config/httpd.conf.stub
- /etc/opt/tableau/tableau\_tsig/environment.bash

## 步骤 2：卸载独立网关

若要从服务器中移除独立网关，请使用 Windows 卸载程序

1. 打开控制面板，并转到“已安装的应用”。
2. 选择“Tableau Server 独立网关”，并单击“卸载”。
3. 重新启动计算机。
4. 删除位于以下位置的 config.old 文件夹：`C:\ProgramData\Tableau\Tableau Server\independentgateway\config.old`

## 步骤 3：安装独立网关

下载要升级到的独立网关版本，然后按照主题[安装具有独立网关的 Tableau Server](https://help.tableau.com/v0.0/server-linux/zh-cn/server_tsig_new_install.htm)中描述的相同安装过程进行操作。

与初始安装一样，您需要在安装过程中指定初始化设置。若要使用相同的值，请引用您在步骤 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` 文件（位于 `/var/opt/tableau/tableau_tsig/config/tsighk-auth.conf`）。

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

## 步骤 5：更新整理 TLS 设置

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

如果配置了 HK TLS，则必须手动将配置从原始 `httpd.conf.stub` 文件复制到位于 `/var/opt/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](https://help.tableau.com/v0.0/server-linux/zh-cn/server_tsig_configure_tls.htm)。
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](https://help.tableau.com/v0.0/server-linux/zh-cn/server_tsig_new_install.htm)。完成后，运行以下 TSM 命令：

tsm stop

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

tsm start

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

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

sudo su - tableau-tsig

systemctl --user restart tsig-httpd

exit