tsm maintenance

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

tsm maintenance backup

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

참고: 외부 파일 저장소가 있는 Tableau Server 설치에 이 명령을 사용하지 마십시오. 자세한 내용은 외부 파일 저장소를 사용하는 백업 및 복원을 참조하십시오.

토폴로지 구성으로 최적화:

  • 관리 컨트롤러와 동일한 노드에 파일 저장소를 함께 배치하면 백업 프로세스 중에 노드 간에서 데이터를 전송해야 할 필요성이 줄어들거나 없어져 Tableau Server를 백업하는 데 걸리는 기간을 줄일 수 있습니다. 특히 조직이 많은 추출을 사용하는 경우 효과적입니다.
  • 관리 컨트롤러 노드와 함께 리포지토리(pgsql)를 배치하면 백업 시간도 줄일 수 있지만 시간 절약 효과는 파일 저장소만큼 크지 않습니다.

초기 노드 장애가 발생하여 컨트롤러를 다른 노드로 이동하지 않은 한 관리 컨트롤러는 일반적으로 초기 노드에 있습니다.

백업 파일은 데이터 디렉터리의 임시 위치에서 결합된 후 TSM basefilepath.backuprestore 변수에 정의된 디렉터리에 저장됩니다. 기본적으로 다음과 같습니다.

C:\ProgramData\Tableau\Tableau Server\data\tabsvc\files\backups\<filename>.tsbak

백업 파일이 저장되는 위치와 해당 위치를 변경하는 방법에 대한 자세한 내용은 tsm 파일 경로를 참조하십시오. 참고: 백업 위치를 변경한 경우에도 백업 프로세스는 데이터 디렉터리의 임시 위치를 사용하여 백업 파일을 결합합니다.

개요

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

옵션

-f, --file <backup_file>

필수 항목입니다.

리포지토리 데이터 백업에 대한 자세한 내용은 Tableau Server 데이터 백업을 참조하십시오.

-d, --append-date

선택 사항입니다.

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

참고: 예약을 사용하여 만들어진 백업에는 백업 파일 이름의 시작 날짜/시간이 자동으로 포함됩니다. -d 옵션도 사용하는 경우 파일 이름에 날짜가 두 번 포함됩니다. 예약 백업에 대한 자세한 내용은 백업 일정 예약 및 관리를 참조하십시오.

-i, --description <string>

선택 사항입니다.

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

--ignore-prompt

선택 사항입니다. 버전 2020.2에 추가되었습니다.

파일 저장소가 관리 컨트롤러와 동일한 노드(일반적으로 초기 노드)에 있지 않은 경우에도 메시지를 표시하지 않고 백업합니다. 백업을 자동화하는 경우(예: 스크립트 사용) 이 프롬프트를 사용하십시오.

-k, --skip-verification

선택 사항입니다.

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

--multithreaded

선택 사항입니다. 버전 2021.1에 추가되었습니다.

기본적으로 Tableau Server 백업을 만들 때는 단일 스레드가 사용됩니다. 이 옵션을 지정하면 여러 스레드를 사용하여 백업이 만들어집니다. 이 옵션을 지정한 경우 기본적으로 스레드 2개가 사용됩니다. backup.zstd.thread_count 구성 키를 설정하여 사용되는 스레드 수를 변경할 수 있습니다.

--override-disk-space-check

선택 사항입니다.

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

-po, --pg-only

선택 사항입니다.

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

--request-timeout <timeout in seconds>

선택 사항입니다.

명령이 완료되도록 대기하는 시간(초)입니다. 기본값은 86400(1440분)입니다.

-sd, --schedule-days <day[,day]>

선택 사항입니다. 버전 2020.4에 추가되었습니다.

일정을 실행할 날짜입니다. 주별 일정에는 1~7(월요일은 1, 일요일은 7), 월별 일정에는 1~31을 사용합니다(월에 지정된 날짜가 포함되지 않은 경우 해당 월의 마지막 날짜가 사용됨). 여러 값은 쉼표로 구분합니다.

-si, --schedule-id <ID>

선택 사항입니다. 버전 2020.4에 추가되었습니다.

업데이트하려는 기존 일정의 ID를 지정합니다.

--skip-compression

선택 사항입니다.

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

-sn, --schedule-name <name>

선택 사항입니다. 버전 2020.4에 추가되었습니다.

만들거나 업데이트할 일정의 이름을 지정합니다.

-sr, --schedule-recurrence <frequency>

선택 사항입니다. 버전 2020.4에 추가되었습니다.

