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

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

更新を実行できるユーザー

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

Edge RPM をインストールすると、誰でもそれを構成できます。

更新が必要なコンポーネント

すべての Edge コンポーネントを更新する必要があります。Edge は、コンポーネントを含む設定をサポートしていません 使用できます。

前提条件の更新

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

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

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

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

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

• Cassandra の互換性戦略が LeveledCompactionStrategy であることを確認する
  Cassandra の互換性戦略が LeveledCompactionStrategy。説明: Cassandra の圧縮戦略。

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

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

Zookeeper 3.8.3 へのアップグレードが必要です

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

Zookeeper をアップグレードする前に、 動物園 メンテナンス ガイドをご覧ください。Edge の本番環境システムのほとんどは、さまざまなゾーンに広がる Zookeeper ノードのクラスタを使用しています。 複数のデータセンターに分散しています。これらのノードの一部は、参加するボーターとして構成されています。 残りはオブザーバーとして構成します。 <ph type="x-smartling-placeholder"></ph>をご覧ください。 リーダー、フォロワー、ボーター、オブザーバーについてをご覧ください。投票者ノードは その後は、ボーターノード自体がフォロワーになります。

アップデート プロセス中に、Zookeeper への一時的な遅延や書き込みエラーが発生する可能性があります。 シャットダウン状態になりますこれは、API にログを書き込む管理オペレーションに影響する可能性があります。 Zookeeper（プロキシのデプロイ オペレーション、Apigee インフラストラクチャの変更など） Message Processor の追加や削除などです。実行時への影響は の API Zookeeper のアップグレード中に Apigee（これらのランタイム API が管理 API を呼び出す場合を除く）を 次の手順に沿って操作してください。

大まかに言うと、アップグレード プロセスでは各ノードのバックアップが作成されます。これが続く すべてのオブザーバーとフォロワーをアップグレードし、最後にリーダーノードをアップグレードします。

バックアップを作成

ロールバックが必要になった場合に備えて、Zookeeper のすべてのノードのバックアップを作成します。注: ロールバックを行うと、Zookeeper はバックアップが作成された時点の状態に復元されます。注: Deployment または バックアップの作成後に Apigee でインフラストラクチャの変更（ Zookeeper など）は、復元中に失われます。

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

仮想マシンを使用しており、その機能がある場合は、VM のスナップショットまたはバックアップも 復元またはロールバックの対象になります（必要な場合）。

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

注: 以下のサンプル コマンドでは、 nc ユーティリティ Zookeeper にデータを送信します。これを使用して、 Zookeeper にデータを送信するための代替ユーティリティも作成します。

1. ZooKeeper ノードにインストールされていない場合は、nc をインストールします。

     sudo yum install nc

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

     echo stat | nc localhost 2181

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

     Zookeeper version: 3.8.3-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. Edge for Private Cloud 4.52 のブートストラップをダウンロードして実行する <ph type="x-smartling-placeholder"></ph> 外部インターネット接続があるノードで 4.52.01 に更新する。このプロセスは ノードの外部インターネット接続の有無や、 オフライン インストールを実行する場合。
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 の書き込みエラー。これは、Zookeeper に書き込むオペレーションに影響する可能性があります。 プロキシのデプロイ アクションや Apigee インフラストラクチャの変更（追加や Message Processor の削除などです。

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

リーダーの特定 のフォロワーとオブザーバーのセクションで説明したタスクの中から新しいリーダーが選出されていることを確認します。 フォロワー（既存のリーダーが停止すると）なお、 現在のリーダーとは別のデータセンターになります。

リーダーのアップグレード

<ph type="x-smartling-placeholder"></ph>と同じ手順に従います。 オブザーバー ノードとフォロワー ノードで 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

5. 通常どおりに Zookeeper をインストールします。

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

6. すべてのフォロワーとオブザーバーがロールバックされたら、次の手順でリーダーノードをロールバックします。 ステップ 2 ～ 5 を行います。
7. すべてのノードがロールバックされたら、クラスタの正常性と、 クラスタ内のリーダーノードに配置されます。

バックアップを復元

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

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

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

