독립 게이트웨이로 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 설치 프로그램과 구분되는 독립 실행형 설치
설치 후에는 initialize-tsig 스크립트를 실행하여 설치를 완료해야 합니다. 이 스크립트는 매개 변수를 사용하여 제공된 정보를 사용하여 독립 게이트웨이를 구성합니다. 독립 게이트웨이가 완벽하게 설치되면 초기 Tableau Server 노드에서 TSM 명령을 실행하여 독립 게이트웨이 인스턴스에 대한 세부 정보로 서버를 구성해야 합니다.
IG 설치는 다음 단계로 구성됩니다.
플랫폼별 설치 프로그램을 실행합니다.
설치 후 스크립트를 실행합니다.
TSM을 사용하여 독립 게이트웨이를 사용하도록 설정합니다.
1단계: Tableau Server 다운로드 및 설치
TSM 설치 및 초기화: 이 항목에 제공된 지침에 따라 1~5단계를 수행하여 설치 프로그램을 실행하고 TSM을 설치합니다.
Tableau Server 활성화 및 등록: 활성화 단계에서 Tableau Server 키와 Advanced Management 키를 제공합니다. 다음 명령을 두 번 실행해야 합니다. 먼저 Tableau Server 제품 키로 실행한 후 Advanced Management 제품 키로 실행합니다.
tsm licenses activate -k <product key>초기 노드 설정 구성: 이 항목에 제공된 지침에 따라 초기 노드 설정을 구성합니다.
2단계: 독립 게이트웨이 다운로드 및 설치
배포의 패키지 관리자를 사용하여 Tableau Server 독립 게이트웨이를 설치한 다음 스크립트를 실행하여 독립 게이트웨이를 초기화합니다. 스크립트는 설치된 패키지에 포함되어 있습니다.
독립 게이트웨이는 /opt 디렉터리에 설치됩니다.
독립 게이트웨이를 설치하려는 컴퓨터에
sudo액세스 권한이 있는 사용자로 로그온합니다.참고: 문제가 발생하지 않도록 특수 문자(예: ASCII 이외 문자, "+", "-")를 포함하지 않는 사용자 계정을 사용하는 것이 좋습니다. 이 경우 사용자 환경의 구성 방식에 따라 독립 게이트웨이를 완전히 설치하지 못하는 등의 문제가 발생할 수 있습니다.
Tableau Server 다운로드 및 릴리스 정보 페이지에서
.rpm또는.deb설치 프로그램 패키지를 다운로드합니다..rpm또는.deb패키지를 복사한 디렉터리로 이동합니다.패키지 관리자를 사용하여 독립 게이트웨이 패키지를 설치합니다.
심볼릭 링크를 사용하는 위치 또는 NFS(네트워크 파일 시스템) 볼륨의 디렉터리에는 설치하지 마십시오. 다음 명령을 실행하여 독립 게이트웨이를 설치합니다. 여기서
<version>은 주-부-유지 관리 형식입니다(예:2022-1-0).CentOS를 포함한 RHEL 호환 배포:
sudo yum updatesudo yum install tableau-tsig-<version>.x86_64.rpmUbuntu:
sudo apt-get update sudo apt-get upgrade sudo apt-get -y install gdebi-core sudo gdebi -n tableau-tsig-<version>_amd64.deb
Tableau Server 독립 게이트웨이 초기화
다음 단계는 initialize-tsig 스크립트를 실행하는 것입니다.
scripts디렉터리로 이동합니다.cd /opt/tableau/tableau_tsig/packages/scripts.<version_code>/
다음 스크립트를 실행하여 독립 게이트웨이를 초기화하고 시작합니다.
sudo ./initialize-tsig --accepteula -c <ts_cluster_location> --<optional_parameters>initialize-tsig스크립트의 유일한 필수 매개 변수는--accepteula와-c입니다.--accepteula - Tableau EULA(최종 사용자 사용권 계약)에 동의하려면 이 매개 변수를 포함해야 합니다. EULA 링크는 다음 위치에서 확인할 수 있습니다.
/opt/tableau/tableau_tsig/packages/docs.<version_code>/- -c - 이 매개 변수를 포함하여 Tableau Server 클러스터에 있는 모든 노드의 네트워크 위치를 지정해야 합니다. 이러한 노드에서는 독립 게이트웨이로 “관리” 요청을 전송할 수 있습니다. 와일드카드 및 서브넷 마스크를 사용하여 여러 노드를 지정할 수 있습니다. 여러 주소를 지정하려면 공백으로 주소를 구분하고 전체 집합 주위에 따옴표를 사용합니다. Apache
httpd mod_authz_host“Require” 지시문에 사용할 수 있는 형식 중 하나로 값을 제공해야 합니다. 자세한 내용은 https://httpd.apache.org/docs/2.4/mod/mod_authz_host.html(링크가 새 창에서 열림)을 참조하십시오.
HTTP와 하우스키핑 프로세스에 사용되는 기본 포트와 같은 다른 모든 매개 변수는 선택 사항이며 그냥 둘 경우 지정된 기본값이 사용됩니다. 스크립트를 실행하기 전에 initialize-tsig 스크립트의 도움말 출력에서 매개 변수와 해당 기본값을 검토하십시오.
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와 일치해야 합니다. 이 값을 제공하지 않은 경우 기본값은 독립 게이트웨이 컴퓨터의 정규화된 도메인 이름(소문자)입니다. json 파일에서 이 값은hostname명령의 출력과 일치해야 합니다. - host - 호스트 값은 Tableau Server 노드에서 DNS를 사용하여 확인할 수 있는 독립 게이트웨이 컴퓨터의 DNS 확인 가능한 이름이어야 합니다.
- port - 포트는 독립 게이트웨이 인스턴스에 지정된 하우스키핑 포트(
tsig_housekeeping_port)와 일치해야 합니다. 초기화 중에 이 값을 제공하지 않은 경우 기본값은 “21319”입니다. - protocol - 프로토콜은 독립 게이트웨이 인스턴스에 지정된 하우스키핑 프로토콜(
tsig_housekeeping_port_protocol)과 동일해야 합니다. 초기화 중에 이 값을 제공하지 않은 경우 기본값은 “http”입니다. - authsecret - 인증 암호는 독립 게이트웨이 인스턴스에서 초기화 스크립트를 통해 만들어진 암호와 일치해야 합니다.
독립 게이트웨이 인증 암호
초기화 스크립트를 실행하면 각 독립 인스턴스 컴퓨터에 고유한 공유 암호가 만들어집니다. 이 암호는 Tableau Server에서 독립 게이트웨이를 사용하도록 설정할 때 필요합니다. 암호를 복사하고 JSON 파일에 “authsecret”로 포함합니다.
공유 암호는 tsighk-auth.conf 파일에 위치합니다.
/var/opt/tableau/tableau_tsig/config/tsighk-auth.conf
독립 게이트웨이 JSON 파일 예
JSON 파일은 아래 형식이어야 합니다. 이 예제 JSON 파일은 기본값을 보여줍니다(기본값이 있는 경우). 실제 파일에는 독립 게이트웨이 설치 및 조직과 일치하는 실제 값을 사용해야 합니다.
{
"independentGateways": [
{
"id": "<mycomputer.example.com >",
"host": "<DNS name of Independent Gateway computer>",
"port": "21319",
"protocol": "http",
"authsecret": "<shared-secret01>"
},
{
"id": "<mycomputer2.example.com >",
"host": "<DNS name of second Independent Gateway computer>",
"port": "21319",
"protocol": "http",
"authsecret": "<shared-secret02>"
}
]
}Tableau Server에서 독립 게이트웨이를 사용하도록 설정
독립 게이트웨이 설치를 완료하려면 TSM을 사용하여 독립 게이트웨이를 사용하도록 설정해야 합니다.
- Tableau Server의 초기 노드에 JSON 구성 파일을 복사합니다.
- 초기 노드에서
tsmadmin그룹의 멤버인 계정을 사용하여 명령 프롬프트를 엽니다. 다음 명령을 실행하여 Tableau Server를 중지하고 json 구성 파일을 사용하여 독립 게이트웨이를 사용하도록 설정한 다음 서버를 다시 시작합니다.
tsm stop tsm topology external-services gateway enable -c tsig.json tsm start