---
schema_version: "1"
id: 8e4577aef8e7e7774191eb8dc6a1e12d3b87faf7c2a105faeaae7e78d0042e91
title: 명령줄을 사용하여 에이전트 설치
collection: tableau
version: current
locale: ko-kr
portal_url: https://docs.salesforce.com/tableau/current/ko-kr/server-linux/rmt-admin-agent-install-cli.md
canonical_url: https://help.tableau.com/current/server-linux/ko-kr/rmt-admin-agent-install-cli.htm
source_site: help.tableau.com
content_type: documentation
content_hash: b54e1a1295e875d179988e0cc6d0194cbe25d38f90803c31a8170af93e6f358d
description: Install the Resource Monitoring Tool Agent using the command line.
---
[주요 콘텐츠로 건너뛰기](#main-content)

# 명령줄을 사용하여 에이전트 설치

에이전트는 최소한의 서버 리소스를 사용하고 데이터를 Resource Monitoring Tool 서버(RMT 서버)로 보내는 경량 프로세스입니다. 각 Tableau Server 노드에 Resource Monitoring Tool 에이전트를 설치합니다. 에이전트를 설치하고 등록하려면 에이전트 부트스트랩 구성 파일을 다운로드하여 Resource Monitoring Tool 에이전트 노드에서 액세스할 수 있는 위치에 저장합니다.

이 항목에서는 명령줄을 사용하여 Resource Monitoring Tool 에이전트를 설치하는 데 사용할 수 있는 단계를 설명합니다. 명령줄 설치는 Windows 및 Linux 운영 체제 모두에서 지원됩니다.

회사 가치인 평등에 맞추려는 노력의 일환으로 가능한 경우 비포용적인 용어를 변경했습니다. 특정 위치에서 용어를 변경하면 해당 변경이 너무 큰 영향을 미칠 수 있으므로 기존 용어를 유지합니다. 따라서 CLI 명령 및 옵션, 설치 폴더, 구성 파일 및 기타 인스턴스에는 계속해서 이러한 용어가 표시될 수 있습니다. 자세한 내용은 [Tableau 도움말 정보](https://help.tableau.com/current/tableau/ko-kr/about-tableau-help.htm)를 참조하십시오.

## 설치 전 수행할 작업

- 부트스트랩 파일을 다운로드하고 RMT 에이전트를 설치할 노드에서 액세스할 수 있는 위치에 저장합니다. **부트스트랩 파일은 다운로드 후 24시간 동안만 유효합니다. 사용하는 부트스트랩 파일이 24시간이 지난 경우 부트스트랩 파일을 다시 생성해야 합니다.**
- https 끝점 및 RabbitMQ 둘 모두를 통해 통신해야 에이전트 등록이 완료됩니다. 포트 443과 5672가 이러한 통신에 대해 열려 있는지 확인하십시오.

**에이전트를 설치하고 구성하려면:**

1. **설치:**
    1. .rpm 또는 .deb 에이전트 설치 프로그램을 다운로드하여 에이전트를 설치할 컴퓨터에서 액세스할 수 있는 위치에 저장합니다.
    2. 다음 명령을 실행하여 에이전트를 설치합니다. 여기서, <version>은 주-부-유지 관리 형식입니다.
        
        CentOS를 포함한 RHEL 호환 배포의 경우:
        
        `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 에이전트 초기화 스크립트 옵션](https://help.tableau.com/current/server-linux/ko-kr/rmt-install-init-agent-opts.htm#RMTServerInitOpts)을 참조하십시오.
3. **등록:**
    1. 로그오프한 후 항상 _tabrmt-agent_ 사용자로 실행해야 하는 rmtadmin 명령을 실행할 수 있도록 _tabrmt-agent_ 사용자로 로그온합니다. 또한 다시 로그온하면 그룹 멤버 자격 변경 사항이 적용된 새 세션이 생성됩니다.
        
        `sudo su --login tabrmt-agent`
    2. 다음 명령을 실행하고 부트스트랩 파일이 있는 경로를 제공합니다. 에이전트가 설치되는 노드에 대한 설명을 제공합니다.
        
        `rmtadmin register <bootstrap file path\file> --server-name=<Friendly name of machine> --server-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>.`이 됩니다.
        
        다음 표에는 에이전트를 등록하는 데 사용되는 구성 옵션이 나와 있습니다.
        
        <table style="width: 100%;" class="TableStyle-Basic-Border"><colgroup><col><col><col><col></colgroup><thead><tr><th>옵션</th><th>필수?</th><th>기본값</th><th>설명</th></tr></thead><tbody><tr><td>--bootstrap file</td><td>예</td><td>&lt;없음&gt;</td><td>부트스트랩 파일의 위치입니다.</td></tr><tr><td>--username</td><td>예</td><td>&lt;없음&gt;</td><td>이는 일반적으로 RMT 서버 설치 중에 만든 관리자 사용자입니다.</td></tr><tr><td>--password</td><td>예</td><td>&lt;없음&gt;</td><td>이는 사용자 계정의 비밀번호입니다.</td></tr><tr><td>--password-file</td><td><p>아니요</p><p>비밀번호는 명령줄에서 제공하거나 비밀번호가 포함된 파일에서 제공할 수 있습니다. 어느 것도 제공하지 않으면 비밀번호를 입력하라는 메시지가 나타납니다.</p></td><td>&lt;없음&gt;</td><td>비밀번호가 저장된 파일 이름이 포함된 경로입니다.</td></tr><tr><td>-- server-name</td><td>아니요</td><td>컴퓨터의 호스트 이름</td><td>에이전트가 설치된 컴퓨터의 이름입니다. 옵션이 제공되지 않으면 이 필드는 기본적으로 컴퓨터의 호스트 이름으로 설정됩니다.</td></tr><tr><td>--server-description</td><td>아니요</td><td>&lt;없음&gt;</td><td>에이전트가 설치된 컴퓨터의 설명입니다. 옵션이 제공되지 않으면 이 필드는 비어 있습니다.</td></tr></tbody></table>

**에이전트를 설치하고 구성하려면:**

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`
        
        > [!TIP]
        > 
        > **참고:** UI 또는 프롬프트를 표시하지 않고 자동으로 설치를 실행하려면 /silent 또는 /quiet 스위치를 사용합니다.
        
        기본 설치 폴더는 일반적으로 _C:\\Program Files\\Tableau\\Tableau Resource Monitoring Tool\\agent_입니다. 다른 설치 위치를 제공하려면 다음 명령을 실행합니다.
        
        `Tabrmt-Agent-64bit-<version>.exee /silent ACCEPTEULA=1 InstallFolder="D:\Tableau Resource Monitoring Tool\agent"`
3. 에이전트 등록:
    1. 다음 명령을 실행하여 에이전트를 등록합니다.
        
        `rmtadmin register <bootstrap file path\file> --server-name=<Friendly name of machine> --server-description=<server description>`
        
        다음 표에는 에이전트를 등록하는 데 사용되는 구성 옵션이 나와 있습니다.
        
        <table style="width: 100%;" class="TableStyle-Basic-Border"><colgroup><col><col><col><col></colgroup><thead><tr><th>옵션</th><th>필수?</th><th><p>기본값</p></th><th>설명</th></tr></thead><tbody><tr><td>--bootstrap file</td><td>예</td><td>&lt;없음&gt;</td><td>부트스트랩 파일의 위치입니다.</td></tr><tr><td>--username</td><td>예</td><td>&lt;없음&gt;</td><td>이는 일반적으로 RMT 서버 설치 중에 만든 관리자 사용자입니다.</td></tr><tr><td>--password</td><td>예</td><td>&lt;없음&gt;</td><td>이는 사용자 계정의 비밀번호입니다.</td></tr><tr><td>--password-file</td><td><p>아니요</p><p>비밀번호는 명령줄에서 제공하거나 비밀번호가 포함된 파일에서 제공할 수 있습니다. 어느 것도 제공하지 않으면 비밀번호를 입력하라는 메시지가 나타납니다.</p></td><td>&lt;없음&gt;</td><td>비밀번호가 저장된 파일 이름이 포함된 경로입니다.</td></tr><tr><td>-- server-name</td><td>아니요</td><td>컴퓨터의 호스트 이름</td><td>에이전트가 설치된 컴퓨터의 이름입니다. 옵션이 제공되지 않으면 이 필드는 기본적으로 컴퓨터의 호스트 이름으로 설정됩니다.</td></tr><tr><td>-- server-description</td><td>아니요</td><td>&lt;없음&gt;</td><td>에이전트가 설치된 컴퓨터의 설명입니다. 옵션이 제공되지 않으면 이 필드는 비어 있습니다.</td></tr></tbody></table>
        
        ### Windows 설치 속성 및 스위치
        
        **스위치:**
        
        | 스위치 | 설명 | 댓글 |
        | --- | --- | --- |
        | `/passive` | 최소한의 UI를 사용하고 프롬프트 없이 설치 프로그램을 실행합니다. |   |
        | `/quiet | /silent` | 완전 무인 자동 모드로 설치를 실행합니다. 웹 인터페이스 또는 프롬프트를 표시하지 않습니다. | /quiet 또는 /silent 중 하나만 사용하십시오. 둘 모두를 사용해서는 안 됩니다. |
        
        속성:
        
        <table style="width: 100%;" class="simple-table"><colgroup><col><col><col></colgroup><thead><tr><th>속성</th><th>설명</th><th>댓글</th></tr></thead><tbody><tr><td><code>InstallFolder=&lt;path\to\installation\directory&gt;</code></td><td>지정된 기본 위치가 아닌 설치 위치에 설치합니다.</td><td><p>RMT를 설치할 위치를 지정합니다. 사용하지 않으면 RMT는 <i>C:\Program Files\Tableau\Tableau Resource Monitoring Tool\master</i>에 설치됩니다.</p><p>예: <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>EULA(최종 사용자 사용권 계약)에 동의합니다. 초기 노드와 추가 노드 모두에서 quiet, silent 및 passive 설치에 필요합니다. 1 = true, EULA에 동의, 0 = false, EULA에 동의하지 않음.</td><td>/passive, /silent 또는 /quiet를 사용할 때 이 스위치가 없으면 설치가 실패합니다. 포함되어 있지만 0으로 설정된 경우에도 설치가 실패합니다.</td></tr></tbody></table>

### 다중 노드 Tableau Server에 에이전트 설치

Tableau Server의 각 노드에서 위에 설명된 단계를 실행합니다. RMT 서버의 웹 인터페이스에서 에이전트가 설치된 모든 노드를 볼 수 있어야 합니다.

## 이 작업을 수행할 수 있는 사용자

Resource Monitoring Tool를 설치하려면 다음이 모두 필요합니다.

**Windows:**

- Resource Monitoring Tool를 설치하는 컴퓨터에 대한 관리자 사용 권한
- Tableau Server 관리자 사이트 역할

**Linux:**

- 에이전트를 설치하는 데 사용되는 사용자 계정에 대한 전체 sudo 액세스 권한

## 다음 단계

[Tableau Resource Monitoring Tool 구성](https://help.tableau.com/current/server-linux/ko-kr/rmt-config-index-config.htm)