tsm maintenance

您可以使用 tsm maintenance 命令來管理伺服器維護工作,例如建立定期備份或從先前建立的備份還原 Tableau Server

tsm maintenance backup

建立 Tableau Server 管理的資料的備份。此資料包括 Tableau PostgreSQL 資料庫(存放庫),其中包含工作簿和使用者中繼資料,以及擷取檔(.tde 或 .hyper)。此資料不包含設定資料。請參閱執行 Tableau Server 的完整備份和還原

將存放庫 (pgsql) 和檔案存放區置於管理控制器所在的相同節點上,可以減少備份 Tableau Server 所需花費的時間。除非您曾遭遇初始節點故障,而必須將控制器移到另一個節點上,否則管理控制器通常是在起始節點上。

當存放庫與控制器位於相同位置,便消除或大幅減少在備份程序中壓縮並在節點間傳輸資料的需求。這個方法也適用於檔案存放區,特別是如果您的組織大量使用擷取。

概要

tsm maintenance backup --file <backup_file> [options] [global options]

選項

-d, --append-date

可選。

將當前日期附加到備份檔案名。

-f, --file <backup_file>

必要。

將備份寫入指定的檔案。系統會自動使用 .tsbak 副檔名。檔案將寫入 TSM basefilepath.backuprestore 變數中定義的目錄。預設情況下:

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

有關檔案路徑及其修改方式的詳情,請參閱tsm File Paths

-i, --description <string>

可選。

包括備份檔案的指定說明。

--跳過-壓縮

可選。

不使用壓縮建立備份。這會產生較大的備份檔案,但是可以縮短備份完成的時間。若在多節點安裝中使用此操作,強烈建議您在初始節點上設定檔案存放區執行個體。

-k, --skip-verification

可選。

不驗證資料庫備份的完整性。

--override-disk-space-check

可選。

即使在出現磁碟空間不足警告時也嘗試建立備份。

-po, --pg-only

可選。

只產生存放庫備份。

--request-timeout <timeout in seconds>

可選。

等待指定的時間以完成命令。預設值為 1800(30 分鐘)。

範例

此範例會在 /var/opt/tableau/tableau_server/data/tabsvc/files/backups/ 目錄中建立名為 ts_backup-<yyyy-mm-dd>.tsbak 的備份:

tsm maintenance backup -f ts_backup -d

tsm maintenance cleanup

刪除舊記錄檔案和暫封存。

如果您在分散式部署上執行 Tableau Server,請在執行管理控制器(也稱為 TSM 控制器)處理序的節點上執行此命令。預設情況下,控制器位於叢集的初始節點上。

此命令的目的是透過刪除舊的檔案以在 Tableau 部署中建立可用空間。因此,在伺服器啟動時執行此命令會移除此案例大部分的內容。若要移除目前的記錄檔,您必須先停止伺服器,再執行此命令。

附註:此命令是 Tableau Server 版本 10.5.1 中的新增命令,部分選項是版本 2018.1 中的新增選項。

概要

tsm maintenance cleanup [options] [global options]

選項

-a, --all

可選。

使用預設保留值執行所有清理操作。相當於使用以下選項執行 cleanup 命令: -l -t -r -q

--http-requests-table-retention <天數>

可選。

預設值:7 天

指定應保留 http_requests 表項目的天數。刪除早於指定天數的項目。此選項指定保留天數,但不刪除表項目。要刪除項目,除此選項外,請使用 -q 選項。

-ic, --sheet-image-cache

可選。

清除影像快取。此快取可包含離線預覽的影像、訂閱電子郵件訊息的快照、訂閱 PDF,以及任何從發佈 REST API 端點要求的影像(有關詳情請參閱 rest_api_ref.htm)。

附註:版本 2019.4 中新增的選項

-l, --log-files

可選。

刪除 retention-period 之前的記錄檔案。將刪除 data/tabsvc/logs 下的子目錄中的檔案。

--log-files-retention <天數>

可選。

預設值:1(24 小時)

刪除此天數之前的記錄。此命令不適用於暫封存。

-q, --http-requests-table

可選。

刪除舊的 http_requests 表項目。必須行 Tableau Server 才能刪除表項目。如果停止 Tableau Server,則忽略此選項。

-r, --redis-cache

可選。

清除 Redis 快取。

--request-timeout <timeout in seconds>

可選。

等待指定的時間以完成命令。預設值為 1800(30 分鐘)。

-t, --temp-files

可選。

刪除以下目錄中的所有檔案和子目錄:

  • /var/opt/tableau/tableau_server/data/tabsvc/temp:只會刪除存放已過期(未在執行)會話檔案的目錄。

  • /var/opt/tableau/tableau_server/data/tabsvc/httpd/temp

  • /var/opt/tableau/tableau_server/temp

-v, --verbose

可選。

顯示所清理內容的詳情。

範例

