初期ノードの障害からの回復

Tableau を最初にインストールした PC ("最初のノード") には独特の特性があります。ライセンス サービス (ライセンス マネージャー) と Tableau サービス マネージャー コントローラ (管理コントローラ) の 2 つのプロセスは最初のノードでのみ実行され、障害発生時を除いて別のノードに移動できません。

別の 2 つのプロセス (CFS (クライアント ファイル サービス) と調整サービス) は、初期状態では最初のノードに含まれていますが、別のノードに追加または移動することができます。

最初のノードに問題が発生し、他のノードに冗長プロセスがある場合、Tableau Server は、ライセンス発行サービスがないことにより他のプロセスに影響が出るまで、最長 72 時間継続して実行できます。最初のノードでエラーが発生しても、ユーザーは引き続きサインインしてコンテンツを表示および使用することはできますが、管理コントローラへのアクセス権はないため、Tableau Server の再構成はできません。つまり、できるだけ早く、2 つの固有のプロセスを別の実行中のノードに移動させる必要があります。相対的に時間が足りず復元できないという理由で最初のノードに失敗が起きる場合 (修正できるハードウェアのエラーなど)、まずは以下の手順を実行せずにノードのバックアップを試行する必要があります。

注: この記事の手順ではサーバーのダウンタイムが必要となり、業務に支障が出る可能性があります。したがって、最初のノードに非常に重大な障害が発生した場合にのみ実行する必要があります。最初のノードを再稼働できない場合は、次の手順を使用して主要な TSM プロセスをクラスタ内の別のノードに移動してください。

Tableau Server には、これらのプロセスを他のいずれかの既存ノードに移動するのを自動化するスクリプトがあり、TSM への完全なアクセス権を取得し、Tableau Server の実行を維持できるようにしています。CFS と調整サービスでインストールがどのように構成されたかに応じ、これらを再展開するために対応を取る必要がある場合もあります。

一般的な要件

  • 最初のノードがクライアント ファイル サービス (CFS) のインスタンスのみを実行していた場合、そのプロセスを別のプロセスに追加する必要があります。Tableau Server には最低 1 インスタンスの CFS が必要です。詳細については、クライアント ファイル サービスの構成を参照してください。
  • マルチノード Tableau Server インストールをセットアップするプロセスの一環として、調整サービス アンサンブルを展開してあるはずです。下記のプロセスは、最初のノードで問題が発生する前に調整サービス アンサンブルが展開されていることを前提にしています。新しい調整サービス アンサンブルを展開する方法について詳細は、調整サービス アンサンブルの展開を参照してください。

注: この操作には、TSM コマンド ラインを使用した実行が必要な場合がある手順が含まれています。TSM CLI を使用するには、インストール済みノードのいずれかでコマンド ラインにアクセスするための管理者アクセス権限と、TSM コマンドを実行するための TSM 管理者認証資格情報が必要です。

TSM コントローラおよびライセンス サービスを別のノードに移動する

