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

Apigee では、Edge for Private Cloud をバージョン 4.50.00 またはバージョン 4.51.00 からバージョン 4.52.00 に直接アップグレードできます。このページでは、これらのアップグレードを行う方法について説明します。

更新を行えるユーザー

アップデートを実行するユーザーは、最初に Edge をインストールしたユーザーまたは root として実行しているユーザーである必要があります。

Edge RPM をインストールした後は、すべてのユーザーがそれを構成できます。

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

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

更新の前提条件

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

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

  これにより、新しいバージョンへの更新が失敗した場合に備えてバックアップ計画を立てることができます。バックアップの詳細については、バックアップと復元をご覧ください。

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

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

• Cassandra 圧縮戦略が LeveledCompactionStrategy であることを確認する
  Cassandra 圧縮戦略を変更するで説明されているように、Cassandra 圧縮戦略が LeveledCompactionStrategy に設定されていることを確認します。

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

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

Zookeeper 3.8.0 へのアップグレードが必須

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

Zookeeper をアップグレードする前に、Zookeeper メンテナンス ガイドをお読みください。ほとんどの Edge 本番環境システムでは、複数のデータセンターに分散された Zookeeper ノードのクラスタを使用します。これらのノードの一部は Zookeeper リーダー選出に参加するボーターとして構成され、残りはオブザーバーとして構成されます。 詳しくは、リーダー、フォロワー、ボーター、オブザーバについてをご覧ください。ボーターノードはリーダーを選出します。その後、ボーターノード自体がフォロワーになります。

更新プロセス中に、リーダーノードがシャットダウンされたときに、Zookeeper への書き込みが一時的に遅れたり、失敗したりする可能性があります。これにより、プロキシのデプロイ オペレーションなど、Zookeeper に書き込む管理オペレーションや、メッセージ プロセッサの追加や削除など、Apigee インフラストラクチャの変更に影響する可能性があります。以下の手順に沿って Zookeeper をアップグレードする際、Apigee のランタイム API に影響はありません（これらのランタイム API が管理 API を呼び出す場合を除きます）。

大まかに、アップグレード プロセスでは各ノードのバックアップを取得します。その後、すべてのオブザーバーとフォロワーをアップグレードし、最後にリーダーノードをアップグレードします。

バックアップを作成

ロールバックが必要になった場合に備えて、Zookeeper のすべてのノードのバックアップを作成します。ロールバックすると、Zookeeper はバックアップを取得したときと同じ状態に復元されます。注: バックアップの取得後に Apigee で行われたデプロイやインフラストラクチャの変更（Zookeeper に保存されている情報）は、復元中に失われます。

  /opt/apigee/apigee-service/bin/apigee-service apigee-zookeeper backup

仮想マシンを使用している場合、復元またはロールバックのために VM スナップショットまたはバックアップを取得することもできます（必要に応じて）。

リーダー、フォロワー、オブザーバを特定する

注: 以下のサンプル コマンドでは、nc ユーティリティを使用して Zookeeper にデータを送信します。別のユーティリティを使用して Zookeeper にデータを送信することもできます。

1. nc が ZooKeeper ノードにインストールされていない場合は、次のコマンドを使用してインストールします。

     sudo yum install nc

2. ノードで次の nc コマンドを実行します。ここで、2181 は ZooKeeper ポートです。

     echo stat | nc localhost 2181

   次のような出力が表示されます。

     Zookeeper version: 3.8.0-5a02a05eddb59aee6ac762f7ea82e92a68eb9c0f, built on 2022-02-25 08:49 UTC
     Clients:
      /0:0:0:0:0:0:0:1:41246[0](queued=0,recved=1,sent=0)
     
     Latency min/avg/max: 0/0.2518/41
     Received: 647228
     Sent: 647339
     Connections: 4
     Outstanding: 0
     Zxid: 0x400018b15
     Mode: follower
     Node count: 100597

   出力の Mode 行に、そのノードの構成に応じてオブザーバ、リーダー、フォロワー（リーダーではないボーター）のいずれかが表示されます。注: 単一の ZooKeeper ノードを持つ Edge のスタンドアロン インストールでは、Mode はスタンドアロンに設定されます。

3. ZooKeeper ノードごとに手順 1 と 2 を繰り返します。

オーバーライド ノードとフォロワー ノードで Zookeeper をアップグレードする

オブザーバー ノードとフォロワー ノードごとに Zookeeper をアップグレードします。