일정 되풀이 빈도입니다. 유효한 옵션은 "daily", "weekly" 또는 "monthly"입니다.

-st, --schedule-time <HH:MM>

선택 사항입니다. 버전 2020.4에 추가되었습니다.

일정이 실행되는 24시간 형식(HH:MM)의 시간입니다.

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

tsm maintenance backup -f ts_backup -d

이 예에서는 매주 토요일 정오에 실행되는 "weekly-saturday-backup"이라는 주별 반복 백업 일정을 만들고 <yyyy.mm.dd.hh.mm>-ts_saturday_backup.tsbak라는 백업을 만듭니다.

tsm maintenance backup -f ts_saturday_backup -sr weekly -st 12:00 -sd 6 -sn weekly-saturday-backup

예약된 백업 관리에 대한 자세한 내용은 백업 일정 예약 및 관리를 참조하십시오.

tsm maintenance cleanup

기본적으로 tsm maintenance cleanup 명령은 하루가 지난 임시 파일과 로그 파일을 삭제하고 7일이 지난 http_requests 테이블 항목을 삭제합니다. 명령 옵션으로 삭제할 파일과 보존 길이를 수정할 수 있습니다.

이 명령의 영향은 Tableau Server가 실행되고 있는지 여부에 따라 달라집니다.

  • 서버가 실행되고 있으면 대부분의 오래된 파일과 http_requests 테이블 항목은 삭제할 수 있지만 사용되고 있는 모든 파일(운영 체제에 의해 잠긴 파일)은 삭제할 수 없기 때문에 임시 파일과 활성 로그 파일이 제거되지 않습니다. 임시 파일과 현재 로그 파일을 삭제하려면 이 명령을 실행하기 전에 서버를 중지해야 합니다.
  • 서버가 중지된 경우 http_requests 항목을 삭제할 수 없습니다.

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

개요

tsm maintenance cleanup [options] [global options]

옵션

-a, --all

선택 사항입니다.

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

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

선택 사항입니다.

기본값: 7일

유지되어야 하는 http_requests 테이블 항목의 일 수를 지정합니다. 이 옵션을 -q 옵션과 함께 사용하여 테이블 항목의 보존 일수를 지정하고 기본값인 7일을 재정의합니다. 이 옵션은 테이블 항목 보존 기간을 지정하지만 테이블 항목의 실제 삭제를 트리거하지는 않습니다. 이는 항목 삭제를 트리거하는 -q 옵션과 함께 사용하십시오.

-ic, --sheet-image-cache

선택 사항입니다. 버전 2019.4에 추가되었습니다.

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

-l, --log-files

선택 사항입니다.

1일이 지난 로그 파일을 삭제합니다. data\tabsvc\logs의 하위 디렉터리에 있는 파일이 삭제됩니다.

--log-files-retention <일 수>

선택 사항입니다.

기본값: 1(24시간)

이 일 수보다 오래된 로그를 삭제합니다. 이를 사용하여 기본 보존 기간인 1일을 재정의합니다. 이 명령은 임시 파일에 적용되지 않습니다.

-q, --http-requests-table

선택 사항입니다.

이전 http_requests 테이블 항목을 삭제합니다. Tableau Server가 실행되고 있어야 테이블 항목이 삭제됩니다. Tableau Server가 중지된 경우 이 옵션은 무시됩니다. 이 옵션을 단독으로 사용하여 기본 보존 기간(7일)보다 오래된 항목을 삭제하도록 지정하거나 --http-requests-table-retention 옵션과 함께 사용하여 기본값과 다른 보존 기간을 지정할 수 있습니다.

참고: http_requests 테이블 항목을 삭제하면 관리 뷰를 사용자 지정하는 데 사용할 수 있는 데이터가 영구적으로 제거됩니다. 이 데이터를 제거해도 필요한 사용자 지정 뷰가 영향을 받지 않는지 확인하십시오.

-r, --redis-cache

선택 사항입니다.

Redis 캐시를 지웁니다.

--request-timeout <timeout in seconds>

선택 사항입니다.

명령이 완료될 수 있도록 지정된 시간 동안 기다립니다.

-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

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

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

tsm maintenance jmx disable

버전: 버전 2022.1에 추가된 명령입니다.

Tableau Server에서 JMX를 사용하지 않으려면 tsm maintenance jmx disable 명령을 사용합니다.

이 명령을 실행할 때는 TSM 서비스를 포함하여 Tableau Server를 다시 시작해야 합니다.

