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

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

<ph type="x-smartling-placeholder">で確認できます。 <ph type="x-smartling-placeholder">で確認できます。 <ph type="x-smartling-placeholder">で確認できます。

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

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

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

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

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

<ph type="x-smartling-placeholder">

前提条件の更新

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

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

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

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

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

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

アップグレードで考慮すべき特別な手順

Edge for Private Cloud 4.52.02 にアップグレードするには、特定のソフトウェアをアップグレードするための特定の手順の実行を検討してください。必要な手順は、現在のバージョンによって異なります。補足手順が必要な各種ソフトウェアについては、以下の表を参照してください。このページの後半のセクションでは、各ソフトウェアの詳細な説明と正確な手順について説明します。

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

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

Cassandra 3.11.16 へのアップグレードが必要

Apigee Edge for Private Cloud 4.52.02 には、Cassandra からバージョン 3.11.16 へのアップグレードが含まれています。Cassandra は Apigee の重要なコンポーネントであり、このアップグレードには、Cassandra に対するクエリと書き込みに使用されるさまざまなランタイム コンポーネントと管理コンポーネントのドライバ ソフトウェアの更新も含まれています。

これはメジャー アップグレードであるため、新しいバージョンで最適なパフォーマンスを確保するために、Cassandra の Apigee のデータモデルに特定の変更を加える必要がありました。これらの変更は最小限ですが、アップグレード プロセスによって特定の管理 API が中断され、Apigee UI とデベロッパー ポータルの両方に影響します。以下のドキュメントでは、機能しない API と、中断の開始時と終了時のアップグレード中の手順の概要を示します。重要なのは、アップグレード中にランタイム トラフィックが中断されないことです。

<ph type="x-smartling-placeholder">で確認できます。 <ph type="x-smartling-placeholder">

ロールバックの概要

Cassandra は、一度に 1 つのノードをアップグレードします。ノードが更新されるとすぐに、直接ロールバックできない特定のスキーマの変更が有効になります。アップグレードされたクラスタの量に応じて異なる手法を使用できるため、ロールバックに関するセクションをよくお読みください。

Cassandra クラスタ全体のアップグレード後にアップグレードをロールバックする必要がある場合、バックアップを復元することが唯一の選択肢です。これに備え、Cassandra のバックアップの復元について理解を深めます。Apigee バックアップよりも VM レベルのスナップショットをすばやく復元できる場合は、VM スナップショットを使用して Cassandra VM を以前の状態に復元します。

詳細については、Cassandra 3.11.16 の更新をロールバックするをご覧ください。

デベロッパー ポータルでの API のドキュメント化

Apigee Drupal デベロッパー ポータルには、API を文書化するためのさまざまな機能が用意されています。Drupal 7 ベースのデベロッパー ポータルの使用から移行することをおすすめしますが、まだ使用していて SmartDocs 機能を使用している場合は、 SmartDocs API の使用のドキュメントをご覧ください。新しいバージョンのデベロッパー ポータルを使用している場合、このアップグレードによる API ドキュメントへの影響はありません。

Apigee をバージョン 4.52.02 にアップグレードすると、Drupal 7 デベロッパー ポータルの SmartDocs 機能を使用して作成された API モデルは、新しいバージョンに自動的に移行されません。デベロッパー ポータルを使用して各モデルを手動でエクスポートし、アップグレードの完了後に再度インポートする必要があります。

以降のセクションで使用する用語

ランタイム: ランタイムには、ランタイム プロキシ トラフィックの処理が含まれます。これには、既存のプロキシに対するランタイム API リクエストを効果的に処理するために、Router と Message Processor によって実行されるすべてのオペレーションが含まれています。ただし、新しいプロキシのデプロイやプロキシの新しいリビジョンは含まれません。

管理: 管理には Apigee Edge システムの管理が含まれます。これには、デプロイ、アプリ、プロダクト、ターゲット サーバー、キーストアなどの変更が含まれますが、これらに限定されません。すべての管理 API（および Apigee UI やデベロッパー ポータルなどのクライアント）がこの範囲に含まれます。

以下の各ステップでは、アップグレード手順のさまざまな段階の過程で、ランタイムと管理の状態について説明します。アップグレード中のランタイム トラフィックへの影響はありません。ただし、管理 API とデベロッパー ポータルの機能の一部に障害が発生しています。

ステップ 0: 開始状態