1. 外部インターネット接続があるノードで 4.52.00 に更新するの説明に沿って、Edge for Private Cloud 4.52 のブートストラップをダウンロードして実行します。プロセスは、ノードに外部インターネット接続があるかどうか、オフライン インストールを実行しているかどうかによって異なる場合があります。
2. Zookeeper コンポーネントをアップグレードします。

     /opt/apigee/apigee-setup/bin/update.sh -c zk -f <silent-config-file>

   注: これらのノードに他のコンポーネント（Cassandra など）がインストールされている場合は、今すぐ（cs、zk プロファイルなど）アップグレードすることも、後でアップグレードすることもできます。Apigee では、まず Zookeeper のみをアップグレードし、クラスタが正常に動作していることを確認してから、他のコンポーネントをアップグレードすることをおすすめします。
3. 各 Zookeeper オブザーバー ノードとフォロワー ノードで上記の手順を繰り返します。

リーダーをシャットダウンする

すべてのオブザーバー ノードとフォロワー ノードをアップグレードしたら、リーダーをシャットダウンします。リーダーとして識別されたノードで、次のコマンドを実行します。

  /opt/apigee/apigee-service/bin/apigee-service apigee-zookeeper stop

このイベント中、新しいリーダーが選出される前に、Zookeeper で一時的な遅延や書き込みエラーが発生する可能性があります。これにより、プロキシのデプロイ アクションや Apigee インフラストラクチャの変更（メッセージ プロセッサの追加や削除など）など、Zookeeper に書き込むオペレーションに影響する可能性があります。

新しいリーダーが選出されたことを確認する

上記のリーダー、フォロワー、オブザーバーを特定するの手順に沿って、既存のリーダーが停止された後、フォロワーから新しいリーダーが選出されていることを確認します。リーダーは、現在のリーダーとは異なるデータセンターで選出されている可能性があります。

アップグレード リーダー

上記の オブザーバー ノードとフォロワー ノードの Zookeeper のアップグレードと同じ手順を行います。

古いリーダーノードもアップグレードしたら、クラスタの健全性を確認し、リーダーノードがあることを確認します。

ロールバック

ロールバックが必要な場合:

1. まず、オブザーバーとフォロワーに対してロールバックの手順を実施します。
2. ロールバック先のバージョン（4.50 または 4.51）のブートストラップをダウンロードして実行します。プロセスは、ノードに外部インターネット接続があるかどうか、またはオフライン インストールを行うかどうかによって異なります。
3. ノードで実行されている場合は Zookeeper を停止します。

     /opt/apigee/apigee-service/bin/apigee-service apigee-zookeeper stop

4. 既存の Zookeeper をアンインストールします。

     /opt/apigee/apigee-service/bin/apigee-service apigee-zookeeper uninstall

  /opt/apigee/apigee-setup/bin/setup.sh -p zk -f <silent-config-file>

バックアップを復元

バックアップから復元するを参照してください。4.50 や 4.51 などの以前のバージョンの Edge for Private Cloud から取得した Zookeeper のバックアップは、Edge for Private Cloud 4.52 の Zookeeper のバージョンと互換性がある必要があります。

Postgres 14 へのアップグレードが必要

Edge のこのリリースでは、Postgres 14 へのアップグレードが含まれています。アップグレードの際に、すべての Postgres のデータが Postgres 14 に移行されます。

本番環境の Edge システムの場合、通常は 2 台の Postgres ノードでマスター / スタンバイのレプリケーションを構成します。 更新の際、Postgres ノードはダウンしますが、分析データは Qpid ノードに書き込まれます。Postgres が更新され、オンラインに復帰すると、分析データが Postgres ノードに送信されるようになります。

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

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

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

  Edge の 1 ノードまたは 2 ノード構成（プロトタイピングやテストに使用するトポロジ）では、Postgres ノードは 1 つだけです。このような Postgres ノードは、新しい Postgres ノードを作成せずに直接更新できます。

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

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

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

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

インストールを行うには、現在のバージョンの 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 4.51.00 を使用している場合:

      1. Edge 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

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

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

      現在 Edge 4.50.00 を使用している場合:

      1. 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

      2. 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 へのインプレース アップグレードを実行する前に、マスターホストとスタンバイの両方で次の手順を行い、apigee-postgresql の max_locks_per_transaction プロパティを更新します。

1. 存在しない場合は、/opt/apigee/customer/application/postgresql.properties ファイルを作成します。
2. このファイルの所有権を apigee に変更します。

   sudo chown apigee:apigee /opt/apigee/customer/application/postgresql.properties

