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

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

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

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

설치 전 수행할 작업

  • 부트스트랩 파일을 다운로드합니다. 부트스트랩 파일은 다운로드 후 24시간 동안만 유효합니다. 사용하는 부트스트랩 파일이 24시간이 지난 경우 부트스트랩 파일을 다시 생성해야 합니다.
  • 버전 2021.3부터 에이전트 등록 시 https 끝점 및 RabbitMQ를 통해 통신해야 에이전트 등록이 완료됩니다. 포트 443과 5672가 이러한 통신에 대해 열려 있는지 확인하십시오.

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

  1. 설치:
    1. .rpm 또는 .deb 에이전트 설치 프로그램을 다운로드하여 에이전트를 설치할 컴퓨터에서 액세스할 수 있는 위치에 저장합니다.

    2. 다음 명령을 실행하여 에이전트를 설치합니다. 여기서, <version>은 주-부-유지 관리 형식입니다.

      CentOS를 포함한 RHEL 호환 배포의 경우:

      sudo yum install tabrmt-agent-setup-<version>-x86_64.rpm

      Ubuntu 및 Debian의 경우:

      sudo apt install tabrmt-agent-setup<version>-amd64.deb

  2. 초기화:
    1. EULA에 동의하고 초기화하려면 다음 명령을 실행합니다.

      sudo /opt/tableau/tabrmt/agent/install-scripts/initialize-rmt-agent --accepteula

      EULA(최종 사용자 계약)는 /opt/tableau/tabrmt/agent/docs 폴더에서 찾을 수 있습니다.

  3. 부트스트랩 파일 다운로드

    부트스트랩 파일을 Tableau Server 노드에서 액세스할 수 있는 위치에 다운로드합니다.

    rmtadmin bootstrap-file --env=<myenvironment> --filename<The absolute or relative path including the file name>

  4. 등록:
    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>

      참고: tabrmt-agent 사용자는 기본적으로 기본 작업 디렉터리(/var/opt/tableau/tabrmt/agent)에서 명령을 실행하므로 파일 경로를 지정해야 합니다. 예를 들어 부트스트랩 파일을 권장된 대로 /var/opt/tableau/tabrmt/agent/bootstrap/ 폴더에 배치한 경우 파일 경로는 /var/opt/tableau/tabrmt/agent/bootstrap/<bootstrap_file_name>.이 됩니다.

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

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

      아니요

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

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

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

  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-<version>-64bit.exe /silent ACCEPTEULA=1

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

      기본 설치 폴더는 일반적으로 C:\Program Files\Tableau\Tableau Resource Monitoring Tool\agent입니다. 다른 설치 위치를 제공하려면 다음 명령을 실행합니다.

      tabrmt-agent-<version>-64bit.exe /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>

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

      옵션필수?

      기본값

      설명
      --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 서버의 웹 인터페이스에서 에이전트가 설치된 모든 노드를 볼 수 있어야 합니다.

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

리소스 모니터링 도구를 설치하려면 다음이 모두 필요합니다.

Windows:

  • 리소스 모니터링 도구를 설치하는 컴퓨터에 대한 관리자 사용 권한
  • Tableau Server 관리자 사이트 역할

Linux:

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

다음 단계

Tableau 리소스 모니터링 도구 구성

피드백을 제공해 주셔서 감사합니다!