使用命令行安装 RMT Server

适用于： Tableau Advanced Management

Resource Monitoring Tool Server(RMT Server) 承载用户与之交互的 Web 应用程序。它还可以进行大量的后台处理，对代理中的数据进行排序和监视。RMT Server 必须安装在专用硬件上。

本主题介绍可以使用命令行安装 RMT Server 的步骤。Windows 和 Linux 操作系统都支持命令行安装。

为了与我们公司的平等价值观保持一致，我们在可能的情况下更改了非包容性术语。由于在某些地方更改术语可能会导致重大更改，因此我们保留现有术语：因此，您可能会继续在 CLI 命令和选项、安装文件夹、配置文件和其他实例中看到这些术语。有关详细信息，请参见“关于 Tableau 帮助”(链接在新窗口中打开)。

若要安装 RMT Server，请执行以下操作：

  1. 安装 RMT Server：

    1. 下载 rpm 或 .deb RMT Server 安装程序，并将其保存到可以从计划安装 RMT Server 的计算机上访问的位置。

    2. 登录到希望在其中以具有 sudo 访问权限的用户身份安装 RMT Server 的计算机。

    3. 运行以下命令以安装 RMT Server，其中 <version> 的格式为“主要-次要-维护”：

      对于类似于 RHEL 的发行版（包括 CentOS）：

      sudo yum install <pathtormtserverinstaller>/Tabrmt-Master-x86_64-<version>.rpm

      对于 Ubuntu 发行版：

      sudo apt install ./<pathtormtserverinstaller>/Tabrmt-Master-amd_64-<version>.deb

    这将安装软件包和必备组件，包括 RabbitMQ、Erlang 和 PostgreSQL 数据库。PostgreSQL 数据库用于存储从 Tableau Server 收集的使用情况数据。然后，它将继续安装 RMT Server。

  2. 初始化RMT Server：

    初始化 RMT Server 时，您必须明确接受最终用户许可协议 (EULA)。您还可以选择指定非默认配置。若要使用默认配置初始化 RMT Server，请运行以下命令：

    sudo /opt/tableau/tabrmt/master/install-scripts/initialize-rmt-master --accepteula

    EULA 可在 /opt/tableau/tabrmt/master/docs 文件夹中找到。

    从版本 2023.1 开始，您可以指定 RMT 使用的自定义运行身份帐户，以及其他配置选项。默认情况下，RMT 创建并使用一个名为 rmt-master 的帐户以在其下运行。若要指定 RMT Server 使用的自定义运行身份帐户，请在运行初始化脚本时包括 --unprivileged-user 选项。有关 initialize-rmt-master 脚本的所有可用开关的信息，请参见RMT Server 初始化脚本选项。

  3. 配置 RMT 服务器：

    1. 以 tabrmt-master 用户身份运行以下命令：

      sudo su --login tabrmt-master

      rmtadmin master-setup [options]

      配置选项可以通过命令提示符（配置文件）提供。如果未提供选项，则会应用除管理员密码外的默认值。管理员用户名将设置为 admin，并将提示您提供密码。

      示例命令，包括所需的 password 参数：

      rmtadmin master-setup --admin-username=<name of the administrator user> --admin-password=<administrator user password>

      下表列出了用于配置 RMT Server 所需的选项和一些常用选项。有关配置选项的完整列表，请参见rmtadmin 命令行实用工具。

      注意：需要 HTTPS 选项来确保 RMT Server 和用户之间的安全通信。当您需要 HTTPS 进行通信时，还必须为应该用于这些通信的证书选择一种模式。下表包括各种选项。若要详细了解这些模式和证书，请参见SSL 证书模式和要求。

      选项是否必需？

      默认

      		描述
      admin-password

      是

      密码可以在命令行中提供，也可以提供包含要使用的密码的文件。如果未提供任何一项，系统将提示您输入密码。

      		不适用管理员用户的密码。
      admin-password-file

      否

      密码可以在命令行中提供，也可以提供包含要使用的密码的文件。如果未提供任何一项，系统将提示您输入密码。

      		不适用

      存储管理员用户密码的文件。

      注意：tabrmt-master 用户必须有权访问此文件。

      admin-username否admin管理员用户的用户名。
      http-port否80 
      require-https否False将 http 流量重定向到 HTTPS。
      https-certificate-mode否

      "Default"

      可用选项：

      默认

      本地

      要对 HTTPS 证书执行的证书搜索的类型。

      默认：此模式使用安装程序提供的默认自签名证书。

      本地：允许您在 /var/opt/tableau/tabrmt/master/config 文件夹中指定基于文件的证书。

      https-certificate-local-name

      否

      注意：如果未指定，Resource Monitoring Tool 安装时将附带自签名证书，并将使用该证书进行 HTTPS 通信。

      		Null不带文件扩展名的 HTTPS 证书文件的名称。
      https-certificate-local-password否Null用于 HTTPS 证书的密码。
      https-certificate-local-password-file否Null包含用于 HTTPS 证书的密码的文件的路径。

  4. 创建环境：

    1. 运行以下命令以创建环境：

      rmtadmin create-env --name=<myenvironment> --api-username=<TableauServer API user name> --api-password=<password for the Tableau Server API user account>

      使用此命令可用的选项配置环境。以下是一些需要考虑的关键配置选项：

      • Tableau Server REST API 和 Tableau Server 存储库配置用于与 Tableau Server 通信。Tableau Server 存储库配置是可选的，但该配置是访问 Tableau Server 的首选方法。

      • 当 RMT 连接到 Tableau Server 存储库时，您可以选择配置安全加密连接。为了在 RMT 和 Tableau Server 存储库数据库之间使用 SSL 连接，必须将 Tableau Server 配置为使用 SSL。有关详细信息，请参见针对内部 Postgres 通信配置 SSL。

      下表列出了一些常用选项。若要查看选项的完整列表，请参见rmtadmin 命令行实用工具。

      选项是否必需？默认描述
      --name是不适用环境的名称。
      --gateway-url

      是

       

      		不适用

      用于访问 Tableau Server 网关的 URL。

      --version是不适用此环境将监控的 Tableau Server 版本。
      --api-username否Null用于连接到 Tableau Server API 的帐户的用户名。用户帐户应该是可以访问所有 Tableau Server 站点的 Tableau Server 管理员。
      --api-password

      否

      （如果您指定 Tableau API 用户名，您将提供密码，或指定文件路径和包含密码的文件）

      Null

      用于连接到 Tableau Server API 的 Tableau Server API 用户帐户的密码。

      --api-password-file否Null文件的路径和包含 Tableau Server API 用户帐户密码的文件的名称。
      --repository-server是

      Null

      		这是与 Tableau Server 一起安装的 PostgreSQL 数据库的服务器名称
      --repository-port是NullTableau Server 存储库数据库的的端口号。
      --repository-username是Null

      用于连接到随 Tableau Server 存储库一起安装的 PostgreSQL 数据库的用户名。

      出于性能原因，Resource Monitoring Tool 会直接访问 Tableau Server 存储库数据库。为了实现这一点，必须启用对存储库的访问，并为 readonly 数据库用户设置密码。有关详细信息，请参见启用对 Tableau Server 存储库的访问。

      --repository-password是Null

      用于连接到随 Tableau Server 一起安装的 PostgreSQL 数据库的用户帐户的密码。

      出于性能原因，Resource Monitoring Tool 会直接访问 Tableau Server 存储库数据库。为了实现这一点，必须启用对存储库的访问，并为 readonly 数据库用户设置密码。有关详细信息，请参见启用对 Tableau Server 存储库的访问。

      --repository-password-file否Null包含用于连接到与 Tableau Server 一起安装的 PostgreSQL 数据库的用户帐户密码所在文件名的路径。
      --repository-ssl-mode

      否

      		首选

      Tableau Server 存储库 SSL 模式：

      选择“首选SSL”或“需要 SSL”以配置与 Tableau 存储库的 SSL 连接。

      选择“禁用”以从不使用 SSL 建立 Tableau Server 存储库连接。

      --repository-ssl-thumbprint

      否

      		Null您可以选择提供 Tableau Server 生成的指纹，也可以将 server.crt 文件复制到 Resource Monitoring Tool 服务器 (RMT Server) 计算机。如果您选择复制证书文件，则不必提供指纹。有关详细信息，请参见配置 Postgres SSL 以允许从客户端直接连接。

    2. 将引导程序文件下载到可从 Tableau Server 节点访问的位置。

      rmtadmin bootstrap-file --env=<myenvironment> --filename=<The absolute or relative path including the file name>

  5. 可选步骤 - 仅在不使用 SSD 时：默认情况下，会针对 SSD 优化 Resource Monitoring Tool。如果未使用 SSD 硬件，请运行以下命令：

    sudo /opt/tableau/tabrmt/master/tabrmt-master optimize --no-ssd