此範例將清理 2 天之前的所有記錄檔案:

tsm maintenance cleanup -l --log-files-retention 2

tsm maintenance metadata-services enable

使用 tsm maintenance metadata-services enable 命令可啟用 Tableau Server 的 Tableau 中繼資料 API。

如果 Tableau Server 已獲得 資料管理附加元件 授權,則啟用中繼資料 API 就會啟用 Tableau Catalog。

啟用中繼資料 API 時,會擷取 Tableau Server 上內容的相關資訊,然後將該資訊編製成中繼資料 API 儲存區的索引。中繼資料 API 可用來查詢有關已發佈至 Tableau Server 之內容的架構、歷程和使用者管理的中繼資料。啟用中繼資料 API 之後,在停用中繼資料 API 之前,系統會持續擷取中繼資料並編製成索引。

執行此命令時,請記住下列事項:

  • 此命令會停止及啟動某些 Tableau Server 使用的服務,因此造成使用者暫時無法使用部分功能,例如推薦功能。
  • 新的中繼資料索引隨即建立,並在每次使用此命令時取代先前的索引。

有關 Tableau Catalog 的詳情,請參閱關於 Tableau Catalog

概要

tsm maintenance metadata-services enable

選項

--ignore-prompt

可選。

啟用中繼資料 API 時,關閉確認提示。

tsm maintenance metadata-services disable

使用 tsm maintenance metadata-services disable 命令來停用 Tableau 中繼資料 API。

停用中繼資料 API 後,會停止 Tableau Server 上內容之相關資訊的持續擷取和索引編製、刪除發佈至 Tableau Server 之內容的相關資訊索引以及與該內容關聯的資產,並停用查詢中繼資料 API 和存取 Tableau Catalog 的功能。

執行此命令會停止及啟動某些 Tableau Server 使用的服務,因此造成使用者暫時無法使用部分功能,例如建議功能。

概要

tsm maintenance metadata-services disable

選項

--ignore-prompt

可選。

停用中繼資料 API 時,關閉確認提示。

tsm maintenance metadata-services get-status

使用 tsm maintenance metadata-services get-status 命令取得中繼資料服務的狀態資訊。

中繼資料服務的狀態會指出中繼資料 API 存放區是否已初始化,或 Tableau 中繼資料 API 是否已執行。

概要

tsm maintenance metadata-services get-status

tsm maintenance reindex-search

使用 tsm maintenance reindex-search 命令來重建搜尋索引。

概要

tsm maintenance reindex-search [options] [global options]

選項

--request-timeout <timeout in seconds>

可選。

等待指定的時間以完成命令。預設值為 1800(30 分鐘)。

tsm maintenance reset-searchserver

將搜尋伺服器重置為清除狀態,刪除搜尋資訊並重新搜尋索引。

概要

tsm maintenance reset-searchserver [options] [global options]

選項

--request-timeout <timeout in seconds>

可選。

等待指定的時間以完成命令。預設值為 1800(30 分鐘)。

tsm maintenance restore

使用指定的備份檔案還原 Tableau Server。還原備份檔案並不會還原任何設定資料。請參閱執行 Tableau Server 的完整備份和還原

您只能從識別身分存放區與執行伺服器類型相同的備份中進行還原。例如,使用本機驗證的伺服器中的備份只能還原到使用本機驗證初始化的 Tableau Server,但使用 Active Directory 驗證的伺服器中的備份無法還原到使用本機驗證初始化的伺服器。

概要

tsm maintenance restore --file <file_name> [--restart-server] [global options]

選項

-ak, --asset-key-file <file_name>

可選。唯有在您要從 Tableau Server (2018.1 及更早版本) 所建立的資產進行還原時,才指定這個選項。

要還原之資產金鑰檔案的名稱。資產金鑰檔案是由 tabadmin assetkeys 命令所建立。檔案必須位於伺服器中預先定義的備份/還原位置。

-f, --file <file_name>

必要。

指定要還原的備份檔案。

restore 命令需要 TSM basefilepath.backuprestore 變數定義的目錄中有備份檔案。預設情況下:

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

有關檔案路徑及其修改方式的詳情,請參閱tsm File Paths

-k, --skip-identity-store-verification

可選。唯有在您要從 Tableau Server (2018.1 及更早版本) 所建立的備份檔案還原時,才指定這個選項。

略過識別身份存放區驗證。如果您要還原使用 tabadmin backup --no-config 命令建立的備份檔案,請指定此選項。

-po, --pg-only

可選。

僅還原存放庫。

-r, --restart-server

可選。

還原後重新啟動伺服器。

--request-timeout <timeout in seconds>

可選。

等待指定的時間以完成命令。預設值為 1800(30 分鐘)。

tsm maintenance send-logs

將指定的檔案上載到 Tableau 並將其與支援案例相關聯。若要順利將檔上載至 Tableau,Tableau Server 必須能夠與傳送記錄伺服器進行通訊:https://report-issue.tableau.com

