使用命令行安装代理

代理是一个轻量级进程,它占用的服务器资源最少,并将数据发送到 Resource Monitoring Tool Server (RMT Server)。在每个 Tableau Server 节点上安装 Resource Monitoring Tool 代理。若要安装和注册代理,请下载代理引导程序配置文件,并将其保存到可从 Resource Monitoring Tool 代理节点中访问的一个位置。

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

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

安装之前

  • 下载引导程序文件。引导程序文件仅在下载后 24 小时内有效。如果您使用的引导程序文件超过 24 小时,您将需要重新生成引导程序文件。
  • 从版本 2021.3 开始,代理注册将需要通过 https 端点和 RabbitMQ 进行通信以完成代理注册。确保为这些通信打开了端口 443 和 5672。

安装和配置代理:

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

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

  2. 运行代理安装程序:
    1. 下载代理安装程序,将其保存到可以从 Tableau Server 计算机访问的位置。

    2. 以管理员身份打开命令提示符。
    3. 导航到代理安装程序的位置,并使用以下命令运行 exe 文件

      Tabrmt-Agent-64bit-<version>.exe /silent ACCEPTEULA=1 RUN_AS_USER_CUSTOM=1 RUN_AS_USERNAME=<username> RUN_AS_PASSWORD=<password>

      从 2021.4 开始,您必须为代理指定用户运行身份帐户。此帐户用于访问 Tableau Server 以收集监控信息。

      对于用户运行身份帐户,指定您当前用于 Tableau Server 用户帐户的相同帐户。如果您提供的帐户信息与 Tableau Server 上的帐户信息不同,则代理将无法收集该节点上的监控数据。

      • 如果您的 Tableau Server 配置为使用网络服务帐户作为用户运行身份,请使用 RUN_AS_NETWORK_SERVICE=1。
      • 如果您的 Tableau Server 配置为使用自定义用户,请使用 RUN_AS_USER_CUSTOM=1。使用为 Tableau Server 指定的相同帐户凭据。

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

      Tabrmt-Agent-64bit-<version>.exe/silent ACCEPTEULA=1 RUN_AS_USER_CUSTOM=1 RUN_AS_USERNAME=<username> RUN_AS_PASSWORD=<password> InstallFolder="D:\Tableau Resource Monitoring Tool\agent"

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

  3. 注册代理:
    1. 运行以下命令以注册代理:

      rmtadmin register <bootstrap file path\file> --server-name=<Friendly name of machine> --server-description=<server description> --username <name of the RMT admin user> --password <password for the user account>

      下表列出了用于注册代理的配置选项:

      选项是否必需?

      默认

      描述
      --bootstrap file<无>引导程序文件的位置。
      --username<无>这通常是您在 RMT Server 安装期间创建的管理员用户。
      --password<无>这是用户帐户的密码
      --password-file

      密码可以在命令行中提供,或者在包含密码的文件中提供。如果未提供任何一项,系统将提示您输入密码。

      <无>包含存储密码的文件名的路径。
      --server-name计算机的主机名安装了代理的计算机的名称。如果未提供任何选项,此字段将默认为计算机的主机名。
      --server-description<无>安装了代理的计算机的描述。如果未提供任何选项,此字段将留空。

      Windows 安装属性和开关

      开关:

      开关描述注释
      /passive运行安装程序并显示最少的 UI,并且不显示提示。 
      /quiet | /silent以无人参与的完全无提示模式运行安装程序。不显示任何 Web 界面或提示。使用 /quiet 或 /silent,而不是两者。

      属性:

      属性描述注释
      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\agent"

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

       

安装和配置代理:

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

    2. 运行以下命令以安装代理,其中 <version> 的格式为“主要-次要-维护”:

      对于类似于 RHEL 的发行版(包括 CentOS):

      sudo yum install Tabrmt-Agent-x86_64-<version>.rpm

      对于 Ubuntu:

      sudo apt install Tabrmt-Agent-amd64-<version>.deb

  2. 初始化 RMT 代理:

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

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

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

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

  3. 下载引导程序文件

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

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

  4. 注册:
    1. 注销并以 tabrmt-agent 用户身份登录,以便可以运行 rtmadmin 命令,该命令始终要求您以 tabrmt-agent 用户身份运行。并且,当您再次登录时,将会创建一个组成员身份变更已生效的新会话。

      sudo su --login tabrmt-agent

    2. 运行以下命令并提供引导程序文件所在的路径。提供安装代理的节点的描述。

      rmtadmin register <bootstrap file path\file> --server-name=<Friendly name of machine> --agent-description=<server description> --username=<name of the RMt admin user> --password=<password of the RMT admin user>

      注意:tabrmt-agent 用户默认从基本工作目录运行命令:/var/opt/tableau/tabrmt/agent,因此您必须相应地指定完整的文件路径。举例来说,如果按照建议将引导程序文件放在 /var/opt/tableau/tabrmt/agent/bootstrap/ 文件夹中,则文件路径为 /var/opt/tableau/tabrmt/agent/bootstrap/<bootstrap_file_name>.json

      下表列出了用于注册代理的配置选项:

      选项是否必需?默认描述
      --bootstrap file<无>引导程序文件的位置。
      --username<无>这通常是您在 RMT Server 安装期间创建的管理员用户。
      --password<无>这是用户帐户的密码
       

      密码可以在命令行中提供,或者在包含密码的文件中提供。如果未提供任何一项,系统将提示您输入密码。

      <无>包含存储密码的文件名的路径。
      --server-name计算机的主机名安装了代理的计算机的名称。如果未提供任何选项,此字段将默认为计算机的主机名。
      --server-description<无>安装了代理的计算机的描述。如果未提供任何选项,此字段将留空。

在多节点 Tableau Server 上安装代理

在 Tableau Server 的每个节点上运行上述步骤。在 RMT Server 的 Web 界面上,您应该能够看到安装代理的所有节点。

谁可以执行此操作

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

Windows:

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

Linux:

  • 用于安装代理的用户帐户的完全 sudo 访问权限。

后续步骤

配置 Tableau Resource Monitoring Tool

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