개요

tsm maintenance jmx disable [options] [global options]

옵션

--ignore-prompt

선택 사항입니다.

메시지 표시 없이 JMX를 사용하지 않도록 설정합니다.

--request-timeout <timeout in seconds>

선택 사항입니다.

명령이 완료될 수 있도록 지정된 시간 동안 기다립니다.

tsm maintenance jmx enable

버전: 버전 2022.1에 추가된 명령입니다.

Tableau Server에서 JMX를 사용하려면 tsm maintenance jmx enable 명령을 사용합니다.

이 대화형 명령은 명령줄 매개 변수로 옵션을 제공하지 않을 경우 해당하는 옵션을 선택하라는 메시지를 표시합니다.

이 명령을 사용하려면 TSM 서비스를 포함하여 Tableau Server를 다시 시작해야 합니다.

개요

tsm maintenance jmx enable

옵션

--access <readonly | readwrite>

선택 사항입니다.

JMX를 읽기 전용 또는 읽기/쓰기 액세스로 사용하도록 설정합니다. 기본값은 readonly입니다.

--ignore-prompt

선택 사항입니다.

추가 보안 옵션에 대한 메시지를 표시하지 않고 JMX를 사용하도록 설정합니다. 다른 명령 옵션을 포함하지 않으면 JMX와 함께 SSL을 사용할 수 있게 되고 Tableau Server가 다시 시작됩니다. 예:

tsm maintenance jmx enable --ignore-prompt

--no-ssl

선택 사항입니다.

SSL 없이 JMX를 사용하도록 설정합니다.

--request-timeout <timeout in seconds>

선택 사항입니다.

명령이 완료될 수 있도록 지정된 시간 동안 기다립니다.

--ssl-client-auth

선택 사항입니다.

JMX에서 클라이언트 인증에 SSL을 요구하도록 합니다.

--unsecured

선택 사항입니다.

보안 기능을 사용하지 않고 JMX를 사용하도록 설정합니다(권장되지 않음). 이 옵션은 2022.1 이전 버전에서 service.jmx_enabled 구성 키를 true로 설정하는 것과 같습니다.

tsm maintenance metadata-services disable

버전: 버전 2019.3에 추가된 명령입니다.

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 enable

버전: 버전 2019.3에 추가된 명령입니다.

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

Tableau Server에 Data Management 라이선스가 부여된 경우 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 get-status

버전: 버전 2019.3에 추가된 명령입니다.

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

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

개요

tsm maintenance metadata-services get-status

tsm maintenance preflight-check permissions

버전: Windows 기반 Tableau Server 버전 2020.3에서 추가된 명령입니다.

tsm maintenance preflight-check permissions 명령을 사용하여 디렉터리 사용 권한을 확인하십시오.

개요

tsm maintenance preflight-check permissions [options] [global options]

옵션

-d, --data-dir <데이터 디렉터리>

선택 사항입니다.

사용 권한을 확인할 데이터 디렉터리를 지정합니다. 포함하지 않을 경우 데이터 디렉터리는 현재 Tableau Server 구성에 따라 결정됩니다.

-i, --install-dir <설치 디렉터리>

선택 사항입니다.

사용 권한을 확인할 설치 디렉터리를 지정합니다. 포함하지 않을 경우 설치 디렉터리는 현재 Tableau Server 구성에 따라 결정됩니다.

-n --nodes <노드 ID,노드 ID,...>

선택 사항입니다.

사용 권한 확인에 특별히 포함할 노드의 노드 ID입니다. 지정하지 않으면 클러스터의 모든 노드에서 확인이 수행됩니다.

--request-timeout <timeout in seconds>

선택 사항입니다.

명령이 완료될 수 있도록 지정된 시간 동안 기다립니다.

-ru --runas-user <초 단위 시간 초과 시간>

선택 사항입니다.

사용 권한을 확인할 '서비스 계정' 사용자 이름입니다. 제공되지 않는 경우 '서비스 계정' 사용자는 현재 구성에서 결정됩니다.

tsm maintenance preflight-check ports

버전: Windows 기반 Tableau Server 버전 2020.3에서 추가된 명령입니다.

tsm maintenance preflight-check ports 명령을 사용하면 현재 설치된 모든 서비스에서 포트를 사용할 수 있는지 확인할 수 있습니다. 서비스 및 포트를 지정하면 서비스가 현재 설치되지 않은 경우에도 해당 서비스에서 포트를 사용할 수 있는지 확인할 수 있습니다.

