Apigee Edge 4.19.06 または 4.50.00 を 4.51.00 に更新する

このセクションでは、Apigee Edge 4.19.06 または 4.50.00 から 4.51.00 にアップグレードする方法について説明します。

更新を行えるユーザー

更新を行うユーザーは、最初に Edge をインストールしたユーザー、または root として実行しているユーザーと同じである必要があります。

Edge RPM をインストールした後は、誰でも構成できます。

更新する必要があるコンポーネント

すべての Edge コンポーネントを更新する必要があります。Edge では、複数のバージョンのコンポーネントを含む設定はサポートされていません。

プロパティ設定の自動伝播

/opt/apigee/customer/application の .properties ファイルを編集してプロパティを設定した場合、これらの値は更新後も保持されます。

Postgres 10.17 への必須アップグレード

この Edge リリースには、Postgres 10.17 へのアップグレードが含まれています。このアップグレードの一環として、すべての Postgres データが Postgres 10.17 に移行されます。

ほとんどの Edge 本番環境システムでは、マスター / スタンバイ レプリケーション用に構成された 2 つの Postgres ノードが使用されます。更新プロセス中、Postgres ノードが更新のために停止している間、分析データは Qpid ノードに書き込まれます。Postgres ノードが更新されてオンラインに戻ると、分析データが Postgres ノードに push されます。

Postgres の更新方法は、Postgres ノードのデータ ストレージの構成方法によって異なります。

• Postgres ノードにローカル データ ストレージを使用している場合は、アップグレード中に新しい Postgres スタンバイ ノードをインストールする必要があります。アップグレードが完了したら、新しい Postgres スタンバイ ノードを廃止できます。

  なんらかの理由で更新をロールバックする必要がある場合は、追加の Postgres スタンバイ ノードが必要です。更新をロールバックする必要がある場合は、ロールバック後に、新しい Postgres スタンバイ ノードがマスター Postgres ノードになります。したがって、新しい Postgres スタンバイ ノードは、Edge のインストール要件で定義されている Postgres サーバーのハードウェア要件をすべて満たすノードにインストールする必要があります。

  Edge の 1 ノード構成と 2 ノード構成（プロトタイピングとテストに使用されるトポロジ）では、Postgres ノードは 1 つだけです。これらの Postgres ノードは、新しい Postgres ノードを作成しなくても直接更新できます。

• Postgres ノードにネットワーク ストレージを使用する場合（Apigee で推奨されているように）、新しい Postgres ノードをインストールする必要はありません。以下の手順では、新しい Postgres スタンバイ ノードをインストールして後で廃止する手順を省略できます。

  更新プロセスを開始する前に、Postgres で使用されるデータストアのネットワーク スナップショットを取得します。更新中にエラーが発生し、ロールバックが必要になった場合は、そのスナップショットから Postgres ノードを復元できます。

新しい Postgres スタンバイ ノードをインストールする

この手順では、新しいノードに Postgres スタンバイ サーバーを作成します。バージョン 4.51.00 ではなく、既存の Edge バージョン（4.19.06 または 4.50.00）用に新しい Postgres スタンバイ サーバーをインストールしてください。

インストールには、現バージョンの Edge のインストールに使用したものと同じ構成ファイルを使用します。

新しい Postgres スタンバイ ノードを作成するには:

1. 現在の Postgres マスターで、/opt/apigee/customer/application/postgresql.properties ファイルを編集して次のトークンを設定します。このファイルが存在しない場合は作成します。

   conf_pg_hba_replication.connection=host replication apigee existing_standby_ip/32 trust\ \nhost replication apigee new_standby_ip/32 trust

   ここで、existing_standby_ip は現在の Postgres スタンバイ サーバーの IP アドレス、new_standby_ip は新しいスタンバイ ノードの IP アドレスです。

2. Postgres マスターで apigee-postgresql を再起動します。

   /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql restart

3. マスターの /opt/apigee/apigee-postgresql/conf/pg_hba.conf ファイルを表示して、新しいスタンバイ ノードが追加されたことを確認します。このファイルに次の行があるはずです。

   host replication apigee existing_standby_ip/32 trust
   host replication apigee new_standby_ip/32 trust

