tsm File Paths

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

檔的預設位置

tsm maintenance backuprestoresend-logsziplogs 過程中以及 tsm sites exportsites import 過程中,Tableau Server 為這些命令建立或使用的檔使用預設位置。

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

預設情況下:

  • Tsm 維護命令

    • backup — 備份的 .tsbak 檔案建立在初始節點上資料目錄中的暫存位置,然後儲存在:

      /var/opt/tableau/tableau_server/data/tabsvc/files/backups/

    • restore — restore 過程從以下位置還原備份檔案:

      /var/opt/tableau/tableau_server/data/tabsvc/files/backups/

    • send-logs — send-logs 從以下位置傳送記錄檔:

      /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 — 在匯入過程中,Tableau Server 將在以下位置中尋找檔:

      /var/opt/tableau/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 詳情,請參閱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 "/new/directory/path"

    • 變更 ziplogs 目錄:

      tsm configuration set -k basefilepath.log_archive -v "/new/directory/path"

  • 對於 tsm 網站命令:

    • 變更網站匯出目錄:

      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

  2. 停止 Tableau Server:

    tsm stop

  3. (以 tableau 系統帳戶身分)重新開機 TSM 控制項目:

    sudo su -l tableau -c "systemctl --user restart tabadmincontroller_0.service"

  4. 等待幾分鐘,重新啟動控制項目。您可以使用此命令確認控制項目是否已重新啟動:

    tsm status -v

    當您可以執行該命令並且 Tableau Server 管理控制項目被列為 [正在執行] 時,控制項目已重新啟動。

  5. 啟動 Tableau Server:

    tsm start

 

感謝您的意見反應!已成功提交您的意見回饋。謝謝!