개요

tsm maintenance preflight-check ports [options] [global options]

옵션

-a, --tabadminagent-addresses <호스트 이름:포트>

선택 사항입니다.

관리 에이전트에 대한 액세스를 확인할 호스트 및 포트를 지정합니다. 주소는 hostname:port 형식으로 지정합니다. 둘 이상의 주소를 확인하는 경우 쉼표로 주소를 구분하십시오. 이 옵션을 사용하면 포트를 설치하거나 변경하기 전에 포트를 사용할 수 있는지 확인할 수 있습니다.

-g, --gateway-addresses <호스트 이름:포트>

선택 사항입니다.

게이트웨이 서비스에 대한 액세스를 확인할 호스트 및 포트를 지정합니다. 주소는 hostname:port 형식으로 지정합니다. 둘 이상의 주소를 확인하는 경우 쉼표로 주소를 구분하십시오. 이 옵션을 사용하면 포트를 설치하거나 변경하기 전에 포트를 사용할 수 있는지 확인할 수 있습니다.

-n --nodes <노드 ID,노드 ID,...>

선택 사항입니다.

실행 전 검사를 실행할 노드의 노드 ID입니다. 지정하지 않으면 클러스터의 모든 노드에서 검사가 수행됩니다.

-r, --repository-addresses <호스트 이름:포트>

선택 사항입니다.

리포지토리 서비스에 대한 액세스를 확인할 호스트 및 포트를 지정합니다. 주소는 hostname:port 형식으로 지정합니다. 둘 이상의 주소를 확인하는 경우 쉼표로 주소를 구분하십시오. 이 옵션을 사용하면 포트를 설치하거나 변경하기 전에 포트를 사용할 수 있는지 확인할 수 있습니다.

-re --remote

선택 사항입니다.

모든 노드에서 관리 에이전트에 대한 원격 액세스를 확인합니다. 이 확인은 기본적으로 수행되지 않습니다.

--request-timeout <timeout in seconds>

선택 사항입니다.

명령이 완료될 수 있도록 지정된 시간 동안 기다립니다.

-t, --tabadmincontroller-addresses <호스트 이름:포트>

선택 사항입니다.

관리 컨트롤러에 대한 액세스를 확인할 호스트 및 포트를 지정합니다. 주소는 hostname:port 형식으로 지정합니다. 둘 이상의 주소를 확인하는 경우 쉼표로 주소를 구분하십시오. 이 옵션을 사용하면 포트를 설치하거나 변경하기 전에 포트를 사용할 수 있는지 확인할 수 있습니다.

tsm maintenance reindex-search

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

개요

tsm maintenance reindex-search [options] [global options]

옵션

--request-timeout <timeout in seconds>

선택 사항입니다.

명령이 완료될 수 있도록 지정된 시간 동안 기다립니다.

tsm maintenance reset-searchserver

버전: 이 명령은 검색 및 찾아보기(검색 서버라고도 함)가 사용 중지된 2023.3.0에서 사용 중지(제거)되었습니다. 검색 및 찾아보기가 인덱스 및 검색 서버로 대체되었습니다.

참고: 버전 2023.3.0 이상에서 이 명령을 실행하면 아무 작업도 수행되지 않습니다.

검색 서버를 정리된 상태로 재설정하고 검색 정보를 삭제한 다음 검색 인덱스를 다시 작성합니다.

개요

tsm maintenance reset-searchserver [options] [global options]

옵션

--request-timeout <timeout in seconds>

선택 사항입니다.

명령이 완료될 수 있도록 지정된 시간 동안 기다립니다.

tsm maintenance restore

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

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

버전 2022.3 부터는 tabadmin("TSM 이전 백업")을 사용하여 만든 백업이 지원되지 않습니다. TSM 이전 백업을 Tableau Server 버전 2022.3 이상으로 복원할 수 없습니다.

개요

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

옵션

-f, --file <file_name>

필수 항목입니다.

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

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

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

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

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

선택 사항입니다. 버전 2021.4.0에서 사용이 중단되었습니다.

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

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

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

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

원래 백업 파일을 만든 Tableau Server와 다른 ID 저장소 유형으로 변경하는 데 이 키를 사용하지 마십시오. ID 저장소를 변경하려면 ID 저장소 변경을 참조하십시오.

-po, --pg-only

선택 사항입니다.

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

-r, --restart-server

선택 사항입니다.

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

--request-timeout <timeout in seconds>

선택 사항입니다.

명령이 완료될 수 있도록 지정된 시간 동안 기다립니다.