4. 新しい Postgres スタンバイ サーバーをインストールします。
   1. 現在のバージョンの Edge のインストールに使用した構成ファイルを編集して、次の内容を指定します。

      # IP address of the current master:
      PG_MASTER=192.168.56.103
      # IP address of the new standby node
      PG_STANDBY=192.168.56.102

   2. Edge apigee-setup ユーティリティのインストールの説明に従って、SELinux を無効にします。
   3. アップグレード元の Edge のバージョンに応じて、次のいずれかの操作を行います。
      • Edge 4.19.06 からアップグレードする場合は、Edge bootstrap_4.19.06.sh ファイルを /tmp/bootstrap_4.19.06.sh にダウンロードします:

        curl https://software.apigee.com/bootstrap_4.19.06.sh -o /tmp/bootstrap_4.19.06.sh

        次に、Edge apigee-service ユーティリティと依存関係をインストールします。

        sudo bash /tmp/bootstrap_4.19.06.sh apigeeuser=uName apigeepassword=pWord

      • Edge 4.50.00 からアップグレードする場合は、Edge bootstrap_4.50.00.sh ファイルを /tmp/bootstrap_4.50.00.sh にダウンロードします:

        curl https://software.apigee.com/bootstrap_4.50.00.sh -o /tmp/bootstrap_4.50.00.sh

        次に、Edge apigee-service ユーティリティと依存関係をインストールします。

        sudo bash /tmp/bootstrap_4.50.00.sh apigeeuser=uName apigeepassword=pWord

   4. apigee-service を使用して apigee-setup ユーティリティをインストールします。

      /opt/apigee/apigee-service/bin/apigee-service apigee-setup install

   5. Postgres をインストールします。

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

   6. 新しいスタンバイ ノードで、次のコマンドを実行します。

      /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql postgres-check-standby

      スタンバイと表示されることを確認します。

Postgres のインプレース アップグレードの実行

Postgres 10.17 へのインプレース アップグレードを行うには、次の操作を行います。

1. マスターホスト

   /opt/apigee/apigee-setup/bin/update.sh -c ps -f /opt/silent.conf

   上の postgres のアップグレード
2. マスターホストで setup コマンドを実行します。

   apigee-service apigee-postgresql setup -f /opt/silent.conf

3. マスターホストで Configure コマンドを実行します。

   apigee-service apigee-postgresql configure

4. マスターホストを再起動します。

   apigee-service apigee-postgresql restart

5. マスターとして構成します。

   apigee-service apigee-postgresql setup-replication-on-master -f /opt/silent.conf

6. マスターホストが起動していることを確認します。

   apigee-service apigee-postgresql wait_for_ready

7. スタンバイを停止します。

   apigee-service apigee-postgresql stop

8. スタンバイをアップグレードします。

   注: このステップでエラーまたは失敗した場合、無視してかまいません。update.sh はスタンバイ サーバーを誤った構成で起動しようとします。Postgres インストールが 10.17 にアップグレードされている場合、エラーは無視してかまいません。

   /opt/apigee/apigee-setup/bin/update.sh -c ps -f /opt/silent.conf

9. スタンバイが停止していることを確認します。

   apigee-service apigee-postgresql stop

10. 古いスタンバイ構成

    rm -rf /opt/apigee/data/apigee-postgresql/

    を削除します。
11. スタンバイ サーバーでのレプリケーションを設定します。

    apigee-service apigee-postgresql setup-replication-on-standby -f /opt/silent.conf

この手順を完了すると、スタンバイ モードが正常に開始されます。

Postgres ノードを廃止する

更新が完了したら、新しいスタンバイ ノードを廃止します。

1. Postgres が実行されていることを確認します。

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

   Postgres が実行されていない場合は、起動します。

   /opt/apigee/apigee-service/bin/apigee-all start

2. 新しいスタンバイ ノードで次の curl コマンドを実行して、新しいスタンバイ ノードの UUID を取得します。

   curl -u sysAdminEmail:password http://node_IP:8084/v1/servers/self

   出力の最後に、

   "type" : [ "postgres-server" ],
   "uUID" : "599e8ebf-5d69-4ae4-aa71-154970a8ec75"

   という形式でノードの UUID が表示されます。

3. 新しいスタンバイ ノードで次のコマンドを実行して、新しいスタンバイ ノードを停止します。

   /opt/apigee/apigee-service/bin/apigee-all stop

4. Postgres マスターノードで、/opt/apigee/customer/application/postgresql.properties を編集して conf_pg_hba_replication.connection から新しいスタンバイ ノードを削除します。

   conf_pg_hba_replication.connection=host replication apigee existing_standby_ip/32 trust

5. Postgres マスターで apigee-postgresql を再起動します。

   /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql restart

6. マスターの /opt/apigee/apigee-postgresql/conf/pg_hba.conf ファイルを表示して、新しいスタンバイ ノードが削除されたことを確認します。このファイルには次の行だけが表示されます。

   host replication apigee existing_standby_ip/32 trust

