Apigee では、Edge for Private Cloud をバージョン 4.51.00、4.52.00、または 4.52.01 からバージョン 4.52.02 に直接アップグレードできます。このページでは、そのようなアップグレードを行う方法について説明します。
更新を実行できるユーザー
更新を実行するユーザーは、最初に Edge をインストールしたユーザーまたは root として実行しているユーザーである必要があります。
Edge RPM をインストールすると、誰でもそれを構成できます。
更新が必要なコンポーネント
すべての Edge コンポーネントを更新する必要があります。Edge では、複数のバージョンのコンポーネントを含む設定はサポートされていません。
前提条件の更新
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 にアップグレードするには、特定のソフトウェアをアップグレードするための特定の手順の実行を検討してください。必要な手順は、現在のバージョンによって異なります。補足手順が必要な各種ソフトウェアについては、以下の表を参照してください。このページの後半のセクションでは、各ソフトウェアの詳細な説明と正確な手順について説明します。
現在のバージョン | 4.52.02 へのアップグレードに特別な手順が必要なソフトウェア |
---|---|
4.52.01 | Cassandra |
4.52.00 | Cassandra、Zookeeper、Qpid |
4.51.00 | Cassandra、Zookeeper、Qpid、Postgres |
プロパティ設定の自動伝播
/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 と、中断の開始時と終了時のアップグレード中の手順の概要を示します。重要なのは、アップグレード中にランタイム トラフィックが中断されないことです。
ロールバックの概要
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: 開始状態
- バージョン 2.1.22 で実行されている Apigee の Cassandra。
- Edge for Private Cloud 4.52.02 のコンポーネント:
- 古い Thrift プロトコルを介して Cassandra と通信する管理サーバー。
- 古い Thrift プロトコルを介して Cassandra と通信するランタイム サーバー(Message Processor と Router)。
この段階での実行時の状態 | この段階での管理の状態 |
---|---|
ランタイムが完全に機能する | 管理機能は完全に機能している |
ステップ 1: アップグレードを準備する
以下の手順は、コンポーネントのアップグレードを有効にするために通常作成する標準ファイル(Apigee の標準構成ファイルなど)に加えて行います。
- LeveledCompactionStrategy を使用するように Cassandra を変更します。
- Apigee を使用して Cassandra をバックアップします。
- Cassandra ノードの VM スナップショットを作成します(可能な場合)。
-
各 Cassandra ノードに、次の内容の Cassandra アップグレード構成ファイルを作成します。
# 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
を作成します。/opt/apigee/apigee-cassandra/cass_upgrade.conf
- Apigee Drupal 7 デベロッパー ポータルの SmartDocs 機能を使用する場合は、デベロッパー ポータル UI から JSON 形式でモデルをダウンロードして各モデルをエクスポートします。これらのモデルは、管理サーバーの更新後に Apigee に再度インポートする必要があります。
- ポート 9160 と 9042 がすべての Edge for Private Cloud 4.52.02 コンポーネントから Cassandra ノードにアクセスできることを確認します(まだ存在しない場合)。詳細については、ポートの要件をご覧ください。
ステップ 2: すべての Cassandra ノードをアップグレードする
-
すべてのリージョンのすべての Cassandra ノードを 1 つずつアップグレードします。各ノードで次のコマンドを実行します。
/opt/apigee/apigee-setup/bin/update.sh -c cs -f configFile
-
ノードが更新されたら、先に進む前に、ノードで次のコマンドを実行して検証をいくつか実行します。
/opt/apigee/apigee-service/bin/apigee-service apigee-cassandra validate_upgrade -f configFile
-
上記のコマンドでは、次のような行が出力されます。
Cassandra version is verified - [cqlsh 5.0.1 | Cassandra 3.11.16 | CQL spec 3.4.4 | Native protocol v3] Metadata is verified
この段階での実行時の状態 | この段階での管理の状態 |
---|---|
ランタイムが完全に機能する | Cassandra のアップグレード後、次の管理機能はデグレードします。 |
ステップ 3: すべての管理ノードをアップグレードする
すべてのリージョンのすべての管理ノードを 1 つずつアップグレードします。
/opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile
ランタイムの状態 | 管理の状態 |
---|---|
ランタイムが完全に機能する |
Management API のデグレード:
|
ステップ 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: アップグレード後の手順
アップグレードが完了したら、各 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 をアップグレードするための特別な手順を行う必要はありません。
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 認証を無効にして、SAML や LDAP などの IDP を使用する必要があります。
詳細については、新しい Edge UI をインストールするをご覧ください。
Edge UI を更新する
Edge UI コンポーネントを更新するには、アップグレード元の Private Cloud 用 Edge のバージョンを検討します。
- 4.51.00 から 4.52.00 へ(新しい Edge UI がすでにインストールされている):
edge-management-ui
コンポーネントについては、このセクションのアップグレード手順を行います。
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 とその他のコンポーネントを更新してから、Router をロードバランサに追加し直します。
- マシンの更新順序に記載されている正しい順序でマシンを更新します。
- Router を更新するときは、いずれかの Router を選択し、サーバー(Message Processor/Router)のネットワーク到達性の有効化/無効化の説明に従ってその Router を到達不能な状態にします。
- 選択した Router と、その Router と同じマシンにある他のすべての Edge コンポーネントを更新します。 すべての Edge 構成では、同じノード上に Router と Message Processor があります。
- Router を再び到達可能にします。
- 残りのルーターに手順 2 ~ 4 を繰り返します。
- インストール済みの残りのマシンについて、更新を続行してください。
更新の前後に、次の点に注意してください。
- Router ノードと Message Processor ノードが統合されている場合:
- 更新前 - 次のことを行います。
- Router を到達不能にします。
- Message Processor を到達不能な状態にします。
- 更新後 - 以下を行います。
- Message Processor を到達可能にします。
- Router を到達可能にします。
- 更新前 - 次のことを行います。
- 単一の Router ノードの場合:
- 更新する前に、Router を到達不能な状態にします。
- 更新後、Router を到達可能にします。
- 単一の Message Processor ノードの場合:
サイレント構成ファイルを使用する
更新コマンドにはサイレント構成ファイルを渡す必要があります。サイレント構成ファイルは、Edge 4.50.00 または 4.51.00 のインストールに使用したものと同じである必要があります。
外部インターネット接続があるノードで 4.52.02 に更新する
ノード上の Edge コンポーネントを更新するには、次の操作を行います。
- Cassandra の修復オペレーションを実行するように構成された
cron
ジョブがある場合は、更新が完了するまで無効にします。 - root としてノードにログインして Edge RPM をインストールします。
yum-utils
とyum-plugin-priorities
をインストールします。sudo yum install yum-utils
sudo yum install yum-plugin-priorities
- Edge apigee-setup ユーティリティをインストールするの説明に従って、SELinux を無効にします。
- Oracle 7.x にインストールする場合は、次のコマンドを実行します。
sudo yum-config-manager --enable ol7_optional_latest
- 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
現在 Edge 4.51.00 を使用している場合:
- 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
- 次のコマンドを実行して、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 のインストールの処理方法を指定するには、
JAVA_FIX
オプションを使用します。JAVA_FIX
は次の値を取ります。I
: OpenJDK 1.8 をインストールします(デフォルト)。C
: Java をインストールせずに続行します。Q
: 終了します。このオプションでは、Java を自分でインストールする必要があります。
- 次の例のように、
apigee-service
を使用してapigee-setup
ユーティリティを更新します。/opt/apigee/apigee-service/bin/apigee-service apigee-setup update
- 次の例のように、Management Server の
apigee-validate
ユーティリティを更新します。/opt/apigee/apigee-service/bin/apigee-service apigee-validate update
- 次の例のように、Management Server の
apigee-provision
ユーティリティを更新します。/opt/apigee/apigee-service/bin/apigee-service apigee-provision update
- 次のコマンドを実行して、ノードで
update
ユーティリティを実行します。/opt/apigee/apigee-setup/bin/update.sh -c component -f configFile
この操作は、マシンの更新順序に記載されている順序で行ってください。
ここで
- component は、更新する Edge コンポーネントです。有効な値は次のとおりです。
cs
: Cassandraedge
: Edge UI を除くすべての Edge コンポーネント(Management Server、Message Processor、Router、QPID Server、Postgres Server)ldap
: OpenLDAPps
: postgresqlqpid
: qpiddsso
: Apigee SSO(SSO をインストールしている場合)ue
: 新しい Edge UIui
: Classic Edge UIzk
: 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
- component は、更新する Edge コンポーネントです。有効な値は次のとおりです。
- Edge UI コンポーネントを実行しているすべてのノードで Edge UI コンポーネントを再起動します(まだ再起動していない場合)。
/opt/apigee/apigee-service/bin/apigee-service edge-ui restart
- インストールをテストするの説明に沿って、Management Server で
apigee-validate
ユーティリティを実行して、更新をテストします。
- Edge
後で更新をロールバックする場合は、4.52.02 のロールバックの手順に従ってください。
ローカル リポジトリから 4.52.02 に更新する
Edge ノードがファイアウォールの内側にあるか、インターネット経由での Apigee リポジトリへのアクセスが禁止されている場合は、Apigee リポジトリのローカル リポジトリ(ミラー)から更新を実行できます。
ローカル Edge リポジトリを作成した後、ローカル リポジトリから Edge を更新するには、次の 2 つの方法があります。
- リポジトリの .tar ファイルを作成してノードにコピーし、.tar ファイルから Edge を更新します。
- ローカル リポジトリのあるノードにウェブサーバーをインストールし、他のノードがアクセスできるようにします。Apigee には、Nginx ウェブサーバーが用意されています。独自のウェブサーバーを使用することもできます。
ローカルの 4.52.02 リポジトリから更新するには:
- Edge apigee-setup ユーティリティをインストールするの「ローカルに Apigee リポジトリを作成する」の説明に従って、ローカルに 4.52.02 リポジトリを作成します。
- .tar ファイルから apigee-service をインストールするには:
- ローカル リポジトリがあるノードで次のコマンドを使用して、ローカル リポジトリを
/opt/apigee/data/apigee-mirror/apigee-4.52.02.tar.gz
という名前の単一の .tar ファイルにパッケージ化します。/opt/apigee/apigee-service/bin/apigee-service apigee-mirror package
- Edge を更新するノードに .tar ファイルをコピーします。たとえば、新しいノードの
/tmp
ディレクトリにコピーします。 - 新しいノードで、
/tmp
ディレクトリにファイルを展開します。tar -xzf apigee-4.52.02.tar.gz
このコマンドにより、.tar ファイルを含むディレクトリに
repos
という名前の新しいディレクトリが作成されます。例:/tmp/repos
/tmp/repos
から Edgeapigee-service
ユーティリティと依存関係をインストールします。sudo bash /tmp/repos/bootstrap_4.52.02.sh apigeeprotocol="file://" apigeerepobasepath=/tmp/repos
このコマンドには、Repo ディレクトリのパスが含まれています。
- ローカル リポジトリがあるノードで次のコマンドを使用して、ローカル リポジトリを
- Nginx ウェブサーバーを使用して apigee-service をインストールするには:
- Edge apigee-setup ユーティリティをインストールするの「Nginx ウェブサーバーを使用してリポジトリからインストールする」の説明に従って Nginx ウェブサーバーを構成します。
- リモートノードで、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 名です。
- リモートノードで、Edge
apigee-setup
ユーティリティと依存関係をインストールします。sudo bash /tmp/bootstrap_4.52.02.sh apigeerepohost=remoteRepo:3939 apigeeuser=uName apigeepassword=pWord apigeeprotocol=http://
ここで、uName:pWord はリポジトリのユーザー名とパスワードです。
- 次の例のように、
apigee-service
を使用してapigee-setup
ユーティリティを更新します。/opt/apigee/apigee-service/bin/apigee-service apigee-setup update
- 次の例のように、Management Server の
apigee-validate
ユーティリティを更新します。/opt/apigee/apigee-service/bin/apigee-service apigee-validate update
- 次の例のように、Management Server の
apigee-provision
ユーティリティを更新します。/opt/apigee/apigee-service/bin/apigee-service apigee-provision update
- マシンの更新順序に記載された順序で、ノードで
update
ユーティリティを実行します。/opt/apigee/apigee-setup/bin/update.sh -c component -f configFile
ここで
- component は、更新する Edge コンポーネントです。通常、次のコンポーネントを更新します。
cs
: Cassandraedge
: Edge UI を除くすべての Edge コンポーネント(Management Server、Message Processor、Router、QPID Server、Postgres Server)ldap
: OpenLDAPps
: postgresqlqpid
: qpiddsso
: Apigee SSO(SSO をインストールしている場合)ue
新しい Edge UIui
: Classic Edge UIzk
: 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
- component は、更新する Edge コンポーネントです。通常、次のコンポーネントを更新します。
- UI コンポーネントを実行しているすべてのノードで UI コンポーネントを再起動します(まだ再起動していない場合)。
/opt/apigee/apigee-service/bin/apigee-service [edge-management-ui|edge-ui] restart
- インストールをテストするの説明に沿って、Management Server で
apigee-validate
ユーティリティを実行して、更新をテストします。
後で更新をロールバックする場合は、4.52.02 のロールバックの手順に従ってください。
マシンの更新の順序
Edge インストールでは、マシンを更新する順序が重要です。
- 他のノードを更新する前に、すべての Cassandra ノードと ZooKeeper ノードを更新する必要があります。
- 複数の Edge コンポーネント(Management Server、Message Processor、Router、QPID Server、Postgres Server は含まない)を搭載したマシンの場合は、
-c edge
オプションを使用してすべてを同時に更新します。 - ステップが複数のマシンで実行するように指定されている場合は、指定されたマシン順序で実行します。
- Monetization を更新するための個別の手順はありません。
-c edge
オプションを指定すると更新されます。
1 ノードのスタンドアロン アップグレード
1 ノードのスタンドアロン構成を 4.52.02 にアップグレードするには:
- すべてのコンポーネントを更新します。
/opt/apigee/apigee-setup/bin/update.sh -c all -f configFile
apigee-adminapi
がインストールされている場合apigee-adminapi
ユーティリティを更新します。/opt/apigee/apigee-service/bin/apigee-service apigee-adminapi update
2 ノードのスタンドアロン アップグレード
2 ノードのスタンドアロン インストールでは、次のコンポーネントを更新します。
Edge トポロジとノード番号のリストについては、インストール トポロジをご覧ください。
- マシン 1 の Cassandra と ZooKeeper を更新します。
/opt/apigee/apigee-setup/bin/update.sh -c cs,zk -f configFile
- マシン 2 の Postgres を更新します。
/opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile
- マシン 1 の LDAP を更新します。
/opt/apigee/apigee-setup/bin/update.sh -c ldap -f configFile
- マシン 2、1 の Edge コンポーネントを更新します。
/opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile
- マシン 2 の Qpid を更新します。
/opt/apigee/apigee-setup/bin/update.sh -c qpid -f configFile
- マシン 1 の UI を更新します。
/opt/apigee/apigee-setup/bin/update.sh -c ui -f configFile
- (
apigee-adminapi
がインストールされている場合)マシン 1 のapigee-adminapi
ユーティリティを更新します。/opt/apigee/apigee-service/bin/apigee-service apigee-adminapi update
- Apigee SSO がインストールされている場合は、マシン 1 の Apigee SSO を更新します。
/opt/apigee/apigee-setup/bin/update.sh -c sso -f sso_config_file
ここで、sso_config_file は、SSO をインストールしたときに作成した構成ファイルです。
- マシン 1 の Edge UI コンポーネントを再起動します。
/opt/apigee/apigee-service/bin/apigee-service edge-ui restart
5 ノード アップグレード
5 ノード インストールの場合は、次のコンポーネントを更新します。
Edge トポロジとノード番号のリストについては、インストール トポロジをご覧ください。
- マシン 1、2、3 の Cassandra と ZooKeeper を更新します。
/opt/apigee/apigee-setup/bin/update.sh -c cs,zk -f configFile
- マシン 4 の Postgres を更新します。
/opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile
- マシン 5 の Postgres を更新します。
/opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile
- マシン 1 の LDAP を更新します。
/opt/apigee/apigee-setup/bin/update.sh -c ldap -f configFile
- マシン 4、5、1、2、3 の Edge コンポーネントを更新します。
/opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile
- マシン 4 の Qpid を更新します:
/opt/apigee/apigee-setup/bin/update.sh -c qpid -f configFile
- マシン 5 の Qpid を更新します。
/opt/apigee/apigee-setup/bin/update.sh -c qpid -f configFile
- 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
- 従来の UI: 従来の UI を使用している場合は、次の例のようにマシン 1 の
- (
apigee-adminapi
がインストールされている場合)マシン 1 のapigee-adminapi
ユーティリティを更新します。/opt/apigee/apigee-service/bin/apigee-service apigee-adminapi update
- Apigee SSO がインストールされている場合は、マシン 1 の Apigee SSO を更新します。
/opt/apigee/apigee-setup/bin/update.sh -c sso -f sso_config_file
ここで、sso_config_file は、SSO をインストールしたときに作成した構成ファイルです。
- 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
- 従来の UI: 従来の UI を使用している場合は、次の例のようにマシン 1 の
9 ノードのクラスタ化アップグレード
9 ノードクラスタ インストールでは、次のコンポーネントを更新します。
Edge トポロジとノード番号のリストについては、インストール トポロジをご覧ください。
- マシン 1、2、3 の Cassandra と ZooKeeper を更新します。
/opt/apigee/apigee-setup/bin/update.sh -c cs,zk -f configFile
- マシン 8 の Postgres を更新します。
/opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile
- マシン 9 の Postgres を更新します。
/opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile
- マシン 1 の LDAP を更新します。
/opt/apigee/apigee-setup/bin/update.sh -c ldap -f configFile
- マシン 6、7、8、9、1、4、5 の順序で Edge コンポーネントを更新します。
/opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile
- マシン 6、7 の Qpid を更新します。
/opt/apigee/apigee-setup/bin/update.sh -c qpid -f configFile
- マシン 1 の新しい UI(
ue
)または従来の UI(ui
)を更新します。/opt/apigee/apigee-setup/bin/update.sh -c [ui|ue] -f configFile
- (
apigee-adminapi
がインストールされている場合)マシン 1 のapigee-adminapi
ユーティリティを更新します。/opt/apigee/apigee-service/bin/apigee-service apigee-adminapi update
- Apigee SSO がインストールされている場合は、マシン 1 の Apigee SSO を更新します。
/opt/apigee/apigee-setup/bin/update.sh -c sso -f sso_config_file
ここで、sso_config_file は、SSO をインストールしたときに作成した構成ファイルです。
- 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
- 従来の UI: 従来の UI を使用している場合は、次の例のようにマシン 1 の
13 ノードのクラスタ化アップグレード
13 ノードクラスタ インストールでは、次のコンポーネントを更新します。
Edge トポロジとノード番号のリストについては、インストール トポロジをご覧ください。
- マシン 1、2、3 の Cassandra と ZooKeeper を更新します。
/opt/apigee/apigee-setup/bin/update.sh -c cs,zk -f configFile
- マシン 8 の Postgres を更新します。
/opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile
- マシン 9 の Postgres を更新します。
/opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile
- マシン 4、5 の LDAP を更新します。
/opt/apigee/apigee-setup/bin/update.sh -c ldap -f configFile
- マシン 12、13、8、9、6、7、10、11 の順序で Edge コンポーネントを更新します。
/opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile
- マシン 12、13 の Qpid を更新します。
/opt/apigee/apigee-setup/bin/update.sh -c qpid -f configFile
- マシン 6、7 の新しい UI(
ue
)または従来の UI(ui
)を更新します。/opt/apigee/apigee-setup/bin/update.sh -c [ui|ue] -f configFile
- (
apigee-adminapi
がインストールされている場合)マシン 6、7 のapigee-adminapi
ユーティリティを更新します。/opt/apigee/apigee-service/bin/apigee-service apigee-adminapi update
- Apigee SSO がインストールされている場合は、マシン 6、7 の Apigee SSO を更新します。
/opt/apigee/apigee-setup/bin/update.sh -c sso -f sso_config_file
ここで、sso_config_file は、SSO をインストールしたときに作成した構成ファイルです。
- 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
- 従来の UI: 従来の UI を使用している場合は、次の例のようにマシン 6 と 7 の
12 ノードのクラスタ化アップグレード
12 ノードクラスタ インストールでは、次のコンポーネントを更新します。
Edge トポロジとノード番号のリストについては、インストール トポロジをご覧ください。
- Cassandra と ZooKeeper を更新します。
- データセンター 1 のマシン 1、2、3 の場合:
/opt/apigee/apigee-setup/bin/update.sh -c cs,zk -f configFile
- データセンター 2 のマシン 7、8、9 の場合
/opt/apigee/apigee-setup/bin/update.sh -c cs,zk -f configFile
- データセンター 1 のマシン 1、2、3 の場合:
- Postgres を更新します。
- データセンター 1 のマシン 6
/opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile
- データセンター 2 のマシン 12
/opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile
- データセンター 1 のマシン 6
- LDAP を更新します。
- データセンター 1 のマシン 1
/opt/apigee/apigee-setup/bin/update.sh -c ldap -f configFile
- データセンター 2 のマシン 7
/opt/apigee/apigee-setup/bin/update.sh -c ldap -f configFile
- データセンター 1 のマシン 1
- Edge コンポーネントを更新します。
- データセンター 1 のマシン 4、5、6、1、2、3
/opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile
- データセンター 2 のマシン 10、11、12、7、8、9
/opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile
- データセンター 1 のマシン 4、5、6、1、2、3
- qpidd を更新します。
- データセンター 1 のマシン 4、5
- マシン 4 の
qpidd
を更新します。/opt/apigee/apigee-setup/bin/update.sh -c qpid -f configFile
- マシン 5 の
qpidd
を更新します。/opt/apigee/apigee-setup/bin/update.sh -c qpid -f configFile
- マシン 4 の
- データセンター 2 のマシン 10、11
- マシン 10 の
qpidd
を更新します。/opt/apigee/apigee-setup/bin/update.sh -c qpid -f configFile
- マシン 11 の
qpidd
を更新します。/opt/apigee/apigee-setup/bin/update.sh -c qpid -f configFile
- マシン 10 の
- データセンター 1 のマシン 4、5
- 新しい UI(
ue
)または従来の UI(ui
)のいずれかを更新します。- データセンター 1 のマシン 1:
/opt/apigee/apigee-setup/bin/update.sh -c [ui|ue] -f configFile
- データセンター 2 のマシン 7:
/opt/apigee/apigee-setup/bin/update.sh -c [ui|ue] -f configFile
- データセンター 1 のマシン 1:
apigee-adminapi
がインストールされている場合apigee-adminapi
ユーティリティを更新します。- データセンター 1 のマシン 1:
/opt/apigee/apigee-service/bin/apigee-service apigee-adminapi update
- データセンター 2 のマシン 7:
/opt/apigee/apigee-service/bin/apigee-service apigee-adminapi update
- データセンター 1 のマシン 1:
- Apigee SSO がインストールされている場合は、Apigee SSO を更新します。
- データセンター 1 のマシン 1:
/opt/apigee/apigee-setup/bin/update.sh -c sso -f sso_config_file
- データセンター 2 のマシン 7:
/opt/apigee/apigee-setup/bin/update.sh -c sso -f sso_config_file
ここで、sso_config_file は、SSO をインストールしたときに作成した構成ファイルです。
- データセンター 1 のマシン 1:
- マシン 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 コンポーネントを更新します。
- ZooKeeper
- Cassandra
- ps
- LDAP
- Edge。Qpid Server、Edge Postgres Server、Management Server、Message Processor、Router の順に、すべてのノードで「-c edge」プロファイルを指定します。
- Qpidd
- Edge UI(従来または新規)
apigee-adminapi
- Apigee SSO
更新が完了したら、そのコンポーネントを実行しているすべてのマシンで Edge UI コンポーネントを再起動してください。