tsm maintenance send-logs

지정된 파일을 Tableau에 업로드하고 지원 사례에 연결합니다. Tableau에 파일을 업로드하려면 Tableau Server가 https://report-issue.tableau.com에서 send-logs 서버와 통신할 수 있어야 합니다.

개요

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>

선택 사항입니다.

명령이 완료될 수 있도록 지정된 시간 동안 기다립니다.

tsm maintenance snapshot-backup complete

버전: 2020.1 버전에 추가된 명령이며 Tableau Server가 외부 파일 저장소용으로 구성된 경우에만 사용할 수 있습니다.

Tableau Server에서 스냅샷 백업 프로세스를 완료합니다. 외부 저장소의 스냅샷 백업을 생성한 후 이 명령을 실행합니다.

tsm maintenance snapshot-backup preparetsm maintenace snapshot-backup complete 명령은 외부 파일 저장소가 구성되어 있는 Tableau Server 설치의 Tableau Server 데이터 백업을 만드는 데 사용됩니다. 자세한 내용은 외부 파일 저장소를 사용하는 백업 및 복원을 참조하십시오.

개요

tsm maintenance snapshot-backup complete [options] [global options]

옵션

--request-timeout <timeout in seconds>

선택 사항입니다.

명령이 완료될 수 있도록 지정된 시간 동안 기다립니다.

tsm maintenance snapshot-backup prepare

버전: 2020.1 버전에 추가된 명령이며 Tableau Server가 외부 파일 저장소용으로 구성된 경우에만 사용할 수 있습니다.

스냅샷 백업을 준비합니다. 준비 단계가 완료되면 네트워크 저장소의 스냅샷 백업을 생성할 수 있습니다.

tsm maintenance snapshot-backup preparetsm maintenace snapshot-backup complete 명령은 외부 파일 저장소가 구성되어 있는 Tableau Server 설치의 Tableau Server 데이터 백업을 만드는 데 사용됩니다. 자세한 내용은 외부 파일 저장소를 사용하는 백업 및 복원을 참조하십시오.

개요

tsm maintenance snapshot-backup prepare [options] [global options]

옵션

--include-pg-backup

선택 사항입니다. 버전 2021.1에 추가되었습니다. 이전 버전에는 항상 외부 리포지토리의 백업이 포함되었습니다.

선택 사항입니다.

리포지토리 백업이 만들어지고 네트워크 공유로 복사됩니다. 외부 리포지토리와 외부 파일 저장소가 모두 구성된 배포에만 적용됩니다. 자세한 내용은 외부 파일 저장소를 사용하는 백업 및 복원을 참조하십시오.

--request-timeout <timeout in seconds>

선택 사항입니다.

명령이 완료될 수 있도록 지정된 시간 동안 기다립니다.

tsm maintenance snapshot-backup restore

버전: 2020.1 버전에 추가된 명령이며 Tableau Server가 외부 파일 저장소용으로 구성된 경우에만 사용할 수 있습니다.

저장소 스냅샷의 리포지토리 백업을 Tableau Server로 복원합니다.

자세한 내용은 외부 파일 저장소를 사용하는 백업 및 복원을 참조하십시오.

개요

tsm maintenance snapshot-backup restore [options] [global options]

옵션

--request-timeout <timeout in seconds>

선택 사항입니다.

명령이 완료될 수 있도록 지정된 시간 동안 기다립니다.

tsm maintenance validate-backup-basefilepath

버전: 버전 2022.1에 추가된 명령입니다.

백업/복원 기본 파일 경로 위치에 백업 및 복원 기능의 올바른 작동을 위한 사용 권한이 있는지 확인합니다. 백업 및 복원의 기본 파일 경로를 설정한 후 이 명령을 실행합니다. 자세한 내용은 현재 파일 위치 변경을 참조하십시오.

개요

tsm maintenance validate-backup-basefilepath [options][global options]

옵션

--request-timeout <timeout in seconds>

선택 사항입니다.

명령이 완료될 수 있도록 지정된 시간 동안 기다립니다.

tsm maintenance validate-resources

사이트의 통합 문서 및 데이터 원본의 유효성을 검사합니다. 사이트를 마이그레이션하기 전에 이 명령을 사용하여 사이트 가져오기 실패를 유발할 수 있는 통합 문서 및 데이터 원본과 같은 사이트 리소스 문제를 탐지합니다. 일부 리소스 문제는 로컬 원본에서 다시 게시하여 해결할 수 있습니다. 다른 문제는 Tableau 지원 팀의 지원이 필요할 수 있습니다.

