---
schema_version: "1"
id: efccf5f40758cca3b00a9e050046a90170f2116a677f78ca5c3da2e510614786
title: tsm 파일 경로
collection: tableau
version: next
locale: ko-kr
portal_url: https://docs.salesforce.com/tableau/next/ko-kr/server-linux/cli_default_filepaths_tsm.md
canonical_url: https://help.tableau.com/v0.0/server-linux/ko-kr/cli_default_filepaths_tsm.htm
source_site: help.tableau.com
content_type: documentation
content_hash: f5ec481ae259aa46ed08e2d3bfe356092ddf24e66009e174aaf5585c713d9c5a
description: View and change the default file path locations tsm commands use for backups and other files.
---
[주요 콘텐츠로 건너뛰기](#main-content)

# tsm 파일 경로

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

## 파일의 기본 위치

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

Tableau Server 백업을 위한 디스크 공간 요구 사항에 대한 자세한 내용은 [백업의 디스크 공간 사용량](https://help.tableau.com/v0.0/server-linux/ko-kr/db_backup.htm#BackupDiskSpaceReqs)을 참조하십시오.

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

- tsm maintenance 명령:
    
    - **backup** - `.tsbak` 백업 파일은 초기 노드의 데이터 디렉터리에 있는 임시 위치에 만들어진 후 다음 위치에 저장됩니다.
        
        `` `/var/opt/tableau/tableau_server/data/tabsvc/files/backups/` ``
        
        - **backup** - 임시 준비 위치입니다. `.tsbak` 백업 파일은 초기 노드의 데이터 디렉터리에 있는 임시 위치에 만들어집니다.
            
            버전 2026.2.0부터 백업 파일을 만드는 대체 임시 위치를 지정할 수 있습니다. 이는 백업 파일이 크거나 초기 노드의 공간이 제한되어 있는 경우에 유용합니다. 자세한 내용은 [backuprestore.use\_custom\_staging\_dir.enabled](https://help.tableau.com/v0.0/server-linux/ko-kr/cli_configuration-set_tsm.htm#backuprestore_staging)를 참조하십시오.
    - restore - 복원 프로세스는 다음 위치의 백업 파일을 복원합니다.
        
        `` `/var/opt/tableau/tableau_server/data/tabsvc/files/backups/` ``
    - ziplogs - ziplogs 파일은 다음 위치에 생성됩니다.
        
        `/var/opt/tableau/tableau_server/data/tabsvc/files/log-archives`
- tsm sites
    
    - export - 내보내기 .zip 파일은 다음 디렉터리에 생성됩니다.
        
        `/var/opt/tableau/tableau_server/data/tabsvc/files/siteexports`
    - import - import 프로세스 중에 Tableau Server는 다음 위치에서 파일을 찾습니다.
        
        `/var/opt/tableau/tableau_server/data/tabsvc/files/siteimports`

## 현재 파일 위치 보기

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

- tsm maintenance 명령의 경우:
    
    - backup 및 restore:
        
        `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`

## 현재 basefilepath 위치 변경

`tsm configuration set` 명령을 사용하여 `basefilepath` 변수를 업데이트하면 TSM이 파일 동작에 사용하는 일부 위치를 변경할 수 있습니다. 특정 기준 파일 경로에 대한 자세한 내용은 [tsm configuration set 옵션](https://help.tableau.com/v0.0/server-linux/ko-kr/cli_configuration-set_tsm.htm)을 참조하십시오.

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

`tsm maintenance backup` 명령은 백업 파일을 `basefilepath.backuprestore` 변수로 지정된 위치에 저장하기 전에 파일 동작(어셈블, 추출)을 수행하기 위해 데이터 디렉터리의 임시 준비 위치를 사용합니다. 버전 2026.2.0부터 `basefilepath.backuprestore`에 지정된 위치를 사용하도록 TSM을 구성하면 백업이 `basefilepath.backuprestore`에 지정된 위치 아래의 임시 하위 디렉터리에서 어셈블됩니다. 2026.2.0 이전 버전의 경우 basefilepath를 변경해도 `tsm maintenance backup` 명령이 백업 파일을 어셈블하는 위치는 영향을 받지 않습니다.

- tsm maintenance 명령의 경우:
    
    - `backup` 및 `restore`
        
        `backup` 및 `restore` 명령에서 사용하는 디렉터리를 변경하려면 다음 명령을 실행합니다.
        
        `tsm configuration set -k basefilepath.backuprestore -v "/new/directory/path"`
    - `backup` 준비 위치
        
        **참고:** 준비 위치를 변경하는 기능은 버전 2026.2.0부터 사용할 수 있습니다.
        
        `backup` 에서 사용하는 임시 준비 위치를 `basefilepath.backuprestore` 위치 아래의 하위 디렉터리로 변경하려면 다음 명령을 실행합니다.
        
        `tsm configuration set -k backuprestore.use_custom_staging_dir.enabled -v true`
        
        `true`로 설정되어 있으면 `backup` 명령이 `basefilepath.backuprestore` 값으로 지정된 위치 아래의 임시 디렉터리를 사용합니다.
    - ziplogs 디렉터리를 변경하려면 다음 명령을 실행합니다.
        
        `tsm configuration set -k basefilepath.log_archive -v "/new/directory/path"`
- tsm sites 명령의 경우:
    
    - 사이트 내보내기 디렉터리를 변경하려면 다음 명령을 실행합니다.
        
        `tsm configuration set -k basefilepath.site_export.exports -v "/new/directory/path"`
    - 사이트 가져오기 디렉터리를 변경하려면 다음 명령을 실행합니다.
        
        `tsm configuration set -k basefilepath.site_import.exports -v "/new/directory/path"`

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

1. 보류 중인 변경 내용을 적용합니다.
    
    `tsm pending-changes apply`
    
    보류 중인 변경 내용을 적용하려면 서버를 다시 시작해야 하는 경우 `pending-changes apply` 명령은 서버가 다시 시작됨을 알리는 메시지를 표시합니다. 서버가 중지된 경우에도 이 메시지가 표시되지만 이 경우 다시 시작은 없습니다. `--ignore-prompt` 옵션을 사용하여 이 메시지를 표시하지 않을 수 있지만 다시 시작 동작은 변경되지 않습니다. 변경 내용을 적용해도 다시 시작할 필요가 없는 경우 메시지 없이 변경 내용이 적용됩니다. 자세한 내용은 [tsm pending-changes apply](https://help.tableau.com/v0.0/server-linux/ko-kr/cli_pending-changes.htm#pending-changes-apply)를 참조하십시오.
2. Tableau Server를 중지합니다.
    
    `tsm stop`
3. TSM 컨트롤러를 다시 시작합니다(_tableau_ 시스템 계정 사용).
    
    `sudo su -l tableau -c "systemctl --user restart tabadmincontroller_0.service"`
4. 컨트롤러가 다시 시작될 수 있도록 몇 분 정도 기다립니다. 다음 명령으로 컨트롤러가 다시 시작되었는지 확인할 수 있습니다.
    
    `tsm status -v`
    
    이 명령을 실행하여 Tableau Server 관리 컨트롤러가 '실행 중'으로 나열되면 컨트롤러가 다시 시작된 것입니다.
5. Tableau Server를 시작합니다.
    
    `tsm start`