• Edge for Private Cloud 4.51.00 から 4.52.01 にアップグレードする場合は、追加の Postgres アップグレード手順を実施する必要があります。バージョン 4.51.00 から 4.52.01 にアップグレードする場合は、「Postgres 14 へのアップグレードが必要」セクションをご覧ください。
• Edge for Private Cloud 4.52.00 から 4.52.01 にアップグレードする場合、追加の Postgres アップグレード手順は必要ありません。

Qpid のアップグレード

この Edge for Private Cloud リリースには、Qpid J-Broker へのアップグレードが含まれています。

Qpid のアップグレードを行うには、次のいずれかの方法を選択することをおすすめします。

• ダウンタイムなしのインプレース アップグレード
• 新しい Qpid ノードのコミッショニング

ダウンタイムなしのインプレース アップグレード

この方法により、Edge ランタイム環境のダウンタイムがなくなり、 分析のために取得したランタイム データ（存在する場合）の損失。

Qpid へのダウンタイムなしでインプレース アップグレードを実行するには:

1. 最初に使用する Qpid ノードを 1 つ選択します。
2. ノードで Qpid ブローカーを停止します。

   apigee-service apigee-qpidd stop

3. 次のルールを適用して、すべての Message Processor からブローカー ポート 5672 の受信トラフィックをブロックします。 必要ありません。このファイアウォールは、Qpid ノード インスタンスのレベルで適用することも、 外部ファイアウォール/ネットワーク コンポーネントを経由します。

   すべての Message Processor IP アドレスに同じ手順を実行することをおすすめします。 たとえば、Message Processor の IP アドレスからポート上の Qpid ノードへの DROP リクエストを 5672 を指定する場合は、次のようなコマンドを使用できます。

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

4. 既存のメッセージがある場合は、ドレインするために Qpid ブローカーをもう一度起動します。

   apigee-service apigee-qpidd start

5. 既存のキューが空であることを確認します。

   qpid-stat -q

   メッセージがデッドレター キュー（DLQ）（ax-q-axgroup-001-consumer-group-001-dl）に進まない場合は、ドレインする キューに 分析データがデッドレター キューから先に進まない問題を解決するをご覧ください。

6. キューが古いノードでドレインされたら、apigee-qpidd を停止します。

   apigee-service apigee-qpidd stop

7. ノードの Qpid をアップグレードします。

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

8. edge-qpid-server を再起動します。

   apigee-service edge-qpid-server restart

9. 手順 3 で適用したファイアウォール ルールを削除します。

   ファイアウォールが適用されたすべての Message Processor の IP アドレスに対して、同じ削除手順を実行します。 ファイアウォールを削除すると、Message Processor の IP アドレスから ポート 5672 の Qpid ノードが受け入れられます。iptables を使用してファイアウォールを追加した場合、 ファイアウォールを削除し、既存の設定を一覧表示するには、次のようなコマンドを使用します。

   iptables -F
     iptables -L

10. Web Monitoring を使用して、Qpid キューがメッセージを受信していることを確認します。

    http://QPID_NODE_IP:8090

11. Qpid ノードごとにステップ 1 ～ 9 を繰り返します。

新しい Qpid ノードのコミッショニング

このメソッドは、apigee-qpidd と edge-qpid-server を 作成します。

1. 新しい Qpid ノードを追加します。このステップでは、J- Broker で Qpid ノードを設定します。詳しい手順については Qpid サーバーを追加するをご覧ください。
2. 既存の Qpid ノード（アップグレード元のバージョンのノード）を選択します。
3. ノードで Qpid ブローカーを停止します。

   apigee-service apigee-qpidd stop

4. 次のルールを適用して、すべての Message Processor からブローカー ポート 5672 の受信トラフィックをブロックします。 必要ありません。このファイアウォールは、Qpid ノード インスタンスのレベルで適用することも、 外部ファイアウォール/ネットワーク コンポーネントを経由します。

   すべての Message Processor IP アドレスに同じ手順を実行することをおすすめします。 たとえば、Message Processor の IP アドレスからポート上の Qpid ノードへの DROP リクエストを 5672 を指定する場合は、次のようなコマンドを使用できます。

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