개요

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

옵션

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

필수 항목입니다.

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

-r,--repair

선택 사항입니다.

잘못된 리소스를 복구하려고 시도합니다. 복구할 수 없는 리소스는 출력에 표시됩니다.

--request-timeout <timeout in seconds>

선택 사항입니다.

명령이 완료될 수 있도록 지정된 시간 동안 기다립니다.

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 덤프 파일을 포함합니다. Tableau Server 외부 리포지토리로 실행되는 배포에서는 이 플래그가 무시됩니다.

--enddate "<mm/dd/yyyy H:mm>"

선택 사항입니다. 시간 옵션(H:mm)은 버전 2021.4.0에 추가되었습니다.

포함할 로그 파일의 마지막 날짜입니다. 이 옵션은 --startdate와 함께 사용되어야 하며 --minimumdate 옵션과 함께 사용할 수 없습니다. 이 옵션을 지정하지 않으면 00:00(GMT)을 시작으로 최대 2일간의 로그가 포함됩니다.

시간 옵션을 포함할 경우 날짜와 시간을 따옴표로 묶어야 합니다. 시간 옵션은 GMT를 사용하지만 결과 로그 파일은 Tableau Server 컴퓨터의 현지 표준 시간대를 사용하여 기록됩니다.

예를 들어 Tableau Server 컴퓨터의 현지 표준 시간대가 PDT인 경우 2022년 7월 28일 오전 7시(PDT)에 로그 파일을 시작하고 오후 7시(PDT)에 종료하려면 다음을 사용합니다.

tsm maintenance ziplogs -f logs.zip --startdate "07/28/2022 14:00" --enddate "07/29/2022 02:00"

-f, --file <name>

선택 사항입니다.

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

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

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

-i, --description <string>

선택 사항입니다.

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

-l, --with-latest-dump

선택 사항입니다.

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

-m, --minimumdate <mm/dd/yyyy>

선택 사항입니다.

포함할 로그 파일의 가장 빠른 날짜입니다. 지정하지 않은 경우 최대 2일간의 로그 파일이 포함됩니다. 날짜 형식은 "mm/dd/yyyy"여야 합니다. 이 옵션은 --startdate--enddate 또는 --all과 함께 사용할 수 없습니다.

-mi, --with-msinfo

선택 사항입니다.

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

--nodes

선택 사항입니다. 버전 2020.3에 추가되었습니다.

ziplog 파일을 만들 노드를 지정합니다. 지정하지 않으면 모든 노드에 대해 ziplog 파일이 만들어지고 초기 노드에 저장됩니다. 노드를 쉼표로 구분합니다. 예를 들어 노드 2와 4에 대한 로그를 수집하려면 다음과 같이 합니다.

tsm maintenance ziplogs --nodes node2,node4

-o, --overwrite

선택 사항입니다.

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

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

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

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

--request-timeout <seconds>

선택 사항입니다.

명령이 완료되도록 대기하는 시간(초)입니다. 기본값은 7200(120분)입니다.

--startdate "<mm/dd/yyyy H:mm>"

선택 사항입니다. 시간 옵션(H:mm)은 버전 2021.4.0에 추가되었습니다.

포함할 로그 파일의 마지막 날짜입니다. 이 옵션은 --enddate와 함께 사용되어야 하며 --minimumdate 옵션과 함께 사용할 수 없습니다. 이 옵션을 지정하지 않으면 00:00(GMT)을 시작으로 최대 2일간의 로그가 포함됩니다.

시간 옵션을 포함할 경우 날짜와 시간을 따옴표로 묶어야 합니다. 시간 옵션은 GMT를 사용하지만 결과 로그 파일은 Tableau Server 컴퓨터의 현지 표준 시간대를 사용하여 기록됩니다.

예를 들어 Tableau Server 컴퓨터의 현지 표준 시간대가 PDT인 경우 2022년 7월 28일 오전 7시(PDT)에 로그 파일을 시작하고 오후 7시(PDT)에 종료하려면 다음을 사용합니다.

tsm maintenance ziplogs -f logs.zip --startdate "07/28/2022 14:00" --enddate "07/29/2022 02:00"

-t, --with-netstat-info

선택 사항입니다.

Netstat 정보를 포함합니다.

 

전역 옵션

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

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

 

피드백을 제공해 주셔서 감사합니다!귀하의 피드백이 제출되었습니다. 감사합니다!