Windows 기반 Tableau Server 도움말

백업/복원 파일 위치에 대한 사용 권한

파일의 기본 위치

tsm maintenance backup, restore, send-logs 및 ziplogs 프로세스와 tsm sites export 및 sites import 프로세스 중에 Tableau Server는 이러한 명령을 통해 만들어지거나 사용되는 파일의 기본 위치를 사용합니다.

Tableau Server 백업을 위한 디스크 공간 요구 사항에 대한 자세한 내용은 백업의 디스크 공간 사용량을 참조하십시오.

기본적으로 다음과 같습니다.

• tsm maintenance 명령:

  • backup - 백업 .tsbak 파일은 초기 노드의 데이터 디렉터리에 있는 임시 위치에 만들어진 후 다음 위치에 저장됩니다.

    <install drive>:<install\path>\data\tabsvc\files\backups

    기본적으로 다음과 같습니다.

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

    하지만 Tableau를 기본 위치가 아닌 위치에 설치한 경우 이 위치가 달라집니다. 예를 들어 D:\Tableau Server에 설치한 경우 백업은 다음 위치에 저장됩니다.

    D:\Tableau Server\data\tabsvc\files\backups

    참고: tsm maintenance backup 명령은 Microsoft Windows UNC(범용 명명 규칙) 파일 경로 또는 "네트워크 경로"(\\<컴퓨터 이름>\<폴더>\<파일 이름>)를 백업 파일이 작성되는 위치에 대한 경로로 지원하지 않습니다. 대신 로컬 파일 시스템 경로(<드라이브 문자>:\<폴더 이름>\<파일 이름>)를 사용하십시오.

  • restore - 복원 프로세스는 다음 위치의 백업 파일을 복원합니다.

    <install drive>:<install\path>\data\tabsvc\files\backups

    기본적으로 다음과 같습니다.

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

    하지만 Tableau를 기본 위치가 아닌 위치에 설치한 경우 이 위치가 달라집니다. 예를 들어 D:\Tableau Server에 설치한 경우 복원 프로세스에서 다음 위치에 있는 백업을 사용합니다.

    D:\Tableau Server\data\tabsvc\files\backups

  • send-logs - send-logs는 다음 위치의 로그 파일을 전송합니다.

    <install drive>:<install\path>\data\tabsvc\files\backups

    기본적으로 다음과 같습니다.

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

    하지만 Tableau를 기본 위치가 아닌 위치에 설치한 경우 이 위치가 달라집니다. 예를 들어 D:\Tableau Server에 설치한 경우 send-logs 프로세스는 다음 위치의 로그 파일을 전송합니다.

    D:\Tableau Server\data\tabsvc\files\backups

  • ziplogs - ziplogs 파일은 다음 위치에 생성됩니다.

    <install drive>:<install\path>\data\tabsvc\files\log-archives

    기본적으로 다음과 같습니다.

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

    하지만 Tableau를 기본 위치가 아닌 위치에 설치한 경우 이 위치가 달라집니다. 예를 들어 D:\Tableau Server에 설치한 경우 ziplogs 파일은 다음 위치에 생성됩니다.

    D:\Tableau Server\data\tabsvc\files\log-archives

• tsm sites

  • export - 내보내기 .zip 파일은 다음 디렉터리에 생성됩니다.

    <install drive>:<install\path>\data\tabsvc\files\siteexports

    기본적으로 다음과 같습니다.

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

    하지만 Tableau를 기본 위치가 아닌 위치에 설치한 경우 이 위치가 달라집니다. 예를 들어 D:\Tableau Server에 설치한 경우 내보내기 .zip 파일은 다음 위치에 생성됩니다.

    D:\Tableau Server\data\tabsvc\files\siteexports

  • import - import 프로세스 중에 Tableau Server는 다음 위치에서 파일을 찾습니다.

    <install drive>:<install\path>\data\tabsvc\files\siteimports

    기본적으로 다음과 같습니다.

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

    하지만 Tableau를 기본 위치가 아닌 위치에 설치한 경우 이 위치가 달라집니다. 예를 들어 D:\Tableau Server에 설치한 경우 가져오기 프로세스에서 다음 위치에 있는 파일을 찾습니다.

    D:\Tableau Server\data\tabsvc\files\siteimports

현재 파일 위치 보기

