Apigee Edge for Private Cloud のノードごとのオペレーティング システムのアップグレード

Apigee Edge のドキュメントを表示しています。
Apigee X のドキュメントに移動します。 情報

このドキュメントでは、Apigee Edge for Private Cloud クラスタ内のサーバーのオペレーティング システム（OS）をアップグレードする別の方法について説明します。このノード単位のアプローチでは、完全に新しい並列データセンターをセットアップするのではなく、一度に 1 台のマシン/ノードで OS をインプレース アップグレードできます。

互換性

ノードごとの OS アップグレードを開始する前に、現在のバージョンの Apigee Edge for Private Cloud がターゲット OS バージョンをサポートしていることを確認します。確認するには、OS 互換性マトリックスを参照してください。

前提条件

ノードごとのアップグレードを開始する前に、次のタスクが完了していることを確認します。

すべてのノードをバックアップする

安全上の理由から、この手順を行う前に、VM レベルのバックアップやコンポーネント レベルのバックアップなど、すべてのノードの完全なバックアップを行うことをおすすめします。これにより、次の手順のいずれかが適切に機能しない場合に備えてバックアップ計画を立てることができます。コンポーネント レベルのバックアップの詳細については、バックアップと復元をご覧ください。

Edge が実行中であることを確認する

次のコマンドを使用して、Edge が更新中に起動していることを確認します。

/opt/apigee/apigee-service/bin/apigee-all status

ノードの交換順序

コンポーネント タイプに基づいて、次の順序でノードをアップグレードすることをおすすめします。

• Cassandra
• Zookeeper
• Postgres
• LDAP
• Qpid
• Message-Processor
• ルーター
• Management-server
• UI/UE
• SSO

その他のシナリオ

ノード単位の OS アップグレードを実行する場合、既存の設定に次のいずれかの構成が存在する場合は、次の追加の手順を検討してください。

• apigee-mtls - apigee-mtls が有効になっている場合、この設定ではノードごとの OS アップグレード（ローリング）は対象外です。アップグレードするには、apigee-mtls のアップグレード ガイドをご覧ください。

Cassandra

Cassandra を置き換える場合は、まずシードノード以外のノードを置き換え、次にシードノードを置き換えることを検討してください。

Cassandra で考慮すべき特殊なケースは次のとおりです。

• Cassandra Native-mTLS - native-mTLS が有効で適用されている場合は、conf_cassandra_client_encryption_optional=true を設定して、mTLS 対応ノードでの適用を削除します。詳細については、ネイティブ mTLS のドキュメントをご覧ください。
• Cassandra ノード間暗号化が有効になっている - Cassandra ノード間暗号化を有効にするを参照して、既存の Cassandra ノードの証明書が新しく置き換えられたノードのトラストストアに含まれていることを確認します。

Cassandra ノードを置き換える手順は次のとおりです。

1. 仮想マシンのスナップショットを作成してノードをバックアップし（可能な場合）、次のコマンドを使用して、すべてのノードで Cassandra の Apigee バックアップを作成します。

   apigee-service apigee-cassandra backup

2. アップグレードされた OS を使用して新しいノードを取得します。
3. OS 固有の前提条件を適用します。
4. Edge ファイルをダウンロードして実行し、apigee-service ユーティリティをインストールします。使用中の Apigee バージョンのブートストラップ。ブートストラップを実行して apigee-service を取得し、apigee-setup をインストールします。
5. シードノードを一覧表示します。

   apigee-service apigee-cassandra configure -search conf_cassandra_seeds

6. 既存の Cassandra ノードの IP を変更し、新しいノードの IP アドレスに置き換えて、構成ファイルを更新します。

   既存の CASS_HOSTS

   CASS_HOSTS="$IP1 $IP2 $IP3"

   CASS_HOSTS を新たに更新

   CASS_HOSTS="$IP1 $IP4 $IP3"

