tsm maintenance

tsm maintenance 명령을 사용하여 정기 백업을 만들거나 이전에 만든 백업에서 Tableau Server를 복원하는 등, 서버 유지 관리 작업을 수행할 수 있습니다.

tsm maintenance backup

Tableau Server에 의해 관리되는 데이터의 백업을 만듭니다. 이 데이터에는 통합 문서 및 사용자 메타데이터와 추출(.tde 또는 .hyper) 파일을 포함하는 Tableau PostgreSQL 데이터베이스(리포지토리)가 포함됩니다. 이 데이터에는 구성 데이터가 포함되지 않습니다. 자세한 내용은 Tableau Server의 전체 백업 및 복원 수행을 참조하십시오.

관리 컨트롤러와 동일한 노드에 리포지토리(pgsql)와 파일 저장소를 배치하면 Tableau Server를 백업하는 데 걸리는 시간을 줄일 수 있습니다. 초기 노드 장애가 발생하여 컨트롤러를 다른 노드로 이동하지 않은 한 관리 컨트롤러는 일반적으로 초기 노드에 있습니다.

백업 프로세스 중에는 노드 간에서 데이터를 압축하여 전송해야 하는 데 리포지토리를 컨트롤러와 같은 위치에 배치하면 이러한 필요성이 없어지거나 크게 줄어듭니다. 파일 저장소도 마찬가지이며, 특히 조직에서 추출을 많이 사용하는 경우 효과가 큽니다.

개요

tsm maintenance backup --file <backup_file> [options] [global options]

옵션

-d, --append-date

선택 사항입니다.

백업 파일 이름에 현재 날짜를 추가합니다.

-f, --file <backup_file>

필수 항목입니다.

지정된 파일에 백업을 작성합니다. .tsbak 확장명이 자동으로 사용됩니다. 파일은 TSM basefilepath.backuprestore 변수에 정의된 디렉터리에 작성됩니다. 기본적으로 다음과 같습니다.

C:\ProgramData\Tableau\Tableau Server\data\tabsvc\files\backups\

파일 경로 및 파일 경로를 변경하는 방법에 대한 자세한 내용은 tsm 파일 경로를 참조하십시오.

-i, --description <string>

선택 사항입니다.

백업 파일의 지정된 설명을 포함합니다.

--skip-compression

선택 사항입니다.

압축을 사용하지 않고 백업을 만듭니다. 이렇게 하면 더 큰 백업 파일이 만들어지지만 백업을 완료하는 데 걸리는 시간을 줄일 수 있습니다. 다중 노드 설치에서 이 옵션을 사용하는 경우 초기 노드에 파일 저장소 인스턴스를 구성하는 것이 좋습니다.

-k, --skip-verification

선택 사항입니다.

데이터베이스 백업의 무결성을 확인하지 않습니다.

--override-disk-space-check

선택 사항입니다.

디스크 공간 부족 경고가 표시된 경우에도 백업 만들기를 시도합니다.

-po, --pg-only

선택 사항입니다.

리포지토리 백업만 생성합니다.

--request-timeout <timeout in seconds>

선택 사항입니다.

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

이 예에서는 <install dir>\ProgramData\Tableau\Tableau Server\data\tabsvc\files\backups\ 폴더에 ts_backup-<yyyy-mm-dd>.tsbak라는 백업을 만듭니다.

tsm maintenance backup -f ts_backup -d

tsm maintenance cleanup

오래된 로그 파일 및 임시 파일을 삭제합니다.

분산 배포에서 Tableau Server를 실행하는 경우 관리 컨트롤러(TSM 컨트롤러라고도 함) 프로세스를 실행하는 노드에서 이 명령을 실행합니다. 기본적으로 컨트롤러는 클러스터의 초기 노드에 있습니다.

이 명령의 목적은 Tableau 배포에서 오래된 파일을 삭제하여 여유 공간을 확보하는 것입니다. 따라서, 이 시나리오의 경우 서버를 시작할 때 이 명령을 실행하면 오래된 콘텐츠 대부분이 제거됩니다. 현재 로그 파일을 제거하려면 이 명령을 실행하기 전에 서버를 중지해야 합니다.