7. Management Server ノードで次の Edge 管理 API 呼び出しを行い、ZooKeeper からスタンバイ ノードの UUID を削除します。

   curl -u sysAdminEmail:password -X DELETE http://ms_IP:8080/v1/servers/new_standby_uuid

更新の前提条件

Apigee Edge をアップグレードする前に、次の前提条件を満たしていることを確認してください。

• すべてのノードをバックアップする
  安全上の理由から、更新する前に、すべてのノードを完全にバックアップすることをおすすめします。現在の Edge バージョンのバックアップ手順に沿ってください。

  これにより、新しいバージョンへの更新が正常に機能しなかった場合に備え、バックアップ プランを作成できます。バックアップの詳細については、バックアップと復元をご覧ください。

• Edge が実行中であることを確認する
  次のコマンドを使用して、更新プロセス中に Edge が稼働していることを確認します。

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

新しい Edge UI

このセクションでは、Edge UI に関する考慮事項について説明します。詳細については、Private Cloud 用の新しい Edge UI をご覧ください。

Edge UI のインストール

初期インストールが完了したら、Edge UI をインストールすることをおすすめします。Edge UI は、Apigee Edge for Private Cloud のデベロッパーと管理者向けの強化されたユーザー インターフェースです。

Edge UI では Basic 認証を無効にし、SAML や LDAP などの IDP を使用する必要があります。

詳細については、新しい Edge UI のインストールをご覧ください。

Edge UI の更新

Edge UI コンポーネントを更新するには、アップグレード元の Edge for Private Cloud のバージョンを検討します。

• 4.19.06 または 4.50.00 から 4.51.00（新しい Edge UI がインストール済みの場合）: このセクションに記載されているアップグレード手順で edge-management-ui コンポーネントをアップグレードします。

Apigee mTLS での更新

Apigee mTLS を更新する手順は次のとおりです。

• Apigee mTLS をアンインストールします。
• Apigee mTLS を再インストールします。

更新のロールバック

アップデートに失敗した場合は、問題を修正してから update.sh を再度実行してみてください。更新は複数回実行でき、最後に中断したところから続行されます。

失敗したため更新を前のバージョンにロールバックする必要がある場合は、4.51.00 のロールバックで詳細な手順をご覧ください。

更新情報のロギング

デフォルトでは、update.sh ユーティリティはログ情報を次の場所に書き込みます。

/opt/apigee/var/log/apigee-setup/update.log

update.sh ユーティリティを実行しているユーザーにこのディレクトリへのアクセス権がない場合は、ログが update_username.log という名前のファイルとして /tmp ディレクトリに書き込まれます。

ユーザーに /tmp へのアクセス権がない場合、update.sh ユーティリティは失敗します。

ゼロダウンタイムでの更新

ゼロ ダウンタイム アップデート（ローリング アップデート）を使用すると、Edge をダウンさせることなく Edge インストール環境を更新できます。

ゼロ ダウンタイムの更新は、5 ノード以上の構成でのみ可能です。

ダウンタイムなしでアップグレードするための鍵は、各 Router をロードバランサから 1 つずつ削除することです。次に、Router と、Router と同じマシン上のすべてのコンポーネントを更新してから、Router をロードバランサに再び追加します。

1. マシンの更新順序の説明に従って、インストール環境に合った正しい順序でマシンを更新します。
2. Router を更新するときは、サーバー（Message Processor/Router）のネットワーク到達性の有効化/無効化の説明に従って、Router を 1 台選択して到達不能にします。
3. 選択した Router と、Router と同じマシン上の他のすべての Edge コンポーネントを更新します。どの Edge 構成でも、Router と Message Processor は同じノードに表示されます。
4. Router が再び到達可能になるようにします。
5. 残りの Router に手順 2 ～ 4 を繰り返します。
6. インストールに残っているすべてのマシンの更新を続行します。

アップデートの前後に次の点に留意してください。

• Router と Message Processor ノードの組み合わせ:
  • 更新前 - 次のことを行います。
    1. Router を到達不能にします。
    2. Message Processor をアクセス不能にします。
  • 更新後 - 以下の手順を行います。
    1. Message Processor を到達可能にする
    2. Router が到達可能になるようにします。
• Router 単一ノードの場合:
  • 更新前に、Router を到達不能な状態にします。
  • 更新後、Router に到達可能になるようにします。
• 単一の Message Processor ノードの場合:
  • 更新前に、Message Processor を到達不能な状態にします。
  • 更新後、Message Processor を到達可能にする

