tsm sites
tsm sites
명령을 사용하여 새 사이트로 가져올 기존 사이트를 내보내고 새 사이트로 가져올 수 있습니다(사이트 마이그레이션이라고도 함). 오류로 인해 사이트가 잠긴 경우 unlock
명령을 사용할 수 있습니다.
tsm sites
명령은 사용자의 로컬 파일 저장소를 사용하여 내보내기 및 가져오기 데이터를 유지합니다. 다중 노드 Tableau 클러스터를 실행하는 경우 데이터 엔진 프로세스가 실행되고 있는 Tableau Server에서 tsm sites
명령을 실행해야 합니다. 데이터 엔진 프로세스와 이 프로세스가 필요한 프로세스에 대한 자세한 내용은 Tableau Server 프로세스를 참조하십시오.
참고: Tableau Server 인스턴스 간에 사이트를 마이그레이션하는 경우 대상 사이트는 원본 사이트의 Tableau Server 버전보다 높거나 같은 Tableau Server 버전에 있어야 합니다. 원본 사이트와 대상 사이트 모두 지원되는 Tableau Server 버전에 있어야 합니다.
사이트를 마이그레이션하는 전체 단계는 사이트 내보내기 또는 가져오기를 참조하십시오.
tsm sites export
지정된 Tableau Server 사이트를 .zip 파일로 내보냅니다. 특정 시점에 설정을 아카이브하기 위해 또는 사이트 마이그레이션 프로세스의 첫 번째 단계를 완료하기 위해 사이트를 내보낼 수 있습니다.
참고: tsm sites import
및 tsm sites export
명령에서 오류가 발생할 경우 사이트가 잠긴 상태로 유지될 수 있습니다. 사이트 잠금을 해제하려면 tsm sites unlock
명령을 사용합니다.
개요
tsm sites export --site-id <source-siteID> --file <export-file> [options] [global options]
옵션
-f,--file <export-file>
필수 항목입니다.
Tableau Server가 모든 사이트 정보를 저장할 파일의 이름을 지정합니다.
이 파일은 TSM
basefilepath.site_export.exports
변수에 정의된 디렉터리에 생성됩니다. 기본적으로 다음과 같습니다.C:\ProgramData\Tableau\Tableau Server\data\tabsvc\files\siteexports
파일 경로 및 파일 경로를 변경하는 방법에 대한 자세한 내용은 tsm 파일 경로를 참조하십시오.
-id,--site-id <source-siteID>
필수 항목입니다.
내보내는 사이트의 사이트 ID입니다. 사이트 ID는 웹 브라우저에서 사이트에 로그인하면 나타나는 URL에서 얻을 수 있습니다. 사이트 ID 찾기에 대한 자세한 내용은 원본 및 대상 사이트 준비를 참조하십시오.
-ow,--overwrite
선택 사항입니다.
이미 존재하는 같은 이름의 내보내기 파일을 덮어씁니다.
--request-timeout <timeout in seconds>
선택 사항입니다.
명령이 완료될 수 있도록 지정된 시간 동안 기다립니다. 기본값은 43200(720분)입니다.
tsm sites import
이 명령에서는 tsm sites export
를 사용하여 생성한 .zip 파일을 사용하여 내보낸 원본 사이트 설정이 새 대상 사이트에 매핑되는 방식을 보여 주는 일련의 .csv 파일을 생성합니다.
기본적으로 .zip 파일이 생성되어 siteexports
디렉터리에 저장됩니다.
C:\ProgramData\Tableau\Tableau Server\data\tabsvc\files\siteexports
이 명령을 사용하기 전에 .zip 파일을 Tableau가 요구하는 디렉터리로 복사해야 합니다. 이 위치는 TSM basefilepath.site_import.exports
변수에 정의되어 있습니다. 기본적으로 가져오기 디렉터리는 다음과 같습니다.
C:\ProgramData\Tableau\Tableau Server\data\tabsvc\files\siteimports
파일 경로 및 파일 경로를 변경하는 방법에 대한 자세한 내용은 tsm 파일 경로를 참조하십시오.
참고: tsm sites import
및 tsm sites export
명령에서 오류가 발생할 경우 사이트가 잠긴 상태로 유지될 수 있습니다. 사이트 잠금을 해제하려면 tsm sites unlock
명령을 사용합니다.
개요
tsm sites import --file <export-file.zip> --site-id <target-siteID> [options] [global options]
옵션
-f,--file <export-file.zip>
필수 항목입니다.
tsm sites export
프로세스에서 생성된 .zip 파일의 이름이며 가져오기 디렉터리로 복사해야 하는 파일입니다. 기본적으로 다음과 같습니다.C:\ProgramData\Tableau\Tableau Server\data\tabsvc\files\siteimports
-id,--site-id <target-siteID>
필수 항목입니다.
가져올 새 사이트(대상 사이트)의 사이트 ID입니다. 사이트 ID 찾기에 대한 자세한 내용은 원본 및 대상 사이트 준비를 참조하십시오.
-c,--continue-on-ignorable-errors
선택 사항입니다.
무시할 수 있는 오류가 발생한 경우 사이트 가져오기를 계속합니다. 이러한 오류는 특정 통합 문서 또는 데이터 원본의 가져오기 문제를 나타낼 수 있습니다.
-k,--no-verify
선택 사항입니다.
매핑 파일의 확인을 건너뜁니다.
-m, --override-schedule-mapper <mapping-file.csv>
선택 사항입니다.
이름별로 일반 매핑을 재정의할 일정 매핑 파일입니다.
--request-timeout <timeout in seconds>
선택 사항입니다.
명령이 완료될 수 있도록 지정된 시간 동안 기다립니다. 기본값은 7200(120분)입니다.
tsm sites import-verified
새 사이트로 가져올 내보낸 사이트의 .csv 매핑 파일이 들어 있는 디렉터리를 지정합니다. 이것은 사이트 마이그레이션 프로세스의 마지막 단계입니다.
개요
tsm sites import-verified --import-job-dir <importjob-directory> --site-id <target-siteID> [options] [global options]
옵션
-id,--site-id <target-siteID>
필수 항목입니다.
가져올 새 사이트(대상 사이트)의 사이트 ID입니다. 사이트 ID 찾기에 대한 자세한 내용은 원본 및 대상 사이트 준비를 참조하십시오.
-w, --import-job-dir <importjob-directory>
필수 항목입니다.
내보낸(원본) 사이트의 .csv 파일이 들어 있는
mappings
디렉터리의 상위 디렉터리입니다. 이 상위 디렉터리의 이름은 가져오기 id와 날짜/시간을 포함합니다. 예:C:\ProgramData\Tableau\Tableau Server\data\tabsvc\files\siteimports\working\import_ff00_20180102022014457
--request-timeout <timeout in seconds>
선택 사항입니다.
명령이 완료될 수 있도록 지정된 시간 동안 기다립니다. 기본값은 7200(120분)입니다.
tsm sites unlock
이 명령을 사용하여 사이트를 잠금 해제합니다.
옵션
-id,--site-id <target-siteID>
필수 항목입니다.
잠금 해제하려는 사이트의 사이트 ID입니다. 사이트 ID 찾기에 대한 자세한 내용은 원본 및 대상 사이트 준비를 참조하십시오.
-d, --desired-state <잠금 해제된 사이트를 유지할 상태>
선택 사항입니다.
사이트를 잠금 해제한 후 유지할 상태입니다. 옵션은 "active" 및 "suspended"입니다. 지정되지 않은 경우 기본값은 "active"입니다.
예:
tsm sites unlock -id mysite -d suspended
--request-timeout <timeout in seconds>
선택 사항입니다.
명령이 완료될 수 있도록 지정된 시간 동안 기다립니다. 기본값은 300(5분)입니다.
전역 옵션
-h, --help
선택 사항입니다.
명령 도움말을 보여 줍니다.
-p, --password <password>
활성 상태인 세션이 없는 경우 필수 사항이며
-u
또는--username
과 함께 사용합니다.-u
또는--username
에 지정된 사용자의 암호를 지정합니다.암호에 공백 또는 특수 문자가 포함된 경우 암호를 따옴표로 묶습니다.
--password "my password"
-s, --server https://<hostname>:8850
선택 사항입니다.
Tableau 서비스 관리자에 대해 지정된 주소를 사용합니다. URL은
https
로 시작하고 포트 8850을 포함하며 IP 주소가 아닌 서버 이름을 사용해야 합니다. 예:https://<tsm_hostname>:8850
. 서버를 지정하지 않으면https://<localhost | dnsname>:8850
이 사용됩니다.--trust-admin-controller-cert
선택 사항입니다.
TSM 컨트롤러에서 자체 서명된 인증서를 신뢰하려면 이 플래그를 사용합니다. 인증서 신뢰 및 CLI 연결에 대한 자세한 내용은 TSM 클라이언트 연결을 참조하십시오.
-u, --username <user>
활성 상태인 세션이 없는 경우 필수 사항이며
-p
또는--password
와 함께 사용합니다.사용자 계정을 지정합니다. 이 옵션이 포함되어 있지 않으면 현재 로그인한 사용자의 자격 증명을 사용하여 명령이 실행됩니다.