tsm File Paths


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

檔的預設位置

在 tsm maintenance backup、restore、send-logs 和 ziplogs 過程中以及 tsm sites export 和 sites 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

 

返回頂端
感謝您的意見反應！已成功提交您的意見回饋。謝謝！