サイレント構成ファイルを使用する

update コマンドにサイレント構成ファイルを渡す必要があります。サイレント構成ファイルは、Edge 4.19.06 または 4.50.00 のインストールに使用したものと同じである必要があります。

外部インターネット接続があるノードで 4.51.00 に更新する

ノード上の Edge コンポーネントを更新する手順は次のとおりです。

1. 存在する場合は、更新が完了するまで、Cassandra で修復オペレーションを行うように構成された cron ジョブを無効にします。
2. ノードに root としてログインし、Edge RPM をインストールします。
3. yum-utils と yum-plugin-priorities をインストールします。

   sudo yum install yum-utils
   sudo yum install yum-plugin-priorities

4. Edge apigee-setup ユーティリティのインストールの説明に従って、SELinux を無効にします。
5. Oracle 7.x にインストールする場合は、次のコマンドを実行します。

   sudo yum-config-manager --enable ol7_optional_latest

6. AWS にインストールする場合は、次の yum-configure-manager コマンドを実行します。

   yum update rh-amazon-rhui-client.noarch
   sudo yum-config-manager --enable rhui-REGION-rhel-server-extras rhui-REGION-rhel-server-optional

7. Edge 4.51.00 の bootstrap_4.51.00.sh ファイルを /tmp/bootstrap_4.51.00.sh にダウンロードします。

   curl https://software.apigee.com/bootstrap_4.51.00.sh -o /tmp/bootstrap_4.51.00.sh

8. 次のコマンドを実行して、Edge 4.51.00 apigee-service ユーティリティと依存関係をインストールします。

   sudo bash /tmp/bootstrap_4.51.00.sh apigeeuser=uName apigeepassword=pWord

   ここで、uName:pWord は Apigee から受け取ったユーザー名とパスワードです。pWord を省略すると、入力するように求められます。

   デフォルトでは、Java 1.8 がインストールされているかどうかが確認されます。インストールされていない場合は、インストールが自動的に行われます。

   Java のインストールの処理方法を指定するには、JAVA_FIX オプションを使用します。JAVA_FIX は、次の値を取ります。

   • I: OpenJDK 1.8（デフォルト）をインストールします。
   • C: Java をインストールせずに続行します。
   • Q: 終了します。このオプションでは、Java をユーザー自身でインストールする必要があります。
9. 次の例のように、apigee-service を使用して apigee-setup ユーティリティを更新します。

   /opt/apigee/apigee-service/bin/apigee-service apigee-setup update

10. 次の例のように、Management Server の apigee-validate ユーティリティを更新します。

    /opt/apigee/apigee-service/bin/apigee-service apigee-validate update

11. 次の例のように、Management Server の apigee-provision ユーティリティを更新します。

    /opt/apigee/apigee-service/bin/apigee-service apigee-provision update

12. 次のコマンドを実行して、ノードで update ユーティリティを実行します。

    /opt/apigee/apigee-setup/bin/update.sh -c component -f configFile

    これは、マシンの更新順序に記載された順序で行います。

    ここで

    • component は、更新する Edge コンポーネントです。有効な値は次のとおりです。
      • cs: Cassandra
      • edge: Edge UI を除くすべての Edge コンポーネント（Management Server、Message Processor、Router、QPID Server、Postgres Server）
      • ldap: OpenLDAP
      • ps: postgresql
      • qpid: qpidd
      • sso: Apigee SSO（SSO をインストールしている場合）
      • ue: 新しい Edge UI
      • ui: 従来の Edge UI
      • zk: Zookeeper
    • configFile は、4.19.06 または 4.50.00 のインストール時に Edge コンポーネントの定義に使用したのと同じ構成ファイルです。

    component を「all」に設定すると、すべてのコンポーネントに対して update.sh を実行できます。ただし、これは Edge オールインワン（AIO）インストール プロファイルがある場合に限られます。例:

    /opt/apigee/apigee-setup/bin/update.sh -c all -f ./sa_silent_config

13. Edge UI コンポーネントを実行するすべてのノードで Edge UI コンポーネントを再起動します（まだ再起動していない場合）。

    /opt/apigee/apigee-service/bin/apigee-service edge-ui restart

14. インストールをテストするの説明に従って、Management Server で apigee-validate ユーティリティを実行して、更新をテストします。

後で更新をロールバックすることにした場合は、4.51.00 のロールバックの手順に沿ってください。

ローカル リポジトリから 4.51.00 に更新する

Edge ノードがファイアウォールの内側にあるか、インターネット経由での Apigee リポジトリ アクセスが禁止されている場合は、Apigee リポジトリのローカル リポジトリ（つまりミラー）から更新を実行できます。

