명령줄을 사용하여 에이전트 설치
에이전트는 최소한의 서버 리소스를 사용하고 데이터를 Resource Monitoring Tool 서버(RMT 서버)로 보내는 경량 프로세스입니다. 각 Tableau Server 노드에 Resource Monitoring Tool 에이전트를 설치합니다. 에이전트를 설치하고 등록하려면 에이전트 부트스트랩 구성 파일을 다운로드하여 Resource Monitoring Tool 에이전트 노드에서 액세스할 수 있는 위치에 저장합니다.
이 항목에서는 명령줄을 사용하여 Resource Monitoring Tool 에이전트를 설치하는 데 사용할 수 있는 단계를 설명합니다. 명령줄 설치는 Windows 및 Linux 운영 체제 모두에서 지원됩니다.
회사 가치인 평등에 맞추려는 노력의 일환으로 가능한 경우 비포용적인 용어를 변경했습니다. 특정 위치에서 용어를 변경하면 해당 변경이 너무 큰 영향을 미칠 수 있으므로 기존 용어를 유지합니다. 따라서 CLI 명령 및 옵션, 설치 폴더, 구성 파일 및 기타 인스턴스에는 계속해서 이러한 용어가 표시될 수 있습니다. 자세한 내용은 Tableau 도움말 정보(링크가 새 창에서 열림)를 참조하십시오.
설치 전 수행할 작업
- 부트스트랩 파일을 다운로드하고 RMT 에이전트를 설치할 노드에서 액세스할 수 있는 위치에 저장합니다. 부트스트랩 파일은 다운로드 후 24시간 동안만 유효합니다. 사용하는 부트스트랩 파일이 24시간이 지난 경우 부트스트랩 파일을 다시 생성해야 합니다.
- 버전 2021.3부터 에이전트 등록 시 https 끝점 및 RabbitMQ를 통해 통신해야 에이전트 등록이 완료됩니다. 포트 443과 5672가 이러한 통신에 대해 열려 있는지 확인하십시오.
에이전트를 설치하고 구성하려면:
부트스트랩 파일을 Tableau Server 노드에서 액세스할 수 있는 위치에 다운로드합니다.
rmtadmin bootstrap-file --env=<myenvironment> --filename<The absolute or relative path including the file name>
- 에이전트 설치 프로그램 실행:
에이전트 설치 프로그램을 다운로드하여 Tableau Server 컴퓨터에서 액세스할 수 있는 위치에 저장합니다.
- 관리자 자격으로 명령 프롬프트를 엽니다.
에이전트 설치 프로그램의 위치로 이동하고 다음 명령을 사용하여 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"
참고: UI 또는 프롬프트를 표시하지 않고 자동으로 설치를 실행하려면 /silent 또는 /quiet 스위치를 사용합니다.
- 에이전트 등록:
다음 명령을 실행하여 에이전트를 등록합니다.
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 서버 설치 중에 만든 관리자 사용자입니다. --password 예 <없음> 이는 사용자 계정의 비밀번호입니다. --password-file 아니요
비밀번호는 명령줄에서 제공하거나 비밀번호가 포함된 파일에서 제공할 수 있습니다. 어느 것도 제공하지 않으면 비밀번호를 입력하라는 메시지가 나타납니다.
<없음> 비밀번호가 저장된 파일 이름이 포함된 경로입니다. --server-name 아니요 컴퓨터의 호스트 이름 에이전트가 설치된 컴퓨터의 이름입니다. 옵션이 제공되지 않으면 이 필드는 기본적으로 컴퓨터의 호스트 이름으로 설정됩니다. --server-description 아니요 <없음> 에이전트가 설치된 컴퓨터의 설명입니다. 옵션이 제공되지 않으면 이 필드는 비어 있습니다. Windows 설치 속성 및 스위치
스위치:
스위치 설명 댓글 /passive
최소한의 UI를 사용하고 프롬프트 없이 설치 프로그램을 실행합니다. /quiet | /silent
완전 무인 자동 모드로 설치를 실행합니다. 웹 인터페이스 또는 프롬프트를 표시하지 않습니다. /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(최종 사용자 사용권 계약)에 동의합니다. 초기 노드와 추가 노드 모두에서 quiet, silent 및 passive 설치에 필요합니다. 1 = true, EULA에 동의, 0 = false, EULA에 동의하지 않음. /passive, /silent 또는 /quiet를 사용할 때 이 스위치가 없으면 설치가 실패합니다. 포함되어 있지만 0으로 설정된 경우에도 설치가 실패합니다.
다중 노드 Tableau Server에 에이전트 설치
Tableau Server의 각 노드에서 위에 설명된 단계를 실행합니다. RMT 서버의 웹 인터페이스에서 에이전트가 설치된 모든 노드를 볼 수 있어야 합니다.
Resource Monitoring Tool를 설치하려면 다음이 모두 필요합니다.
Windows:
- Resource Monitoring Tool를 설치하는 컴퓨터에 대한 관리자 사용 권한
- Tableau Server 관리자 사이트 역할
Linux:
- 에이전트를 설치하는 데 사용되는 사용자 계정에 대한 전체 sudo 액세스 권한