tsm topology

tsm topology 명령을 사용하여 파일 저장소 노드를 안전하게 제거할 수 있도록 준비하거나 다시 읽기-쓰기 모드로 전환할 수 있습니다. 또한 리포지토리 장애 조치를 초기화하고, 노드 또는 포트 목록을 가져오고, 클러스터에 다른 노드를 추가하는 데 필요한 부트스트랩 구성 파일을 얻고, 노드를 제거하고, 외부 리포지토리를 구성할 수 있습니다.

tsm topology cleanup-coordination-service

새 집합을 배포한 후 비프로덕션 Tableau Server 조정 서비스 집합을 제거하려면 tsm topology cleanup-coordination-service 명령을 사용합니다. 이 명령은 비프로덕션 조정 서비스 집합의 모든 노드에서 이전 조정 서비스 인스턴스를 제거하며 새 조정 서비스 집합을 배포한 후 필요합니다. 조정 서비스 집합에 대해 자세히 알아보려면 조정 서비스 집합 배포를 참조하십시오.

개요

tsm topology cleanup-coordination-service [option] [global options]

옵션

--request-timeout <timeout in seconds>

선택 사항입니다.

명령이 완료될 수 있도록 지정된 시간 동안 기다립니다. 기본값은 2700(45분)입니다.

tsm topology deploy-coordination-service

tsm topology deploy-coordination-service 명령을 사용하여 Tableau Server 조정 서비스를 배포할 수 있습니다. 이 명령은 조정 서비스 집합을 배포합니다. 이 집합은 서버 클러스터의 지정된 노드에서 실행되는 조정 서비스 인스턴스의 집합입니다. 클러스터에 필요한 조정 서비스 인스턴스 노드의 수를 비롯하여, 조정 서비스 집합에 대해 자세히 알아보려면 조정 서비스 집합 배포를 참조하십시오.

개요

tsm topology deploy-coordination-service --nodes <nodeID,nodeID,...> [option] [global-options]

옵션

-n, --nodes <nodeID,nodeID,...>

필수 항목입니다.

새 조정 서비스 집합에 포함할 노드의 쉼표로 구분된 노드 ID입니다. 클러스터의 총 노드 수에 따라 1개, 3개 또는 5개 조정 서비스 노드를 지정할 수 있습니다. 자세한 내용은 조정 서비스 쿼럼을 참조하십시오.

--request-timeout <timeout in seconds>

선택 사항입니다.

명령이 완료될 수 있도록 지정된 시간 동안 기다립니다. 기본값은 2700(45분)입니다.

tsm topology external-services list

tsm topology external-service-list 명령을 사용하여 Tableau Server 외부 리포지토리에 사용되는 서비스를 가져옵니다. 예를 들어 Amazon RDS를 사용하도록 Tableau Server를 구성한 경우 다음과 같은 메시지가 표시됩니다.

다음 외부 구성 서비스가 Tableau Server에 사용됩니다.

- pgsql

개요

tsm topology external-service list [global options]

옵션

이 명령에는 옵션이 없습니다.

tsm topology external-services repository enable

tsm topology external-services repository enable 명령을 사용하여 Tableau Server를 외부 리포지토리를 사용하도록 구성합니다. 새 Tableau Server를 설치하는 동안 이 명령을 사용하여 외부 리포지토리를 구성할 수 있습니다. 기존의 실행 중인 Tableau Server에 대해 이 명령을 실행하면 로컬 노드에서 외부 리포지토리로 데이터를 마이그레이션하며 마이그레이션이 완료된 후 외부 리포지토리를 사용하도록 Tableau Server를 구성합니다.

개요

tsm topology external-services repository enable -f <filename>.json -c <ssl certificate file>.pem

옵션

-f <file name>

필수 항목입니다.

구성 파일을 저장할 전체 경로 및 파일 이름입니다. 자세한 내용은 Tableau Server 리포지토리 다시 구성을 참조하십시오.

-c <ssl certificate file>

필수 항목입니다.

