使用命令行安装 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. 下载 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 Server。

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

      rmtadmin master-setup [options]

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

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

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

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

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

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

      是

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

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

      否

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

      		不适用存储管理员用户密码的文件。
      admin-username否admin管理员用户的用户名。
      http-port否80 
      require-https否False如果为 True，则 http 不可用。

      如果为 False，则 htt p将转发到 https。
      https-certificate-mode否

      'Default'

      可用选项：

      • 默认
      • 存储
      • 本地

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

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

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

      本地：允许您在 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，安装程序将失败

若要安装 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 <path/to/rmtserverinstaller>/Tabrmt-Master-x86_64-<version>.rpm

      对于 Ubuntu 发行版：

      sudo apt install ./ <path/to/rmtserverinstaller>/Tabrmt-Master-amd64-<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 Server

    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 进行通信时，还必须为应该用于这些通信的证书选择一种模式。下表包括各种选项。若要详细了解这些模式和证书，请参见安装 Tableau Resource Monitoring Tool。

      选项是否必需？

      默认

      		描述
      admin-password

      是

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

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

      否

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

      		不适用

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

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

      admin-username否admin管理员用户的用户名。
      http-port否80 
      require-https否False

      将 http 流量重定向到 HTTPS。

      https-certificate-mode否

      可用选项：

      • 默认
      • 本地

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

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

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

     

谁可以执行此操作

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

Windows

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

Linux

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

后续步骤

使用命令行安装代理

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