某些 tsm 命令都從預設位置讀取檔或將檔案寫入預設位置。這些預設位置由為每個命令定義的 basefilepath 設定金鑰確定。可以使用 tsm 檢視金鑰的當前值,並變更位置。

NetworkService 系統帳戶

在某些組織中,會實作限制系統帳戶的檔案存取的安全性原則,例如 NetworkService 帳戶。如果變更 tsm 檔案路徑,則應驗證 NetworkService 系統帳戶是否擁有所產生路徑的完整權限(且已啟用權限繼承)。此外,如果您變更原本在 *\data\tabsvc\* 路徑中的檔案路徑,就必須將 NetworkService 權限保留為原始路徑。之所以必須保留此權限,是因為 NetworkService 系統帳戶會透過 Tableau Server 管理控制器、Tableau Server Client File Service 以及 Tableau Server Coordination Service 等處理作業。

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

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

  • NetworkService:讀/寫/執行權限
  • 執行身份服務帳戶:讀/寫/執行權限

檔的預設位置

tsm maintenance backuprestoresend-logsziplogs 過程中以及 tsm sites exportsites 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 組合備份檔案的位置。

  • 對於 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

 

感謝您的意見回饋!