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

에이전트는 최소한의 서버 리소스를 사용하고 데이터를 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으로 설정된 경우에도 설치가 실패합니다.

       

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

  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 에이전트 초기화 스크립트 옵션을 참조하십시오.

  3. 등록:
    1. 로그오프한 후 항상 tabrmt-agent 사용자로 실행해야 하는 rtmadmin 명령을 실행할 수 있도록 tabrmt-agent 사용자로 로그온합니다. 또한, 다시 로그온하면 그룹 멤버 자격 변경 사항이 적용된 새 세션이 생성됩니다.

      sudo su --login tabrmt-agent

    2. 다음 명령을 실행하고 부트스트랩 파일이 있는 경로를 제공합니다. 에이전트가 설치되는 노드에 대한 식별 이름과 설명을 제공합니다.

      rmtadmin register <bootstrap file path\file> --server-name=<Friendly name of machine> --agent-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>.json이 됩니다.

      다음 표에는 에이전트를 등록하는 데 사용되는 구성 옵션이 나와 있습니다.

      옵션필수?기본값설명
      --bootstrap file<없음>부트스트랩 파일의 위치입니다.
      --username<없음>이는 일반적으로 RMT 서버 설치 중에 만든 관리자 사용자입니다.
      --password<없음>이는 사용자 계정의 비밀번호입니다.
       

      아니요

      비밀번호는 명령줄에서 제공하거나 비밀번호가 포함된 파일에서 제공할 수 있습니다. 어느 것도 제공하지 않으면 비밀번호를 입력하라는 메시지가 나타납니다.

      <없음>비밀번호가 저장된 파일 이름이 포함된 경로입니다.
      --server-name아니요컴퓨터의 호스트 이름에이전트가 설치된 컴퓨터의 이름입니다. 옵션이 제공되지 않으면 이 필드는 기본적으로 컴퓨터의 호스트 이름으로 설정됩니다.
      --server-description아니요<없음>에이전트가 설치된 컴퓨터의 설명입니다. 옵션이 제공되지 않으면 이 필드는 비어 있습니다.

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

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

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

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

Windows:

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

Linux:

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

다음 단계

Tableau Resource Monitoring Tool 구성

피드백을 제공해 주셔서 감사합니다!귀하의 피드백이 제출되었습니다. 감사합니다!