Windows 기반 Tableau Server 도움말

Windows 기반 TSM(Tableau 서비스 관리자) 및 Tableau Server의 구성 요소를 구성하는 프로세스 및 서비스는 다양한 포트를 사용하여 통신합니다. 기본적으로 이러한 포트의 대부분은 미리 정의된 포트 범위에서 동적으로 할당(매핑)됩니다. 포트 할당은 각 서비스 또는 프로세스가 설치될 때 수행됩니다. 다양한 방법으로 사용되는 포트를 제어할 수 있습니다.

프로세스 중 일부 하위 집합은 동적 포트 매핑을 사용하지 않고 고유하게 동작합니다. 자세한 내용은 아래에서 동적으로 매핑되지 않는 포트를 참조하십시오.

참고: 이 작업에는 TSM 명령줄을 사용해야 할 수 있는 단계가 포함되어 있습니다. TSM CLI를 사용하려면 설치의 노드 중 하나에서 관리자 권한으로 명령줄에 액세스하고 TSM 관리자 자격 증명을 사용하여 TSM 명령을 실행해야 합니다.

임시 포트 사용

운영 체제가 임시 포트를 사용하도록 구성된 경우 아래 설명과 같이 구성된 경우라도 Tableau 트래픽이 이를 통해 라우팅될 수 있습니다. 이는 OS 수준에서 발생하는 문제이며 Tableau에서 구성할 수 있는 것이 아닙니다. 포트 사용을 제어하려면 운영 체제 설명서에서 임시 포트 사용을 제한하는 방법을 참조하십시오.

방화벽 요구 사항

Tableau Server를 설치할 컴퓨터에서 방화벽을 실행하는 경우 Tableau Server 트래픽에 대해 다음과 같은 기본 포트를 열어야 합니다. 443을 제외한 모든 포트 번호를 변경할 수 있습니다.

포트 할당

TSM에서 포트 할당 또는 매핑에 사용할 수 있는 두 가지 접근 방식이 있습니다.

• 동적 포트 할당. 기본 방식이며 관리자 개입이 가장 적습니다.
• 수동 포트 할당. 이 옵션에서는 관리자가 각 포트를 개별적으로 할당해야 합니다.

포트 할당을 변경하고 로컬 방화벽을 실행하는 경우 로컬 방화벽 구성을 참조하십시오.

동적 포트 할당

동적 할당 프로세스에서 사용할 수 있는 포트 범위를 변경하여 사용되는 포트를 제어할 수 있습니다. 이렇게 하면 동적 포트 할당이 그대로 유지되지만 선택할 수 있는 포트가 제한됩니다. 동적 포트 할당을 사용해도 여전히 특정 프로세스에 대한 포트를 수동으로 할당하도록 선택할 수 있습니다. 이 접근 방식을 사용하면 특정 프로세스에 특정 포트를 할당하면서도 다른 포트는 동적으로 매핑되게 할 수 있습니다. 일부 개별적으로 할당되는 포트가 있는지 여부와 관계없이 동적 매핑을 사용하는 것이 가장 쉬운 방법이며 대부분의 고객 요구 사항을 충족합니다. Tableau Server 구성을 내보내는 경우 동적으로 할당된 포트가 보존됩니다.

기본적으로 포트는 8000에서 9000 사이의 사용 가능한 포트에서 각 서비스 또는 프로세스에 할당됩니다. 이 할당은 노드에 서비스를 처음 설치할 때 실행됩니다. Tableau Server가 초기화된 후 다음 명령을 실행하여 어떤 서비스 또는 프로세스가 어떤 포트를 사용하고 있는지 확인할 수 있습니다.

tsm topology list-ports

다중 노드 클러스터가 있는 경우 모든 노드의 포트가 나열됩니다.

"configKeys": {
    "ports.range.min": "8300",
    "ports.range.max": "8600"
}

tsm configuration set -k ports.blocklist -v <port>[,<port>,<port>]

tsm configuration set -k ports.blocklist -v 8000,8088, 8090

동적 포트 할당 사용 안 함

