安装具有独立网关的 Tableau Server

适用于： Tableau Advanced Management

本主题将引导您完成安装 Tableau Server 独立网关的过程。

遵循此过程将生成与后端 Tableau Sever 部署直接连接的独立网关配置。您可以在主题配置具有独立网关的 Tableau Server中了解有关直接与中继连接模式的详细信息。

先决条件

您必须拥有至少具有 2 个内核（4 个 vCPU）、8 GB RAM 和 100 GB 可用磁盘空间的专用服务器。
您必须使用 Tableau Server 2022.1 或更高版本。
您必须使用与 Tableau Server 版本匹配的主要版本（例如 2022.1）的 Tableau Server 独立网关安装程序。我们建议维护版本（例如2022.1.1 或 2022.1.5）也匹配，但这不是必需的。如果版本和版本之间的“静态资产”更改不匹配，您可能会看到一些意想不到的映像影响。举例来说，如果独立网关的版本早于 Tableau Server，则地图可能不是最新的。
您必须在 Tableau Server 中激活有效的 Advanced Management 许可证。若在了解有关 Advanced Management 的详细信息，请参见关于 Tableau Server 上的 Tableau Advanced Management。
默认情况下，独立网关必须能够在安装期间通过端口 80 和 21319 与后端 Tableau Server 部署进行通信。您可以在初始化期间更改这些默认端口，如本主题后面所述。
在安装和配置独立网关之前，验证您的 Tableau Server 部署是否完整且正常。
确认您没有在安装独立网关的计算机上运行任何其他 Web 感知应用程序。举例来说，如果计算机上安装了 Apache httpd，请将其卸载，或将 httpd 配置为不主动侦听端口 80。

安装 Tableau Server 和独立网关

安装独立网关是使用独立安装程序完成的，它在文件名中包含“tsig”，以将其与完整的 Tableau Server 安装程序区分开来。我们强烈建议您在安装 Tableau Server 并确认它按预期运行后安装独立网关。若要进行安装，您必须具有管理员权限。您可以安装一个或多个独立网关实例，但必须单独安装每个独立网关实例。如果您要安装多个实例以实现高可用性或分摊繁重的客户端负载，请为每个实例重复安装步骤。

在安装过程中，会运行一个名为 initialize-tsig.bat 的脚本。该脚本会提示您提供配置独立网关所需的信息。完全安装独立网关后，您需要在 Tableau Server 初始节点上运行 TSM 命令，以使用有关独立网关实例的详细信息来配置服务器。

独立网关安装包括以下步骤：

运行特定于平台的安装程序。
运行安装后脚本。此步骤由安装程序自动完成。
使用 TSM 启用独立网关实例。

步骤 1：下载并安装 Tableau Server

安装 TSM：按照本主题中提供的说明进行操作，并完成运行安装程序和安装 TSM 的步骤 1-5。
激活并注册 Tableau Server：在激活步骤中提供 Tableau Server 密钥和 Advanced Management 密钥。您将需要运行以下命令两次，第一次使用 Tableau Server 产品密钥，然后使用 Advanced Management 产品密钥：
tsm licenses activate -k <product key>
配置初始节点设置：按照本主题中提供的说明进行操作，以配置初始节点设置。

步骤 2：下载并安装独立网关

下载 Tableau Server 独立网关安装文件后，请按照下面的说明安装独立网关。

在要安装独立网关的计算机上，以具有管理员访问权限的用户身份登录，然后双击下载的安装文件。
在第一个屏幕上，您必须接受许可协议才能继续。
接受许可协议后，您可以采取以下两种操作之一：
- 通过单击“安装”来安装独立网关
  或
- 通过单击“自定义”更改安装位置，然后安装独立网关：
  默认情况下，独立网关安装到 C:\Program Files\Tableau\Tableau Server\independentgateway。您可以通过浏览到或键入新路径来选择非默认位置，包括其他驱动器。
  指定安装位置后，单击“安装”将独立网关安装到此位置。
安装程序安装独立网关并自动运行 initialize-tsig.bat 脚本。
在安装程序打开的命令窗口中，系统会提示您输入用于配置独立网关的值：
- TSIG_TS_CLUSTER — 必需。没有默认值。您必须在出现提示时输入一个值。
  此值应该是 Tableau Server 群集中每个节点的一个或多个 Internet 地址。可以使用通配符，并且可以使用子网掩码来指定多个节点。若要指定多个地址，请用空格分隔各个地址。必须以 Apache httpd mod_authz_host“Require”指令可接受的形式之一提供值。有关详细信息，请参见 https://httpd.apache.org/docs/2.4/mod/mod_authz_host.html(链接在新窗口中打开)。
