Edge 4.52.01 への更新中にエラーが発生した場合は、 コンポーネントを確認してから、再度アップデートを試みてください。
Edge 4.52.01 は、次のメジャー リリース バージョンにロールバックできます。
- バージョン 4.52.00
- バージョン 4.51.00
ロールバックを実行するシナリオは 2 つあります。
- 以前のメジャー リリースまたはマイナー リリースにロールバックする。たとえば、 4.52.01 ~ 4.52.00
- 同じ期間内の以前のパッチリリースにロールバックする リリース。たとえば、4.52.00.02 から 4.52.00.01 へのロールバックです。
詳細については、Apigee Edge リリースをご覧ください。 プロセスをご覧ください。
ロールバックを実行できるユーザー
ロールバックを実行するユーザーは、最初に Edge を更新したユーザーと同じである必要があります。または、 ユーザーです。
デフォルトでは、Edge コンポーネントはユーザー「apigee」として実行されます。場合によっては 異なるユーザーとして識別されます。たとえば、ルーターが次のような特権ポートにアクセスする必要がある場合、 root またはアクセス権のあるユーザーとして Router を実行する必要があります。 ポート。また、あるコンポーネントをあるユーザーとして実行し、別のコンポーネントを別のユーザーとして実行することもできます。
共通のコードを使用するコンポーネント
次の Edge コンポーネントは共通のコードを共有しています。したがって、任意の 1 つのインスタンスを そのノード上にあるこれらのコンポーネントをすべてロールバックする必要があります。
edge-management-server
(Management Server)edge-message-processor
(Message Processor)edge-router
(ルーター)edge-postgres-server
(Postgres Server)edge-qpid-server
(Qpid Server)
たとえば、Management Server、Router、Message Processor を いずれかをロールバックするには、3 つすべてをロールバックする必要があります。
以前のメジャー リリースまたはマイナー リリースにロールバックする
以前のメジャー リリースまたはマイナー リリースにロールバックするには、 component:
-
ロールするバージョンの
bootstrap.sh
ファイルをダウンロードします back:- 4.51.00 にロールバックするには、
bootstrap_4.51.00.sh
をダウンロードします。curl https://software.apigee.com/bootstrap_4.51.00.sh -o /tmp/bootstrap_4.51.00.sh
- 4.51.00 にロールバックするには、
- ロールバックするコンポーネントを停止します。
<ph type="x-smartling-placeholder">
- </ph>
- プロジェクトの共通のコードを使用するコンポーネントをロールバック
次の例に示すように、それらをすべて停止する必要があります。
/opt/apigee/apigee-service/bin/apigee-service edge-management-server stop
/opt/apigee/apigee-service/bin/apigee-service edge-router stop
/opt/apigee/apigee-service/bin/apigee-service edge-message-processor stop
/opt/apigee/apigee-service/bin/apigee-service edge-qpid-server stop
/opt/apigee/apigee-service/bin/apigee-service edge-postgres-server stop
- ノード上のその他のコンポーネントをロールバックするには、そのコンポーネントのみを停止します。
<ph type="x-smartling-placeholder">
- </ph>
/opt/apigee/apigee-service/bin/apigee-service component stop
- プロジェクトの共通のコードを使用するコンポーネントをロールバック
次の例に示すように、それらをすべて停止する必要があります。
- Monetization をロールバックする場合は、すべての Management Server および Message
プロセッサ ノード:
/opt/apigee/apigee-service/bin/apigee-service edge-mint-gateway uninstall
- ロールバックするコンポーネントをノードでアンインストールします。
<ph type="x-smartling-placeholder">
- </ph>
- プロジェクトの共通のコードを使用するコンポーネントをロールバック
edge-gateway
コンポーネントをアンインストールして、すべてのコンポーネントをアンインストールする必要があります。 次の例をご覧ください。/opt/apigee/apigee-service/bin/apigee-service edge-gateway uninstall
- ノード上の他のコンポーネントをロールバックするには、そのコンポーネントのみをアンインストールします。
次の例をご覧ください。
/opt/apigee/apigee-service/bin/apigee-service component uninstall
ここで、component はコンポーネント名です。
- Edge Router をロールバックするには、
/opt/nginx/conf.d
ファイルと、edge-gateway
コンポーネント グループ:cd /opt/nginx/conf.d
rm -rf *
- プロジェクトの共通のコードを使用するコンポーネントをロールバック
- バージョン 4.52.01 の
apigee-setup
をアンインストールします。/opt/apigee/apigee-service/bin/apigee-service apigee-setup uninstall
- バージョン 4.51.00 の
apigee-service
をインストールします。 その依存関係について説明します。次の例では、4.51.00 バージョンのapigee-service
:sudo bash /tmp/bootstrap_4.51.00.sh apigeeuser=uName apigeepassword=pWord
uName と pWord は、取得したユーザー名とパスワードです。 Apigee からデプロイできます。pWord を省略すると、入力を求められます。
エラーが発生した場合は、ステップで
bootstrap.sh
ファイルをダウンロードしたことを確認してください。 1. apigee-setup
のインストール:/opt/apigee/apigee-service/bin/apigee-service apigee-setup install
- 古いバージョンのコンポーネントをインストールします。
/opt/apigee/apigee-setup/bin/setup.sh -p component -f configFile
ここで、component はインストールするコンポーネント、configFile は 構成ファイルが更新されます。
- Qpid をロールバックする場合は、iptables をフラッシュします。
sudo iptables -F
- ロールバックするコンポーネントをホストするノードごとに、この手順を繰り返します。
以前のパッチリリースにロールバックする
コンポーネントを特定のパッチリリースにロールバックするには、各ノードで次の操作を行います。 コンポーネントをホストします。
- 特定のコンポーネント バージョンをダウンロードします。
/opt/apigee/apigee-service/bin/apigee-service component_version install
ここで、component_version はインストールするコンポーネントとパッチリリースです。例:
/opt/apigee/apigee-service/bin/apigee-service edge-ui-4.51.05-0.0.3749 install
Apigee オンライン リポジトリを使用している場合は、利用可能なコンポーネントを 次のコマンドを使用します。
yum --showduplicates list comp
例:
yum --showduplicates list edge-ui
apigee-setup
を使用してコンポーネントをインストールします。/opt/apigee/apigee-setup/bin/setup.sh -p comp -f configFile
例:
/opt/apigee/apigee-setup/bin/setup.sh -p ui -f configFile
インストール時に指定するのは、バージョンではなく、コンポーネント名のみです。
- ロールバックするコンポーネントをホストするノードごとに、この手順を繰り返します。
Postgres 10.17 の更新をロールバックする
バージョン 4.50.00 または 4.51.00 から 4.52.01 にアップグレードした場合、 Edge コンポーネントに加えて Postgres が更新されます。
マスター / スタンバイ構成で Postgres を更新するときに、Postgres の更新をロールバックするには:
- 新しいスタンバイ ノードを Postgres マスターに昇格させます。新しい Postgres マスターは 前の Edge インストール環境と同じバージョンにする必要があります。
- 古いスタンバイ ノードを新しいマスターのスタンバイ ノードとして構成します。旧スタンバイ ノード 以前の Edge インストールと同じバージョンになります。
- 新しいマスターノードとスタンバイ ノードを、分析グループとコンシューマ グループに登録します。
ロールバックが完了したら、古いマスターノードは必要なくなります。Google Chat では 古いマスターノードを廃止します
- 新しいスタンバイ Postgres ノードが実行されていることを確認します。
/opt/apigee/apigee-service/bin/apigee-all status
Postgres が実行されていない場合は、起動します。
/opt/apigee/apigee-service/bin/apigee-all start
- 旧マスターノードと旧スタンバイ ノードで Postgres が停止していることを確認します。
/opt/apigee/apigee-service/bin/apigee-all status
Postgres が実行中の場合は停止します。
/opt/apigee/apigee-service/bin/apigee-service edge-postgres-server stop > /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql stop
- Qpid がインストールされている場合は、古いスタンバイ ノードで Qpid を起動します。
/opt/apigee/apigee-service/bin/apigee-service edge-qpid-server start
- 新しいスタンバイ ノードを Postgres マスターに昇格させます。
<ph type="x-smartling-placeholder">
- </ph>
- 新しいスタンバイ ノードを新しいマスターに昇格します。
apigee-service apigee-postgresql promote-standby-to-master new_standby_IP
プロンプトが表示されたら、「apigee」の Postgres パスワードを入力します。デフォルトで暗号化されます。 「postgres」です。
- 現在のバージョンの Edge のインストールに使用した構成ファイルを編集して、
次のとおりです。
# IP address of the new master: PG_MASTER=new_standby_IP # IP address of the old standby node PG_STANDBY=old_standby_IP
- 新しいマスターを構成します。
/opt/apigee/apigee-service/bin/apigee-service apigee-postgresql setup-replication-on-master -f configFile
- 新しいスタンバイ ノードを新しいマスターに昇格します。
- 古いスタンバイ ノードをすでに新しいバージョンにアップグレードしている場合は、まず
古いスタンバイ ノードで Apigee ソフトウェアをダウングレードできます。古いバージョンが古いバージョンに残っている場合
必要な場合は、この手順をスキップして手順 6 に進みます。
- 古いスタンバイ ノードで Postgres を停止します。
apigee-service apigee-postgresql stop apigee-service edge-postgres-server stop
- 古いスタンバイ ノードから Postgres をアンインストールします。
apigee-service apigee-postgresql uninstall apigee-service edge-postgres-server uninstall
- 古いスタンバイ ノードから Postgres データ ディレクトリを削除します。
cd /opt/apigee/data/apigee-postgresql/pgdata > rm -rf *
- 古いバージョンのブートストラップ(ローリングする Apigee バージョン用)をダウンロードして実行します。 元のスタンバイ ノードに戻ります。正確な手順は、 オフラインでも設置できます。古いバージョンの Apigee ブートストラップを実行すると、 古いバージョンの Apigee データを使用して yum リポジトリを設定する。
- 古いスタンバイ ノードで Postgres コンポーネントを設定します。
/opt/apigee/apigee-setup/bin/setup.sh -p ps -f configFile
- 古いスタンバイ ノード上の Postgres コンポーネントを確認して検証する
古いバージョンにロールバックされています。
apigee-service apigee-postgresql version apigee-service edge-postgres-server version
- 古いスタンバイ ノードで Postgres を停止します。
- 古いスタンバイ ノードを再ビルドします。
<ph type="x-smartling-placeholder">
- </ph>
- 現在のバージョンの Edge のインストールに使用した構成ファイルを編集して、
次のとおりです。
# IP address of the new master: PG_MASTER=new_standby_IP # IP address of the old standby node PG_STANDBY=old_standby_IP
- 古いスタンバイ ノードのデータ ディレクトリを削除します。
cd /opt/apigee/data/apigee-postgresql/pgdata > rm -rf *
- 古いスタンバイ ノードを再構成して、新しいマスターのスタンバイ ノードにします。
/opt/apigee/apigee-service/bin/apigee-service apigee-postgresql setup-replication-on-standby -f configFile
- Postgres が古いスタンバイ ノードで実行されていることを確認します。
/opt/apigee/apigee-service/bin/apigee-all status
Postgres が実行されていない場合は、起動します。
/opt/apigee/apigee-service/bin/apigee-service edge-postgres-server start
- 現在のバージョンの Edge のインストールに使用した構成ファイルを編集して、
次のとおりです。
- 新しいスタンバイ ノードが追加されたことを確認するには、
新しいマスターの
/opt/apigee/apigee-postgresql/conf/pg_hba.conf
ファイル。 - 次のコマンドを実行して、現在の分析グループとコンシューマ グループの情報を表示します。
Management Server で次のように設定します。
curl -u sysAdminEmail:password http://ms_IP:8080/v1/analytics/groups/ax
このコマンドは、
name
フィールドに分析グループ名を返し、consumer-groups
のname
フィールドにコンシューマ グループ名を指定します。また、 クラスタ内の古い Postgres マスターノードとスタンバイ ノードの UUID が返されます。postgres-server
フィールドとdatastores
フィールドに入力します。次のように表示されます。 次の形式になります。{ "name" : "axgroup-001", "properties" : { }, "scopes" : [ "VALIDATE~test", "sgilson~prod" ], "uuids" : { "qpid-server" : [ "8381a053-433f-4382-bd2a-100fd37a1592", "4b6856ec-ef05-498f-bac6-ef5f0d5f6521" ], "postgres-server" : [ "ab1158bd-1d59-4e2a-9c95-24cc2cfa6edc:27f90844-efab-4b32-8a23-8f85cdc9a256" ] }, "consumer-groups" : [ { "name" : "consumer-group-001", "consumers" : [ "8381a053-433f-4382-bd2a-100fd37a1592", "4b6856ec-ef05-498f-bac6-ef5f0d5f6521" ], "datastores" : [ "ab1158bd-1d59-4e2a-9c95-24cc2cfa6edc:27f90844-efab-4b32-8a23-8f85cdc9a256" ], "properties" : { } } ], "data-processors" : { } }
- 次の
curl
コマンドを実行して、旧マスターの UUID アドレスを取得します。 旧マスターノードを指定します。curl -u sysAdminEmail:password http://node_IP:8084/v1/servers/self
出力の最後に、次の形式でノードの UUID が表示されます。
"type" : [ "postgres-server" ], "uUID" : "599e8ebf-5d69-4ae4-aa71-154970a8ec75"
- 前の手順を繰り返して、古いスタンバイ ノードと新しいスタンバイ ノードの IP アドレスを取得します。 あります。
- 古いマスターノードとスタンバイ ノードをコンシューマ グループから削除します。
curl -u sysAdminEmail:password -X DELETE \ "http://ms_IP:8080/v1/analytics/groups/ax/axgroup-001/consumer-groups/consumer-group-001/datastores/masterUUID,standbyUUID" -v
ここで、axgroup-001 と consumer-group-001 は コンシューマグループなどがあります「masterUUID,standbyUUID」の順序が「同じ」です は、現在の分析グループとコンシューマ グループの情報を表示したときに上に表示されています。マイページ standbyUUID,masterUUID として指定する必要がある場合があります。
consumer-groups
のdatastores
プロパティは次のようになります。 空です。 - 旧マスターノードと旧スタンバイ ノードを分析グループから削除します。
curl -u sysAdminEmail:password -X DELETE \ "http://ms_IP:8080/v1/analytics/groups/ax/axgroup-001/servers?uuid=masterUUID,standbyUUID&type=postgres-server" -v
uuids
のpostgres-server
プロパティが空になっているはずです。 - 新しい PG マスターノードと PG スタンバイ ノードを、分析グループとコンシューマ グループに登録します。
curl -u sysAdminEmail:password -X POST -H "Content-Type: application/json" -d '' "http://ms_IP:8080/v1/analytics/groups/ax/axgroup-001/servers?uuid=masterUUID,standbyUUID&type=postgres-server" -v
curl -u sysAdminEmail:password -X POST -H "Content-Type:application/json" -d '' "http://ms_IP:8080/v1/analytics/groups/ax/axgroup-001/consumer-groups/consumer-group-001/datastores?uuid=masterUUID,standbyUUID" -v
- 分析グループを検証します。
curl -u sysAdminEmail:password http://ms_IP:8080/v1/analytics/groups/ax
新しいマスターノードとスタンバイ ノードの UUID が分析グループに表示されます。 2 つのグループがあります
- Edge Management Server を再起動します。
/opt/apigee/apigee-service/bin/apigee-service edge-management-server restart
- すべての Qpid サーバーを再起動します。
/opt/apigee/apigee-service/bin/apigee-service edge-qpid-server restart
- すべての Postgres サーバーを再起動します。
/opt/apigee/apigee-service/bin/apigee-service edge-postgres-server restart
- 両方のサーバーで次のスクリプトを発行して、レプリケーションのステータスを確認します。システム
両方のサーバーで同じ結果が表示され、レプリケーションが成功していることを確認します。
新しいマスターで、次のコマンドを実行します。
/opt/apigee/apigee-service/bin/apigee-service apigee-postgresql postgres-check-master
マスターであることを確認します。旧スタンバイ ノードで次の操作を行います。
/opt/apigee/apigee-service/bin/apigee-service apigee-postgresql postgres-check-standby
スタンバイであることを確認します。
- 複数の API リクエストを発行した後、前の手順を繰り返し、ノードが 同期できます。
- 次の手順に沿って、古い Postgres マスターを廃止します。
サービスの廃止は
Postgres ノード。
または、旧マスターから Qpid をアンインストールし、 新しいマスターノードに Qpid をインストールします。Qpid をアンインストールした後、 古いマスターノードです。
mTLS をロールバックする
mTLS の更新をロールバックするには、すべてのホストで次の操作を行います。
- Apigee を停止します。
apigee-all stop
- mTLS を停止します。
apigee-service apigee-mtls uninstall
- mTLS を再インストールします。
apigee-service apigee-mtls install
apigee-service apigee-mtls setup -f /opt/silent.conf