7. 更新された新しい Cassandra ノードの IP を使用して、クラスタ上の既存のノードを再構成します（置き換えるノードを除く）。構成ファイルのリファレンスをご覧ください。

   /opt/apigee/apigee-setup/bin/setup.sh -p c -f updatedConfigFile

8. 古いノードで Cassandra を停止して登録解除します。
   1. 置き換えるノードで Cassandra を停止します。

      apigee-service apigee-cassandra stop

   2. デコミッションする Cassandra ノードの UUID を一覧表示します（複数のデータセンターがある場合は、それに応じて検討してください）。

      apigee-adminapi.sh servers list -r dc-1 -p central -t application-datastore --admin AdminEmailID --pwd 'AdminPassword' --host localhost

   3. 既存の Cassandra UUID に関連付けられているデータストア タイプを登録解除します。

      curl -u AdminEmailID:'AdminPassword' -X POST http://MS_IP:8080/v1/servers -d "type=cache-datastore&type=user-settings-datastore&type=scheduler-datastore&type=audit-datastore&type=apimodel-datastore&type=application-datastore&type=edgenotification-datastore&type=identityzone-datastore&type=auth-datastore&region=dc-1&pod=central&uuid=old_cassandra_uuid&action=remove"

   4. サーバーを削除します。

      curl -u AdminEmailID:AdminPassword -X DELETE http://MS_IP:8080/v1/servers/old_cassandra_uuid

9. apigee-cassandra ホスト用に新しいノードを準備します。新しい Cassandra ノードの /opt/apigee/customer/application/cassandra.properties にある cassandra.properties ファイルに次の行を追加します（まだ存在しない場合は作成します）。

   conf_jvm_options_custom_settings=-Dcassandra.replace_address=IPOfOldCassandraNode -Dcassandra.allow_unsafe_replace=true

10. cassandra.properties ファイルで、所有者とグループが apigee:apigee に設定されていることを確認します。必要に応じて、次のコマンドを使用して所有者とグループを更新します。

    chown apigee:apigee /opt/apigee/customer/application/cassandra.properties

11. Cassandra をインストールし、新たに追加したノードでセットアップを実行します。

    apigee-service apigee-cassandra install

    apigee-service apigee-cassandra setup -f updatedConfigFile

12. 新しいノードを設定したら、/opt/apigee/customer/application/cassandra.properties に追加された追加の構成を削除し、apigee-cassandra を再起動します。

    conf_jvm_options_custom_settings=-Dcassandra.replace_address=IPOfOldCassandraNode -Dcassandra.allow_unsafe_replace=true

    apigee-service apigee-cassandra restart

13. 新しく置き換えられたノードのステータスを確認します。

    apigee-service apigee-cassandra status

    /opt/apigee/apigee-cassandra/bin/nodetool status

14. クラスタに追加された新しいノードを再構築します。

    /opt/apigee/apigee-cassandra/bin/nodetool rebuild -dc dc-1

15. 構成ファイルで新しい Cassandra ノードの IP を更新して、Router、Message-Processor、Qpid、Postgres、Management サーバーの既存のノードをそれぞれ再設定します。

    /opt/apigee/apigee-setup/bin/setup.sh -p r|mp|qs|ps|ms|mo -f updatedConfigFile

16. 古いノードから Cassandra を削除またはアンインストールします。

    apigee-service apigee-cassandra uninstall

17. クラスタ内の他の Cassandra ノードについても繰り返します。

Zookeeper

Zookeeper ノードを置き換えるには、次の手順を参照してください。アンサンブルがクォーラムを維持できるように、フォロワー ノードを最初に、リーダー ノードを 2 番目に置き換えることを検討してください。

1. 仮想マシンのスナップショットを作成してノードをバックアップし（可能な場合）、すべてのノードで Zookeeper の Apigee バックアップを作成します。
2. 既存のノードで Zookeeper を停止してアンインストールします。

   apigee-service apigee-zookeeper stop

   apigee-service apigee-zookeeper uninstall