참고: 이 명령은 Tableau Server 버전 10.5.1에서 추가되었으며 버전 2018.1에서 몇 가지 옵션이 추가되었습니다.

개요

tsm maintenance cleanup [options] [global options]

옵션

-a, --all

선택 사항입니다.

기본 유지 값을 사용하여 모든 정리 작업을 수행합니다. cleanup 명령을 -l -t -r -q 옵션을 사용하여 실행하는 것과 동일합니다.

--http-requests-table-retention <일 수>

선택 사항입니다.

이 기간(일)보다 오래된 http 요청 테이블 항목을 삭제합니다. (기본값: 7일)

-ic, --sheet-image-cache

선택 사항입니다.

이미지 캐시를 지웁니다. 이 캐시에는 오프라인 미리 보기용 이미지와 구독 이메일 메시지의 스냅샷뿐만 아니라 게시 REST API 끝점에서 요청된 모든 이미지가 포함될 수 있습니다(자세한 내용은 rest_api_ref.htm 참조).

참고: 버전 2019.4에 추가된 옵션

-l, --log-files

선택 사항입니다.

retention-period 이전의 로그 파일을 삭제합니다. data\tabsvc\logs의 하위 디렉터리에 있는 파일이 삭제됩니다.

--log-files-retention <일 수>

선택 사항입니다.

기본값: 1(24시간)

이 일 수보다 오래된 로그를 삭제합니다. 이 명령은 임시 파일에 적용되지 않습니다.

-q, --http-requests-table

선택 사항입니다.

이전 http_requests 테이블 항목을 삭제합니다.

-r, --redis-cache

선택 사항입니다.

Redis 캐시를 지웁니다.

--request-timeout <timeout in seconds>

선택 사항입니다.

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

-t, --temp-files

선택 사항입니다.

다음 디렉터리의 모든 파일과 하위 디렉터리를 삭제합니다.

  • <install dir>\ProgramData\Tableau\Tableau Server\data\tabsvc\temp: 만료된(실행 중이 아닌) 세션에 대한 파일을 저장하는 디렉터리만 삭제됩니다.

  • <install dir>\ProgramData\Tableau\Tableau Server\data\tabsvc\httpd\temp

  • <install dir>\ProgramData\Tableau\Tableau Server\temp

-v, --verbose

선택 사항입니다.

정리된 항목의 세부 정보를 표시합니다.

이 예에서는 2일이 지난 모든 로그 파일을 정리합니다.

tsm maintenance cleanup -l --log-files-retention 2

tsm maintenance metadata-services enable

Tableau Server에서 Tableau Metadata API를 사용하려면 tsm maintenance metadata-services enable 명령을 사용합니다.

Tableau Server에 Data Management Add-on 라이선스가 부여된 경우 Metadata API를 사용하도록 설정하면 Tableau Catalog가 사용하도록 설정됩니다.

Metadata API를 사용하도록 설정하면 Tableau Server의 콘텐츠에 대한 정보가 수집된 후 Metadata API 저장소에서 인덱싱됩니다. Metadata API를 사용하여 Tableau Server에 게시된 콘텐츠에 대한 스키마, 계보 및 사용자 관리 메타데이터를 쿼리할 수 있습니다. Metadata API를 사용하도록 설정하면 메타데이터가 지속적으로 수집되고 인덱싱되며, 중지하려면 Metadata API를 사용하지 않도록 설정해야 합니다.

이 명령을 실행할 때 다음 사항에 유의하십시오.

  • 이 명령은 Tableau Server에 사용되는 일부 서비스를 중지한 후 다시 시작하므로 권장 사항 같은 특정 기능이 일시적으로 사용자에게 제공되지 않습니다.
  • 이 명령을 사용할 때마다 새로운 메타데이터 인덱스가 만들어지고 이전 인덱스가 대체됩니다.

Tableau Catalog에 대한 자세한 내용은 Tableau Catalog 정보를 참조하십시오.

개요

tsm maintenance metadata-services enable

옵션

--ignore-prompt

선택 사항입니다.

Metadata API를 사용할 때 확인 메시지를 표시하지 않습니다.

