Windows 版 Tableau Server 說明

備份/還原檔案位置的權限

檔的預設位置

在 tsm maintenance backup、restore、send-logs 和 ziplogs 過程中以及 tsm sites export 和 sites import 過程中，Tableau Server 為這些命令建立或使用的檔使用預設位置。

有關備份 Tableau Server 之磁碟空間要求的詳情，請參閱用於備份的磁碟空間使用情況。

預設情況下：

• Tsm 維護命令

  • 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 維護備份命令不支援 Microsoft Windows 通用命名慣例 (UNC) 檔案路徑（亦稱為「網路路徑」，例如，\\<computer name>\<folder>\<file name>）作為備份檔案寫入位置的路徑。請改用本機檔案系統路徑（<drive letter>:\<folder name\<file name>）。

  • restore — 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，傳送記錄檔處理序將從以下位置傳送記錄檔：

    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 — 在匯入過程中，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 維護命令：

  • Backup、restore 和 send-logs：

    tsm configuration get -k basefilepath.backuprestore

  • ziplogs：

    tsm configuration get -k basefilepath.log_archive

• 對於 tsm 網站命令：

  • 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 維護命令：

  • 若要變更 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 網站命令：

  • 變更網站匯出目錄：

    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