3. アップグレードされた OS を使用して新しいノードを取得します。
4. OS 固有の前提条件を適用します。
5. 使用中の Apigee バージョンのブートストラップをダウンロードし、ブートストラップを実行して apigee-service を取得し、apigee-setup をインストールします。
6. 構成ファイルを更新して、古いノードまたは削除されたノードの IP アドレスを削除し、ZooKeeper の新しいノード IP に置き換えます。詳細については、構成ファイルのリファレンスをご覧ください。

   既存の ZK 構成

   ZK_HOSTS="$IP1 $IP2 $IP3"
   ZK_CLIENT_HOSTS="$IP1 $IP2 $IP3"
       

   ZK 構成を更新しました

   ZK_HOSTS="$IP1 $IP4 $IP3"
   ZK_CLIENT_HOSTS="$IP1 $IP4 $IP3"
       

7. 更新した構成ファイルを使用して、新しいノードに Zookeeper をインストール、設定、起動します。

   /opt/apigee/apigee-setup/bin/setup.sh -p zk -f updatedConfigFile

8. updatedConfigFile を使用して、既存の Zookeeper ノードに変更を加えます。

   /opt/apigee/apigee-setup/bin/setup.sh -p zk -f updatedConfigFile

9. 構成ファイルで新しい ZooKeeper ノードの IP を更新して、Router、Message-Processor、Qpid、Postgres、Management Server の既存のノードをそれぞれ再設定します。

   /opt/apigee/apigee-setup/bin/setup.sh -p r|mp|qs|ps|ms|mo -f updatedConfigFile

10. すべての ZooKeeper ノードで繰り返します。

Postgres

このセクションでは、Postgres ノードをアップグレードする際のダウンタイムをゼロにする方法について説明します。この方法では、概要で説明した手順を完了します。各手順の詳細な手順については、以降のサブセクションをご覧ください。

• 既存のスタンバイ ノードをターゲット OS に置き換えます。
• 新しいスタンバイ ノードをマスターに昇格させます。
• 古いマスターを廃止します。
• 引き続き、追加のスタンバイ ノードを置き換えます。

置換を開始する前に、分析メッセージの損失を最小限に抑えるため、edge-qpid-server を停止することをおすすめします。

apigee-service edge-qpid-server stop

スタンバイ

1. edge-postgres-server ノードの UUID を取得します。

   curl http://pg_standby_ip:8084/v1/servers/self

2. Postgres を停止します。

   apigee-service edge-postgres-server stop

   apigee-service apigee-postgresql stop

3. 次の手順に沿って、既存の Postgres スタンバイを分析グループから削除します。
4. apigee-postgres と postgres-server をアンインストールします。

   apigee-service edge-postgres-server uninstall

   apigee-service apigee-postgresql uninstall

5. アップグレードされた OS を使用して新しいノードを取得します。
6. OS 固有の前提条件を適用します。
7. 使用中の Apigee バージョンのブートストラップをダウンロードし、ブートストラップを実行して apigee-service を取得し、apigee-setup をインストールします。
8. EXISTING_PG_MASTER_IP と NEW_PG_STANDBY_IP を使用して構成ファイルを更新し、既存のマスターでマスター / スタンバイ レプリケーションを設定します。詳細については、構成ファイルのリファレンスをご覧ください。

   PG_MASTER=EXISTING_PG_MASTER_IP

   PG_STANDBY=NEW_PG_STANDBY_IP

   apigee-service apigee-postgresql setup-replication-on-master -f updatedConfigFile

9. 新しいスタンバイ ノードにマスター / スタンバイ構成で Postgres をインストール、設定、起動します。

   PG_MASTER=EXISTING_PG_MASTER_IP

   PG_STANDBY=NEW_PG_STANDBY_IP

   /opt/apigee/apigee-setup/bin/setup.sh -p ps -f updatedConfigFile

10. スタンバイの設定を確認します。

    apigee-service apigee-postgresql postgres-check-standby

