독립 게이트웨이로 Tableau Server 설치

이 항목에서는 Tableau Server 독립 게이트웨이 설치 프로세스를 안내합니다.

이 프로세스를 따르면 백엔드 Tableau Server 배포에 직접 연결되는 독립 게이트웨이 구성이 만들어집니다. 독립 게이트웨이로 Tableau Server 구성 항목에서 직접 연결과 릴레이 연결 모드에 대해 자세히 알아볼 수 있습니다.

필수 요건

  • 2개 이상의 코어(4 vCPU), 8GB의 RAM 및 100GB의 디스크 여유 공간이 있는 전용 서버가 있어야 합니다.
  • Tableau Server 2022.1 이상을 사용해야 합니다.
  • 주 버전(예: 2022.1)이 Tableau Server 버전과 일치하는 Tableau Server 독립 게이트웨이용 설치 프로그램을 사용해야 합니다. 유지 관리 버전(예: 2022.1.1 또는 2022.1.5)도 일치하는 것이 좋지만 요구 사항은 아닙니다. 버전 간의 "정적 자산" 변경이 일치하지 않는 경우 예기치 않은 이미지 영향이 발생할 수 있습니다. 예를 들어 독립 게이트웨이 버전이 Tableau Server보다 이전인 경우 맵이 최신 상태가 아닐 수 있습니다.
  • Tableau Server에 유효한 Advanced Management 라이선스가 활성화되어 있어야 합니다. Advanced Management에 대해 자세히 알아보려면 Tableau Server의 Tableau Advanced Management 정보를 참조하십시오.
  • 기본적으로 독립 게이트웨이는 설치 중에 포트 80 및 21319에서 백엔드 Tableau Server 배포와 통신할 수 있어야 합니다. 이 항목의 후반부에 설명된 대로 초기화 중에 이 기본 포트를 변경할 수 있습니다.
  • 독립 게이트웨이를 설치하고 구성하기 전에 Tableau Server 배포가 완전하고 정상 상태인지 확인하십시오.
  • 독립 게이트웨이를 설치하는 컴퓨터에서 다른 웹 인식 응용 프로그램이 실행되고 있지 않은지 확인하십시오. 예를 들어 Apache 설치된 경우 제거하거나 포트 80에서 활성 수신 대기 상태로 있지 않도록 httpd 를 구성합니다.

Tableau Server 및 독립 게이트웨이 설치

독립 게이트웨이 설치는 파일 이름에 포함된 “tsig”로 전체 Tableau Server 설치 프로그램과 구분되는 독립 실행형 설치 프로그램을 사용하여 수행됩니다. 독립 게이트웨이는 Tableau Server를 설치하고 예상대로 작동하는지 확인한 후 설치하는 것이 좋습니다. 설치하려면 관리자 권한이 있어야 합니다. 하나 이상의 독립 게이트웨이 인스턴스를 설치할 수 있지만 독립 게이트웨이의 각 인스턴스를 따로 설치해야 합니다. 고가용성을 구현하거나 많은 클라이언트 부하를 분산하기 위해 여러 인스턴스를 설치하는 경우 각 인스턴스에 대해 설치 단계를 반복합니다.

설치 중에 initialize-tsig.bat 스크립트가 실행됩니다. 이 스크립트가 실행되는 동안 독립 게이트웨이 구성에 필요한 정보를 입력해야 합니다. 독립 게이트웨이가 완벽하게 설치되면 Tableau Server 초기 노드에서 TSM 명령을 실행하여 독립 게이트웨이 인스턴스에 대한 세부 정보로 서버를 구성해야 합니다.

IG 설치는 다음 단계로 구성됩니다.

  • 플랫폼별 설치 프로그램을 실행합니다.

  • 설치 후 스크립트를 실행합니다. 이 단계는 설치 프로그램에 의해 자동으로 수행됩니다.

  • TSM을 사용하여 독립 게이트웨이를 사용하도록 설정합니다.

