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

에이전트는 최소한의 서버 리소스를 사용하고 데이터를 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가 이러한 통신에 대해 열려 있는지 확인하십시오.

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

  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"

      참고: UI 또는 프롬프트를 표시하지 않고 자동으로 설치를 실행하려면 /silent 또는 /quiet 스위치를 사용합니다.

  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 서버 설치 중에 만든 관리자 사용자입니다.
      --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|0EULA(최종 사용자 사용권 계약)에 동의합니다. 초기 노드와 추가 노드 모두에서 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 액세스 권한

다음 단계

Tableau Resource Monitoring Tool 구성