高可用性の構成操作

[High Availability(高可用性)]メニューには、Access Gatewayノードの現在のロールが表示されます。

  • [単一]: ノードはまだワーカー/管理者として構成されていません。
  • [管理者]:ノードは高可用性の管理者として構成されています。
  • [ワーカー]:ノードは高可用性のワーカーとして構成されています。

[高可用性]メニューには次のオプションがあります。
  1. [Reset(リセット)]:ノードキーをリセットします。
  2. [Prepare Admin(管理者を準備)]:新しいワーカーノードに接続するための管理者ノードを準備します。
  3. [Prepare Worker(ワーカーを準備)]:ワーカーノードになるノードを準備します。
  4. [List Nodes(ノードを一覧表示)]:すべてのワーカーノードを一覧表示します。このオプションは、管理者ノードでのみ表示されます。
  5. [Remove Node(ノードを削除)]:既知のワーカーノードを削除します。このオプションは、管理者ノードでのみ表示されます。
  6. [Check Status(ステータスの確認)]:高可用性ステータスを確認します。
  7. [Cluster Manager(クラスターマネージャー)]:クラスターマネージャーを使ってワーカーノードを管理者ノードにローリングアップグレードします。

高可用性の次の管理操作を行うことができます。

  1. Access Gatewayノードに関連付けられるキーをリセットする
  2. ワーカーノードをAccess Gatewayクラスターに追加する
  3. Access Gatewayクラスター内のすべてのワーカーノードを一覧表示する
  4. Access Gatewayクラスターからワーカーノードを削除する
  5. クラスター構成を確認する
  6. ワーカーノードを管理者ノードにローリングアップグレードする
  7. ワーカーノードを管理者ノードに同期させる

高可用性クラスターの初期構成では、クラスターメンバーはHTTPSを使ってポート443で通信します。プロキシの使用時は、高可用性の構成を慎重に行ってください。プロキシおよびプロキシバイパスリストの構成の詳細については、「Command Line Management Consoleリファレンス」の「ネットワーク」セクションにある「プロキシの構成」を参照してください。

Access Gatewayノードに関連付けられるキーをリセットする

Access Gatewayノードは、さまざまなキーを使って相互に通信します。Access Gateway高可用性クラスターの一部としてインスタンスを使用する場合は、キーを再生成する必要があります。キーのリセットが必要になるのは、インスタンスごとに一度のみです。

  1. Access Gateway管理者コンソールに接続します。
  2. [5- System(システム)]を選択します。
  3. [8 - High Availability(高可用性)]を選択します。
  4. [1 - Reset Key(キーをリセット)]を選択します。
  5. 高可用性同期プロセスで使用するキーをリセットする場合は[y]、リセットプロセスを終了する場合は[N]を入力します。
  6. [x]を入力して終了するか、他のメニュー項目を入力して続行します。

ワーカーノードをAccess Gatewayクラスターに追加する

ワーカーノードを追加するには、管理者ノードとワーカーノードの両方が次の条件を満たしている必要があります。

ワーカーを準備するときは、管理者ノードではなくワーカーノードに接続していることを確認してください。クラスター管理者側でワーカー操作の準備を行うと、Access Gateway Admin UIコンソールが動作しなくなります。Access Gatewayバージョン2021.11.2以降では、この操作は禁止されています。ワーカーとして使用していたノードは、管理者ノードとして再利用する前にリセットする必要があります。「Access Gatewayのリセット:コマンドライン」を参照してください。

  1. 管理者ノードで次のタスクを実行します。

    1. Access Gateway管理者コンソールに接続します:ssh oag-mgmt@[admin.tld]
    2. [5- System(システム)]を選択します。
    3. [8 - High Availability(高可用性)]を選択します。
    4. [2 - Prepare Admin(管理者を準備)]を選択します。

      高可用性の管理者ノードを初めて構成するときは、[1 - Reset Keys(キーをリセット)]オプションを選択してインスタンスのSSHキーをリセットします。キーのリセットが必要になるのは、インスタンスごとに一度のみです。「Command Line Management Consoleリファレンス」を参照してください。

      Access Gatewayのレプリケーションでは、コマンドラインコンソールからホスト名の設定を使用します。メニュー項目の[System(システム)(5)][Change Hostname(ホスト名の変更)(1)]を使用して、管理者ノードとワーカーノードの両方のホスト名を更新してください。

    5. 管理者ノードは、ワーカーノードに提供される承認トークンを生成および表示します。承認トークンをセキュアノートアプリなどの安全な場所にコピーします。
    6. 管理者ノードはワーカーノードからの接続を待機します。ワーカーノードが追加されるまでウィンドウは開いたままにします。[X]の入力が早すぎると、管理者ノードはプロセスを終了し、追加ワーカーノードの一覧表示が停止してしまいます。ウィンドウにすべてのワーカーノードが表示された場合にのみ[X]を入力します。
    1. 接続しているワーカーノードのコマンドプロンプトに戻ります。
  2. 各ワーカーノードで次のタスクを実行します。
    1. Access Gateway管理者コンソールに接続します:ssh oag-mgmt@[worker.tld]
    2. [5- System(システム)]を選択します。
    3. [8 - High Availability(高可用性)]を選択します。
    4. [3 - Prepare Worker(ワーカーを準備)]を選択します。

      高可用性のワーカーノードを初めて構成するときは、[1 - Reset Keys(キーをリセット)]オプションを選択してインスタンスのSSHキーをリセットします。キーのリセットが必要になるのは、インスタンスごとに一度のみです。「Command Line Management Consoleリファレンス」を参照してください。

    5. [Access Gateway管理者コンソール]ウィンドウにトークンを貼り付けます。ワーカーノードが管理者ノードに接続し、承認が終了します。
    6. いずれかのキーを押して続行します。ワーカーインスタンスの使用準備が整います。
    7. [x]を入力して終了するか、他のメニュー項目を入力して続行します。
  1. 管理者ノードで次のタスクを実行します。
    1. 管理者インスタンスのAccess Gateway管理者コンソールに戻り、新規ワーカーノードの追加結果を表示します。
    2. [x]を入力して終了するか、他のメニュー項目を入力して続行します。

