Install the Agent Using Command Line

The Agent is a lightweight process that consumes minimal server resources and sends data to the Resource Monitoring Tool Server (RMT Server). Install the Resource Monitoring Tool Agent on each of your Tableau Server nodes. To install and register an Agent, download the Agent bootstrap configuration file and save it to a location that is accessible from the Resource Monitoring Tool Agent nodes.

This topic describes the steps you can use to install the Resource Monitoring Tool Agent using command line. Command line installation is supported on both Windows and Linux operating systems.

In an effort to align with our company values of Equality, we have changed non-inclusive terminology where possible. Because changing terms in certain places can causing a breaking change, we maintain the existing terminology. So, you may continue to see the terms in CLI commands and options, installation folders, configuration files. and other instances. For more information, see About Tableau Help.

Before you install

  • Download the bootstrap file. Bootstrap files are only valid for 24 hours after downloading.  You will need to regenerate the bootstrap file if the one you are using is older than 24 hours.
  • Starting in version 2021.3, Agent registration will need to communicate both through a https endpoint and RabbitMQ to complete Agent registration. Make sure both ports 443 and 5672 are open for these communcations.

To install and configure the Agent:

  1. Install:
    1. Download the .rpm or .deb Agent Installer and save it to a location that you can access from the machine where you plan to install the Agent.

    2. Run the following command to install the Agent where <version> is formatted as major-minor-maintenance:

      For RHEL like distributions including CentOS:

      sudo yum install tabrmt-agent-setup-<version>-x86_64.rpm

      For Ubuntu and Debian:

      sudo apt install tabrmt-agent-setup<version>-amd64.deb

  2. Initialize:
    1. To accept EULA and initialize, run the following command :

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

      The end user agreement (EULA) can be found in the /opt/tableau/tabrmt/agent/docs folder.

  3. Download the bootstrap file

    Download the bootstrap file to a location that can be accessed from the Tableau Server nodes.

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

  4. Register:
    1. Log off and log on as the tabrmt-agent user so you can run rmtadmin commands which always require that you run as the tabrmt-agent user. Also,when you log on again, you create a new session in which group membership changes have taken effect.

      sudo su --login tabrmt-agent

    2. Run the following command and provide the path where the bootstrap file is located. Provide a description of the node where the Agent is being installed.

      rmtadmin register <bootstrap file path\file> --server-name=<Friendly name of machine> --server-description=<server description>

      Note: The tabrmt-agent user defaults to run commands from the base working directory: /var/opt/tableau/tabrmt/agent, so you must specify the file path accordingly. For example, if you placed the bootstrap file in the /var/opt/tableau/tabrmt/agent/bootstrap/ folder as recommended, the file path would be /var/opt/tableau/tabrmt/agent/bootstrap/<bootstrap_file_name>.

      The following table lists the configuration options used to register the Agent:

      Option Required? Default Description
      --bootstrap file Yes <none> The location of the bootstrap file.
      --username Yes <none> This is typically the admin user you created during RMT Server installation.
      --password Yes <none> This is the password for the user account
      --password-file

      No

      Password can be supplied in the command line or a file that contains the password. If neither is provided, you will be prompted for the password.

      <none> Path including the file name where the password is stored.
      -- server-name No Host name of machine Name of the computer that has the Agent Installed. If no option is provided, this field will default to the host name of the machine.
      --server-description No <none> Description of the computer that has the Agent installed. If no option is provided, this field will remain blank.

To install and configure the Agent:

  1. Download the bootstrap file to a location that can be accessed from the Tableau Server nodes.

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

  2. Run the Agent setup program:
    1. Download the Agent installer and save it to a location that you can access from Tableau Server machines.

    2. Open the command prompt as an administrator.
    3. Navigate to the location of the Agent installer and run the exe file using the following command

      tabrmt-agent-<version>-64bit.exe /silent ACCEPTEULA=1

      Note: Use the /silent or /quiet switch to run the setup unattended and without displaying any UI or prompts.

      The default install folder is usually like this: C:\Program Files\Tableau\Tableau Resource Monitoring Tool\agent. To provide a different install location run the following command:

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

  3. Register the Agent:
    1. Run the following command to register the Agent:

      rmtadmin register <bootstrap file path\file> --server-name=<Friendly name of machine> --server-description=<server description>

      The following table lists the configuration options used to register the Agent:

      OptionRequired?

      Default

      Description
      --bootstrap file Yes <none> The location of the bootstrap file.
      --usernameYes<none>This is typically the admin user you created during RMT Server installation.
      --passwordYes<none>This is the password for the user account
      --password-file

      No

      Password can be supplied in the command line or a file that contains the password. If neither is provided, you will be prompted for the password.

      <none>Path including the file name where the password is stored.
      -- server-name No Host name of machine Name of the computer that has the Agent Installed. If no option is provided, this field will default to the host name of the machine.
      -- server-description No <none> Description of the computer that has the Agent installed. If no option is provided, this field will remain blank.

      Windows install properties and switches

      Switches:

      SwitchDescriptionComments
      /passiveRun Setup with minimal UI and no prompts. 
      /quiet | /silentRun Setup in unattended, fully silent mode. No web interface or prompts are displayed.Use either /quiet or /silent, not both.

      Properties:

      PropertyDescriptionComments
      InstallFolder=<path\to\installation\directory>Install to the specified non-default install location.

      Specifies the location to install RMT. If not used, RMT is installed to C:\Program Files\Tableau\Tableau Resource Monitoring Tool\master.

      Example: <Setup file> /silent InstallFolder="D:\Tableau\Tableau Resource Monitoring Tool\agent"

      ACCEPTEULA=1|0Accept the End User License Agreement (EULA). Required for quiet, silent, and passive install on both initial and additional nodes. 1 = true, accept the EULA, 0 = false, do not accept the EULA. If not included when using /passive, /silent or /quiet, Setup fails silently. If included but set to 0, Setup fails.

       

Installing Agent on Multi-Node Tableau Server

Run the steps described above on each of the nodes of Tableau Server. On the web interface of the RMT Server you should be able to see all the nodes where the Agent is installed.

Who can do this

To install Resource Monitoring Tool, you must have all the following:

Windows:

  • Administrator permissions on the machine you are installing Resource Monitoring Tool.
  • Tableau Server Administrator site role.

Linux:

  • Full sudo access for the user account that is used to install the Agent.

Next Step

Configure Tableau Resource Monitoring Tool

Thanks for your feedback!