tsm 파일 경로

특정 tsm 명령이 기본 위치에서 파일을 읽거나 기본 위치에 파일을 씁니다. 이러한 기본 위치는 각 명령에 정의된 basefilepath 구성 키를 통해 결정됩니다. tsm을 사용하여 키의 현재 값을 보고 위치를 변경할 수 있습니다.

NetworkService 시스템 계정

일부 조직에서는 NetworkService 계정 같은 시스템 계정의 파일 액세스를 제한하는 보안 정책을 구현합니다. tsm 파일 경로를 변경하는 경우 NetworkService 시스템 계정에 변경 후 경로에 대한 전체 사용 권한(사용 권한 상속을 사용하도록 설정)이 있는지 확인해야 합니다. 또한 원래 *\data\tabsvc\* 경로에 속한 파일 경로를 변경한 경우 원래 경로에 대한 NetworkService 사용 권한을 유지해야 합니다. NetworkService 시스템 계정은 Tableau Server 관리 컨트롤러, Tableau Server 클라이언트 파일 서비스 및 Tableau Server 조정 서비스의 작업을 처리하기 때문에 이 사용 권한을 유지해야 합니다.

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

백업/복원 파일 위치에 대해 필요한 사용 권한:

  • NetworkService: 읽기/쓰기/실행 권한
  • ‘서비스 계정’ 서비스 계정: 읽기/쓰기/실행 권한

파일의 기본 위치

tsm maintenance backup, restore, send-logsziplogs 프로세스와 tsm sites exportsites 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

 

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