Windows 版 Tableau Server 說明

一些命令列選項允許您使用自動指令碼執行常見的 Tableau Server 授權任務。

如果要使用自動指令碼執行這些 Tableau Desktop 授權任務，請參閱《桌面部署指南》中的部署 Tableau Desktop(連結在新視窗開啟)。

命令列工具選項和更好的指令碼自動化

您可以使用名為 tabinstallck.exe 的實用程式對伺服器產品金鑰的啟動、重新整理和停用編寫指令碼。tabinstallck.exe 安裝在初始節點上的 Tableau Server \bin 目錄中。預設情況下，此目錄為：

C:\Program Files\Tableau\Tableau Server\packages\bin.<version_code>

您也可以使用 tsm licenses 執行授權工作，例如連線或離線啟用或停用 Tableau Server 產品金鑰，以及獲取關聯的檔案以進行離線啟用或停用。但是，必須已部署和設定 Tableau Server。您可以使用 Tableau 服務管理員 API 自動執行這些授權工作。此外，tabinstallck.exe 提供了一種方法來為未完全設定的全新 Tableau Server 安裝的授權步驟編寫指令碼。

若要使用 tabinstallck.exe，需要在主要 Tableau Server 節點上以管理員身分執行命令或指令碼。

附註：tabinstallck.exe 不支援離線啟動和停用。若要瞭解詳情，請參閱離線啟用 Tableau Server。

啟用

使用 -activate 選項啟用 Tableau Server 授權：

start/wait tabinstallck.exe -activate <product_key>

重新整理

使用 -refresh 選項重新整理 Tableau Server 授權：

start/wait tabinstallck.exe -refresh <product_key>

停用

使用 -return 選項停用 Tableau Server 授權：

start/wait tabinstallck.exe -return <product_key>

範例

用於啟用 Tableau Server 的指令碼的範例可能如下所示：

@echo off
start/wait tabinstallck.exe -activate <product_key>
if %errorlevel% EQU 0 (ECHO SUCCESS) ELSE (ECHO FAILED)

錯誤處理

使用 tabinstallck.exe 自動執行 Tableau Server 授權任務時，狀態資訊將作為 ERRORLEVEL 環境變數中的結束代碼返回。如果啟動成功，結束代碼為 0（零）。下表列出了啟動過程中的結束代碼及其含義。您也可以在 tabinstallck.log 檔案中找到錯誤訊息。預設情況下，此記錄檔案位於 Tableau Server \logs 資料夾中：

C:\ProgramData\Tableau\Tableau Server\data\tabsvc\logs\

ProgramData 資料夾預設情況下處於隱藏狀態。

此範例指令碼顯示了如何啟用 Tableau Server 並檢查特定錯誤，例如無效的產品金鑰 (536871018) 和一般授權問題 (536871012)。

@echo off
start/wait tabinstallck.exe -activate  <product_key>
if %errorlevel% EQU 536871018 (ECHO TABLEAU_ERROR_LICENSING_INVALID_KEY)
if %errorlevel% EQU 536871012 (ECHO TABLEAU_ERROR_LICENCING_GENERAL)
if %errorlevel% EQU 0 (ECHO SUCCESS)