1. バージョン 2.1.22 で実行されている Apigee の Cassandra。
2. Edge for Private Cloud 4.52.02 のコンポーネント:
• 古い Thrift プロトコルを介して Cassandra と通信する管理サーバー。
• 古い Thrift プロトコルを介して Cassandra と通信するランタイム サーバー（Message Processor と Router）。

この段階での実行時の状態	この段階での管理の状態
ランタイムが完全に機能する	管理機能は完全に機能している

ステップ 1: アップグレードを準備する

以下の手順は、コンポーネントのアップグレードを有効にするために通常作成する標準ファイル（Apigee の標準構成ファイルなど）に加えて行います。

1. LeveledCompactionStrategy を使用するように Cassandra を変更します。
2. Apigee を使用して Cassandra をバックアップします。
3. Cassandra ノードの VM スナップショットを作成します（可能な場合）。
4. 各 Cassandra ノードに、次の内容の Cassandra アップグレード構成ファイルを /opt/apigee/apigee-cassandra/cass_upgrade.conf で作成します。

   # IP Address of node
   HOSTIP=10.0.0.1
   
   # Username for running Cassandra queries. Optional. Can be skipped if you have not enabled Cassandra authentication.
   CASS_USERNAME=<cassuser>
   
   # Password for running Cassandra queries. Optional. Can be skipped if you have not enabled Cassandra authentication.
   CASS_PASSWORD=<casspass>
   
   # Port for connecting to Cassandra via thrift. Optional. Defaults to 9160 if skipped.
   CASS_PORT=9160
   
   # Port for connecting to Cassandra via CQL. Optional. Defaults to 9042 if skipped.
   CASS_CQL_PORT=9042
   
   # Directory to be used by Cassandra upgrade scripts. Optional. Defaults to /tmp/cass_upgrade_scripts if skipped.
   # Note that if upgrade is successful, this directory is deleted via root user - so provide a directory accordingly.
   CASS_TMP_DIR=/tmp/cass_upgrade_scripts
       

   ファイルを /opt/apigee/apigee-cassandra/cass_upgrade.conf に作成できない場合は、各 Cassandra ノードに同じ内容のファイル /opt/silent.conf を作成します。 <ph type="x-smartling-placeholder">

• Apigee Drupal 7 デベロッパー ポータルの SmartDocs 機能を使用する場合は、 デベロッパー ポータルの UI から JSON 形式で各モデルをダウンロードして、各モデルをエクスポートする。これらのモデルは、管理サーバーの更新後に Apigee に再度インポートする必要があります。
• ポート 9160 と 9042 がすべての Edge for Private Cloud 4.52.02 コンポーネントから Cassandra ノードにアクセスできることを確認します（まだ存在しない場合）。詳しくは、 詳細については、ポートの要件をご覧ください。

で確認できます。 <ph type="x-smartling-placeholder">

ステップ 2: すべての Cassandra ノードをアップグレードする

1. すべてのリージョンのすべての Cassandra ノードを 1 つずつアップグレードします。各ノードで次のコマンドを実行します。

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

2. ノードが更新されたら、先に進む前に、ノードで次のコマンドを実行して検証をいくつか実行します。

   /opt/apigee/apigee-service/bin/apigee-service apigee-cassandra validate_upgrade -f configFile

3. 上記のコマンドを実行すると、次のような行が出力されます。

   Cassandra version is verified - [cqlsh 5.0.1 | Cassandra 3.11.16 | CQL spec 3.4.4 | Native protocol v3] Metadata is verified

この段階での実行時の状態	この段階での管理の状態
ランタイムが完全に機能する	Cassandra のアップグレード後、次の管理機能はデグレードします。 <ph type="x-smartling-placeholder"> </ph> 環境を使用して API プロダクトを作成するための管理 API API プロダクトを環境とともに更新する Management API 組織を削除する Management API

<ph type="x-smartling-placeholder">

ステップ 3: すべての管理ノードをアップグレードする

すべてのリージョンのすべての管理ノードを 1 つずつアップグレードします。

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

ランタイムの状態	管理の状態
ランタイムが完全に機能する	Management API のデグレード: <ph type="x-smartling-placeholder"> </ph> Drupal 7 デベロッパー ポータルの SmartDocs 機能にデータが表示されない

ステップ 3a: [オプション] 前にエクスポートした SmartDocs をインポートする

すべての管理サーバーをアップグレードすると、 ステップ 1 でエクスポートした SmartDocs モデルをインポートします。この操作は後で行うこともできます。

ランタイムの状態	管理の状態
ランタイムが完全に機能する	管理機能は完全に機能している

ステップ 4: すべてのランタイム ノードをアップグレードする