5. 既存のメッセージがある場合は、ドレインするために Qpid ブローカーをもう一度起動します。

   apigee-service apigee-qpidd start

6. 既存のキューが空であることを確認します。

   qpid-stat -q

   メッセージがデッドレター キュー（DLQ）（ax-q-axgroup-001-consumer-group-001-dl）に進まない場合は、 次のトラブルシューティング トピックの手順に沿ってキューに追加します。 分析データが Qpidd のデッドレター キューから先に進まない。

7. 古いノードでキューがドレインされたら、apigee-qpidd を停止します。

   apigee-service apigee-qpidd stop

8. 次の手順に従って、古い Qpid ノードの登録を解除します。 Qpid サーバーを削除します。
9. すべての Qpid ノードの設定が完了するまで、新しいノードの追加と古いノードの削除を 1 つずつ続けます。 アップグレードされます。

ロールバック

以前の機能リリースにロールバックするには、必ず次の bootstrap.sh ファイルをダウンロードしてください: ロールバックするバージョンを指定します。v 4.52.00 にロールバックするには、bootstrap_4.52.00.sh をダウンロードします。

Qpid をロールバックするには、すべての Qpid ホストで次の手順を行います。

1. 既存の Qpid ブローカーを停止する

   apigee-service apigee-qpidd stop

2. 次のルールを適用して、すべての Message Processor からブローカー ポート 5672 の受信トラフィックをブロックします。 必要ありません。このファイアウォールは、Qpid ノード インスタンスのレベルで適用することも、 外部ファイアウォール/ネットワーク コンポーネントを経由します。

   すべての Message Processor IP アドレスに同じ手順を実行することをおすすめします。 たとえば、Message Processor の IP アドレスからポート上の Qpid ノードへの DROP リクエストを 5672 を指定する場合は、次のようなコマンドを使用できます。

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

3. 既存のメッセージがある場合はドレインするために、qpid ブローカーをもう一度起動します。

   apigee-service apigee-qpidd start

4. 既存のキューが空であることを確認します。確認するには、Qpid にログインしてください 管理ポータル:

   http://QPID_NODE_IP:8090

   注: QPID ノードのこのポート 8090 にアクセスできない場合は、SSH ポート転送などの別のメカニズムを使用してこの URL にアクセスできます。
5. キューがドレインされたことを確認したら、Qpid を停止してアンインストールします。

   apigee-service apigee-apidd uninstall

6. Qpid データ ディレクトリを削除します。

   rm -r APIGEE_ROOT/data/apigee-qpidd

7. Qpid ブローカーを再インストールします。

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

8. Qpid ブローカーを再インストールしたら、ファイアウォール設定を削除し、次のコマンドを使用して既存の設定を一覧表示します。

   iptables -F

   iptables -L

新しい Edge UI

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

Edge UI をインストールする

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

Edge UI では、Basic 認証を無効にし、 IDP（SAML、LDAP など）。

詳細については、新しい 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 つずつ負荷から削除することです。 内部 IP アドレスを使用します次に、ルーターとその同じマシン上にある他のコンポーネントを更新します。 Router をロードバランサに追加し直します

1. 説明に沿って、設置方法に合わせてマシンを更新してください マシンの更新の順序。
2. Router を更新するときは、任意の Router を 1 つ選択し、 サーバーの有効化と無効化に関する （Message Processor/Router）のネットワーク到達性。
3. 選択した Router と、その Router と同じマシンにある他のすべての Edge コンポーネントを更新します。 すべての Edge 構成では、同じノード上に Router と Message Processor があります。
4. Router を再び到達可能にします。
5. 残りのルーターに手順 2 ～ 4 を繰り返します。
6. インストール済みの残りのマシンについて、更新を続行してください。

更新の前後に、次の点に注意してください。