외부 리포지토리로 Amazon RDS를 사용하는 경우 SSL을 사용해야 합니다. .pem 파일을 다운로드하고 이 옵션과 함께 사용할 .pem 파일을 지정합니다. .pem 파일을 얻는 방법에 대한 자세한 내용은 Using SSL to Encrypt a Connection to a DB Instance(SSL을 사용하여 DB 인스턴스에 대한 연결 암호화)를 참조하십시오.

tsm topology external-services repository disable -n nodeN

tsm topology external-services repository disable 명령을 사용하여 외부 리포지토리 사용을 중지하고 로컬 리포지토리를 사용하도록 설치를 다시 구성합니다. 이 명령은 데이터를 로컬 리포지토리로 마이그레이션하고 Tableau Server를 로컬 리포지토리를 사용하도록 구성합니다.

개요

tsm topology external-services repository disable -n nodeN

옵션

-n, --node-name <nodeID>

필수 항목입니다.

리포지토리를 이동할 대상 노드의 노드 ID를 지정합니다.

이 명령은 RDS 인스턴스를 중지하거나 삭제하지 않습니다. RDS 인스턴스를 삭제하는 방법에 대한 자세한 내용은 AWS 사이트에서 Deleting a DB Instance(DB 인스턴스 삭제)를 참조하십시오.

전역 옵션

-h, --help

선택 사항입니다.

명령 도움말을 보여 줍니다.

-p, --password <password>

활성 상태인 세션이 없는 경우 필수 사항이며 -u 또는 --username과 함께 사용합니다.

-u 또는 --username에 지정된 사용자의 암호를 지정합니다.

암호에 공백 또는 특수 문자가 포함된 경우 암호를 따옴표로 묶습니다.

--password 'my password'

-s, --server <url_to_tsm>

선택 사항입니다.