ローカル Edge リポジトリを作成した後、ローカル リポジトリから Edge を更新する方法は 2 つあります。

• リポジトリの .tar ファイルを作成し、その .tar ファイルをノードにコピーして、.tar ファイルから Edge を更新します。
• ローカル リポジトリを持つノードにウェブサーバーをインストールし、他のノードからアクセスできるようにします。Apigee から提供されているウェブサーバーは NGINX ですが、他のウェブサーバーを使用してもかまいません。

ローカルの 4.51.00 リポジトリから更新するには:

1. Edge apigee-setup ユーティリティのインストールの「ローカルに Apigee リポジトリを作成する」の手順で 4.51.00 リポジトリをローカルに作成します。
2. .tar ファイルから apigee-service をインストールするには:
   1. ローカル リポジトリがあるノードで、次のコマンドを使用して、ローカル リポジトリを /opt/apigee/data/apigee-mirror/apigee-4.51.00.tar.gz という名前の単一の .tar ファイルにパッケージ化します。

      /opt/apigee/apigee-service/bin/apigee-service apigee-mirror package

   2. Edge を更新する対象のノードに .tar ファイルをコピーします。たとえば、新しいノードの /tmp ディレクトリにコピーします。
   3. 新しいノードで、/tmp ディレクトリに tar ファイルを解凍します。

      tar -xzf apigee-4.51.00.tar.gz

      このコマンドにより、.tar ファイルを含むディレクトリに repos という名前の新しいディレクトリが作成されます。例: /tmp/repos

   4. /tmp/repos から Edge apigee-service ユーティリティと依存関係をインストールします。

      sudo bash /tmp/repos/bootstrap_4.51.00.sh apigeeprotocol="file://" apigeerepobasepath=/tmp/repos

      コマンドに repos ディレクトリへのパスが含まれている点に注意してください。

3. NGINX ウェブサーバーを使用して apigee-service をインストールするには:
   1. Edge apigee-setup ユーティリティのインストールの「NGINX ウェブサーバーを使用してリポジトリからインストールする」の手順に沿って、NGINX ウェブサーバーを構成します。
   2. リモートノードで、Edge bootstrap_4.51.00.sh ファイルを /tmp/bootstrap_4.51.00.sh にダウンロードします。

      /usr/bin/curl http://uName:pWord@remoteRepo:3939/bootstrap_4.51.00.sh -o /tmp/bootstrap_4.51.00.sh

      ここで、uName:pWord は、以前にリポジトリに設定したユーザー名とパスワードです。remoteRepo は、リポジトリ ノードの IP アドレスまたは DNS 名です。

   3. リモートノードで、Edge apigee-setup ユーティリティと依存関係をインストールします。

      sudo bash /tmp/bootstrap_4.51.00.sh apigeerepohost=remoteRepo:3939 apigeeuser=uName apigeepassword=pWord apigeeprotocol=http://

      ここで、uName:pWord はリポジトリのユーザー名とパスワードです。

4. 次の例のように、apigee-service を使用して apigee-setup ユーティリティを更新します。

   /opt/apigee/apigee-service/bin/apigee-service apigee-setup update 

5. 次の例のように、Management Server の apigee-validate ユーティリティを更新します。

   /opt/apigee/apigee-service/bin/apigee-service apigee-validate update

6. 次の例のように、Management Server の apigee-provision ユーティリティを更新します。

   /opt/apigee/apigee-service/bin/apigee-service apigee-provision update

7. マシンの更新順序に記載された順序で、各ノードで update ユーティリティを実行します。

   /opt/apigee/apigee-setup/bin/update.sh -c component -f configFile

   ここで

   • component は、更新する Edge コンポーネントです。通常は、次のコンポーネントを更新します。
     • cs: Cassandra
     • edge: Edge UI を除くすべての Edge コンポーネント（Management Server、Message Processor、Router、QPID Server、Postgres Server）
     • ldap: OpenLDAP
     • ps: postgresql
     • qpid: qpidd
     • sso: Apigee SSO（SSO をインストールしている場合）
     • ue 新しい Edge UI
     • ui: 従来の Edge UI
     • zk: Zookeeper
   • configFile は、4.19.06 または 4.50.00 のインストール時に Edge コンポーネントの定義に使用したのと同じ構成ファイルです。

   component を「all」に設定すると、すべてのコンポーネントに対して update.sh を実行できます。ただし、これは Edge オールインワン（AIO）インストール プロファイルがある場合に限られます。例:

   /opt/apigee/apigee-setup/bin/update.sh -c all -f /tmp/sa_silent_config

