使用命令行安装 RMT Server

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-usernameadmin管理员用户的用户名。
      http-port80 
      require-httpsFalse如果为 True,则 http 不可用。

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

      'Default'

      可用选项:

      • 默认
      • 存储
      • 本地

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

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

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

      本地:允许您在 config 文件夹中指定基于文件的证书。

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

      Null

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

      不带文件扩展名的 HTTPS 证书文件的名称。
      https-certificate-local-passwordNull用于 HTTPS 证书的密码。
      https-certificate-local-password-fileNull包含用于 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-usernameNull用于连接到 Tableau Server API 的帐户的用户名。用户帐户应该是可以访问所有 Tableau Server 站点的 Tableau Server 管理员。
      --api-password

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

      Null

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

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

      Null

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

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

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

      --repository-passwordNull

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

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

      --repository-password-fileNull包含用于连接到与 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-usernameadmin管理员用户的用户名。
      http-port80 
      require-httpsFalse

      将 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-passwordNull用于 HTTPS 证书的密码。
      https-certificate-local-password-fileNull包含用于 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-usernameNull用于连接到 Tableau Server API 的帐户的用户名。用户帐户应该是可以访问所有 Tableau Server 站点的 Tableau Server 管理员。
      --api-password

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

      Null

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

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

      Null

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

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

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

      --repository-passwordNull

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

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

      --repository-password-fileNull包含用于连接到与 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 管理员帐户

后续步骤

使用命令行安装代理

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