概要

tsm maintenance send-logs --case <case_number> --email <contact_email> --file <path/to/file> [global options]

選項

-c,--case <case_number>

必要。

支援案例編號。

-e,--email <contact_email>

必要。

連絡人電子郵件。

-f, --file <path/to/file>

必要。

指定要傳送的記錄檔案封存的位置和名稱。

--request-timeout <timeout in seconds>

可選。

等待指定的時間以完成命令。預設值為 1800(30 分鐘)。

tsm maintenance validate-resources

驗證網站的工作簿和資料來源。

概要

tsm maintenance validate-resources --site-id <site ID> [global options]

選項

-id,--site-id <site ID>

必要。

要驗證其資源的網站的 ID。

-r,--repair

可選。

修復無效資源。

--request-timeout <timeout in seconds>

可選。

等待指定的時間以完成命令。預設值為 1800(30 分鐘)。

 

tsm maintenance ziplogs

使用 ziplogs 命令建立 Tableau Server 記錄檔案的封存。

附註:如果無法成功執行 ziplogs 命令,則可以手動壓縮 Tableau Server 記錄。有關詳情,請參閱Linux 上的 Tableau Server 疑難排解

概要

tsm maintenance ziplogs [options] [global options]

選項

-a, --all

可選。

包括除 PostgreSQL 資料以外的所有檔案。

-d, --with-postgresql-data

可選。

如果 Tableau Server 已停止,則包括 PostgreSQL 資料檔案夾,如果 Tableau Server 正在執行,則包括 PostgreSQL 轉儲檔案。

--enddate <mm/dd/yyyy>

可選。

要包含的記錄檔的最晚日期。此選項必須與 --startdate 搭配使用,且無法與 --minimumdate 一起使用。如果未指定此選項,則最多包含兩天的記錄。

在 2019.3 版中新增

-f, --file <name>

可選。

指定壓縮封封存的名稱。如果沒有提供名稱,則將封存建立為 logs.zip。檔案將寫入 TSM basefilepath.log_archive 變數中定義的目錄。預設情況下:

/var/opt/tableau/tableau_server/data/tabsvc/files/log-archives/

有關檔案路徑及其修改方式的詳情,請參閱tsm File Paths

-i, --description <string>

可選。

包括封存檔案的指定說明。

-l, --with-latest-dump

可選。

有任何服務當機時,Tableau Server 就會產生傾印檔案。設定此選項可包括最新的服務當機傾印檔案。如未設定此選項,所產生的 ziplog 就不會包括任何傾印檔案。

-m, --minimumdate <mm/dd/yyyy>

可選。

要包括的記錄檔案的最早日期。如果未指定,則最多包含兩天的記錄檔案。日期格式應為「mm/dd/yyyy」。此選項無法與 --startdate--enddate 一起使用。

-o, --overwrite

可選。

用於覆寫現有的 ziplog 檔案。如果已經存在同名的檔案,並且未使用此選項,則 ziplogs 命令將失敗。

預設情況下會將檔案寫入到:

/var/opt/tableau/tableau_server/data/tabsvc/files/log-archives/

有關檔案路徑及其修改方式的詳情,請參閱tsm File Paths

--startdate <mm/dd/yyyy>

可選。

要包含的記錄檔的最早日期。此選項必須與 --enddate 搭配使用,且無法與 --minimumdate 一起使用。如果未指定此選項,則最多包含兩天的記錄。

在 2019.3 版中新增

--request-timeout <timeout in seconds>

可選。

等待指定的時間以完成命令。預設值為 7200(120 分鐘)。

-t, --with-netstat-info

可選。

包括 netstat 資訊。

 

全網域選項

-h, --help

可選。

顯示命令說明。

-p, --password <password>

在會話不是活動狀態的情況下為必需,-u--username 也為必需。

為在 -u--username 中指定的使用者指定密碼。

如果密碼包括窗格或特殊字元,請將其括在引號中:

--password 'my password'

-s, --server <url_to_tsm>

可選。

對 Tableau 服務管理器使用指定的位址。URL 必須以 https 開頭且包含連接埠 8850,並應使用伺服器名稱,而非 IP 位址,例如:https://mytableauhost:8850。如果沒有指定伺服器,則假定為 https://<localhost | dnsname>:8850

--trust-admin-controller-cert

可選。

使用此旗標來信任 TSM 控制器上的自我簽署憑證。如需有關憑證信任和 CLI 連線的詳細資訊,請參閱連接 TSM 用戶端

-u, --username <user>

在會話不是活動狀態的情況下為必需,-p--password 也為必需。

請指定使用者名稱。如果未包括此選項,則使用您登入所使用的認證執行該命令。

 

感謝您的回饋! 提交意見回饋時發生錯誤。重試或傳送訊息給我們