8. UI コンポーネントを実行するすべてのノードで UI コンポーネントを再起動します（まだ再起動していない場合）。

   /opt/apigee/apigee-service/bin/apigee-service [edge-management-ui|edge-ui] restart

9. インストールをテストするの説明に従って、Management Server で apigee-validate ユーティリティを実行して、更新をテストします。

後で更新をロールバックすることにした場合は、4.51.00 のロールバックの手順に沿ってください。

マシンの更新順序

Edge インストール環境でマシンを更新する順序は重要です。

• 他のノードを更新する前に、すべての Cassandra ノードと ZooKeeper ノードを更新する必要があります。
• 複数の Edge コンポーネント（Management Server、Message Processor、Router、QPID Server、ただし Postgres Server は除く）を搭載したマシンの場合は、-c edge オプションを使用してそれらすべてを同時に更新します。
• 複数のマシンで行うよう指定されたステップは、指定されたマシン順に実行します。
• 収益化の更新に特別な手順はありません。-c edge オプションを指定すると、この値が更新されます。

1 ノード スタンドアロン構成のアップグレード

1 ノードのスタンドアロン構成を 4.51.00 にアップグレードするには:

1. すべてのコンポーネントを更新します。

   /opt/apigee/apigee-setup/bin/update.sh -c all -f configFile

2. apigee-adminapi がインストールされている場合は、apigee-adminapi ユーティリティを更新します。

   /opt/apigee/apigee-service/bin/apigee-service apigee-adminapi update

2 ノード スタンドアロン構成のアップグレード

2 ノード スタンドアロン構成の場合は、次のコンポーネントを更新します。

Edge トポロジとノード番号のリストについては、インストール トポロジをご覧ください。

1. マシン 1 の Cassandra と ZooKeeper を更新します。

   /opt/apigee/apigee-setup/bin/update.sh -c cs,zk -f configFile

2. マシン 2 の Qpid と Postgres を更新します。

   /opt/apigee/apigee-setup/bin/update.sh -c qpid,ps -f configFile

3. マシン 1 の LDAP を更新します。

   /opt/apigee/apigee-setup/bin/update.sh -c ldap -f configFile

4. マシン 2 と 1 の Edge コンポーネントを更新します。

   /opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile

5. マシン 1 の UI を更新します。

   /opt/apigee/apigee-setup/bin/update.sh -c ui -f configFile

6. apigee-adminapi がインストールされている場合は、マシン 1 の apigee-adminapi ユーティリティを更新します。

   /opt/apigee/apigee-service/bin/apigee-service apigee-adminapi update

7. （Apigee SSO がインストールされている場合）マシン 1 の Apigee SSO を更新します。

   /opt/apigee/apigee-setup/bin/update.sh -c sso -f sso_config_file

   ここで、sso_config_file は SSO をインストールしたときに作成した構成ファイルです。

8. マシン 1 の Edge UI コンポーネントを再起動します。

   /opt/apigee/apigee-service/bin/apigee-service edge-ui restart

5 ノード構成のアップグレード

5 ノード構成の場合は、次のコンポーネントを更新します。

Edge トポロジとノード番号のリストについては、インストール トポロジをご覧ください。

1. マシン 1、2、3 の Cassandra と ZooKeeper を更新します。

   /opt/apigee/apigee-setup/bin/update.sh -c cs,zk -f configFile

2. マシン 4 の Qpid と Postgres を更新します。

   /opt/apigee/apigee-setup/bin/update.sh -c qpid, ps -f configFile

3. マシン 5 の Qpid と Postgres を更新します。

   /opt/apigee/apigee-setup/bin/update.sh -c qpid, ps -f configFile

4. マシン 1 の LDAP を更新します。

   /opt/apigee/apigee-setup/bin/update.sh -c ldap -f configFile

5. マシン 4、5、1、2、3 の Edge コンポーネントを更新します。

   /opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile

6. Edge UI を更新します。
   • Classic UI: Classic UI を使用している場合は、次の例のようにマシン 1 の ui コンポーネントを更新します。

     /opt/apigee/apigee-setup/bin/update.sh -c ui -f configFile

   • 新しい Edge UI: 新しい Edge UI をインストールした場合は、該当するマシン（マシン 1 ではない場合があります）の ue コンポーネントを更新します。

     /opt/apigee/apigee-setup/bin/update.sh -c ue -f /opt/silent.conf

7. apigee-adminapi がインストールされている場合は、マシン 1 の apigee-adminapi ユーティリティを更新します。

   /opt/apigee/apigee-service/bin/apigee-service apigee-adminapi update