Tableau 서비스 관리자에 대해 지정된 주소를 사용합니다. URL은 https로 시작하고 포트 8850을 포함하며 IP 주소가 아닌 서버 이름을 사용해야 합니다(예: https://mytableauhost:8850). 서버를 지정하지 않으면 https://<localhost | dnsname>:8850이 사용됩니다.

--trust-admin-controller-cert

선택 사항입니다.

TSM 컨트롤러에서 자체 서명된 인증서를 신뢰하려면 이 플래그를 사용합니다. 인증서 신뢰 및 CLI 연결에 대한 자세한 내용은 TSM 클라이언트 연결을 참조하십시오.

-u, --username <user>

활성 상태인 세션이 없는 경우 필수 사항이며 -p 또는 --password와 함께 사용합니다.

사용자 계정을 지정합니다. 이 옵션이 포함되어 있지 않으면 현재 로그인한 사용자의 자격 증명을 사용하여 명령이 실행됩니다.

tsm topology failover-repository

tsm topology failover-repository 명령을 사용하여 현재 활성 리포지토리에서 두 번째 수동 리포지토리로의 리포지토리 장애 조치를 수동으로 시작할 수 있습니다.

tsm topology failover-repository 명령은 영구적입니다. 명령을 다시 실행하거나 자동 장애 조치(Tableau Server에 자동 장애 조치가 구성된 경우)가 발생할 때까지 장애 조치 리포지토리가 활성 리포지토리로 유지됩니다. 기본 설정 활성 리포지토리가 구성되어 있는 경우 --preferred 옵션을 사용하여 해당 리포지토리로 전환합니다. 기본 설정된 활성 리포지토리의 구성에 대한 자세한 내용은 Tableau Server 리포지토리를 참조하십시오.Tableau Server가 고가용성으로 구성되어 있는 경우 리포지토리 장애 조치는 자동입니다(필요한 경우). 리포지토리를 수동으로 장애 조치하려면 failover-repository 명령을 사용합니다.

개요

tsm topology failover-repository --preferred | --target <node_id> [global options]

옵션

-r, --preferred

-t 또는 --target을 사용하지 않는 경우 필수입니다.

구성된 기본 노드를 리포지토리 장애 조치 대상으로 사용합니다.

--request-timeout <timeout in seconds>

선택 사항입니다.

명령이 완료될 수 있도록 지정된 시간 동안 기다립니다. 기본값은 1800(30분)입니다.

-t, --target <node_id>

-r 또는 --preferred를 사용하지 않는 경우 필수입니다.

장애 조치가 실행될 대상 노드의 노드 ID입니다. tsm topology list-nodes 명령을 사용하여 노드 ID를 찾습니다.

tsm topology filestore decommission

tsm topology filestore decommission 명령을 사용하여 하나 이상의 파일 저장소 노드를 안전하게 제거하도록 준비해야 합니다. 이 명령은 지정된 노드를 읽기 전용 모드로 전환하고 지정된 노드에 고유한 콘텐츠가 없는지 확인합니다.

단일 파일 저장소 노드에서 해제가 발생하는 경우 --override 옵션을 사용해야 합니다. 그렇지 않으면 해제가 실패합니다.

개요

tsm topology filestore decommission --nodes <nodeID,nodeID,...> [options] [global options]

옵션

-n, --nodes <nodeID,nodeID,...>

필수 항목입니다.

해제할 하나 이상의 노드 목록입니다(노드 ID를 쉼표로 구분하여 지정).

--delete-filestore

선택 사항입니다.

파일 저장소 제거를 강제하며, 파일 저장소가 해제되지 않은 경우에도 제거합니다. 파일 저장소가 있는 노드가 오류 상태이고 해제를 수행할 수 없는 경우에만 이 옵션을 사용해야 합니다. 노드의 모든 고유 파일이 영구적으로 삭제됩니다.

-o, --override

선택 사항입니다.

대상 파일 저장소 노드를 제거하면 남은 파일 저장소 노드 수가 1로 줄어드는 경우 일반적으로 발생하는 경고 또는 오류를 재정의합니다.

--request-timeout <timeout in seconds>

선택 사항입니다.

명령이 완료될 수 있도록 지정된 시간 동안 기다립니다. 기본값은 1800(30분)입니다.

tsm topology filestore recommission

tsm topology filestore recommission 명령을 사용하여 해제된 모든 노드를 다시 읽기-쓰기 모드로 전환할 수 있습니다.

개요

tsm topology filestore recommission --nodes <nodeID,nodeID,...> [global options]

옵션

-n, --nodes <nodeID,nodeID,...>

필수 항목입니다.

다시 연결할 하나 이상의 노드 목록입니다(노드 ID를 쉼표로 구분하여 지정).

tsm topology list-nodes

클러스터의 노드와 (선택적으로) 각 노드의 서비스를 표시합니다.

개요

tsm topology list-nodes [options] [global options]

옵션

-v, --verbose

선택 사항입니다.

각 노드 ID, 노드 역할(자세한 내용은 아래 set-node-role 참조), 노드 주소 및 각 노드의 프로세스를 표시합니다.

 

tsm topology list-ports

클러스터의 포트를 표시합니다.

개요

tsm topology list-ports [options] [global options]

옵션

--node-name <nodeID>

선택 사항입니다.

포트를 나열할 노드를 지정합니다.

--service-name

선택 사항입니다.

포트를 나열할 서비스를 지정합니다.

 

tsm topology nodes get-bootstrap-file

tsm topology nodes get-bootstrap-file 명령을 사용하여 새 노드를 클러스터에 추가하는 데 필요한 부트스트랩 파일을 가져올 수 있습니다.

중요: 부트스트랩 파일에는 구성 암호를 암호화하는 데 사용되는 마스터 키 저장소 파일의 복사본이 포함되어 있습니다. 또한 파일에는 미리 정의된 기간(tabadmincontroller.auth.expiration.minutes 참조) 동안 유효하며 세션 쿠키로 사용되는 자격 증명을 내장할 수 있습니다. 따라서 가져오기 및 내보내기 작업을 위한 암호 보호에 설명되어 있는 메커니즘을 사용하여 부트스트랩 파일을 보호하는 추가적인 조치를 취하는 것이 좋습니다.

개요

tsm topology nodes get-bootstrap-file --file <path\file>.json [global options]

옵션

-f,--file <file>

필수 항목입니다.

구성 파일을 저장할 전체 경로 및 파일 이름입니다. 중복된 파일이 있는 경우 해당 파일을 덮어씁니다.

-nec,--no-embedded-credential

선택 사항입니다.

버전 2019.3에 추가되었습니다.

기본적으로 부트스트랩 파일에 내장된 자격 증명이 포함됩니다. 부트스트랩 파일에 자격 증명을 포함하지 않으려면 이 옵션을 사용하십시오. 내장된 자격 증명은 일시적이며 tabadmincontroller.auth.expiration.minutes구성 키 값(기본값 120분)에 따라 만료됩니다.

참고: 구성 옵션을 통해 서버 수준에서 내장된 자격 증명을 포함하는 기능을 사용하지 않도록 설정할 수 있습니다. 자세한 내용은 features.PasswordlessBootstrapInit를 참조하십시오.

 

tsm topology remove-nodes

클러스터에서 노드를 제거합니다.

노드 제거를 완료하려면 tsm pending-changes apply 명령도 실행해야 합니다. 일부 시나리오에서는 노드를 제거하기 전에 프로세스를 이동하거나 다시 배포해야 합니다. 자세한 내용은 노드 제거를 참조하십시오.

노드를 제거하고 이를 클러스터에 다시 추가하려면 먼저 obliterate 스크립트를 실행하여 노드에서 Tableau를 제거한 다음 새 노드를 추가하는 일반적인 프로세스를 사용하여 노드를 다시 설치해야 합니다. 자세한 내용은 컴퓨터에서 Tableau Server 제거추가 노드 설치 및 구성을 참조하십시오.

참고: 클러스터에서 노드를 제거하려면 이전에 프로세스가 미리 구성되어 있어야 합니다. 프로세스가 구성되지 않은 노드를 제거하려면 노드에 프로세스를 추가하고 tsm pending-changes apply를 실행한 다음 노드를 제거해야 합니다.

개요

tsm topology remove-nodes --nodes <nodeID,nodeID,...> [global options]

옵션

-n, --nodes <nodeID,nodeID,...>

필수 항목입니다.

제거할 노드를 지정합니다. 여러 노드를 지정하려면 노드 ID를 쉼표로 구분하십시오.

 

tsm topology set-node-role

백그라운더 및 추출 쿼리 노드 역할을 설정합니다. 이것은 노드에서 수행할 작업의 유형을 결정합니다. 다중 노드 클러스터가 있고 Add-on 라이선스가 필요한 경우 다음과 같은 노드 역할이 유용합니다. 자세한 내용은 노드 역할을 통한 작업 부하 관리를 참조하십시오.

참고: 노드 역할을 구성하려면 서버를 다시 시작해야 하며 약간의 중단 시간이 필요합니다. 자세한 내용은 tsm pending-changes를 참조하십시오.

개요

tsm topology set-node-role [options] [global options]

옵션

-n, --nodes <nodeID,nodeID,...>

필수 항목입니다.

노드 역할을 설정할 하나 이상의 노드 목록이며, 노드 ID를 쉼표로 구분하여 지정합니다(사이에 공백 없음).

-r --role <all-jobs,flows,no-flows,extract-refreshes,subscriptions,extract-refreshes-and-subscriptions,no-extract-refreshes,no-subscriptions,no-extract-refreshes-and-subscriptions,extract-queries>

필수 항목입니다.

지정된 노드의 역할을 설정합니다. 이 옵션의 유효한 값은 다음과 같습니다.

  • all-jobs: 백그라운더가 모든 유형의 작업을 실행합니다.

  • flows: 백그라운더가 흐름 실행 작업만 실행합니다.

  • no-flows: 백그라운더가 흐름 실행 작업을 실행하지 않습니다.

  • extract-refreshes: 백그라운더가 추출 새로 고침 작업만 실행합니다. 여기에는 흐름 출력이 생성하는 추출을 비롯한 모든 추출의 증분 새로 고침, 전체 새로 고침, 암호화 및 암호 해독이 포함됩니다.

  • subscriptions: 백그라운더가 구독 작업만 실행합니다.

  • extract-refreshes-and-subscriptions: 백그라운더가 추출 새로 고침, 흐름 출력이 만드는 추출을 비롯한 모든 추출의 암호화 및 암호 해독, 그리고 구독 작업을 실행합니다.

  • no-extract-refreshes: 백그라운더가 추출 새로 고침, 흐름 출력에서 만들어진 추출을 비롯한 추출 암호화 및 암호 해독을 제외한 모든 작업을 실행합니다.

  • no-subscriptions: 백그라운더가 구독을 제외한 모든 작업을 실행합니다.

  • no-extract-refreshes-and-subscriptions: 백그라운더가 추출 새로 고침, 흐름 출력에서 만들어진 추출을 비롯한 모든 추출의 암호화 및 암호 해독, 그리고 구독을 제외한 모든 작업을 실행합니다.

  • extract-queries: 선택된 노드는 all-jobs 역할로 실행되며 추출 쿼리를 우선적으로 처리합니다.

tsm topology set-ports

서비스 인스턴스에 대한 포트를 설정합니다.

개요

tsm topology set-ports --node-name <nodeID> --port-name <port_name> --port-value <port_value> [options] [global options]

옵션

-i, --instance <instance_id>

선택 사항입니다.

서비스의 인스턴스 ID를 지정합니다. 지정하지 않으면 기본적으로 0입니다.

-n, --node-name <nodeID>

필수 항목입니다.

노드의 노드 ID를 지정합니다.

-pn, --port-name <port_name>

필수 항목입니다.

설정할 포트의 이름이며, 형식은 service_name:port_type입니다. 포트 유형을 지정하지 않으면 기본 포트가 사용됩니다. 포트 이름 구문에 대해서는 동적으로 매핑된 포트를 참조하십시오.

-pv, --port-value <port_value>

필수 항목입니다.

설정할 포트입니다.

-r, --restart

선택 사항입니다.

다시 시작하는 메시지를 표시하지 않으며 필요한 경우 Tableau Server를 다시 시작합니다.

 

tsm topology set-process

노드의 프로세스 인스턴스 수를 설정합니다. 노드에 이미 지정된 프로세스가 있는 경우 숫자가 지정된 수와 일치하도록 업데이트됩니다.

한 번에 한 프로세스만 설정할 수 있습니다. 둘 이상의 프로세스를 지정하면 첫 번째 프로세스 이후의 프로세스는 자동으로 무시됩니다.

참고: 프로세스 이름의 전체 목록에 대해서는 Tableau Server 프로세스를 참조하십시오.

개요

tsm topology set-process --count <process_count> --node <nodeID> --process <process_name> [global options]

옵션

-c, --count <process_count>

필수 항목입니다.

설정할 프로세스 수(인스턴스 수)입니다.

-n, --node <nodeID>

필수 항목입니다.

프로세스를 설정할 노드의 노드 ID를 지정합니다.

-pr, --process <process_name>

필수 항목입니다.

설정할 프로세스의 이름입니다.

 

tsm topology toggle-coordination-service

tsm topology toggle-coordination-service 명령을 사용하여 조정 서비스 집합 간을 전환할 수 있습니다. 조정 서비스 집합에 대해 자세히 알아보려면 조정 서비스 집합 배포를 참조하십시오.

개요

tsm topology toggle-coordination-service [option] [global options]

옵션

--request-timeout <timeout in seconds>

선택 사항입니다.

명령이 완료될 수 있도록 지정된 시간 동안 기다립니다. 기본값은 1800(30분)입니다.

의견을 주셔서 감사합니다! 피드백을 제출하는 동안 오류가 발생했습니다. 다시 시도하거나 메시지를 보내주십시오.