• Router ノードと Message Processor ノードが統合されている場合: <ph type="x-smartling-placeholder">
  </ph>
  • 更新前 – 次のことを行います。 <ph type="x-smartling-placeholder">
    </ph>
    1. Router を到達不能にします。
    2. Message Processor を到達不能な状態にします。
  • 更新後 – 次の操作を行います。 <ph type="x-smartling-placeholder">
    </ph>
    1. Message Processor を到達可能にします。
    2. Router を到達可能にします。
• 単一の Router ノードの場合: <ph type="x-smartling-placeholder">
  </ph>
  • 更新する前に、Router を到達不能な状態にします。
  • 更新後、Router を到達可能にします。
• Message Processor の単一ノードの場合: <ph type="x-smartling-placeholder">
  </ph>
  • 更新前に、Message Processor を到達不能な状態にします。
  • 更新後、Message Processor を到達可能にします。

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

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

更新先 外部インターネット接続があるノード上の 4.52.01

ノード上の Edge コンポーネントを更新するには、次の操作を行います。

1. 修復オペレーションを実行するように構成された cron ジョブが存在する場合は、無効にします。 更新が完了するまで Cassandra で保持されます。
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 ユーティリティをご覧ください。
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.01.sh ファイルを次の場所にダウンロードします。 /tmp/bootstrap_4.52.01.sh:

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

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

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

      ここで、uName:pWord は Apigee から取得したユーザー名とパスワードです。もし pWord を省略すると、入力を求めるメッセージが表示されます。

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

      JAVA_FIX オプションを使用して、処理方法を指定する Java のインストール。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 コンポーネントです。有効な値は次のとおりです。 <ph type="x-smartling-placeholder">
        </ph>
        • cs: Cassandra
        • edge: Edge UI を除くすべての Edge コンポーネント: Management Server、Message プロセッサ、ルーター、QPID Server、Postgres Server
        • ldap: OpenLDAP
        • ps: postgresql
        • qpid: qpidd
        • sso: Apigee SSO（SSO をインストールしている場合）
        • ue: 新しい Edge UI
        • ui: Classic Edge UI
        • zk: Zookeeper
      • configFile は、以前に使用したのと同じ構成ファイルです。 Edge の定義 コンポーネントを 4.50.00 または 4.51.00 のインストール中にインストールします。

      component を設定すると、すべてのコンポーネントに対して 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 API で apigee-validate ユーティリティを実行して、更新をテストします。 サーバー。インストールをテストするをご覧ください。

後で更新をロールバックする場合は、 4.52.01 をロールバックする。

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

Edge ノードがファイアウォールの内側にあるか、なんらかの理由でアクセスが禁止されている場合は ローカル リポジトリから更新を実行できます。 またはミラーを作成します。

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

• リポジトリの .tar ファイルを作成し、その .tar ファイルをノードにコピーして、 .tar ファイルです。
• ローカル リポジトリのあるノードにウェブサーバーをインストールし、他のノードがアクセスできるようにします。 Apigee が提供する Nginx ウェブサーバーを使用することも、独自のウェブサーバーを使用することもできます。 使用します。

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

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

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

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

      tar -xzf apigee-4.52.01.tar.gz

      このコマンドにより、このディレクトリに repos という名前の新しいディレクトリが作成されます。 ダウンロードされます。例: /tmp/repos

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

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

      このコマンドには、Repo ディレクトリのパスが含まれています。

3. Nginx ウェブサーバーを使用して apigee-service をインストールするには: <ph type="x-smartling-placeholder">
   </ph>
   1. 「Nginx を使用してリポジトリからインストールする」の説明に沿って、Nginx ウェブサーバーを構成します。 webserver&quot;Edge のインストール apigee-setup ユーティリティを実行します。
   2. リモートノードで、Edge bootstrap_4.52.01.sh ファイルを次の場所にダウンロードします。 /tmp/bootstrap_4.52.01.sh:

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

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

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

      sudo bash /tmp/bootstrap_4.52.01.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 コンポーネントです。通常は 以下のコンポーネントです。 <ph type="x-smartling-placeholder">
     </ph>
     • 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 は、以前に使用したのと同じ構成ファイルです。 Edge コンポーネントの定義 （4.50.00 または 4.51.00 のインストール時）

   component を設定すると、すべてのコンポーネントに対して 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 API で apigee-validate ユーティリティを実行して、更新をテストします。 サーバー。インストールをテストするをご覧ください。