tsm maintenance metadata-services disable

Tableau Metadata API를 사용하지 않으려면 tsm maintenance metadata-services disable 명령을 사용합니다.

Metadata API를 사용하지 않도록 설정하면 Tableau Server의 콘텐츠에 대한 지속적인 수집과 인덱싱이 중지되고, Tableau Server에 게시된 콘텐츠에 대한 정보의 인덱스와 해당 콘텐츠에 연결된 자산이 삭제되며 Metadata API 쿼리 및 Tableau Catalog 액세스 기능을 사용할 수 없게 됩니다.

이 명령을 실행하면 Tableau Server에 사용되는 일부 서비스가 중지된 후 시작되므로 권장 사항 같은 특정 기능이 일시적으로 사용자에게 제공되지 않습니다.

개요

tsm maintenance metadata-services disable

옵션

--ignore-prompt

선택 사항입니다.

Metadata API를 사용하지 않을 때 확인 메시지를 표시하지 않습니다.

tsm maintenance metadata-services get-status

메타데이터 서비스의 상태 정보를 가져오려면 tsm maintenance metadata-services get-status 명령을 사용합니다.

메타데이터 서비스의 상태는 Metadata API 저장소가 초기화되었는지 여부 또는 Tableau Metadata API가 실행되고 있는지 여부를 나타냅니다.

개요

tsm maintenance metadata-services get-status

tsm maintenance reindex-search

검색 인덱스를 다시 작성하려면 tsm maintenance reindex-search 명령을 사용합니다.

개요

tsm maintenance reindex-search [global options]

옵션

--request-timeout <timeout in seconds>

선택 사항입니다.

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

tsm maintenance restore

지정된 백업 파일을 사용하여 Tableau Server를 복원합니다. 백업 파일을 복원해도 구성 데이터가 복원되지 않습니다. 자세한 내용은 Tableau Server의 전체 백업 및 복원 수행을 참조하십시오.

실행 중인 서버와 동일한 유형의 ID 저장소가 있는 백업에서만 복원할 수 있습니다. 예를 들어 로컬 인증을 사용하는 서버의 백업은 로컬 인증으로 초기화된 Tableau Server로 복원될 수 있지만 Active Directory 인증을 사용하는 서버의 백업은 로컬 인증으로 초기화된 서버로 복원할 수 없습니다.

개요

tsm maintenance restore --file <file_name> [--restart-server] [global options]

옵션

-ak, --asset-key-file <file_name>

선택 사항입니다. Tableau Server(버전 2018.1 이하)의 tabadmin에서 만들어진 자산에서 복원하는 경우에만 이 옵션을 지정하십시오.

복원에 사용할 자산 키 파일의 이름. 자산 키 파일은 tabadmin assetkeys 명령에 의해 만들어집니다. 파일은 서버의 미리 정의된 백업/복원 위치에 있어야 합니다.

-f, --file <file_name>

필수 항목입니다.

복원할 백업 파일을 지정합니다.

restore 명령은 TSM basefilepath.backuprestore 변수에 정의된 디렉터리의 백업 파일을 사용합니다. 기본적으로 다음과 같습니다.

C:\ProgramData\Tableau\Tableau Server\data\tabsvc\files\backups\

파일 경로 및 파일 경로를 변경하는 방법에 대한 자세한 내용은 tsm 파일 경로를 참조하십시오.

-k, --skip-identity-store-verification

선택 사항입니다. Tableau Server(버전 2018.1 이하)의 tabadmin에서 만들어진 백업 파일에서 복원하는 경우에만 이 옵션을 지정하십시오.

ID 저장소 확인을 건너뜁니다. tabadmin backup --no-config 명령으로 만들어진 백업 파일을 복원하는 경우 이 옵션을 지정하십시오.

-po, --pg-only

선택 사항입니다.

리포지토리만 복원합니다.

-r, --restart-server

선택 사항입니다.

복원 후 서버를 다시 시작합니다.

--request-timeout <timeout in seconds>

선택 사항입니다.

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

tsm maintenance send-logs

지정된 파일을 Tableau에 업로드하고 지원 사례에 연결합니다.

