tsm 명령줄 참조
이 섹션의 항목에는 Tableau Server를 지원하기 위한 TSM(Tableau 서비스 관리자) CLI(명령줄 인터페이스)에 대한 참조 콘텐츠가 들어 있습니다.
TSM은 Tableau Server의 설치 및 구성을 관리하는 데 사용됩니다. TSM에 대한 자세한 내용은 Tableau 서비스 관리자 개요를 참조하십시오.
TSM API를 사용하여 TSM CLI에서 지원되는 설치 및 구성 작업을 자동화할 수 있습니다. 릴리스 전(알파) TSM API에 대한 자세한 내용은 Tableau 서비스 관리자 API(영문)를 참조하십시오.
Windows 기반 Tableau Server에 대한 tsm 명령을 사용하려고 하십니까? tsm 명령(링크가 새 창에서 열림)을 참조하십시오.
tsm CLI 사용
초기 노드(TSM이 설치된 노드) 또는 클러스터의 모든 추가 노드에서 tsm 명령을 실행할 수 있습니다.
tsm 명령을 실행하려면 명령 프롬프트를 열어야 합니다.
클러스터의 노드에서
tsmadmin그룹의 멤버인 계정을 사용하여 명령 프롬프트를 엽니다.원하는 명령을 실행합니다. 초기 노드가 아닌 다른 노드에서 명령을 실행하는 경우
-s옵션을 포함하여 이름(IP 주소 아님)으로 초기 노드의 URL을 지정하고 TSM 포트 8850을 포함하십시오.초기 노드에서 TSM 및 Tableau Server의 버전을 확인하려면
tsm version추가 노드에서 TSM 및 Tableau Server의 버전을 확인하려면
tsm version -s https://<inital_node_name>:8850예를 들면 다음과 같습니다.
tsm version -s https://myTableauHost:8850
tsm CLI를 사용하여 인증
Tableau Server 2019.2 릴리스부터 다음 사항에 해당하는 경우 tsm 명령을 실행할 때 비밀번호를 입력할 필요가 없습니다.
- 명령을 실행하는 계정이 TSM 권한 그룹의 멤버(기본적으로
tsmadmin그룹)입니다. Tableau 권한이 없는 사용자(기본적으로tableau사용자) 및 루트 계정도 TSM 명령을 실행할 수 있습니다. - Tableau Server 관리 컨트롤러 서비스를 실행하는 Tableau Server에서 로컬로 명령을 실행하고 있습니다. 기본적으로 Tableau Server 관리 컨트롤러 서비스는 분산 배포의 초기 노드에 설치되고 구성됩니다.
로컬에서 tsm CLI 로그인
TSM 권한 그룹의 멤버인 사용자 계정으로 로컬 컴퓨터에서 tsm 명령을 실행하는 경우 암호를 지정할 필요가 없습니다. 이 경우 다음 예와 같이 명령을 실행하십시오.
tsm version
원격에서 tsm CLI 로그인
Tableau Server 관리 컨트롤러 서비스가 실행되고 있지 않은 클러스터의 노드에서 TSM 명령을 실행하는 경우 명령을 실행하기 전에 원격 컴퓨터에서 Tableau Server 관리 컨트롤러 서비스로 세션을 인증해야 합니다. 예를 들어 다음 명령을 실행합니다.
tsm login -s <server_name> -u <account_name>
여기에서 <server_name>은 Tableau Server 관리 컨트롤러 서비스가 실행되고 있는 노드의 이름이고 <account_name>은 TSM 권한 그룹의 멤버인 계정입니다.
이 명령을 실행하면 암호를 입력하라는 메시지가 나타납니다. 계정이 인증되면 TSM 명령을 실행할 수 있습니다.
보안 모범 사례로, TSM 포트(기본값은 8850)를 인터넷에 노출하지 않는 것이 좋습니다.
TSM 권한 그룹 보기 및 계정 추가
TSM 권한 그룹은 서버 설치 중에 만들어집니다. 기본적으로 TSM 권한 그룹의 이름은 tsmadmin으로 지정됩니다. 설치 중에 대체 TSM 권한 그룹을 만든 경우 다음 코드 예제에서 tsmadmin을 사용하는 그룹 이름으로 바꾸십시오.
tsmadmin 그룹의 사용자 계정을 보려면 다음 명령을 실행합니다.
grep tsmadmin /etc/group
tsmadmin 그룹에 사용자 계정을 추가하려면:
sudo usermod -G tsmadmin -a <username>
tsm CLI를 사용하는 스크립팅 및 자동화
스크립트 파일에서 암호를 사용하지 않고 Tableau Server에서 자동화를 실행하려면 초기 노드에서 적절한 TSM 권한 그룹의 계정을 사용하여 스크립트를 실행하십시오. 자세한 내용은 위의 "인증" 섹션을 참조하십시오.
셸에서 도움말 콘텐츠 보기
명령줄에서 최소한의 도움말 콘텐츠를 보려면 tsm help 범주를 사용합니다.
개요
tsm help [category] [command]
명령
tsm help모든 tsm 명령에 대한 도움말
tsm help <category>특정 명령 범주에 대한 도움말을 표시합니다. 예를 들어
tsm help authentication입니다.tsm help <category> <command>특정 명령에 대한 도움말을 표시합니다. 예를 들어
tsm help authentication open-id입니다.tsm help commands모든 최상위 수준 명령 또는 범주를 나열합니다.