マスター

1. 既存の Postgres マスターノードの UUID を取得します。

   curl http://pg_ip:8084/v1/servers/self

2. アップグレードされた新しい OS スタンバイ ノードをマスターに昇格させます。
3. 既存のマスターで Postgres を停止します。

   apigee-service apigee-postgresql stop

   apigee-service edge-postgres-server stop

4. 新しいスタンバイ ノードをマスターに昇格させます。

   apigee-service apigee-postgresql promote-standby-to-master EXISTING_PG_MASTER_IP

5. 古いマスターノードをアナリティクス グループとコンシューマ グループから削除します。
6. 新しいマスターノードをアナリティクス グループとコンシューマ グループに追加します。
7. 収益化を使用している場合は、新しい Postgres マスターノードを更新し、次の手順を行います。
8. マスターノードが置き換えられると、更新されたマスターノード構成で edge-qpid-server を起動できます。

   apigee-service edge-qpid-server start

9. 収益化を使用している場合は、Management Server と Message Processor も再起動します。

   apigee-service edge-management-server restart

10. 旧マスターで apigee-postgres と postgres-server を停止してアンインストールします。

    apigee-service edge-postgres-server uninstall

    apigee-service apigee-postgresql uninstall

新しいスタンバイを追加する

1. アップグレードされた OS を使用して新しいノードを取得します。
2. OS 固有の前提条件を適用します。
3. 使用中の Apigee バージョンのブートストラップをダウンロードし、ブートストラップを実行して apigee-service を取得し、apigee-setup をインストールします。
4. 新しいマスターと新しいスタンバイ ノードの構成ファイルで、新しいマスター IP と新しいスタンバイ ノード IP を使用してマスター / スタンバイ レプリケーションを設定します。詳細については、構成ファイルのリファレンスをご覧ください。

   apigee-service apigee-postgresql setup-replication-on-master -f updatedConfigFile

5. 新しいスタンバイ ノードにインストールして設定します。

   /opt/apigee/apigee-setup/bin/setup.sh -p ps -f updatedConfigFile

6. マスター スタンバイの設定手順に沿って、新しいスタンバイを分析グループに追加します。

LDAP

LDAP ノードを置き換えるには、Management Server を停止する必要があります。このノードの置き換え中は、Management API は使用できません。

1. すべてのノードで Management Server を停止します。

   apigee-service edge-management-server stop

2. 既存の LDAP ノードの廃止:
   1. LDAP ノードの VM レベルのバックアップ/スナップショットを作成します。
   2. LDAP を停止する前に、LDAP データの数をキャプチャしてください。この数は後で確認できます。例:

      ldapsearch -o ldif-wrap=no -b "dc=apigee,dc=com" -D "cn=manager,dc=apigee,dc=com" -H ldap://:10389 -LLL -x -w Secret123 | wc -l

   3. アクティブ / パッシブ設定の場合:
      1. 次の内容の mark_writable.ldif ファイルをパッシブ ノードに追加して、現在のパッシブをアクティブにします。

         dn: olcDatabase={2}bdb,cn=config
         changetype: modify
         replace: olcReadOnly
         olcReadOnly: FALSE

      2. パッシブ ノードで次のコマンドを実行して、アクティブにします。

         ldapmodify -a -x -w "$APIGEE_LDAPPW" -D "$CONFIG_BIND_DN" -H "ldap://:10389" -f mark_writable.ldif

      3. アクティブ / アクティブの場合は、手順 d）に進んでノードを廃止します。
   4. アクティブ / アクティブ LDAP 設定では、2 つの LDAP ノード間のレプリケーションを分割し、構成を更新します。LDAP の廃止に関するドキュメントに記載されている手順に沿って操作します。
   5. LDAP データを停止してバックアップし、既存の LDAP ノードをアンインストールします（アクティブ / アクティブ設定ですでに完了している場合はスキップします）。

      apigee-service apigee-openldap stop

      apigee-service apigee-openldap backup

      apigee-service apigee-openldap uninstall

