tsm maintenance

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

tsm maintenance backup

Tableau Server에 의해 관리되는 데이터의 백업을 만듭니다. 이 데이터에는 통합 문서 및 사용자 메타데이터와 추출(.tde 또는 .hyper) 파일을 포함하는 Tableau PostgreSQL 데이터베이스(리포지토리)가 포함됩니다. 이 데이터에는 구성 데이터가 포함되지 않습니다. 자세한 내용은 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일)

-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 reindex-search

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

선택 사항입니다.

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

선택 사항입니다.

최신 덤프를 포함합니다.

-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>

선택 사항입니다.

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

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

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

 

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