若要安装 RMT Server，请执行以下操作：

  1. 运行 RMT Server 安装程序：

    1. 下载 RMT Server 安装程序，并将其保存到可以从计划安装 RMT Server 的计算机上访问的位置。

    2. 以管理员身份打开命令提示符。

    3. 导航到 RMT Server 安装程序的位置，并使用以下命令运行 exe 文件

      Tabrmt-Master-64bit-<version>.exe /silent ACCEPTEULA=1

      注意：使用 /silent 或 /quiet 开关在无人参与的情况下运行安装程序，而不显示任何 UI 或提示。

      默认安装文件夹通常如下：C:\Program Files\Tableau\Tableau Resource Monitoring Tool\master。若要提供其他安装位置，请运行以下命令：

      Tabrmt-Master-64bit-<version>.exe /silent ACCEPTEULA=1 InstallFolder="D:\Tableau Resource Monitoring Tool\master"

      所有安装命令属性和开关的完整列表可在下面的此部分找到。

    这将安装软件包和必备组件，包括 RabbitMQ、Erlang 和 PostgreSQL 数据库。PostgreSQL 数据库用于存储从 Tableau Server 收集的使用情况数据。然后，它将继续安装 RMT Server。

  2. 配置 RMT 服务器：

    1. 运行以下命令并提供选项：

      rmtadmin master-setup [options]

      配置选项可以通过命令提示符（配置文件）提供。如果未提供选项，则会应用除管理员密码外的默认值。管理员用户名将设置为 admin，并将提示您提供密码。

      示例命令，包括所需的 password 参数：

      rmtadmin master-setup --admin-username=<name of the administrator user> --admin-password=<administrator user password>

      下表列出了用于配置 RMT Server 所需的选项和一些常用选项。有关配置选项的完整列表，请参见rmtadmin 命令行实用工具。

      注意：需要 HTTPS 选项来确保 RMT Server 和用户之间的安全通信。当您需要 HTTPS 进行通信时，还必须为应该用于这些通信的证书选择一种模式。下表包括各种选项。若要详细了解这些模式和证书，请参见安装 Tableau Resource Monitoring Tool。

      选项是否必需？默认描述
      admin-password

      是

      密码可以在命令行中提供，也可以提供包含要使用的密码的文件。如果未提供任何一项，系统将提示您输入密码。

      		不适用管理员用户的密码。
      admin-password-file

      否

      密码可以在命令行中提供，也可以提供包含要使用的密码的文件。如果未提供任何一项，系统将提示您输入密码。

      		不适用存储管理员用户密码的文件。
      admin-username否admin管理员用户的用户名。
      http-port否80 
      require-https否False将 http 流量重定向到 HTTPS。
      https-certificate-mode否

      默认

      可用选项：

      • 默认
      • 存储
      • 本地

      要对 HTTPS 证书执行的证书搜索的类型。

      默认：此模式使用安装程序提供的默认自签名证书。

      存储：此模式允许您在 Windows 证书存储中输入证书的指纹。

      本地：允许您在 <安装目录>\config 文件夹中指定基于文件的证书。默认情况下，此文件夹为 C:\Program Files\Tableau\Tableau Resource Monitoring Tool\master\config。

      https-certificate-store-thumbprint否Null在“存储”证书模式下要搜索的 HTTPS 证书哈希/指纹。
      https-certificate-local-name否

      Null

      注意：如果未指定，Resource Monitoring Tool 安装时将附带自签名证书，并将使用该证书进行 HTTPS 通信。

      		不带文件扩展名的 HTTPS 证书文件的名称。
      https-certificate-local-password否Null用于 HTTPS 证书的密码。
      https-certificate-local-password-file否Null包含用于 HTTPS 证书的密码的文件的路径。

  3. 创建环境：

    1. 运行以下命令以创建环境：

      rmtadmin create-env --name=<myenvironment> --api-username=<TableauServer API user name> --api-password=<password for the Tableau Server API user account>

      使用此命令可用的选项配置环境。以下是一些需要考虑的关键配置选项：

      • Tableau Server REST API 和 Tableau Server 存储库配置用于与 Tableau Server 通信。Tableau Server 存储库配置是可选的，但该配置是访问 Tableau Server 的首选方法。

      • 当 RMT 连接到 Tableau Server 存储库时，您可以选择配置安全加密连接。为了在 RMT 和 Tableau Server 存储库数据库之间使用 SSL 连接，必须将 Tableau Server 配置为使用 SSL。有关详细信息，请参见针对内部 Postgres 通信配置 SSL。

      下表列出了一些常用选项。若要查看选项的完整列表，请参见rmtadmin 命令行实用工具。

      选项是否必需？默认描述
      --name是不适用环境的名称。
      --gateway-url

      是

       

      		不适用

      用于访问 Tableau Server 网关的 URL。

      --version是不适用此环境将监控的 Tableau Server 版本。
      --api-username否Null用于连接到 Tableau Server API 的帐户的用户名。用户帐户应该是可以访问所有 Tableau Server 站点的 Tableau Server 管理员。
      --api-password

      否

      （如果您指定 Tableau API 用户名，您将提供密码，或指定文件路径和包含密码的文件）

      Null

      用于连接到 Tableau Server API 的 Tableau Server API 用户帐户的密码。

      --api-password-file否Null文件的路径和包含 Tableau Server API 用户帐户密码的文件的名称。
      --repository-server是

      Null

      		这是与 Tableau Server 一起安装的 PostgreSQL 数据库的服务器名称
      --repository-port是NullTableau Server 存储库数据库的的端口号。
      --repository-username是Null

      用于连接到随 Tableau Server 存储库一起安装的 PostgreSQL 数据库的用户名。

      出于性能原因，Resource Monitoring Tool 会直接访问 Tableau Server 存储库数据库。为了实现这一点，必须启用对存储库的访问，并为 readonly 数据库用户设置密码。有关详细信息，请参见启用对 Tableau Server 存储库的访问。

      --repository-password是Null

      用于连接到随 Tableau Server 一起安装的 PostgreSQL 数据库的用户帐户的密码。

      出于性能原因，Resource Monitoring Tool 会直接访问 Tableau Server 存储库数据库。为了实现这一点，必须启用对存储库的访问，并为 readonly 数据库用户设置密码。有关详细信息，请参见启用对 Tableau Server 存储库的访问。

      --repository-password-file否Null包含用于连接到与 Tableau Server 一起安装的 PostgreSQL 数据库的用户帐户密码所在文件名的路径。
      --repository-ssl-mode

      否

      		首选

      Tableau Server 存储库 SSL 模式：

      选择“首选SSL”或“需要 SSL”以配置与 Tableau 存储库的 SSL 连接。

      选择“禁用”以从不使用 SSL 建立 Tableau Server 存储库连接。

      --repository-ssl-thumbprint

      否

      		Null您可以选择提供 Tableau Server 生成的指纹，也可以将 server.crt 文件复制到 Resource Monitoring Tool 服务器 (RMT Server) 计算机。如果您选择复制证书文件，则不必提供指纹。有关详细信息，请参见配置 Postgres SSL 以允许从客户端直接连接。

    2. 将引导程序文件下载到可从 Tableau Server 节点访问的位置。

      rmtadmin bootstrap-file --env=<myenvironment> --filename=<The absolute or relative path including the file name>