3. アップグレードされた OS を使用して新しいノードを取得します。
4. OS 固有の前提条件を適用します。
5. 使用中の Apigee バージョンのブートストラップをダウンロードし、ブートストラップを実行して apigee-service を取得し、apigee-setup をインストールします。
6. 新しい LDAP ノードを設定します。
   1. 設定に基づいて新しいノードの configFile を更新します。アクティブのみまたはアクティブ / アクティブの設定に基づいて、Edge 構成ファイル リファレンスを参照してください。
      • LDAP_TYPE
      • LDAP_PEER
      • LDAP_SID
      • USE_LDAP_REMOTE_HOST=y/n
   2. updatedConfigFile を使用して新しいノードで LDAP を設定して起動します。

      /opt/apigee/apigee-setup/bin/setup.sh -p ld -f updatedConfigFile

   3. 古いノードから LDAP データをバックアップします（アクティブ - アクティブ設定をスキップできる場合）。
      1. 新しいノードでサンプル バックアップを作成します。これにより、デフォルトのバックアップ フォルダ/パスが生成されます。

         apigee-service apigee-openldap backup

      2. バックアップしたデータを古いノードから生成されたバックアップ フォルダに移動します。
      3. データを復元する前に apigee-openldap を停止します。

         apigee-service apigee-openldap stop

      4. 古いノードから取得したバックアップを復元します。

         apigee-service apigee-openldap restore backup_file

         次に例を示します。

         apigee-service apigee-openldap restore 2026.02.09,10.28.20

7. 他の LDAP ノード（アクティブ / アクティブの場合）についても繰り返します。
8. 更新された LDAP ホスト構成で Management Server を再設定して起動します。

   /opt/apigee/apigee-setup/bin/setup.sh -p mt -f updatedConfigFile

9. SSO を再設定して開始します（該当する場合）。

   apigee-service apigee-sso setup -f updatedConfigFile

   apigee-service apigee-sso restart

10. （省略可）ドキュメントの手順に沿って、2 つ目のアクティブ ディレクトリを読み取り専用に構成します。

Qpid

既存の Qpid ノードをアップグレードされた OS ノードに置き換えるには、次の手順を確認する必要があります。

1. メッセージ プロセッサから既存のノードキューへのメッセージの受信を停止します。
2. キュー内の既存のメッセージをドレインします。
3. 既存のノードを停止して廃止します。

既存のノードの廃止。メッセージが失われないようにするための追加の対策を以下に示します。

1. Qpid ブローカーを停止します。

   apigee-service apigee-qpidd stop

2. すべての Message Processor からポート 5672 への受信トラフィックをブロックします。

   iptables -A INPUT -p tcp --dport 5672 -s MP_IP -j DROP

3. Qpid ブローカーを再度起動して、既存のメッセージをドレインします。

   apigee-service apigee-qpidd start

4. 廃止を開始する前に、キュー内のすべてのメッセージがコンシューマーに排出されていることを確認します。
5. edge-qpid-server ノードの UUID を取得します。

   curl http://qpid_node_ip:8083/v1/servers/self

6. apigee-qpidd と edge-qpid-server について、分析から Qpid を廃止または削除する手順を完了します。
7. apigee-qpidd と edge-qpid-server の両方を停止してアンインストールします。

   apigee-service apigee-qpidd stop

   apigee-service edge-qpid-server stop

   apigee-service apigee-qpidd uninstall

   apigee-service edge-qpid-server uninstall

新しいノードを追加:

1. アップグレードされた OS を使用して新しいノードを取得します。
2. OS 固有の前提条件を適用します。
3. 使用中の Apigee バージョンのブートストラップをダウンロードし、ブートストラップを実行して apigee-service を取得し、apigee-setup をインストールします。
4. 新しいノードで Qpid サービスを設定して実行し、次の手順に沿って、これらのサービスをコンシューマー グループに追加します。収益化などの他のグループを追加する場合も、同じ手順を検討してください。
5. 収益化サービスが有効になっている場合は、Management Server と Message Processor を再起動します。

   apigee-service edge-management-server restart

   apigee-service edge-message-processor restart