8. （Apigee SSO がインストールされている場合）マシン 1 の Apigee SSO を更新します。

   /opt/apigee/apigee-setup/bin/update.sh -c sso -f sso_config_file

   ここで、sso_config_file は SSO をインストールしたときに作成した構成ファイルです。

9. UI コンポーネントを再起動します。
   • Classic UI: Classic UI を使用している場合は、次の例のようにマシン 1 の edge-ui コンポーネントを再起動します。

     /opt/apigee/apigee-service/bin/apigee-service edge-ui restart

   • 新しい Edge UI: 新しい Edge UI をインストールした場合は、該当するマシン（マシン 1 ではない場合があります）の edge-management-ui コンポーネントを再起動します。

     /opt/apigee/apigee-service/bin/apigee-service edge-management-ui restart

9 ノードクラスタ構成のアップグレード

9 ノードクラスタ構成では、次のコンポーネントを更新します。

Edge トポロジとノード番号のリストについては、インストール トポロジをご覧ください。

1. マシン 1、2、3 の Cassandra と ZooKeeper を更新します。

   /opt/apigee/apigee-setup/bin/update.sh -c cs,zk -f configFile

2. マシン 6、7 の Qpid を更新します。

   /opt/apigee/apigee-setup/bin/update.sh -c qpid -f configFile

3. マシン 8 の Postgres を更新します。

   /opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile

4. マシン 9 の Postgres を更新します。

   /opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile

5. マシン 1 の LDAP を更新します。

   /opt/apigee/apigee-setup/bin/update.sh -c ldap -f configFile

6. マシン 6、7、8、9、1、4、5 の Edge コンポーネントをこの順序で更新します。

   /opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile

7. マシン 1 の新しい UI（ue）または Classic UI（ui）を更新します。

   /opt/apigee/apigee-setup/bin/update.sh -c [ui|ue] -f configFile

8. apigee-adminapi がインストールされている場合は、マシン 1 の apigee-adminapi ユーティリティを更新します。

   /opt/apigee/apigee-service/bin/apigee-service apigee-adminapi update

9. （Apigee SSO がインストールされている場合）マシン 1 の Apigee SSO を更新します。

   /opt/apigee/apigee-setup/bin/update.sh -c sso -f sso_config_file

   ここで、sso_config_file は SSO をインストールしたときに作成した構成ファイルです。

10. UI コンポーネントを再起動します。
    • Classic UI: Classic UI を使用している場合は、次の例のようにマシン 1 の edge-ui コンポーネントを再起動します。

      /opt/apigee/apigee-service/bin/apigee-service edge-ui restart

    • 新しい Edge UI: 新しい Edge UI をインストールした場合は、該当するマシン（マシン 1 ではない場合があります）の edge-management-ui コンポーネントを再起動します。

      /opt/apigee/apigee-service/bin/apigee-service edge-management-ui restart

13 ノードクラスタ構成のアップグレード

13 ノードクラスタ構成では、次のコンポーネントを更新します。

Edge トポロジとノード番号のリストについては、インストール トポロジをご覧ください。

1. マシン 1、2、3 の Cassandra と ZooKeeper を更新します。

   /opt/apigee/apigee-setup/bin/update.sh -c cs,zk -f configFile

2. マシン 12、13 の Qpid を更新します。

   /opt/apigee/apigee-setup/bin/update.sh -c qpid -f configFile

3. マシン 8 の Postgres を更新します。

   /opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile

4. マシン 9 の Postgres を更新します。

   /opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile

5. マシン 4 と 5 の LDAP を更新します。

   /opt/apigee/apigee-setup/bin/update.sh -c ldap -f configFile

6. マシン 12、13、8、9、6、7、10、11 の Edge コンポーネントをこの順序で更新します。

   /opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile

7. マシン 6 と 7 の新しい UI（ue）または Classic UI（ui）を更新します。

   /opt/apigee/apigee-setup/bin/update.sh -c [ui|ue] -f configFile

8. apigee-adminapi がインストールされている場合は、マシン 6、7 の apigee-adminapi ユーティリティを更新しました。

   /opt/apigee/apigee-service/bin/apigee-service apigee-adminapi update

9. （Apigee SSO がインストールされている場合）マシン 6 と 7 の Apigee SSO を更新します。

   /opt/apigee/apigee-setup/bin/update.sh -c sso -f sso_config_file

   ここで、sso_config_file は SSO をインストールしたときに作成した構成ファイルです。