最初のノードで問題が発生した場合、TSM コントローラおよびライセンス サービスを別のノードで起動する必要があります。次のステップに従い、コントローラおよびライセンス サービスを別のノードで動作させます。

  1. まだ動作しているノード上で、コントローラ復旧スクリプトを実行します。これを行うには、コマンド プロンプトを開き、Tableau Server のスクリプト ディレクトリ (既定のディレクトリは次のとおりです。C:\Program Files\Tableau\Tableau Server\packages\scripts.<version_code>\) に移動し、次のコマンドを入力します。

    move-tsm-controller -n <nodeID>

    "nodeID" には TSM コントローラを実行したいノードの ID が入ります。例:

    move-tsm-controller -n node2

  2. コマンド ウィンドウを閉じてからもう一度開き、以下のコマンドを入力して管理コントローラがノード上で実行されていることを確認します。

    tsm status -v

  3. Tableau Server を停止します。

    tsm stop

  4. ノードにライセンス サービスを追加します。

    tsm topology set-process -pr licenseservice -n <nodeID> -c 1

  5. 元のノードから旧ライセンス サービスを削除します。"nodeID" は障害の発生した元の最初のノードです。

    tsm topology set-process -pr licenseservice -n <nodeID> -c 0

  6. 最初のノードで CFS のインスタンスのみを実行していた場合は、このノードに CFS を追加します。

    tsm topology set-process -pr clientfileservice -n node2 -c 1

  7. (オプション) 最初のノードで実行されていて、このノードでは実行されていなかったその他のプロセスも追加できます。例として、キャッシュ サーバーを追加するには次を入力します。

    tsm topology set-process -pr cacheserver -n node2 -c 1

  8. 変更を適用します。

    tsm pending-changes apply

    pending-changes apply コマンドは、Tableau Server が実行中の場合にはそれが再起動することを知らせるプロンプトを表示します。このプロンプトはサーバーが停止しても表示されますが、その場合には再起動は行われません。--ignore-prompt オプションを使用してメッセージが表示されないようにできますが、そのようにしても再起動に関する動作が変わることはありません。詳細については、tsm pending-changes applyを参照してください。

  9. TSM 管理コントローラを再起動します

    net stop tabadmincontroller_0

    net start tabadmincontroller_0

    注: これらのコマンドは管理者としてコマンド プロンプトから実行する必要があります。PC の構成方法に応じ、C:\Windows\System32 フォルダーでコマンドを実行する必要がある場合があります。

    注: tabadmincontroller の再起動には数分かかる場合があります。コントローラを完全に再起動させる前に次の手順で保留中の変更を適用しようとする場合、TSM はコントローラに接続できなくなります。tsm status -v コマンドを使用して、コントローラが実行されていることを確認できます。Tableau Server Administration Controller が「実行中」としてリストされているべきです。

  10. 保留中の変更を適用します (変更は何もないように見えますが、このステップは必要です)。

    tsm pending-changes apply

  11. Tableau Server ライセンスを新しいコントローラ ノード上で認証します。

    tsm licenses activate -k <product-key>

  12. ライセンスが適切に認証されていることを確認します。

    tsm licenses list

  13. 最初のノードで調整サービスを実行していた場合は、そのノードに含まれていない新しい調整サービス アンサンブルを展開する必要があります。ノード クラスタが 3 つあり、最初のノードで調整サービスを実行していた場合、新しい単一インスタンスの調整サービス アンサンブルを別のノードに展開し、古いアンサンブルをクリーンアップする必要があります。次の例では、単一インスタンスの調整サービスが 2 番目のノードに展開されています。

    tsm topology deploy-coordination-service -n <nodeID2>

    サーバーが新しいアンサンブルに完全に切り替わるまで待機します。

  14. サーバーが新しいアンサンブルに切り替わったら、古いアンサンブルをクリーンアップします。

    あまり早くこれを行わないでください。クリーンアップ コマンドを実行する前に、サーバーが新しいアンサンブルに完全に切り替わるまで待機する必要があります。そうでないと、Tableau に永続的な損傷が及ぶ可能性があります。サーバーの準備が完了したことを確認する詳しい手順を含む、調整サービス アンサンブルを展開する方法の詳細については、調整サービス アンサンブルの展開を参照してください。

    tsm topology cleanup-coordination-service

  15. 最初のノードでファイル ストア インスタンスを実行していた場合は、このインスタンスを削除する必要があります。

    tsm topology filestore decommission -n <nodeID> --delete-filestore

    ここで nodeID は障害が発生した最初のノードです。

  16. 上記で展開した新しい調整サービス アンサンブルが単一ノードのアンサンブルの場合は、--ignore-warnings フラグを使用して保留中の変更を適用します。

    tsm pending-changes apply --ignore-warnings

  17. 最初のノードを削除します。 nodeID は障害が発生した最初のノードです。

    tsm topology remove-nodes -n <nodeID>

  18. 上記で展開した新しい調整サービス アンサンブルが単一ノードのアンサンブルの場合は、--ignore-warnings フラグを使用して保留中の変更を適用します。

    tsm pending-changes apply --ignore-warnings

  19. Tableau Server を起動します。

    tsm start

    この時点でサーバーが起動し、TSM を使用して構成を行うことができます。次のステップでは最初のノードを置換し、クラスタに元のノード数が含まれるようにします。この実行方法は、エラーが発生したノードを再利用するかどうかによって変わります。エラーが発生した理由を特定できない場合にはそのノードのみを再利用し、エラーが再発しないように対策を取ることをお勧めします。

  20. 元のノードの再利用を計画している場合は、まずはそこから Tableau を完全に削除する必要があります。これを行うには tableau-server-obliterate スクリプトを実行します。この実行の詳細については、コンピュータから Tableau Server を削除するを参照してください。

  21. 新しいコンピューターまたは Tableau を完全に削除した後の元のコンピューターで、元のセットアップ プログラムと、ライセンス発行サービスおよび管理コントローラを実行中のノードから生成された bootstrap ファイルを使用して Tableau をインストールします。この実行方法の詳細については、追加のノードのインストールと構成を参照してください。

    ベスト プラクティスは、元のノードでエラーが発生したときに失ったプロセスを構成し、クラスタでの十分な冗長性を確保することです。新しい最初のノードから、新しく追加した追加ノードにプロセスを移動し、元の構成を複製することが必要な場合があります。たとえば、最初のノードがゲートウェイとファイル ストアのみを実行していた場合、同様の方法で新しい最初のノードの構成が必要となる場合があります。

  22. 必要な方法でノードを起動して実行したら、新しい調整サービス アンサンブルの再展開も必要です。詳細は、調整サービス アンサンブルの展開を参照してください。

 

フィードバックをくださりありがとうございます! フィードバックの送信中にエラが発生しました。もう一度やり直すか、メッセージをお送りください