6. すべての Qpid ノードで繰り返します。

Message-processor

1. edge-message-processor ノードの UUID を取得します。

   curl http://mp_ip:8082/v1/servers/self

2. Message Processor ノードを廃止してアンインストールします。
3. 収益化サービスが有効になっている場合は、edge-mint-message-processor をアンインストールします。
4. Message Processor をアンインストールします。

   apigee-service edge-message-processor uninstall

5. アップグレードされた OS を使用して新しいノードを取得します。
6. OS 固有の前提条件を適用します。
7. 使用中の Apigee バージョンのブートストラップをダウンロードし、ブートストラップを実行して apigee-service を取得し、apigee-setup をインストールします。
8. 手順に沿って、クラスタに Message Processor を追加、設定、起動します。
9. 収益化が有効になっている場合は、Message Processor とともに収益化サービスを設定します。詳細については、次のドキュメントをご覧ください。

ルーター

1. edge-router ノードの UUID を取得します。

   curl http://router_ip:8081/v1/servers/self

2. 到達可能性を無効にして、到達可能かどうかを確認します。

   iptables -A INPUT -i eth0 -p tcp --dport 15999 -j REJECT

   curl -vvv -X GET http://router_ip:15999/v1/servers/self/reachable

3. ルーターノードを廃止してアンインストールします。
4. ルーターをアンインストールします。

   apigee-service edge-router uninstall

5. アップグレードされた OS を使用して新しいノードを取得します。
6. OS 固有の前提条件を適用します。
7. 使用中の Apigee バージョンのブートストラップをダウンロードし、ブートストラップを実行して apigee-service を取得し、apigee-setup をインストールします。
8. クラスタに ルーターを追加、設定、起動します。

管理サーバー

管理サーバーは 1 台のみ

1. アップグレードされた OS を使用して新しいノードを取得します。
2. OS 固有の前提条件を適用します。
3. 使用中の Apigee バージョンのブートストラップをダウンロードし、ブートストラップを実行して apigee-service を取得し、apigee-setup をインストールします。
4. 更新された IP アドレスと構成ファイル（こちらを参照）を使用して管理サーバーを追加し、設定コマンドを実行します。

   /opt/apigee/apigee-setup/bin/setup.sh -p mt -f updatedConfigFile

5. 新しい管理 IP 構成で UI を再設定して再起動します。

   /opt/apigee/apigee-setup/bin/setup.sh -p ui -f updatedConfigFile

6. 新しい管理 IP 構成で SSO を再設定します（該当する場合）。

   /opt/apigee/apigee-setup/bin/setup.sh -p sso -f updatedConfigFile

7. 新しい管理 IP 構成で新しい UI（UE）を再設定します（該当する場合）。

   /opt/apigee/apigee-setup/bin/setup.sh -p ue -f updatedConfigFile

8. 収益化が有効になっている場合:
   1. 収益化の構成に関するドキュメントを参照して、新しい管理 IP 構成で収益化 MS を再設定します（該当する場合）。

      /opt/apigee/apigee-setup/bin/setup.sh -p mo -f updatedConfigFile

   2. Management Server を再起動します。

      apigee-service edge-management-server restart

9. 次の手順に沿って、既存のノードまたは古いノードで Management Server を廃止します。
10. 収益化が有効になっている場合は、分析グループから Management Server UUID を削除します。例:

    curl -v -u AdminEmail:AdminPassword -X DELETE "http://localhost:8080/v1/analytics/groups/ax/mint_axgroup/servers?uuid=MS_UUID&type=consumer-server"

11. 収益化 Management Server をアンインストールします。

    apigee-service edge-mint-management-server uninstall

複数の管理サーバー