포트 범위 제한과 개별적인 포트 할당 조합 이상의 세밀한 포트 할당 제어가 필요한 경우 초기 서버 구성에서 동적 포트 매핑을 사용하지 않도록 설정할 수 있습니다. 동적 포트 매핑을 사용하지 않도록 설정하면 모든 프로세스에 대해 모든 포트를 수동으로 할당해야 하므로 모든 개별 포트 할당을 제어해야 하는 경우가 아니라면 권장하지 않습니다.

동적 포트 매핑을 사용하지 않도록 설정한 경우 설치의 각 노드에서 각 프로세스에 대한 포트를 구성해야 합니다.

동적 매핑을 사용하도록 설정하려면 구성 파일에 다음과 유사한 항목이 포함되어야 합니다.

"configKeys": {
    "service.port_remapping.enabled": false
}

중요: 동적 포트 할당을 사용하지 않는 경우 라이선스 서비스 포트 범위가 포함되지 않습니다. 이 범위(27000-27009)는 라이선스 서비스를 실행하는 노드에서 열려 있어야 하며 다른 노드에서 액세스할 수 있어야 합니다. 기본적으로 라이선스 서비스는 초기 노드에서 실행됩니다.

수동 포트 할당

자동 포트 할당 전체를 사용하지 않도록 설정하고 각 프로세스의 포트를 개별적으로 할당할 수 있습니다. 이렇게 할 경우 모든 노드의 모든 프로세스에 포트를 할당해야 합니다. 프로세스를 처음 설치할 때 구성 파일에서 포트를 할당하거나 설치 후에 TSM 명령을 사용하여 포트를 할당할 수 있습니다. Tableau Server 구성을 내보내는 경우 프로세스 설치 시에 할당된 포트만 보존됩니다.

동적 매핑의 사용 여부와 관계없이 특정 프로세스에 대해 개별 포트를 지정할 수 있습니다. 프로세스가 특정 포트를 사용해야 하거나 동적 매핑을 사용하지 않도록 설정한 경우 이 작업을 수행할 수 있습니다. 프로세스에 대한 포트는 설치 중에 또는 설치 후에 지정할 수 있습니다.

설치 중에 포트 구성

여기에 설명된 대로 설치 프로세스 중에 포트 할당을 구성하는 것이 좋습니다. 설치 후에 포트를 변경하려면 훨씬 많은 작업이 필요합니다.

설치 중에 포트를 구성하려면 포트 구성을 지정하는 json 파일을 만듭니다. 이 프로세스는 기본값과 다른 포트 범위를 정의하는 것과 비슷하지만 포트 범위를 정의하는 대신 특정 서비스 또는 프로세스에 대한 특정 포트를 지정합니다. 이렇게 하면 tsm settings export 명령을 사용하여 서버 구성 및 토폴로지 설정을 내보내도 포트 매핑이 보존되므로 특정 포트를 할당하려는 경우 이 방법이 가장 확실한 방법입니다.

설치 시 포트를 정의하려면 구성 파일에 정보를 추가하여 노드(workerN), 프로세스(servicename) 및 인스턴스 ID(instanceid)와 포트 유형(porttype) 및 사용할 포트를 지정합니다. 형식은 다음과 같습니다.

workerN.{servicename}_{instanceid}.{porttype}.port:X

다음을 참조하십시오.

• workerN - 선택적 매개 변수이며 재매핑이 적용되는 노드를 식별합니다. 노드 번호는 0부터 시작합니다.
  서로 다른 노드에서 동일한 서비스에 대해 서로 다른 포트를 매핑해야 하는 경우가 아니라면 이 매개 변수를 포함하지 않는 것이 좋습니다. 이 매개 변수를 제외하면 초기 노드에서 서비스 포트를 매핑하거나 여러 노드에서 동일한 서비스 포트를 매핑할 수 있습니다.
