ライセンス発行タスクの自動化

コマンドライン オプションを使用すると、Tableau Server の一般的なライセンス発行タスクを自動スクリプトで実行できます。

これらの Tableau Desktop のライセンス発行タスクを自動スクリプトで実行する場合は、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 のライセンス認証を参照してください。

フォワード プロキシ サーバーを使用したプロダクト キーの操作

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)
終了コードメッセージ
536871012TABLEAU_ERROR_LICENSING_GENERALライセンス発行操作中に不明なエラーが発生しました。
536871013TABLEAU_ERROR_LICENSING_INTERNAL製品は、内部ライセンス発行エラーにより起動できません。
536871014TABLEAU_ERROR_LICENSING_SETUP製品は、内部ライセンス発行エラーにより起動できません。
536871015TABLEAU_ERROR_LICENSING_CONNECTTableau ライセンス サーバーへの通信中にエラーが発生しました。
536871017TABLEAU_ERROR_LICENSING_ACTIVATION_ASRASR のライセンス認証中にエラーが発生しました。
536871016TABLEAU_ERROR_LICENSING_ACTIVATION_GENERALライセンス認証に失敗しました。再試行してください。
536871018TABLEAU_ERROR_LICENSING_ACTIVATION_INVALID_KEYプロダクト キーが無効です。
536871019TABLEAU_ERROR_LICENSING_ACTIVATION_OFFLINEオフラインでのライセンス認証を完了できません。
536871020TABLEAU_ERROR_LICENSING_ACTIVATION_INVALID_MODELライセンス サーバーからエラーが返されました。詳細については、Tableau ログ ファイルを確認してください。
536871021TABLEAU_ERROR_LICENSING_ACTIVATION_MAX_REHOSTSこのライセンス認証の解除制限に到達したため、ライセンス認証を解除できませんでした。
536871033TABLEAU_ERROR_LICENSING_ACTIVATION_MAX_EXTRA_ACTIVATIONSこのライセンスの認証制限に到達したため、ライセンス認証できませんでした。
536871022TABLEAU_ERROR_LICENSING_UNLICENSED_GENERALライセンス取り消し操作中に不明なエラーが発生しました。プロダクト キーを確認するか、サポートに連絡してください。
536871023TABLEAU_ERROR_LICENSING_UNLICENSED_NONE_FOUNDライセンスが見つかりません。
536871024TABLEAU_ERROR_LICENSING_UNLICENSED_EXPIRED期限切れのプロダクト キーのみが見つかりました。
536871025TABLEAU_ERROR_LICENSING_UNLICENSED_EXPIRED_TRIALこのバージョンの試用期間は終了しています。
536871026TABLEAU_ERROR_LICENSING_UNLICENSED_EXPIRED_SUBSCRIPTIONプロダクト キーが期限切れです。
536871027TABLEAU_ERROR_LICENSING_UNLICENSED_EXPIRED_MAINTENANCEメンテナンス期限が切れています。
536871028TABLEAU_ERROR_LICENSING_RESYNC_GENERALプロダクト キーを同期化できませんでした。
536871029TABLEAU_ERROR_LICENSING_REGISTRATION_GENERAL製品登録中にエラーが発生しました。
536871030TABLEAU_ERROR_LICENSING_SERVICE_INSTALLライセンス発行操作中に不明なエラーが発生しました。
536871031TABLEAU_ERROR_LICENSING_SERVICE_UNINSTALLライセンス発行操作中に不明なエラーが発生しました。
536871032TABLEAU_ERROR_LICENSING_SERVICE_NOT_PRESENTFLEXnet ライセンス サービスがシステムに存在しません。
フィードバックをお送りいただき、ありがとうございます。フィードバックは正常に送信されました。ありがとうございます!