1. 既存のノードで、もう一方の Management Server を使用して、一方の Management Server を廃止します。手順はこちら。
2. Management Server を停止してアンインストールします。

   apigee-service edge-management-server stop

   apigee-service edge-management-server uninstall

3. アップグレードされた OS を使用して新しいノードを取得します。
4. OS 固有の前提条件を適用します。
5. 使用中の Apigee バージョンのブートストラップをダウンロードし、ブートストラップを実行して apigee-service を取得し、apigee-setup をインストールします。
6. 更新された IP アドレスと構成ファイル（こちらを参照）を使用して管理サーバーを追加し、設定コマンドを実行します。

   /opt/apigee/apigee-setup/bin/setup.sh -p mt -f updatedConfigFile

7. 更新された管理 IP 構成で UI を再設定して再起動します。

   /opt/apigee/apigee-setup/bin/setup.sh -p ui -f updatedConfigFile

8. （SSO が有効になっている場合のみ）更新された管理 IP 構成で SSO を再設定して再起動します。

   /opt/apigee/apigee-setup/bin/setup.sh -p sso -f updatedConfigFile

9. （新しい UI が有効になっている場合のみ）更新された管理 IP 構成で新しい UI を再設定して再起動します。

   /opt/apigee/apigee-setup/bin/setup.sh -p ue -f updatedConfigFile

10. 他の Management Server についても繰り返します。

UI/UE

1. UI ノードのバックアップ/VM スナップショットを作成します。
2. UI を停止してアンインストールします。

   apigee-service edge-ui stop

   apigee-service edge-ui uninstall

3. （新しい UI のみを使用している場合）新しい UI を停止してアンインストールします。

   apigee-service edge-management-ui stop

   apigee-service edge-management-ui uninstall

4. アップグレードされた OS を使用して新しいノードを取得します。
5. OS 固有の前提条件を適用します。
6. 使用中の Apigee バージョンのブートストラップをダウンロードし、ブートストラップを実行して apigee-service を取得し、apigee-setup をインストールします。
7. 更新された IP 構成を使用して、新しいノードで edge-ui を設定して実行します。

   /opt/apigee/apigee-setup/bin/setup.sh -p ui -f updatedConfigFile

8. （SSO が有効になっている場合のみ）必要に応じて、UI の新しいノードの IP 構成を使用して SSO を再設定して実行します。

   /opt/apigee/apigee-setup/bin/setup.sh -p sso -f updatedConfigFile

9. （新しい UI が有効になっている場合のみ）更新された IP 構成を使用して、新しいノードで新しい UI を設定して実行します。

   /opt/apigee/apigee-setup/bin/setup.sh -p ue -f updatedConfigFile

   apigee-service edge-management-ui configure-sso -f updatedConfigFile

   apigee-service edge-ui configure-sso -f updatedConfigFile

SSO

1. UI ノードのバックアップ/VM スナップショットを作成します。
2. SSO を停止してアンインストールします。

   apigee-service apigee-sso stop

   apigee-service apigee-sso uninstall

3. アップグレードされた OS を使用して新しいノードを取得します。
4. OS 固有の前提条件を適用します。
5. 使用中の Apigee バージョンのブートストラップをダウンロードし、ブートストラップを実行して apigee-service を取得し、apigee-setup をインストールします。
6. 新しいノード IP を考慮して、ガイドに沿って SSO の構成と鍵を追加します。
7. SSO を設定して開始します。

   /opt/apigee/apigee-setup/bin/setup.sh -p sso -f updatedConfigFile

8. 新しい SSO ノードの IP で構成を更新し、UI の SSO を再構成します。

   apigee-service edge-ui configure-sso -f updatedConfigFile

9. （新しい UI を使用している場合）ドキュメントを参照して、新しい UI ノードで configure-sso を実行します。

   apigee-service edge-management-ui configure-sso -f updatedConfigFile

   apigee-service edge-ui configure-sso -f updatedConfigFile