• servicename - 포트를 사용할 프로세스 또는 서비스의 이름입니다.
• instanceid - 프로세스의 인스턴스입니다. 한 노드에서 프로세스의 여러 인스턴스를 구성하려는 경우 각 인스턴스에 대해 이 값을 증가시켜야 합니다. instanceid를 0부터 시작하여 프로세스의 각 인스턴스에 대해 1씩 증가시킵니다. 지정된 노드에 단일 인스턴스만 설치하는 서비스의 경우 이 매개 변수를 제외해야 합니다.
• porttype - 주 포트를 설정하는 경우 이 옵션을 포함하지 마십시오.
• port - 프로세스 또는 서비스가 사용해야 하는 포트입니다.

예를 들어 초기 노드에서 파일 저장소 프로세스의 첫 번째 인스턴스에 대한 포트를 8500으로 설정하려면 다음과 유사한 구성 파일 항목을 포함시킵니다.

"configKeys": {
    "filestore_0.port: "8500"
}

위의 예에는 선택적 workerN 매개 변수가 포함되어 있지 않으므로 클러스터의 모든 노드에 대해 포트를 설정합니다. 또한 주 파일 저장소 포트를 설정하기 때문에 porttype 옵션을 제외합니다.

중요: 구성 파일을 사용하여 포트 변경을 지정하는 경우 --force-keys 매개 변수를 tsm settings import 명령에 포함해야 합니다.

설치 후에 포트 구성

Tableau Server를 설치한 후 포트를 변경해야 한다면 tsm topology set-ports 명령을 사용합니다. 이 방법을 사용하면 특정 프로세스를 설치한 후 해당 프로세스에 대한 포트를 지정할 수 있습니다. 하지만 다음과 같은 제한이 적용됩니다.

• 각 노드에서 개별적으로 포트를 설정해야 합니다.
• 개별 포트를 설정한 후 tsm restart를 실행해야 합니다.
• tsm settings import를 사용하여 Tableau Server 구성을 가져와야 하는 경우 포트 할당이 보존되지 않습니다.
• 포트 이름은 configKeys에 필요한 구문과는 다른 tsm 명령 구문을 사용합니다. 이 항목 끝에 있는 표에 구문 참조가 나와 있습니다.

예를 들어 초기 노드에서 파일 저장소의 두 번째 인스턴스를 설정하려면 포트 8500을 사용합니다.

tsm topology set-ports --node-name node1 --port-name filestore --port-value 8500 --instance 2

다음 예제에서는 단축 명령을 사용하여 JMX 포트를 설정하는 방법을 보여 줍니다.

tsm topology set-ports -n node1 --port-name vizqlserver:jmx.rmi -pv 9403 -i 1

tsm topology set-ports -n node1 --port-name vizqlserver:jmx -pv 9404 -i 2

참고: 포트 항목은 입력할 때 유효성이 검사되지 않습니다. 따라서 이미 할당된 포트를 사용하거나 명령 구문을 잘못 입력한 경우 Tableau를 다시 시작할 때까지 오류가 나타나지 않습니다. 다시 시작한 후 비동기 작업을 재구성하지 못했습니다. 일반 오류가 표시될 수 있습니다.

유효한 포트를 사용하여 잘못된 portname:type을 추가한 경우 잘못된 항목을 삭제할 수 없습니다. 포트를 업데이트하려면 사용하지 않은 포트를 해당 값에 다시 할당하여 포트를 다시 확보해야 합니다.

동적으로 매핑되지 않는 포트

Tableau Server 리포지토리는 동적으로 매핑되지 않는 두 포트를 사용합니다. 이 두 포트에는 기본값이 있으며 tsm configuration set 명령과 프로세스별 매개 변수를 사용하여 재정의할 수 있습니다.

이 두 포트는 동적 포트 매핑 시스템을 사용하지 않으므로 tsm topology list-ports 명령 출력에 표시되지 않습니다. 이 두 포트의 값을 확인하려면 tsm configuration get -k <config.value> 명령을 사용해야 합니다. 예를 들면 다음과 같습니다.

tsm configuration get -k pgsql.port

동적으로 매핑된 포트

다음 표에는 동적으로 매핑된 포트를 사용하는 프로세스 또는 서비스가 나와 있습니다.

이 섹션의 다른 문서