tsm configuration get을 사용하여 특정 명령에 대한 현재 파일 위치를 확인할 수 있습니다.

• tsm maintenance 명령의 경우:

  • backup, restore 및 send-logs:

    tsm configuration get -k basefilepath.backuprestore

  • ziplogs:

    tsm configuration get -k basefilepath.log_archive

• tsm sites 명령의 경우:

  • export

    tsm configuration get -k basefilepath.site_export.exports

  • import

    tsm configuration get -k basefilepath.site_import.exports

현재 파일 위치 변경

tsm configuration set 명령을 사용하여 basefilepath 변수를 업데이트하면 예상 파일 위치를 변경할 수 있습니다. 특정 기준 파일 경로에 대한 자세한 내용은 tsm configuration set 옵션을 참조하십시오.

basefilepath 변수를 변경해도 기존 파일이 원래 디렉터리에서 새 디렉터리로 이동하지는 않습니다. 기존 백업, 복원, 로그 파일 또는 사이트 내보내기 또는 가져오기 파일을 지정한 새 디렉터리에 배치하려면 수동으로 이동해야 합니다. 새 위치를 만드는 것과 tsm이 해당 위치에 배치되는 모든 파일과 해당 파일이 포함된 디렉터리 구조에 액세스할 수 있도록 올바른 사용 권한을 설정하는 것은 사용자의 책임입니다. 백업/복원 기본 파일 경로를 변경하는 경우 tsm maintenance validate-backup-basefilepath 명령(버전 2022.1 이상에서 사용 가능)을 실행하여 사용 권한이 올바르게 설정되었는지 확인해야 합니다.

tsm maintenance backup 명령은 데이터 디렉터리의 임시 위치에서 백업을 결합한 후 백업 파일을 basefilepath.backuprestore 변수로 지정된 위치에 저장합니다. basefilepath를 변경해도 tsm maintenance backup 명령이 백업 파일을 결합하는 위치는 영향을 받지 않습니다.

드라이브의 루트에 basefilepath.backuprestore 위치를 지정할 수 없습니다. 이 위치는 폴더여야 합니다.

• tsm maintenance 명령의 경우:

  • backup, restore 또는 send-logs 디렉터리를 변경하려면 다음 명령을 실행합니다.

    tsm configuration set -k basefilepath.backuprestore -v "<drive>:\new\directory\path"

  • ziplogs 디렉터리를 변경하려면 다음 명령을 실행합니다.

    tsm configuration set -k basefilepath.log_archive -v "<drive>:\new\directory\path"

• tsm sites 명령의 경우:

  • 사이트 내보내기 디렉터리를 변경하려면 다음 명령을 실행합니다.

    tsm configuration set -k basefilepath.site_export.exports -v "<drive>:\new\directory\path"

  • 사이트 가져오기 디렉터리를 변경하려면 다음 명령을 실행합니다.

    tsm configuration set -k basefilepath.site_import.exports -v "<drive>:\new\directory\path"

기본 파일 위치를 변경한 후 다음을 수행해야 합니다.

1. 보류 중인 변경 내용을 적용합니다.

   tsm pending-changes apply

   보류 중인 변경 내용을 적용하려면 서버를 다시 시작해야 하는 경우 pending-changes apply 명령은 서버가 다시 시작됨을 알리는 메시지를 표시합니다. 서버가 중지된 경우에도 이 메시지가 표시되지만 이 경우 다시 시작은 없습니다. --ignore-prompt 옵션을 사용하여 이 메시지를 표시하지 않을 수 있지만 다시 시작 동작은 변경되지 않습니다. 변경 내용을 적용해도 다시 시작할 필요가 없는 경우 메시지 없이 변경 내용이 적용됩니다. 자세한 내용은 tsm pending-changes apply를 참조하십시오.

2. Tableau Server를 중지합니다.

   tsm stop

3. TSM 컨트롤러를 다시 시작합니다.

   net stop tabadmincontroller_0

   net start tabadmincontroller_0

4. 컨트롤러가 다시 시작될 수 있도록 몇 분 정도 기다립니다. 다음 명령으로 컨트롤러가 다시 시작되었는지 확인할 수 있습니다.

   tsm status -v

   이 명령을 실행하여 Tableau Server 관리 컨트롤러가 '실행 중'으로 나열되면 컨트롤러가 다시 시작된 것입니다.

5. Tableau Server를 시작합니다.

   tsm start