개요

tsm maintenance send-logs --case <case_number> --email <contact_email> --file <path/to/file> [global options]

옵션

-c,--case <case_number>

필수 항목입니다.

지원 사례 번호입니다.

-e,--email <contact_email>

필수 항목입니다.

담당자 이메일입니다.

-f, --file <path/to/file>

필수 항목입니다.

보낼 로그 파일 아카이브의 위치 및 이름을 지정합니다.

--request-timeout <timeout in seconds>

선택 사항입니다.

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

tsm maintenance validate-resources

사이트의 통합 문서 및 데이터 원본의 유효성을 검사합니다.

개요

tsm maintenance validate-resources --site-id <site ID> [global options]

옵션

-id,--site-id <site ID>

필수 항목입니다.

리소스의 유효성을 검사하려는 사이트의 ID입니다.

-r,--repair

선택 사항입니다.

잘못된 리소스를 복구합니다.

--request-timeout <timeout in seconds>

선택 사항입니다.

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

 

tsm maintenance ziplogs

ziplogs 명령을 사용하여 Tableau Server 로그 파일의 아카이브를 만듭니다.

개요

tsm maintenance ziplogs [options] [global options]

옵션

-a, --all

선택 사항입니다.

msinfo, netstat 및 최근 덤프를 포함합니다. 명령을 -mi -t -l 옵션을 사용하여 실행하는 것과 동일합니다. PostgreSQL 데이터를 포함하지 않습니다.

-d, --with-postgresql-data

선택 사항입니다.

Tableau Server가 중지된 경우 PostgreSQL 데이터 폴더를 포함하고 Tableau Server가 실행 중인 경우 PostgreSQL 덤프 파일을 포함합니다.

--description <string>

선택 사항입니다.

아카이브 파일의 지정된 설명을 포함합니다.

-f, --file <name>

선택 사항입니다.

압축된 아카이브 파일의 이름을 지정합니다. 이름이 지정되지 않으면 logs.zip으로 아카이브가 만들어집니다. 파일은 TSM basefilepath.log_archive 변수에 정의된 디렉터리에 작성됩니다. 기본적으로 다음과 같습니다.

C:\ProgramData\Tableau\Tableau Server\data\tabsvc\files\log-archives\

파일 경로 및 파일 경로를 변경하는 방법에 대한 자세한 내용은 tsm 파일 경로를 참조하십시오.

-i, --description <string>

선택 사항입니다.

아카이브 파일의 지정된 설명을 포함합니다.

-mi, --with-msinfo

선택 사항입니다.

OS, 하드웨어 및 실행 중인 소프트웨어에 대한 시스템 정보가 포함된 msinfo32 보고서를 포함합니다.

-l, --with-latest-dump

선택 사항입니다.

서비스가 충돌하면 Tableau Server에서 덤프 파일이 생성됩니다. 최신 서비스 충돌 덤프 파일을 포함하려면 이 옵션을 설정합니다. 이 옵션을 설정하지 않으면 결과 ziplog에 덤프 파일이 포함되지 않습니다.

-m, --minimumdate <date>

선택 사항입니다.

포함할 로그 파일의 가장 빠른 날짜입니다. 지정하지 않은 경우 최대 2일간의 로그 파일이 포함됩니다. 날짜 형식은 "mm/dd/yyyy"여야 합니다.

-o, --overwrite

선택 사항입니다.

기존 ziplog 파일을 덮어씁니다. 같은 이름의 기존 파일이 있지만 이 옵션이 사용되지 않은 경우 ziplogs 명령이 실패합니다.

기본적으로 파일은 다음 위치에 기록됩니다.

C:\ProgramData\Tableau\Tableau Server\data\tabsvc\files\log-archives\

파일 경로 및 파일 경로를 변경하는 방법에 대한 자세한 내용은 tsm 파일 경로를 참조하십시오.

--request-timeout <timeout in seconds>

선택 사항입니다.

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

-t, --with-netstat-info

선택 사항입니다.

Netstat 정보를 포함합니다.

 

전역 옵션

-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와 함께 사용합니다.

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

 

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