- TSIG_HK_PORT — 默认值为 21319。这是用于来自 Tableau Server 的传入整理请求的端口。
- TSIG_HK_PROTOCOL — 默认值为 http。有效的值包括 http 和 https。这是用于来自 Tableau Server 的整理请求的协议。
- TSIG_PORT — 默认值为 80。用于外部请求的端口。
- TSIG_PROTOCOL — 默认值为 http。有效的值包括 http 和 https。这是用于外部请求的协议。
- TSIG_INSTANCE_ID — 默认值为计算机名称。独立网关实例的唯一标识符。
当脚本完成运行并初始化独立网关时，安装程序完成。

步骤 3：在 Tableau Server 中启用独立网关

安装和配置独立网关的最后一步是在 Tableau Server 中启用独立网关。为此，请将 TSM 命令 tsm topology external-services gateway enable -c <file>与一个 JSON 文件结合使用，该文件标识一个或多个独立网关实例，并向 Tableau Server 提供服务器与独立网关之间通信所需的详细信息。

Tableau Server 必须处于停止状态才能启用独立网关。

独立网关 JSON 文件内容

用于在 Tableau Server 上启用独立网关实例的 JSON 文件需要包含以下内容：

id — id 值必须与特定实例的 TSIG_INSTANCE_ID 匹配。如果您在初始化期间未提供此信息，则默认值为独立网关计算机的计算机名称 (%COMPUTERNAME%)。json 文件中的值必须与 hostname 命令的输出匹配。
host — host 必须是独立网关计算机的 DNS 可解析名称。
port — port 必须与独立网关实例上指定的 TSIG_HK_PORT 值匹配。如果您在初始化期间未提供此信息，则默认值为“21319”。
protocol — protocol 必须与独立网关实例上指定的 TSIG_HK_PROTOCOL 匹配。如果您在初始化期间未提供此信息，则默认为“http”。
authsecret — authsecret 必须与独立网关实例上的初始化脚本创建的密文匹配。

独立网关身份验证密文

初始化脚本在每台独立网关计算机上创建一个唯一的共享密文。您需要此密文才能在 Tableau Server 中启用独立网关。复制密文并将其作为“authsecret”包含在您的 JSON 文件中。

共享密文位于以下位置的 tsighk-auth.conf 文件中：

C:\ProgramData\Tableau\Tableau Server\independentgateway\config\tsighk-auth.conf

独立网关 JSON 文件示例

JSON 文件应采用以下格式。此示例 JSON 文件显示有默认值的默认值。您的文件应该使用与您的独立网关安装和您的组织相匹配的实际值。

{
 "independentGateways": [
  {
    "id": "<IGCOMPUTER>",
    "host": "<DNS name of Independent Gateway computer>",
    "port": "21319",
    "protocol": "http",
    "authsecret": "<shared-secret01>"
  },
  {
    "id": "<IGCOMPUTER2>",
    "host": "<DNS name of second Independent Gateway computer>",
    "port": "21319",
    "protocol": "http",
    "authsecret": "<shared-secret02>"
  }
 ]
}

在 Tableau Server 中启用独立网关

若要完成独立网关的安装，您需要使用 TSM 来启用它。

将 JSON 配置文件复制到 Tableau Server 的初始节点。
在初始节点上，以管理员身份打开命令提示符。
运行以下命令以停止 Tableau Server，使用 json 配置文件启用独立网关，然后重新启动服务器：
```
tsm stop
tsm topology external-services gateway enable -c tsig.json
tsm start
```

步骤 4：验证 Tableau Server 中的独立网关

通过在浏览器中输入独立网关的地址，您应该能够导航到 Tableau Server 登录页面。

如果独立网关和后端 Tableau Server 部署之间存在防火墙，则您需要为 Tableau Server 进程打开端口以进行直接连接。有关详细信息，请参见直接连接。

或者，您可以选择通过为中继连接配置独立网关来最大程度地减少端口需求。有关详细信息，请参见中继连接。

回到顶部

感谢您的反馈!

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

Windows 版 Tableau Server 帮助