Windows 安装属性和开关

开关：

开关描述注释
/install | /uninstall运行安装程序以安装或卸载 Resource Monitoring Tool。

默认值为进行安装，并显示 UI 和所有提示。如果未对全新安装使用 InstallFolder 属性指定目录，则假定 C:\Program Files\Tableau\Tableau Resource Monitoring Tool\master。如果 Resource Monitoring Tool 已安装 ，安装程序将使用与当前安装相同的位置。

若要彻底移除 Resource Monitoring Tool（包括数据目录），请使用 /uninstall DELTEDATADIR=1

/passive运行安装程序并显示最少的 UI，并且不显示提示。 
/quiet | /silent以无人参与的完全无提示模式运行安装程序。不显示任何 Web 界面或提示。使用 /quiet 或 /silent，而不是两者。
/norestart运行安装程序而不重新启动 Windows，即使必须重新启动也是如此。在某些极少数情况下，即使使用此选项，也无法抑制重新启动。在跳过之前系统重新启动时，很有可能发生这种情况。举例来说，如果在安装其他软件期间跳过了重新启动。
/log <log-file>将信息记录到指定的文件和路径。默认情况下，系统使用命名约定 Tableau_Resource_Monitoring_Tool_<版本代码> 在 %TEMP% 中创建日志文件。

