---
schema_version: "1"
id: 5fd5ad7fa0daa3034396c4eb19f6cc2e838b5e944b495bffbf7e844036276a16
title: Install the Agent Using Command Line
collection: tableau
version: current
locale: en-gb
portal_url: https://docs.salesforce.com/tableau/current/en-gb/server-linux/rmt-admin-agent-install-cli.md
canonical_url: https://help.tableau.com/current/server-linux/en-gb/rmt-admin-agent-install-cli.htm
source_site: help.tableau.com
content_type: documentation
content_hash: f72afcc3a10cf8ebab6a58bc7c865125b97c29cfab88dc69733f26dcfd096f95
description: Install the Resource Monitoring Tool Agent using the command line.
---
[Skip to main content](#main-content)

# 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 cause 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](https://help.tableau.com/current/tableau/en-gb/about-tableau-help.htm).

## Before you install

- Download the bootstrap file and save it to a location that is accessible to the nodes on which you are going to install RMT Agent. **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.**
- Agent registration will need to communicate both through an HTTPS endpoint and RabbitMQ to complete. Make sure both ports 443 and 5672 are open for these communications.

**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-x86_64-<version>.rpm`
        
        For Ubuntu:
        
        `sudo apt install Tabrmt-Agent-amd64-<version>.deb`
2. Initialise RMT Agent:
    
    You must explicitly accept the End User Licence Agreement (EULA) when you initialise RMT Agent. You also have the option to specify non-default configurations. To initialise RMT Agent with a default configuration, run this command :
    
    sudo /opt/tableau/tabrmt/agent/install-scripts/initialize-rmt-agent --accepteula
    
    The EULA can be found in the `/opt/tableau/tabrmt/agent/docs` folder.
    
    Beginning in version 2023.1 you can specify a custom Run As account to be used by RMT, as well as other configuration options. By default RMT creates and uses an account called `rmt-agent` to run under. To specify a custom Run As account to be used by RMT Agent, include the `--unprivileged-user` option when you run the initialisation script. For information about all the available switches for the `initialize-rmt-agent` script, see [RMT Agent Initialisation Script Options](https://help.tableau.com/current/server-linux/en-gb/rmt-install-init-agent-opts.htm#RMTServerInitOpts).
3. **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> --username=<name of the RMT admin user>`
        
        You will be prompted for the password of the RMT admin user.
        
        **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:
        
        <table style="width: 100%;" class="TableStyle-Basic-Border"><colgroup><col><col><col><col></colgroup><thead><tr><th>Option</th><th>Required?</th><th>Default</th><th>Description</th></tr></thead><tbody><tr><td>--bootstrap file</td><td>Yes</td><td>&lt;none&gt;</td><td>The location of the bootstrap file.</td></tr><tr><td>--username</td><td>Yes</td><td>&lt;none&gt;</td><td>This is typically the admin user you created during RMT Server installation.</td></tr><tr><td>--password</td><td>Yes</td><td>&lt;none&gt;</td><td>This is the password for the user account</td></tr><tr><td>--password-file</td><td><p>No</p><p>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.</p></td><td>&lt;none&gt;</td><td>Path including the file name where the password is stored.</td></tr><tr><td>--server-name</td><td>No</td><td>Host name of machine</td><td>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.</td></tr><tr><td>--server-description</td><td>No</td><td>&lt;none&gt;</td><td>Description of the computer that has the Agent installed. If no option is provided, this field will remain blank.</td></tr></tbody></table>

**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-64bit-<version>.exe /silent ACCEPTEULA=1`
        
        > [!TIP]
        > 
        > **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-64bit-<version>.exee /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:
        
        <table style="width: 100%;" class="TableStyle-Basic-Border"><colgroup><col><col><col><col></colgroup><thead><tr><th>Option</th><th>Required?</th><th><p>Default</p></th><th>Description</th></tr></thead><tbody><tr><td>--bootstrap file</td><td>Yes</td><td>&lt;none&gt;</td><td>The location of the bootstrap file.</td></tr><tr><td>--username</td><td>Yes</td><td>&lt;none&gt;</td><td>This is typically the admin user you created during RMT Server installation.</td></tr><tr><td>--password</td><td>Yes</td><td>&lt;none&gt;</td><td>This is the password for the user account</td></tr><tr><td>--password-file</td><td><p>No</p><p>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.</p></td><td>&lt;none&gt;</td><td>Path including the file name where the password is stored.</td></tr><tr><td>--server-name</td><td>No</td><td>Host name of machine</td><td>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.</td></tr><tr><td>--server-description</td><td>No</td><td>&lt;none&gt;</td><td>Description of the computer that has the Agent installed. If no option is provided, this field will remain blank.</td></tr></tbody></table>
        
        ### Windows install properties and switches
        
        **Switches:**
        
        | Switch | Description | Comments |
        | --- | --- | --- |
        | `/passive` | Run Setup with minimal UI and no prompts. |   |
        | `/quiet | /silent` | Run Setup in unattended, fully silent mode. No web interface or prompts are displayed. | Use either /quiet or /silent, not both. |
        
        Properties:
        
        <table style="width: 100%;" class="simple-table"><colgroup><col><col><col></colgroup><thead><tr><th>Property</th><th>Description</th><th>Comments</th></tr></thead><tbody><tr><td><code>InstallFolder=&lt;path\to\installation\directory&gt;</code></td><td>Install to the specified non-default install location.</td><td><p>Specifies the location to install RMT. If not used, RMT is installed to <i>C:\Program Files\Tableau\Tableau Resource Monitoring Tool\master</i>.</p><p>Example: <code>&lt;Setup file&gt; /silent InstallFolder="D:\Tableau\Tableau Resource Monitoring Tool\agent"</code></p></td></tr><tr><td><code>ACCEPTEULA=1|0</code></td><td>Accept the End User Licence 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.</td><td>If not included when using /passive, /silent or /quiet, Setup fails silently. If included but set to 0, Setup fails.</td></tr></tbody></table>

### 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](https://help.tableau.com/current/server-linux/en-gb/rmt-config-index-config.htm)