Apigee では、Edge for Private Cloud のバージョン 4.50.00 または バージョン 4.51.00 を バージョン 4.52.00 としてリリースされます。このページでは、これらのアップグレードを行う方法について説明します。
更新を実行できるユーザー
更新を実行するユーザーは、最初に 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.0 へのアップグレードが必要です
Edge for Private Cloudes のこのリリースには、Zookeeper 3.8.0 へのアップグレードが含まれています。一部として このアップグレードを行うと、すべての Zookeeper データが Zookeeper 3.8.0 に移行されます。
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 にデータを送信するための代替ユーティリティも作成します。
- ZooKeeper ノードにインストールされていない場合は、nc をインストールします。
sudo yum install nc
- ノードで次の 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
スタンドアロンに設定されます。 - ZooKeeper ノードごとに手順 1 と 2 を繰り返します。
オブザーバー ノードとフォロワー ノードで Zookeeper をアップグレードする
オブザーバー ノードとフォロワー ノードごとに Zookeeper をアップグレードします。
- Edge for Private Cloud 4.52 のブートストラップをダウンロードして実行する <ph type="x-smartling-placeholder"></ph> 外部インターネット接続があるノードで 4.52.00 に更新する。このプロセスは ノードの外部インターネット接続の有無や、 オフライン インストールを実行する場合。
- Zookeeper コンポーネントをアップグレードします。
/opt/apigee/apigee-setup/bin/update.sh -c zk -f <silent-config-file>
注: これらのノードに他のコンポーネント(Cassandra など)がインストールされている場合は、これらのノードをアップグレードして、 (cs、zk プロファイルなど)、他のコンポーネントを後でアップグレードすることもできます。Apigee まずは Zookeeper をアップグレードして、クラスタが正常に動作するようにすることをおすすめします 他のコンポーネントをアップグレードしてください。 - Zookeeper のオブザーバー ノードとフォロワーノードごとに上記の手順を繰り返します。
リーダーをシャットダウンする
すべてのオブザーバー ノードとフォロワー ノードがアップグレードされたら、リーダーをシャットダウンします。ノード リーダーとして識別されているかどうかを確認するには、次のコマンドを実行します。
/opt/apigee/apigee-service/bin/apigee-service apigee-zookeeper stop
なお、イベント期間中は、新しいリーダーが選出される前に、一時的に Zookeeper の書き込みエラー。これは、Zookeeper に書き込むオペレーションに影響する可能性があります。 プロキシのデプロイ アクションや Apigee インフラストラクチャの変更(追加や Message Processor の削除などです。
新しいリーダーが選出されていることを確認する
リーダーの特定 のフォロワーとオブザーバーのセクションで説明したタスクの中から新しいリーダーが選出されていることを確認します。 フォロワー(既存のリーダーが停止すると)なお、 現在のリーダーとは別のデータセンターになります。
リーダーのアップグレード
<ph type="x-smartling-placeholder"></ph>と同じ手順に従います。 オブザーバー ノードとフォロワー ノードで Zookeeper をアップグレードするをご覧ください。
古いリーダーノードもアップグレードしたら、クラスタの正常性と リーダーノードがあることを確認してください。
ロールバック
ロールバックが必要な場合:
- 最初にオブザーバーとフォロワーに対してロールバック手順を実行します。
- ロールバックするバージョン(4.50 または 4.51)のブートストラップをダウンロードして実行します。 このプロセスは、ノードが外部インターネットに接続しているかどうかによって異なる可能性があります。 オフライン インストールを実行している場合です。
- ノードで Zookeeper が実行されている場合は、それを停止します。
/opt/apigee/apigee-service/bin/apigee-service apigee-zookeeper stop
- 既存の Zookeeper をアンインストールします。
/opt/apigee/apigee-service/bin/apigee-service apigee-zookeeper uninstall
/opt/apigee/apigee-setup/bin/setup.sh -p zk -f <silent-config-file>
バックアップを復元
バックアップから復元するをご覧ください。 Edge for Private Cloud の以前のバージョン(4.50 や 4.51 など)から取得した Zookeeper のバックアップは、 Edge for Private Cloud 4.52 の Zookeeper のバージョンと互換性があります。
Postgres 14 へのアップグレードが必要
この Edge のリリースには、Postgres 14 へのアップグレードが含まれています。このアップグレードの一環として Postgres データは Postgres 14 に移行されます。
Edge の本番環境システムのほとんどは、マスター / スタンバイ レプリケーション用に構成された 2 つの Postgres ノードを使用します。 更新プロセス中は、Postgres ノードがアップデートのためにダウンしても、分析データは引き続き Qpid ノードに書き込まれます。Postgres ノードが更新されてオンラインに戻った後、分析データ Postgres ノードに push されます
Postgres を更新する方法は、 Postgres ノード:
- Postgres ノードにローカル データ ストレージを使用する場合は、
アップグレード中に新しい Postgres スタンバイ ノードをインストールする
アップグレードが完了したら、新しい Postgres スタンバイ ノードを廃止できます。
更新をロールバックする必要がある場合は、Postgres スタンバイ ノードを追加する必要があります できます。更新をロールバックする必要がある場合は、新しい Postgres スタンバイ ノードに ロールバック後、Postgres のマスターノードになります。そのため、Python や Curl など、 すべてのハードウェアを満たすノード上に配置する必要があります。 Postgres サーバーの要件を満たす必要があります。 インストール要件。
Edge の 1 ノードおよび 2 ノード構成(プロトタイピングとテストに使用するトポロジ)では、 Postgres ノードは 1 つだけですこれらの Postgres ノードは、 新しい Postgres ノードを作成します
- Postgres ノードにネットワーク ストレージを使用している場合:
新しい Postgres ノードをインストールする必要はありません。
手順を実施する場合は、新しいコンテナをインストールして後で廃止することを指定する手順をスキップし、
Postgres スタンバイ ノード。
更新プロセスを開始する前に、使用しているデータストアのネットワーク スナップショットを Postgres です更新中にエラーが発生してロールバックが必要になった場合は そのスナップショットから Postgres ノードを復元できます
新しい Postgres のインストール スタンバイ ノード
この手順では、新しいノードに Postgres スタンバイ サーバーを作成します。新しいソフトウェア インスタンスを Edge の既存のバージョン(4.50.00 または 4.51.00)の Postgres スタンバイ サーバー バージョン 4.52.00 用ではありません。
現在のバージョンのインストールに使用したものと同じ構成ファイルを使用して、インストールを行います。 説明します。
新しい Postgres スタンバイ ノードを作成するには:
- 現在の 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 アドレスです。
- Postgres マスターで
apigee-postgresql
を再起動します。/opt/apigee/apigee-service/bin/apigee-service apigee-postgresql restart
- 新しいスタンバイ ノードが追加されたことを確認するには、
マスターの
/opt/apigee/apigee-postgresql/conf/pg_hba.conf
ファイル。次のように表示されます。 そのファイルに次の行を追加します。host replication apigee existing_standby_ip/32 trust host replication apigee new_standby_ip/32 trust
- 新しい Postgres スタンバイ サーバーをインストールします。
<ph type="x-smartling-placeholder">
- </ph>
- 現在のバージョンの 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
- SELinux を無効にする Edge apigee-setup ユーティリティをインストールします。
現在 Edge 4.51.00 を使用している場合:
- 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
- Edge
apigee-service
ユーティリティと依存関係をインストールします。sudo bash /tmp/bootstrap_4.51.00.sh apigeeuser=uName apigeepassword=pWord
現在 Edge 4.50.00 を使用している場合:
- Edge bootstrap_4.50.00.sh ファイルを
/tmp/bootstrap_4.50.00.sh
:curl https://software.apigee.com/bootstrap_4.50.00.sh -o /tmp/bootstrap_4.50.00.sh
- Edge
apigee-service
ユーティリティと依存関係をインストールします。sudo bash /tmp/bootstrap_4.50.00.sh apigeeuser=uName apigeepassword=pWord
- Edge bootstrap_4.51.00.sh ファイルを
apigee-service
を使用してapigee-setup
ユーティリティをインストールします。/opt/apigee/apigee-service/bin/apigee-service apigee-setup install
- Postgres をインストールします。
/opt/apigee/apigee-setup/bin/setup.sh -p ps -f configFile
- 新しいスタンバイ ノードで、次のコマンドを実行します。
/opt/apigee/apigee-service/bin/apigee-service apigee-postgresql postgres-check-standby
スタンバイであることを確認します。
- 現在のバージョンの Edge のインストールに使用した構成ファイルを編集して、
次のとおりです。
Postgres のインプレース アップグレードの実行
予備的な手順
Postgres へのインプレース アップグレードを実行する前に、両方のマスターで次の手順を行います。
使用するようにして、インスタンスのアップデートを
apigee-postgresql
の max_locks_per_transaction
プロパティ:
- 存在しない場合は、ファイルを作成します。
/opt/apigee/customer/application/postgresql.properties
。 - このファイルのオーナーを
apigee
に変更します。sudo chown apigee:apigee /opt/apigee/customer/application/postgresql.properties
- このファイルに次のプロパティを追加します。
conf/postgresql.conf+max_locks_per_transaction=30000
apigee-postgresql
を構成します。apigee-service apigee-postgresql configure
apigee-postgresql
を再起動します。apigee-service apigee-postgresql restart
インプレース アップグレードを行う
Postgres 14 へのインプレース アップグレードを行う手順は次のとおりです。
- マスターホストで postgres をアップグレードする
/opt/apigee/apigee-setup/bin/update.sh -c ps -f /opt/silent.conf
- マスターホストで setup コマンドを実行します。
apigee-service apigee-postgresql setup -f /opt/silent.conf
- マスターホストで Configure コマンドを実行します。
apigee-service apigee-postgresql configure
- マスターホストを再起動します。
apigee-service apigee-postgresql restart
- これをマスターとして構成します。
apigee-service apigee-postgresql setup-replication-on-master -f /opt/silent.conf
- マスターホストが起動していることを確認します。
apigee-service apigee-postgresql wait_for_ready
- スタンバイを停止します。
apigee-service apigee-postgresql stop
- スタンバイをアップグレードします。
注: このステップがエラーまたは失敗した場合は、無視してかまいません。
update.sh
が試行します 間違った構成でスタンバイ サーバーを起動します。Postgres がある場合 14 にアップグレードされましたが、このエラーは無視してかまいません。/opt/apigee/apigee-setup/bin/update.sh -c ps -f /opt/silent.conf
- スタンバイが停止していることを確認します。
apigee-service apigee-postgresql stop
- 古いスタンバイ構成を削除します。
rm -rf /opt/apigee/data/apigee-postgresql/
- スタンバイ サーバーでレプリケーションを設定します。
apigee-service apigee-postgresql setup-replication-on-standby -f /opt/silent.conf
- 次の行を削除します:
conf/postgresql.conf+max_locks_per_transaction=30000
両方でファイル/opt/apigee/customer/application/postgresql.properties
を 2 つ構成されます。この行は 準備の手順で追加しました。
この手順を完了すると、スタンバイが正常に起動します。
Postgres ノードの廃止
更新が完了したら、新しいスタンバイ ノードを廃止します。
- Postgres が実行されていることを確認します。
/opt/apigee/apigee-service/bin/apigee-all status
Postgres が実行されていない場合は、起動します。
/opt/apigee/apigee-service/bin/apigee-all start
- 新しいスタンバイ ノードの UUID を取得するには、新しいスタンバイ ノードの
curl
スタンバイ ノード:curl -u sysAdminEmail:password http://node_IP:8084/v1/servers/self
出力の最後に、次の形式でノードの UUID が表示されます。
"type" : [ "postgres-server" ], "uUID" : "599e8ebf-5d69-4ae4-aa71-154970a8ec75"
- 新しいスタンバイ ノードで次のコマンドを実行して、新しいスタンバイ ノードを停止します。
/opt/apigee/apigee-service/bin/apigee-all stop
- 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
- Postgres マスターで apigee-postgresql を再起動します。
/opt/apigee/apigee-service/bin/apigee-service apigee-postgresql restart
- 新しいスタンバイ ノードが削除されたことを確認するには、
マスターの
/opt/apigee/apigee-postgresql/conf/pg_hba.conf
ファイル。次のように表示されます。 次の行だけを使用します。host replication apigee existing_standby_ip/32 trust
- 次の Edge 管理を行って、ZooKeeper からスタンバイ ノードの UUID を削除します。
Management Server ノードでの API 呼び出し:
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 をインストールすることをおすすめします。 これは、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 を更新する手順は次のとおりです。 手順:
更新のロールバック
更新に失敗した場合は、問題を修正して
もう一度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 をロードバランサに追加し直します
- 説明に沿って、設置方法に合わせてマシンを更新してください マシンの更新の順序。
- Router を更新するときは、任意の Router を 1 つ選択し、 サーバーの有効化と無効化に関する (Message Processor/Router)のネットワーク到達性。
- 選択した Router と、その Router と同じマシンにある他のすべての Edge コンポーネントを更新します。 すべての Edge 構成では、同じノード上に Router と Message Processor があります。
- Router を再び到達可能にします。
- 残りのルーターに手順 2 ~ 4 を繰り返します。
- インストール済みの残りのマシンについて、更新を続行してください。
更新の前後に、次の点に注意してください。
- Router ノードと Message Processor ノードが統合されている場合:
<ph type="x-smartling-placeholder">
- </ph>
- 更新前 – 次のことを行います。
<ph type="x-smartling-placeholder">
- </ph>
- Router を到達不能にします。
- Message Processor を到達不能な状態にします。
- 更新後 – 次の操作を行います。
<ph type="x-smartling-placeholder">
- </ph>
- Message Processor を到達可能にします。
- Router を到達可能にします。
- 更新前 – 次のことを行います。
<ph type="x-smartling-placeholder">
- 単一の 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.00
ノード上の Edge コンポーネントを更新するには、次の操作を行います。
- 修復オペレーションを実行するように構成された
cron
ジョブが存在する場合は、無効にします。 更新が完了するまで Cassandra で保持されます。 - root としてノードにログインして Edge RPM をインストールします。
yum-utils
とyum-plugin-priorities
をインストールします。sudo yum install yum-utils
sudo yum install yum-plugin-priorities
- インストール Edge apigee-setup ユーティリティをご覧ください。
- 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.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
- 次のコマンドを実行して、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_FIX
オプションを使用して、処理方法を指定する Java のインストール。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 コンポーネントです。有効な値は次のとおりです。
<ph type="x-smartling-placeholder">
- </ph>
cs
: Cassandraedge
: Edge UI を除くすべての Edge コンポーネント: Management Server、Message プロセッサ、ルーター、QPID Server、Postgres Serverldap
: OpenLDAPps
: postgresqlqpid
: qpiddsso
: Apigee SSO(SSO をインストールしている場合)ue
: 新しい Edge UIui
: Classic Edge UIzk
: 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
- component は、更新する Edge コンポーネントです。有効な値は次のとおりです。
<ph type="x-smartling-placeholder">
- Edge UI コンポーネントを実行しているすべてのノードで Edge UI コンポーネントを再起動します(まだ再起動していない場合)。
/opt/apigee/apigee-service/bin/apigee-service edge-ui restart
- Management API で
apigee-validate
ユーティリティを実行して、更新をテストします。 サーバー。インストールをテストするをご覧ください。
後で更新をロールバックする場合は、 4.52.00 をロールバックします。
ローカル リポジトリから 4.52.00 に更新する
Edge ノードがファイアウォールの内側にあるか、なんらかの理由でアクセスが禁止されている場合は ローカル リポジトリから更新を実行できます。 またはミラーを作成します。
ローカルの Edge リポジトリを作成した後、ローカル環境から Edge を更新する方法は 2 つあります。 ローカル リポジトリ:
- リポジトリの .tar ファイルを作成し、その .tar ファイルをノードにコピーして、 .tar ファイルです。
- ローカル リポジトリのあるノードにウェブサーバーをインストールし、他のノードがアクセスできるようにします。 Apigee が提供する Nginx ウェブサーバーを使用することも、独自のウェブサーバーを使用することもできます。 使用します。
ローカルの 4.52.00 リポジトリから更新するには:
- 「ローカルに Apigee リポジトリを作成する」の説明に沿って、ローカルに 4.52.00 リポジトリを作成する Edge apigee-setup ユーティリティをインストールします。
- .tar ファイルから apigee-service をインストールするには:
<ph type="x-smartling-placeholder">
- </ph>
- ローカル リポジトリがあるノードで、次のコマンドを使用してローカル リポジトリをパッケージ化します。
/opt/apigee/data/apigee-mirror/apigee-4.52.00.tar.gz
という名前の単一の .tar ファイルに変換します。/opt/apigee/apigee-service/bin/apigee-service apigee-mirror package
- Edge を更新するノードに .tar ファイルをコピーします。たとえば、
新しいノードの
/tmp
ディレクトリ。 - 新しいノードで、
/tmp
ディレクトリにファイルを展開します。tar -xzf apigee-4.52.00.tar.gz
このコマンドにより、このディレクトリに
repos
という名前の新しいディレクトリが作成されます。 ダウンロードされます。例:/tmp/repos
- Edge
apigee-service
ユーティリティと依存関係を以下からインストールします。/tmp/repos
:sudo bash /tmp/repos/bootstrap_4.52.00.sh apigeeprotocol="file://" apigeerepobasepath=/tmp/repos
このコマンドには、Repo ディレクトリのパスが含まれています。
- ローカル リポジトリがあるノードで、次のコマンドを使用してローカル リポジトリをパッケージ化します。
- Nginx ウェブサーバーを使用して apigee-service をインストールするには:
<ph type="x-smartling-placeholder">
- </ph>
- 「Nginx を使用してリポジトリからインストールする」の説明に沿って、Nginx ウェブサーバーを構成します。 webserver"Edge のインストール apigee-setup ユーティリティを実行します。
- リモートノードで、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 名です。
- リモートノードで、Edge
apigee-setup
ユーティリティと依存関係をインストールします。sudo bash /tmp/bootstrap_4.52.00.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 コンポーネントです。通常は
以下のコンポーネントです。
<ph type="x-smartling-placeholder">
- </ph>
cs
: Cassandraedge
: Edge UI を除くすべての Edge コンポーネント(Management Server、Message Processor、Router、 QPID Server、Postgres Serverldap
: OpenLDAPps
: postgresqlqpid
: qpiddsso
: Apigee SSO(SSO をインストールしている場合)ue
新しい Edge UIui
: Classic Edge UIzk
: 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
- component は、更新する Edge コンポーネントです。通常は
以下のコンポーネントです。
<ph type="x-smartling-placeholder">
- UI コンポーネントを実行しているすべてのノードで UI コンポーネントを再起動します(まだ再起動していない場合)。
/opt/apigee/apigee-service/bin/apigee-service [edge-management-ui|edge-ui] restart
- Management API で
apigee-validate
ユーティリティを実行して、更新をテストします。 サーバー。インストールをテストするをご覧ください。
後で更新をロールバックする場合は、 4.52.00 をロールバックします。
マシンの更新の順序
Edge インストールでは、マシンを更新する順序が重要です。
- いずれかの Cassandra ノードと ZooKeeper ノードを更新する前に、すべての Cassandra ノードを更新する必要があります。 他のノードで使用できます。
- 複数の Edge コンポーネント(Management Server、Message Processor、
Router、QPID Server ではなく QPID サーバー)を使用する場合は、
-c edge
オプションを使用して更新 すべて同時に実行できます - ステップが複数のマシンで実行されるように指定されている場合、そのステップは マシン順序を指定します。
- Monetization を更新するための個別の手順はありません。これは、Pod の
-c edge
オプション。
1 ノードのスタンドアロン アップグレード
1 ノードのスタンドアロン構成を 4.52.00 にアップグレードするには:
- すべてのコンポーネントを更新します。
/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 の Qpid と Postgres を更新します。
/opt/apigee/apigee-setup/bin/update.sh -c qpid,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
- マシン 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 の Qpid と Postgres を更新します。
/opt/apigee/apigee-setup/bin/update.sh -c qpid, ps -f configFile
- マシン 5 の Qpid と Postgres を更新します。
/opt/apigee/apigee-setup/bin/update.sh -c qpid, 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
- 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
- 従来の 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 コンポーネントを再起動します。
<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
- 従来の UI: 従来の UI を使用している場合は、
次のように、マシン 1 の
9 ノードのクラスタ化アップグレード
9 ノードクラスタ インストールでは、次のコンポーネントを更新します。
Edge トポロジとノード番号のリストについては、インストール トポロジをご覧ください。
- マシン 1、2、3 の Cassandra と ZooKeeper を更新します。
/opt/apigee/apigee-setup/bin/update.sh -c cs,zk -f configFile
- マシン 6、7 の Qpid を更新します。
/opt/apigee/apigee-setup/bin/update.sh -c qpid -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
- マシン 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 コンポーネントを再起動します。
<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
- 従来の UI: 従来の UI を使用している場合は、
次のように、マシン 1 の
13 ノードのクラスタ化アップグレード
13 ノードクラスタ インストールでは、次のコンポーネントを更新します。
Edge トポロジとノード番号のリストについては、インストール トポロジをご覧ください。
- マシン 1、2、3 の Cassandra と ZooKeeper を更新します。
/opt/apigee/apigee-setup/bin/update.sh -c cs,zk -f configFile
- マシン 12、13 の Qpid を更新します。
/opt/apigee/apigee-setup/bin/update.sh -c qpid -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
- マシン 6 の新しい UI(
ue
)または従来の UI(ui
)のいずれかを更新します。 7:/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 コンポーネントを再起動します。
<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
- 従来の UI: 従来の UI を使用している場合は、
次の例に示すように、マシン 6 と 7 の
12 ノードのクラスタ化アップグレード
12 ノードクラスタ インストールでは、次のコンポーネントを更新します。
Edge トポロジとノード番号のリストについては、インストール トポロジをご覧ください。
- Cassandra と ZooKeeper を更新します。
<ph type="x-smartling-placeholder">
- </ph>
- データセンター 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 で、次のコマンドを実行します。
- qpidd を更新します。
<ph type="x-smartling-placeholder">
- </ph>
- データセンター 1 のマシン 4、5
<ph type="x-smartling-placeholder">
- </ph>
- マシン 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
<ph type="x-smartling-placeholder">
- </ph>
- マシン 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
<ph type="x-smartling-placeholder">
- Postgres を更新します。
<ph type="x-smartling-placeholder">
- </ph>
- データセンター 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 を更新します。
<ph type="x-smartling-placeholder">
- </ph>
- データセンター 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 コンポーネントを更新します。
<ph type="x-smartling-placeholder">
- </ph>
- データセンター 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
- 新しい UI(
ue
)または従来の UI(ui
)を更新します。 <ph type="x-smartling-placeholder">- </ph>
- データセンター 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
ユーティリティを更新します。 <ph type="x-smartling-placeholder">- </ph>
- データセンター 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 を更新します。
<ph type="x-smartling-placeholder">
- </ph>
- データセンター 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 で、
- 新しい 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:
- ZooKeeper
- Cassandra
- qpidd、ps
- LDAP
- Edge(「-c edge」の意味)すべてのノードのプロファイルを、次の順序で配置します。 Edge Postgres Server、Management Server、Message Processor、Router。
- Edge UI(従来または新規)
apigee-adminapi
- Apigee SSO
更新が完了したら、実行中のすべてのマシンで Edge UI コンポーネントを再起動してください。 できます。
- Edge