1단계: Tableau Server 다운로드 및 설치

  1. TSM 설치: 이 항목에 제공된 지침에 따라 1~5단계를 수행하여 설치 프로그램을 실행하고 TSM을 설치합니다.

  2. Tableau Server 활성화 및 등록: 활성화 단계에서 Tableau Server 키와 Advanced Management 키를 제공합니다. 다음 명령을 두 번 실행해야 합니다. 먼저 Tableau Server 제품 키로 실행한 후 Advanced Management 제품 키로 실행합니다.

    tsm licenses activate -k <product key>

  3. 초기 노드 설정 구성: 이 항목에 제공된 지침에 따라 초기 노드 설정을 구성합니다.

2단계: 독립 게이트웨이 다운로드 및 설치

Tableau Server 독립 게이트웨이 설치 파일을 다운로드한 후 아래 지침에 따라 독립 게이트웨이를 설치합니다.

  1. 독립 게이트웨이를 설치할 컴퓨터에서 관리자 액세스 권한이 있는 사용자로 로그인하고 다운로드된 설치 파일을 두 번 클릭합니다.

  2. 계속하기 전에 첫 번째 화면에서 라이선스 계약을 수락해야 합니다.

  3. 라이선스 계약을 수락한 후 두 가지 동작 중 하나를 선택할 수 있습니다.

    • 설치를 클릭하여 독립 게이트웨이 설치
      또는
    • 사용자 지정을 클릭하여 설치 위치를 변경한 다음 독립 게이트웨이 설치

      기본적으로 독립 게이트웨이는 C:\Program Files\Tableau\Tableau Server\independentgateway에 설치됩니다. 기본이 아닌 위치인 경우 새 경로를 찾아보기로 선택하거나 직접 입력하여 다른 드라이브의 위치를 선택할 수 있습니다.

      설치 위치를 지정한 후에는 설치를 클릭하여 독립 게이트웨이를 이 위치에 설치합니다.

  4. 설치 프로그램이 독립 게이트웨이를 설치하고 initialize-tsig.bat 스크립트를 자동으로 실행합니다.

    설치 프로그램에 의해 열린 명령 창에서 독립 게이트웨이 구성에 사용되는 값을 입력합니다.

    • TSIG_TS_CLUSTER - 필수입니다. 기본값은 없습니다. 메시지가 표시되면 값을 입력해야 합니다.

      Tableau Server 클러스터에 있는 모든 노드의 인터넷 주소를 입력해야 합니다. 와일드카드와 서브넷 마스크를 사용하여 여러 노드를 지정할 수 있습니다. 여러 주소를 지정하려면 주소를 공백으로 구분합니다. Apache httpd mod_authz_host “Require” 지시문에 사용될 수 있는 형식 중 하나로 값을 제공해야 합니다. 자세한 내용은 https://httpd.apache.org/docs/2.4/mod/mod_authz_host.html(링크가 새 창에서 열림)을 참조하십시오.

    • TSIG_HK_PORT - 기본값은 21319입니다. Tableau Server의 수신 하우스키핑 요청에 사용되는 포트입니다.
    • TSIG_HK_PROTOCOL - 기본값은 http입니다. 유효한 값은 http https입니다. Tableau Server의 하우스키핑 요청에 사용되는 프로토콜입니다.
    • TSIG_PORT - 기본값은 80입니다. 외부 요청에 사용되는 포트입니다.
    • TSIG_PROTOCOL - 기본값은 http입니다. 유효한 값은 http https입니다. 외부 요청에 사용되는 프로토콜입니다.
    • TSIG_INSTANCE_ID - 기본값은 컴퓨터 이름입니다. 독립 게이트웨이 인스턴스에 대한 고유 식별자입니다.
  5. 스크립트 실행이 완료되고 독립 게이트웨이가 초기화되면 설치가 끝납니다.

3단계: Tableau Server에서 독립 게이트웨이를 사용하도록 설정

독립 게이트웨이 설치 및 구성의 마지막 단계는 Tableau Server에서 독립 게이트웨이를 사용하도록 설정하는 것입니다. 이 작업을 수행하려면 TSM 명령 tsm topology external-services gateway enable -c <file>과 독립 게이트웨이 인스턴스를 식별하는 JSON 파일을 사용하고, Tableau Server에 서버와 독립 게이트웨이 간 통신에 필요한 세부 정보를 제공합니다.