10. UI コンポーネントを再起動します。
    • Classic UI: Classic UI を使用している場合は、次の例のようにマシン 6 と 7 の edge-ui コンポーネントを再起動します。

      /opt/apigee/apigee-service/bin/apigee-service edge-ui restart

    • 新しい Edge UI: 新しい Edge UI をインストールした場合は、マシン 6 と 7 の edge-management-ui コンポーネントを再起動します。

      /opt/apigee/apigee-service/bin/apigee-service edge-management-ui restart

12 ノードクラスタ構成のアップグレード

12 ノードクラスタ構成では、次のコンポーネントを更新します。

Edge トポロジとノード番号のリストについては、インストール トポロジをご覧ください。

1. Cassandra と ZooKeeper を更新します。
   1. データセンター 1 のマシン 1、2、3 で、次のコマンドを実行します。

      /opt/apigee/apigee-setup/bin/update.sh -c cs,zk -f configFile

   2. データセンター 2 のマシン 7、8、9 で、次のコマンドを実行します。

      /opt/apigee/apigee-setup/bin/update.sh -c cs,zk -f configFile

2. qpidd を更新します。
   1. データセンター 1 のマシン 4、5 で、次のコマンドを実行します。
      1. マシン 4 の qpidd を更新します。

         /opt/apigee/apigee-setup/bin/update.sh -c qpid -f configFile

      2. マシン 5 の qpidd を更新します。

         /opt/apigee/apigee-setup/bin/update.sh -c qpid -f configFile

   2. データセンター 2 のマシン 10、11 で、次のコマンドを実行します。
      1. マシン 10 の qpidd を更新します。

         /opt/apigee/apigee-setup/bin/update.sh -c qpid -f configFile

      2. マシン 11 の qpidd を更新します。

         /opt/apigee/apigee-setup/bin/update.sh -c qpid -f configFile

3. Postgres を更新します。
   1. データセンター 1 のマシン 6

      /opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile

   2. データセンター 2 のマシン 12

      /opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile

4. LDAP を更新します。
   1. データセンター 1 のマシン 1

      /opt/apigee/apigee-setup/bin/update.sh -c ldap -f configFile

   2. データセンター 2 のマシン 7 で、

      /opt/apigee/apigee-setup/bin/update.sh -c ldap -f configFile

5. Edge コンポーネントを更新します。
   1. データセンター 1 のマシン 4、5、6、1、2、3（データセンター 1）

      /opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile

   2. データセンター 2 のマシン 10、11、12、7、8、9（データセンター 2）

      /opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile

6. 新しい UI（ue）または従来の UI（ui）を更新します。
   1. データセンター 1 のマシン 1:

      /opt/apigee/apigee-setup/bin/update.sh -c [ui|ue] -f configFile

   2. データセンター 2 のマシン 7 で、

      /opt/apigee/apigee-setup/bin/update.sh -c [ui|ue] -f configFile

      :
7. apigee-adminapi がインストールされている場合は、apigee-adminapi ユーティリティを更新します。
   1. データセンター 1 のマシン 1:

      /opt/apigee/apigee-service/bin/apigee-service apigee-adminapi update

   2. データセンター 2 のマシン 7 で、

      /opt/apigee/apigee-service/bin/apigee-service apigee-adminapi update

      :
8. Apigee SSO がインストールされている場合は、Apigee SSO を更新します。
   1. データセンター 1 のマシン 1:

      /opt/apigee/apigee-setup/bin/update.sh -c sso -f sso_config_file

   2. データセンター 2 のマシン 7 で、

      /opt/apigee/apigee-setup/bin/update.sh -c sso -f sso_config_file

      :

   ここで、sso_config_file は SSO をインストールしたときに作成した構成ファイルです。

9. マシン 1 と 7 で新しい Edge UI（edge-management-ui）または従来の Edge UI（edge-ui）コンポーネントを再起動します。

   /opt/apigee/apigee-service/bin/apigee-service [edge-ui|edge-management-ui] restart

非標準構成の場合

標準以外の構成がある場合は、次の順序で Edge コンポーネントを更新します。

1. ZooKeeper
2. Cassandra
3. qpidd、ps
4. LDAP
5. Edge（すべてのノードにある「-c edge」プロファイル）。この順序は、Qpid Server、Edge Postgres Server、Management Server、Message Processor、Router の順です。
6. Edge UI（従来の UI または新しい UI）
7. apigee-adminapi
8. Apigee SSO

更新が完了したら、Edge UI コンポーネントを実行しているすべてのマシンで Edge UI コンポーネントを再起動してください。