安装具有独立网关的 Tableau Server

本主题将引导您完成安装 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 并确认它按预期运行后安装独立网关。若要进行安装,您必须是 root 用户(或能够 sudo 到 root)。您可以安装一个或多个独立网关实例,但必须单独安装每个独立网关实例。如果您要安装多个实例以实现高可用性或分摊繁重的客户端负载,请为每个实例重复安装步骤。

安装后,系统会提示您运行一个名为 initialize-tsig 的脚本来完成安装。该脚本获取您使用参数提供的信息,并配置独立网关。完全安装独立网关后,您需要在初始 Tableau Server 节点上运行 TSM 命令,以使用有关独立网关实例的详细信息来配置服务器。

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

  • 运行特定于平台的安装程序。

  • 运行安装后脚本。

  • 使用 TSM 启用独立网关实例。

步骤 1:下载并安装 Tableau Server

  1. 安装和初始化 TSM:按照本主题中提供的说明进行操作,并完成运行安装程序和安装 TSM 的步骤 1-5。

  2. 激活并注册 Tableau Server:在激活步骤中提供 Tableau Server 密钥和 Advanced Management 密钥。您将需要运行以下命令两次,第一次使用 Tableau Server 产品 密钥,然后使用 Advanced Management 产品密钥:

    tsm licenses activate -k <product key>

  3. 配置初始节点设置:按照本主题中提供的说明进行操作,以配置初始节点设置。

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

使用发行版的软件包管理器安装 Tableau Server 独立网关,然后运行脚本以初始化独立网关。安装的软件包附带了该脚本。

独立网关安装在 /opt 目录中。

  1. 以具有 sudo 访问权限的用户身份登录到要在其中安装独立网关的计算机。

    注意:为避免可能出现的复杂情况,我们建议使用不包含任何特殊字符(例如,非 ASCII、“+”、“-”)的用户帐户。这些字符可能会导致问题,包括无法完全安装独立网关,具体取决于您的环境的配置方式。

  2. Tableau Server 下载和版本说明页面下载 .rpm.deb 安装程序包。

  3. 导航到您在其中复制了 .rpm.deb 软件包的目录。

  4. 使用软件包管理器来安装独立网关软件包。

    请不要安装到使用符号链接的位置,或安装到网络文件系统 (NFS) 卷上的目录。运行以下命令以安装独立网关,其中 <version> 的格式为“主要-次要-维护”(示例:2022-1-0)。

    • 在类似于 RHEL 的发行版(包括 CentOS)上:

      sudo yum update

      sudo yum install tableau-tsig-<version>.x86_64.rpm

    • Ubuntu 上:

      sudo apt-get update
      sudo apt-get upgrade
      sudo apt-get -y install gdebi-core
      sudo gdebi -n tableau-tsig-<version>_amd64.deb
      

初始化 Tableau Server 独立网关

下一步是运行 initialize-tsig 脚本。

  1. 导航到 scripts 目录:

    cd /opt/tableau/tableau_tsig/packages/scripts.<version_code>/
  2. 运行以下脚本来初始化并启动独立网关:

    sudo ./initialize-tsig --accepteula -c <ts_cluster_location> --<optional_parameters>

    initialize-tsig 脚本的唯一必需参数为 --accepteula-c

    • --accepteula - 您必须包括此参数来接受 Tableau 最终用户许可协议 (EULA)。EULA 的链接可在以下位置中找到:

      /opt/tableau/tableau_tsig/packages/docs.<version_code>/

    • -c - 您必须包含此参数以指定 Tableau Server 群集中所有节点的网络位置。这些节点可能正在向独立网关发送“整理”请求。可以使用通配符和子网掩码来指定多个节点。若要指定多个地址,请用空格分隔各个地址,并在整个地址周围使用引号。必须以 Apache httpd mod_authz_host “Require”指令可接受的形式之一提供值。有关详细信息,请参见 https://httpd.apache.org/docs/2.4/mod/mod_authz_host.html(链接在新窗口中打开)

    所有其他参数(例如 HTTP 和整理过程使用的默认端口)都是可选的,如果不使用,将被赋予默认值。在运行脚本之前查看参数及其默认值:initialize-tsig 脚本的帮助输出

步骤 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 匹配。如果您未提供此项,则默认值为独立网关计算机的完全限定的域名,以小写形式显示。json 文件中的值必须与 hostname 命令的输出匹配。
  • host - host 值必须是 Tableau Server 节点可使用 DNS 解析的独立网关计算机的 DNS 可解析名称。
  • port - port 必须与在独立网关实例上指定的整理端口 (tsig_housekeeping_port) 匹配。如果您在初始化期间未提供此信息,则默认值为“21319”。
  • protocol- 协议必须与在独立网关实例上指定的整理协议 (tsig_housekeeping_port_protocol ) 相同。如果您在初始化期间未提供此信息,则默认为“http”。
  • authsecret — authsecret 必须与独立网关实例上的初始化脚本创建的密文匹配。

独立网关身份验证密文

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

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

/var/opt/tableau/tableau_tsig/config/tsighk-auth.conf

独立网关 JSON 文件示例

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

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

在 Tableau Server 中启用独立网关

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

  1. 将 JSON 配置文件复制到 Tableau Server 的初始节点。
  2. 在初始节点上,使用作为 tsmadmin 组成员的帐户打开命令提示符。
  3. 运行以下命令以停止 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 进程打开端口以进行直接连接。有关详细信息,请参见直接连接

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

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