すべてのリージョンの Router ノードと Message Processor ノードを 1 つずつアップグレードします。

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

ランタイムの状態	管理の状態
ランタイムが完全に機能する	管理機能は完全に機能している

ステップ 5: 残りのすべての Edge for Private Cloud 4.52.02 コンポーネントをアップグレードする

すべてのリージョンの残りの edge-qpid-server ノードと edge-postgres-server ノードをすべて 1 つずつアップグレードします。

この段階で、Edge for Private Cloud 4.52.01 より前のバージョンからアップグレードし、Qpid または Postgres をアップグレードする追加の手順を実施する場合は、それぞれの手順に沿ってアップグレードします。

ランタイムの状態	管理の状態
ランタイムが完全に機能する	管理機能は完全に機能している

ステップ 6: アップグレード後の手順

<ph type="x-smartling-placeholder">

アップグレードが完了したら、各 Cassandra ノードで次のコマンドを実行します。

/opt/apigee/apigee-service/bin/apigee-service apigee-cassandra post_upgrade

次のコマンドを実行して、Cassandra クラスタから古い未使用のテーブルを削除します。これが実行されるまで、Cassandra の一部の機能は使用できません（新しい認証の設定など、古い認証メカニズムは引き続き機能します）。このコマンドは、クラスタ内の 1 つのノードでのみ実行できます。

/opt/apigee/apigee-service/bin/apigee-service apigee-cassandra drop_old_tables -f configFile

ステップ 3a をまだ完了していない場合は、完了します。

ランタイムの状態	管理の状態
ランタイムが完全に機能する	管理機能は完全に機能している

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

Edge for Private Cloud 4.52.02 には Zookeeper へのアップグレードは含まれていませんが、4.52.01 より古いバージョンからアップグレードする場合は、Zookeeper をアップグレードする手順を実行する必要があります。

• Edge for Private Cloud バージョン 4.51.00 または 4.52.00 からアップグレードする場合は、Zookeeper 3.8.3 への必要なアップグレードの手順を参照して Zookeeper をアップグレードします。
• Edge for Private Cloud バージョン 4.52.01 からアップグレードする場合は、すでに Zookeeper バージョン 3.8.3 を使用しているはずです。また、Zookeeper をアップグレードするための特別な手順を行う必要はありません。

で確認できます。 <ph type="x-smartling-placeholder">

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

• Edge for Private Cloud 4.51.00 から 4.52.02 にアップグレードする場合は、Edge for Private Cloud 4.52.02 に Postgres のアップグレードが含まれていなくても、手順に沿って Postgres をアップグレードする必要があります。Edge for Private Cloud 4.51.00 から 4.52.02 にアップグレードするには、追加の Postgres アップグレード手順が必要です。Postgres 14 へのアップグレードが必要をご覧ください。
• Edge for Private Cloud 4.52.00 または 4.52.01 から 4.52.02 にアップグレードする場合、追加の Postgres アップグレード手順は必要ありません。

Qpid J-Broker へのアップグレードが必要

Edge for Private Cloud 4.52.02 には QPID へのアップグレードが含まれていませんが、4.52.01 より前のバージョンからアップグレードする場合は、次の手順に従って QPID をアップグレードする必要があります。

• Edge for Private Cloud 4.51.00 または 4.52.00 から 4.52.02 にアップグレードする場合は、追加の QPID アップグレード手順に従う必要があります。バージョン 4.51.00 または 4.52.00 から 4.52.02 にアップグレードする場合は、Qpid のアップグレードのセクションをご覧ください。
• Edge for Private Cloud 4.52.01 から 4.52.02 にアップグレードする場合は、すでに最新バージョンの Qpid Broker を使用しているため、追加の QPID アップグレード手順は必要ありません。

新しい 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.02

ノード上の 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.02.sh ファイルを次の場所にダウンロードします。 /tmp/bootstrap_4.52.02.sh:

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

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

      sudo bash /tmp/bootstrap_4.52.02.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.02 をロールバックする。

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

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

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

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

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

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

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

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

      tar -xzf apigee-4.52.02.tar.gz

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

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

      sudo bash /tmp/repos/bootstrap_4.52.02.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.02.sh ファイルを次の場所にダウンロードします。 /tmp/bootstrap_4.52.02.sh:

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

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

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

      sudo bash /tmp/bootstrap_4.52.02.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.02 をロールバックする。

マシンの更新の順序

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

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

で確認できます。

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

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

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 コンポーネントを再起動してください。 できます。