如果未指定文件位置，则将日志文件写入 TEMP 文件夹 - C:\Users\<用户名>\AppData\Local\Temp。安装之后，检查此日志文件来查找错误。

例如：<Setup file> /quiet /log="C:\Tableau\Logs\RmtInstall

属性：

属性描述注释
InstallFolder=<path\to\installation\directory>安装到指定的非默认安装位置。

指定用于安装 RMT 的位置。如果未使用，则 RMT 将安装到 C:\Program Files\Tableau\Tableau Resource Monitoring Tool\master。

示例：<Setup file> /silent InstallFolder="D:\Tableau\Tableau Resource Monitoring Tool\master"

ACCEPTEULA=1|0接受最终用户许可协议 (EULA)。对于初始节点和附加节点上的无提示和被动安装为必需。1=True，接受 EULA，0=false，不接受 EULA。如果使用 /passive、/silent 或 /quiet 时未包括此开关，则安装程序将无法以无提示形式运行。如果包含此属性但设置为 0，安装程序将失败

     

谁可以执行此操作

为了安装 Resource Monitoring Tool，您必须具有以下所有各项：

Windows

  • 正在安装 Resource Monitoring Tool 的计算机上的管理员权限。
  • Tableau Server 管理员站点角色。
  • Resource Monitoring Tool 管理员帐户。

Linux

  • 用于安装代理的用户帐户的完全 sudo 访问权限。
  • Resource Monitoring Tool 管理员帐户

后续步骤

使用命令行安装代理

回到顶部
感谢您的反馈!您的反馈已成功提交。谢谢!