3. ファイルに次のプロパティを追加します。

   conf/postgresql.conf+max_locks_per_transaction=30000

4. apigee-postgresql を構成します。

   apigee-service apigee-postgresql configure

5. apigee-postgresql を再起動します。

   apigee-service apigee-postgresql restart

インプレース アップグレードを行う

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

1. マスターホストで postgres をアップグレードします。

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

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 が 14 にアップグレードされている場合は、このエラーは無視できます。

   /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

12. マスターホストとスタンバイの両方で、ファイル /opt/apigee/customer/application/postgresql.properties から行 conf/postgresql.conf+max_locks_per_transaction=30000 を削除します。この行は準備ステップで追加されました。

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

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

   出力結果の最後の行に、次の形式でノードの UUID が表示されます。

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

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

Postgres のアップグレード後の手順

Postgres の大幅なアップグレード後、Postgres の内部統計情報は消去されます。これらの統計情報は、Postgres のクエリ プランナーがクエリの実行に最適なインデックスとパスを利用する際に役立ちます。

Postgres は、クエリの実行時や自動バキューム デーモンの実行時に、統計情報を徐々に再ビルドできます。ただし、統計情報が再ビルドされるまで、クエリの速度が低下する可能性があります。

この問題に対処するには、マスター Postgres ノードのデータベース内のすべてのテーブルで ANALYZE を実行します。または、一度に複数のテーブルに対して ANALYZE を実行することもできます。

新しい 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.51.00 から 4.52.00（新しい Edge UI をインストール済みの場合）: edge-management-ui コンポーネントにはこのセクションのアップグレード手順を使用してください。

Apigee mTLS での更新

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

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

更新のロールバック

更新に失敗した場合は、問題の解決を試みた後で update.sh を再び実行できます。更新を複数回実行することができ、最後に終了したところから更新が続行されます。

失敗した結果、前のバージョンへのロールバックが必要になった場合の詳しい手順については、4.52.00 のロールバックをご覧ください。

更新情報のロギング

デフォルトでは、update.sh ユーティリティからのログ情報は次のファイルに書き込まれます。

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

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

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

ダウンタイムなしで更新

ゼロダウンタイムでの更新（ローリング アップデート）により、Edge をダウンさせることなく、インストール済みの Edge を更新できます。

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

ゼロダウンタイムでアップグレードする場合に重要となる点は、各 Router をロードバランサから一度に 1 台ずつ削除することです。削除した Router と、その同じマシンにあるすべてのコンポーネントを更新してから、Router をロードバランサに再び追加します。

1. マシンの更新順序に記載された正しい順序でマシンを更新してください。
2. Router を更新するときは、任意の Router を 1 つ選択し、サーバー（Message Processor または Router）の到達可能性の有効化 / 無効化の説明に従ってその Router を到達不能な状態にします。
3. 選択した 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 を到達可能な状態にします。

サイレント構成ファイルの使用

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

外部インターネット接続があるノードで 4.52.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 を使用している場合:

   1. Edge bootstrap_4.52.00.sh ファイルを /tmp/bootstrap_4.52.00.sh にダウンロードします。

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

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

      sudo bash /tmp/bootstrap_4.52.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 を自分でインストールする必要があります。
   3. 次の例のように、apigee-service を使用して apigee-setup ユーティリティを更新します。

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

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

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

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

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

   6. 次のコマンドを実行して、ノードで 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.50.00 または 4.51.00 のインストール時に Edge コンポーネントの定義に使用した構成ファイルです。

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

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

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

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

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

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

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

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

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

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

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

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

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

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

         tar -xzf apigee-4.52.00.tar.gz

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

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

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

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

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

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

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

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

         sudo bash /tmp/bootstrap_4.52.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: Classic Edge UI
        • zk: Zookeeper
      • configFile は、4.50.00 または 4.51.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.52.00 のロールバックの手順に沿ってください。

   マシンの更新順序

   Edge 構成内のマシンの更新順序は重要です。

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

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

   1 ノード スタンドアロン構成を 4.52.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 を更新します。
      • 従来の UI: 従来の 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 コンポーネントを再起動します。
      • 従来の UI: 従来の 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）または従来の 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 コンポーネントを再起動します。
       • 従来の UI: 従来の 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）または従来の 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 コンポーネントを再起動します。
       • 従来の UI: 従来の 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 で、次のコマンドを実行します。

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

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

         /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）
   7. apigee-adminapi
   8. Apigee SSO

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