독립 게이트웨이를 사용하도록 설정할 때 Tableau Server는 중지 상태에 있어야 합니다.

독립 게이트웨이 JSON 파일 내용

Tableau Server에서 독립 게이트웨이 인스턴스를 사용하도록 설정할 때 사용되는 JSON 파일에는 다음이 포함되어야 합니다.

  • id - ID 값은 특정 인스턴스의 TSIG_INSTANCE_ID와 일치해야 합니다. 초기화 중에 이 값을 제공하지 않은 경우 기본값은 독립 게이트웨이 컴퓨터의 이름(%COMPUTERNAME%)입니다. json 파일에서 이 값은 hostname 명령의 출력과 일치해야 합니다.
  • host - 호스트는 독립 게이트웨이 컴퓨터의 DNS 확인 가능한 이름이어야 합니다.
  • port - 포트는 독립 게이트웨이 인스턴스에 지정된 TSIG_HK_PORT 값과 일치해야 합니다. 초기화 중에 이 값을 제공하지 않은 경우 기본값은 “21319”입니다.
  • protocol - 프로토콜은 독립 게이트웨이 인스턴스에 지정된 TSIG_HK_PROTOCOL과 일치해야 합니다. 초기화 중에 이 값을 제공하지 않은 경우 기본값은 “http”입니다.
  • authsecret - 인증 암호는 독립 게이트웨이 인스턴스에서 초기화 스크립트를 통해 만들어진 암호와 일치해야 합니다.

독립 게이트웨이 인증 암호

초기화 스크립트를 실행하면 각 독립 인스턴스 컴퓨터에 고유한 공유 암호가 만들어집니다. 이 암호는 Tableau Server에서 독립 게이트웨이를 사용하도록 설정할 때 필요합니다. 암호를 복사하고 JSON 파일에 “authsecret”로 포함합니다.

공유 암호는 tsighk-auth.conf 파일에 위치합니다.

C:\ProgramData\Tableau\Tableau Server\independentgateway\config\tsighk-auth.conf

독립 게이트웨이 JSON 파일 예

JSON 파일은 아래 형식이어야 합니다. 이 예제 JSON 파일은 기본값을 보여줍니다(기본값이 있는 경우). 실제 파일에는 독립 게이트웨이 설치 및 조직과 일치하는 실제 값을 사용해야 합니다.

{
"independentGateways": [ { "id": "<IGCOMPUTER>", "host": "<DNS name of Independent Gateway computer>", "port": "21319", "protocol": "http", "authsecret": "<shared-secret01>" }, { "id": "<IGCOMPUTER2>", "host": "<DNS name of second Independent Gateway computer>", "port": "21319", "protocol": "http", "authsecret": "<shared-secret02>" } ] }

Tableau Server에서 독립 게이트웨이를 사용하도록 설정

독립 게이트웨이 설치를 완료하려면 TSM을 사용하여 독립 게이트웨이를 사용하도록 설정해야 합니다.

  1. Tableau Server의 초기 노드에 JSON 구성 파일을 복사합니다.
  2. 초기 노드에서 관리자 권한으로 명령 프롬프트를 엽니다.
  3. 다음 명령을 실행하여 Tableau Server를 중지하고 json 구성 파일을 사용하여 독립 게이트웨이를 사용하도록 설정한 다음 서버를 다시 시작합니다.

    tsm stop
    tsm topology external-services gateway enable -c tsig.json
    tsm start

4단계: Tableau Server에서 독립 게이트웨이 확인

브라우저에서 독립 게이트웨이 주소를 입력하여 Tableau Server 로그인 페이지로 이동할 수 있어야 합니다.

독립 게이트웨이와 백엔드 Tableau Server 배포 사이에 방화벽이 있는 경우 Tableau Server 프로세스의 직접 연결을 위한 포트를 열어야 합니다. 자세한 내용은 직접 연결을 참조하십시오.

또는 독립 게이트웨이에 릴레이 연결을 구성하여 포트 요구 사항을 최소화할 수 있습니다. 자세한 내용은 릴레이 연결을 참조하십시오.

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