Access Gatewayクラスター内のすべてのワーカーノードを一覧表示する

  1. Access Gateway管理者コンソールに接続します:ssh oag-mgmt@[admin.tld]
  2. [8 - High Availability(高可用性)]を選択します。
  3. [4 - List Nodes(ノードを一覧表示)]を選択します。現在有効化されているすべてのワーカーノードが一覧表示されます。
  4. [x]を入力して終了するか、他のメニュー項目を入力して続行します。

Access Gatewayクラスターからワーカーノードを削除する

Access Gatewayクラスターからワーカーノードを削除してもノード自体は存続しますが、管理者インスタンスから更新を受信しなくなります。また、Access Gateway UIが無効化されます。必ずロードバランサーからもノードを削除してください。

  1. Access Gateway管理者コンソールに接続します。ssh oag-mgmt@[admin.tld]
  2. [5- System(システム)]を選択します。
  3. [8 - High Availability(高可用性)]を選択します。
  4. [5 - Remove(削除)]を選択します。
  5. 削除するワーカーノードの名前を入力し、Enterキーを押します。
  6. ノードの削除を確認します。
  7. [x]を入力して終了するか、他のメニュー項目を入力して続行します。

クラスター構成を確認する

  1. Access Gateway管理者コンソールに接続します:ssh oag-mgmt@[admin or worker]
  2. [5- System(システム)]を選択します。
  3. [8 - High Availability(高可用性)]を選択します。
  4. [6 - Check Status(ステータスを確認)]を選択します。このオプションは、構成に変更があった場合、またはNGINXエンジンが再起動された場合にのみクラスターの最新ステータスを表示します。新たに追加したノードが表示されないときは、Access Gateway管理者UIコンソールの任意の機能を実行するか、NGINXエンジンを再起動します。Access Gateway Managementコンソールの[サービス]セクションにある[NGINX]サブメニューを参照してください。クラスターインスタンスが一覧表示されます。[成功]は、ノードがアクセス可能であり、機能していることを示します。[失敗]は、ノードが機能していないことを示します。詳細については、ノードログを参照してください。
  5. [x]を入力して終了します。

ワーカーノードを管理者ノードにローリングアップグレードする

クラスターマネージャーを使ってワーカーノードを管理者ノードにローリングアップグレードできます。高可用性構成の詳細については、「高可用性を構成し、管理する」を参照してください。

  1. Access Gateway管理者コンソールに接続します:ssh oag-mgmt@[admin or worker]
  2. ワーカーノード上にいることを確認します。
  3. [5- System(システム)]を選択します。
  4. [8 - High Availability(高可用性)]を選択します。
  5. [7 - Cluster Manager(クラスターマネージャー)]を選択します。
  6. [2 - Authorize Node as Admin node(ノードを管理者ノードとして承認)]を選択します。このオプションは、管理者ノードからは選択できません。また、別の承認プロセスの進行中も選択できません。
  7. 続行する場合は[Y]、確認ダイアログを終了する場合は[N]を入力します。
  8. ワーカーノードが承認コードを生成します。セキュアノートアプリなどの安全な場所にこのコードをコピーします。
    Copy

    The authorization token required to initiate setup for nominated admin node: worker-c:8ba1c123-715d-4b70-ab5d-0e41493bef73
    Copy the token and paste it on the admin node when prompted.
    Press enter to continue
  9. Enterを押して続行します。
  10. 管理者ノードに切り替えます。
  11. [1 - Authorize Node Nomination(ノードの指定を承認)]を選択します。このオプションは、ワーカーノードからは選択できません。また、別の承認プロセスの進行中も選択できません。
  12. セキュアノートアプリにコピーした承認コードをターミナルに貼り付け、Enterキーを押します。再指定プロセスが開始されます。「管理者の再指定を実行する」を参照してください。
  13. ノートアプリから承認コードを削除します。

ワーカーノードを管理者ノードに同期させる

ダウンタイムまたはネットワークの問題が原因でワーカーノードが同期されないときは、管理者ノードから特定のワーカーに変更を同期させることができます。

このオプションは、ワーカーインスタンスでのみ使用できます。

  1. 同期させるワーカーのAccess Gateway管理者コンソールに接続します:ssh oag-mgmt@[<worker>]
  2. [5- System(システム)]を選択します。
  3. [8 - High Availability(高可用性)]を選択します。
  4. [8 - Synch from admin(管理者から同期)]を選択します。
  5. Enterを押して続行します。
  6. [x]を入力して終了します。