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