後で更新をロールバックする場合は、 4.52.01 をロールバックする。

マシンの更新の順序

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

• いずれかの Cassandra ノードと ZooKeeper ノードを更新する前に、すべての Cassandra ノードを更新する必要があります。 他のノードで使用できます。
• 複数の Edge コンポーネント（Management Server、Message Processor、 Router、QPID Server ではなく QPID サーバー）を使用する場合は、-c edge オプションを使用して更新 すべて同時に実行できます
• ステップが複数のマシンで実行されるように指定されている場合、そのステップは マシン順序を指定します。
• Monetization を更新するための個別の手順はありません。これは、Pod の -c edge オプション。

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

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

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 の Postgres を更新します。

   /opt/apigee/apigee-setup/bin/update.sh -c 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. マシン 2 の Qpid を更新します。

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

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

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

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. マシン 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 の Postgres を更新します。

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

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

   /opt/apigee/apigee-setup/bin/update.sh -c 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. マシン 4 の Qpid を更新します。

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

7. マシン 5 の Qpid を更新します。

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

8. Edge UI を更新します。 <ph type="x-smartling-placeholder">
   </ph>
   • 従来の UI: 従来の UI を使用している場合は、 次のように、マシン 1 の ui コンポーネントにアタッチします。

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

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

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

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

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

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

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

    ここで、sso_config_file は、コマンドの実行時に作成した構成ファイルです。 SSO がインストール済み。

11. UI コンポーネントを再起動します。 <ph type="x-smartling-placeholder">
    </ph>
    • 従来の UI: 従来の UI を使用している場合は、 次のように、マシン 1 の edge-ui コンポーネントにアタッチします。

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

    • 新しい Edge UI: 新しい Edge UI をインストールした場合は、 適切なマシン上の edge-management-ui コンポーネント（マシンではなく、 1）:

      /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. マシン 8 の Postgres を更新します。

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

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

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

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

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

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

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

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

   /opt/apigee/apigee-setup/bin/update.sh -c qpid -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 コンポーネントを再起動します。 <ph type="x-smartling-placeholder">
    </ph>
    • 従来の UI: 従来の UI を使用している場合は、 次のように、マシン 1 の edge-ui コンポーネントにアタッチします。

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

    • 新しい Edge UI: 新しい Edge UI をインストールした場合は、 適切なマシン上の edge-management-ui コンポーネント（マシンではなく、 1）:

      /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. マシン 8 の Postgres を更新します。

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

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

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

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

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

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

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

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

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

7. マシン 6 の新しい UI（ue）または従来の UI（ui）のいずれかを更新します。 7:

   /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 コンポーネントを再起動します。 <ph type="x-smartling-placeholder">
    </ph>
    • 従来の 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 を更新します。 <ph type="x-smartling-placeholder">
   </ph>
   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. Postgres を更新します。 <ph type="x-smartling-placeholder">
   </ph>
   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

3. LDAP を更新します。 <ph type="x-smartling-placeholder">
   </ph>
   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

4. Edge コンポーネントを更新します。 <ph type="x-smartling-placeholder">
   </ph>
   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

5. qpidd を更新します。 <ph type="x-smartling-placeholder">
   </ph>
   1. データセンター 1 のマシン 4、5 <ph type="x-smartling-placeholder">
      </ph>
      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 <ph type="x-smartling-placeholder">
      </ph>
      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

6. 新しい UI（ue）または従来の UI（ui）を更新します。 <ph type="x-smartling-placeholder">
   </ph>
   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 ユーティリティを更新します。 <ph type="x-smartling-placeholder">
   </ph>
   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 を更新します。 <ph type="x-smartling-placeholder">
   </ph>
   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. 新しい Edge UI（edge-management-ui）または従来の Edge UI を再起動する マシン 1 と 7 の (edge-ui) コンポーネント:

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

非標準構成の場合

非標準構成の場合は、次の場所で Edge コンポーネントを更新します。 order:

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

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