使用命令行安装代理

适用于： Tableau Advanced Management

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

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

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

安装之前

  • 下载引导程序文件并将其保存到要安装 RMT 代理的节点可以访问的位置。引导程序文件仅在下载后 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. 注册：

    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>

      系统将提示您输入 RMT 管理用户的密码。

      注意：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

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