Apigee では、Edge for Private Cloud をバージョン 4.52.02 からバージョン 4.53.00 に直接アップグレードできます。このページでは、このようなアップグレードを行う方法について説明します。
互換性のあるアップグレード パスの概要については、Edge for Private Cloud リリースのアップグレード互換性マトリックスをご覧ください。
更新を行えるユーザー
アップデートを実行するユーザーは、Edge を最初にインストールしたユーザーと同じか、root として実行するユーザーである必要があります。
Edge RPM をインストールした後は、すべてのユーザーがそれを構成できます。
更新する必要のあるコンポーネント
すべての Edge コンポーネントを更新する必要があります。Edge は、複数のバージョンのコンポーネントを含む設定をサポートしていません。
更新の前提条件
Apigee Edge をアップグレードする前に、次の前提条件を満たしていることを確認してください。
- すべてのノードをバックアップする
更新する前に、安全上の理由から、すべてのノードの完全バックアップを実行することをおすすめします。現在の Edge バージョンのバックアップ手順に沿ってください。これにより、新しいバージョンへの更新が正常に機能しない場合に備えて、バックアップ プランを用意できます。バックアップの詳細については、バックアップと復元をご覧ください。
- Edge が実行されていることを確認する
更新プロセス中に Edge が稼働していることを確認するには、次のコマンドを使用します。/opt/apigee/apigee-service/bin/apigee-all status
- Cassandra の前提条件を確認する
以前に Edge for Private Cloud の古いバージョンからバージョン 4.52.02 にアップグレードし、今回バージョン 4.53.00 へのアップグレードを計画している場合は、Cassandra のアップグレード後に必要な手順を完了していることを確認してください。これらの手順は、バージョン 4.52.02 のアップグレード ドキュメントに記載されています。また、Cassandra のアップグレードの前提条件にも記載されています。前回のアップグレード時にこれらの手順が完了したかどうかわからない場合は、バージョン 4.53.00 へのアップグレードに進む前に、これらの手順を再度完了してください。
- Edge for Private Cloud 4.53.00 での IDP 鍵と証明書の構成
Edge for Private Cloud 4.53.00 では、
apigee-ssoコンポーネントで使用される IDP 鍵と証明書がキーストアを介して構成されるようになりました。以前に使用した鍵と証明書をキーストアにエクスポートする必要があります。SSO コンポーネントを更新する前に、古いバージョンから Apigee SSO を更新する手順の手順に沿って操作します。 - Python の要件
アップグレードを試みる前に、Cassandra ノードを含むすべてのノードに Python 3 がインストールされていることを確認します。
プロパティ設定の自動伝播
/opt/apigee/customer/application の .properties ファイルを編集してプロパティを設定している場合、これらの値は更新によって保持されます。
Edge-Router での Nginx 1.26 へのアップグレード
以前のバージョンから Edge for Private Cloud 4.53.00 にアップグレードしても、Nginx ソフトウェアは最新バージョン(1.26.x)に自動的にアップグレードされません。これは、Apigee Edge 4.53.00 の Nginx 1.26 の変更に記載されている変更の結果として、ランタイムに意図しない副作用が発生するのを防ぐためです。下位環境で検証した後、Nginx を 1.20.x から 1.26.x に手動でアップグレードできます。手動でアップグレードするには:
edge-router ノードに最新の 4.53.00 ソフトウェアがインストールされていることを確認します。
/opt/apigee/apigee-service/bin/apigee-service edge-router version
現在実行中の Nginx のバージョンを確認する
/opt/nginx/sbin/nginx -V
古いバージョンの Nginx を運用している場合は、次の手順に沿って、ルーターノードで Nginx をバージョン 1.26.X にアップグレードできます。
ルーターノードで edge-router プロセスを停止します。
/opt/apigee/apigee-service/bin/apigee-service edge-router stop
ルーターノードの nginx ソフトウェアをアップグレードする
dnf update apigee-nginx-1.26.3
Nginx のバージョンが更新されていることを確認する
/opt/nginx/sbin/nginx -V
ノードでルーター プロセスを開始する
/opt/apigee/apigee-service/bin/apigee-service edge-router start
各ルーターノードでこのプロセスを 1 つずつ繰り返します。
Cassandra 4.0.13 へのアップグレードが必要
Apigee Edge for Private Cloud 4.53.00 には、Cassandra のバージョン 4.0.13 へのアップグレードが含まれています。
アップグレードとロールバック
- Cassandra 3.11.X から Cassandra 4.0.X へのアップグレードは、スムーズなプロセスです。Edge for Private Cloud 4.53.00 でリリースされた Cassandra 4.0.X は、Private Cloud 4.52.02 のランタイム コンポーネントと管理コンポーネントと互換性があります。
- Cassandra 4.0.X から 3.11.X への直接のインプレース ロールバックはできません。レプリカまたはバックアップを使用したロールバックは複雑な手順であり、ダウンタイムやデータ損失を伴う可能性があります。ロールバックするよりも、問題のトラブルシューティングを行い、Cassandra 4.0.X にアップグレードすることをおすすめします。
- アップグレードを試みる前に、ロールバック手順をよく理解しておくことが重要です。アップグレード中のロールバックのニュアンスを考慮することは、適切なロールバック パスを確実に利用できるようにするために重要です。
単一のデータセンター
単一のデータセンター内で Cassandra を 3.11.X から 4.0.X にアップグレードするのはシームレスですが、ロールバックは複雑で、ダウンタイムやデータ損失が発生する可能性があります。本番環境のワークロードでは、アップグレードを開始する前に、新しいデータセンターで少なくとも Cassandra ノードを使用できるように、新しいデータセンターを追加することを強くおすすめします。これにより、データ損失や API トラフィックの停止を発生させることなく、Cassandra のロールバックが可能になります。この追加のデータセンターは、アップグレードが完了するか、チェックポイント 2 に到達すると、廃止できます。
新しいデータセンターを追加できないが、ロールバック機能が必要な場合は、Cassandra 3.11.X を復元するためにバックアップが必要になります。ただし、この方法ではダウンタイムとデータ損失の両方が発生する可能性があります。
複数のデータセンター
Edge for Private Cloud 4.52.02 で複数のデータセンターを運用すると、Edge for Private Cloud 4.53.00 へのアップグレード中にロールバックをより柔軟に行うことができます。
- ロールバックは、古い Cassandra バージョン(3.11.X)を実行しているデータセンターが少なくとも 1 つ存在することに依存します。
- Cassandra クラスタ全体が 4.0.X にアップグレードされている場合は、Cassandra 3.11.X にロールバックしないでください。Private Cloud 4.53.00 または 4.52.02 の他のコンポーネントで、新しい Cassandra バージョンを引き続き使用する必要があります。
推奨されるアップグレード方法
- Cassandra データセンターを 1 つずつアップグレードする: まず、1 つのデータセンター内で Cassandra ノードを個別にアップグレードします。1 つのデータセンター内のすべての Cassandra ノードのアップグレードを完了してから、次のデータセンターに進みます。
- 一時停止して検証する: 1 つのデータセンターをアップグレードしたら、一時停止して、プライベート クラウド クラスタ(特にアップグレードされたデータセンター)が正しく機能していることを確認します。
- 注意: 以前の Cassandra バージョンにロールバックできるのは、古いバージョンを実行しているデータセンターが少なくとも 1 つある場合のみです。
- 時間制限: 機能を検証するために短期間(数時間を推奨)一時停止することはできますが、バージョンが混在した状態を無期限に維持することはできません。これは、不均一な Cassandra クラスタ(異なるバージョンのノードを含む)には運用上の制限があるためです。
- 徹底的なテスト: Apigee では、次のデータセンターをアップグレードする前に、パフォーマンスと機能の包括的なテストを実施することを強くおすすめします。すべてのデータセンターがアップグレードされると、以前のバージョンにロールバックすることはできません。
2 つのチェックポイント プロセスとしてのロールバック
- チェックポイント 1: 初期状態。すべてのコンポーネントがバージョン 4.52.02 です。少なくとも 1 つの Cassandra データセンターが古いバージョンのままであれば、完全なロールバックが可能です。
- チェックポイント 2: すべてのデータセンターのすべての Cassandra ノードが更新された後。この状態にロールバックすることはできますが、チェックポイント 1 に戻すことはできません。
例
2 つのデータセンター(DC)クラスタについて考えてみましょう。
- 開始状態: 両方の DC の Cassandra ノードがバージョン 3.11.X である。他のすべてのノードは Edge for Private Cloud バージョン 4.52.02 にあります。DC ごとに 3 つの Cassandra ノードがあるとします。
- DC-1 をアップグレードする: DC-1 の 3 つの Cassandra ノードを 1 つずつアップグレードします。
- 一時停止して検証する: 一時停止して、クラスタ(特に DC-1)が正しく動作していることを確認します(パフォーマンス、機能を確認します)。DC-2 の Cassandra ノードを使用して、初期状態にロールバックできます。この一時停止は、Cassandra クラスタのバージョンが混在していることによる制限のため、一時的なものである必要があります。
- DC-2 をアップグレードする: DC-2 の残りの 3 つの Cassandra ノードをアップグレードします。これが新しいロールバック チェックポイントになります。
- 他のコンポーネントをアップグレードする: 通常どおり、すべてのデータセンターで管理ノード、ランタイム ノード、分析ノードをアップグレードします。1 つのノードと 1 つのデータセンターを一度にアップグレードします。問題が発生した場合は、ステップ 4 の状態にロールバックできます。
Cassandra のアップグレードの前提条件
Edge for Private Cloud 4.52.02 で Cassandra 3.11.16 を実行し、次のことを確認する必要があります。- クラスタ全体が Cassandra 3.11.16 で動作し、完全に機能しています。
- コンパクション戦略が
LeveledCompactionStrategyに設定されている(バージョン 4.52.02 へのアップグレードの前提条件)。 - 4.52.02 の Edge for Private Cloud で Cassandra 3.11 の最初のアップグレードの一環として、以下のすべての手順が完了していることを確認します。
post_upgradeコマンドは、前回のアップグレード時に各 Cassandra ノードで実行されている必要があります。drop_old_tablesコマンドは、前回のアップグレード時に Cassandra クラスタ全体で実行されている必要があります。
前の手順が完了したかどうかわからない場合は、安全に再実行できます。4.53.00 へのアップグレードを試みる前に、Edge for Private Cloud 4.52.02 を使用している間に、Cassandra 3.11 で次の手順が実行されていることを確認してください。
- 各 Cassandra ノードで次の
post_upgradeコマンドを 1 つずつ実行します。/opt/apigee/apigee-service/bin/apigee-service apigee-cassandra post_upgrade
- 次のコマンドを実行して、Cassandra クラスタから未使用の古いテーブルを削除します。このコマンドは、クラスタ内の 1 つのノードでのみ実行する必要があります。
/opt/apigee/apigee-service/bin/apigee-service apigee-cassandra drop_old_tables -f configFile
ステップ 1: アップグレードを準備する
以下の手順は、コンポーネントのアップグレードを有効にするための Apigee の標準構成ファイルなど、通常作成する標準ファイルに加えて行うものです。
- Apigee を使用して Cassandra をバックアップします。
- Cassandra ノードの VM スナップショットを取得します(可能な場合)。
- まだ構成されていない場合は、Management Server、Message Processor、Router、Qpid、Postgres などのすべての Edge for Private Cloud コンポーネントから Cassandra ノードへのポート 9042 にアクセスできることを確認します。詳細については、ポートの要件をご覧ください。
ステップ 2: すべての Cassandra ノードをアップグレードする
すべての Cassandra ノードは、各データセンターで 1 つずつ、1 つのデータセンターで 1 つずつ更新する必要があります。データセンター内のノードのアップグレードの間に、数分待って、更新されたノードが完全に起動してクラスタに参加したことを確認してから、同じデータセンター内の別のノードのアップグレードに進みます。
データセンター内のすべての Cassandra ノードをアップグレードしたら、しばらく待ってから(30 分~数時間)、次のデータセンターのノードに進みます。この間に、更新されたデータセンターを徹底的に確認し、Apigee クラスタの機能指標とパフォーマンス指標に問題がないことを確認します。このステップは、Cassandra がバージョン 4.0.X にアップグレードされ、残りの Apigee コンポーネントがバージョン 4.52.02 のままであるデータセンターの安定性を確保するために重要です。
-
Cassandra ノードをアップグレードするには、次のコマンドを実行します。
/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 6.0.0 | Cassandra 4.0.13 | CQL spec 3.4.5 | Native protocol v5] Metadata is verified
-
Cassandra ノードで次の
post_upgradeコマンドを実行します。/opt/apigee/apigee-service/bin/apigee-service apigee-cassandra post_upgrade
-
次の nodetool コマンドを実行して、Cassandra ノードでインデックスを再構築します。
収益化を使用している場合は、収益化キースペースに関連する次のインデックス再構築コマンドも実行します。/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index kms api_products api_products_organization_name_idx
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index kms app_credentials app_credentials_api_products_idx/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index kms app_credentials app_credentials_organization_app_id_idx/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index kms app_credentials app_credentials_organization_name_idx/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index kms app_end_user app_end_user_app_id_idx/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index kms apps apps_app_family_idx/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index kms apps apps_app_id_idx/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index kms apps apps_app_type_idx/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index kms apps apps_name_idx/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index kms apps apps_organization_name_idx/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index kms apps apps_parent_id_idx/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index kms apps apps_parent_status_idx/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index kms apps apps_status_idx/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index kms maps maps_organization_name_idx/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index kms oauth_10_access_tokens oauth_10_access_tokens_app_id_idx/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index kms oauth_10_access_tokens oauth_10_access_tokens_consumer_key_idx/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index kms oauth_10_access_tokens oauth_10_access_tokens_organization_name_idx/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index kms oauth_10_access_tokens oauth_10_access_tokens_status_idx/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index kms oauth_10_request_tokens oauth_10_request_tokens_consumer_key_idx/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index kms oauth_10_request_tokens oauth_10_request_tokens_organization_name_idx/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index kms oauth_10_verifiers oauth_10_verifiers_organization_name_idx/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index kms oauth_10_verifiers oauth_10_verifiers_request_token_idx/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index kms oauth_20_access_tokens oauth_20_access_tokens_app_id_idx/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index kms oauth_20_access_tokens oauth_20_access_tokens_client_id_idx/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index kms oauth_20_access_tokens oauth_20_access_tokens_refresh_token_idx/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index kms oauth_20_authorization_codes oauth_20_authorization_codes_client_id_idx/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index kms oauth_20_authorization_codes oauth_20_authorization_codes_organization_name_idx/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index devconnect companies companies_name_idx/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index devconnect companies companies_organization_name_idx/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index devconnect companies companies_status_idx/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index devconnect company_developers company_developers_company_name_idx/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index devconnect company_developers company_developers_developer_email_idx/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index devconnect company_developers company_developers_organization_name_idx/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index devconnect developers developers_email_idx/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index devconnect developers developers_organization_name_idx/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index devconnect developers developers_status_idx/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index cache cache_entries cache_entries_cache_name_idx/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index audit audits audits_operation_idx/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index audit audits audits_requesturi_idx/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index audit audits audits_responsecode_idx/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index audit audits audits_timestamp_idx/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index audit audits audits_user_idx/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index apimodel_v2 apis a_name/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index apimodel_v2 apis a_org_name/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index apimodel_v2 apis_revision ar_a_active_rev/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index apimodel_v2 apis_revision ar_a_def_index_template/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index apimodel_v2 apis_revision ar_a_def_method_template/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index apimodel_v2 apis_revision ar_a_latest_rev/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index apimodel_v2 apis_revision ar_a_name/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index apimodel_v2 apis_revision ar_a_uuid/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index apimodel_v2 apis_revision ar_base_url/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index apimodel_v2 apis_revision ar_is_active/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index apimodel_v2 apis_revision ar_is_latest/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index apimodel_v2 apis_revision ar_name/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index apimodel_v2 apis_revision ar_org_name/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index apimodel_v2 apis_revision ar_rel_ver/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index apimodel_v2 apis_revision ar_rev_num/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index apimodel_v2 method m_a_name/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index apimodel_v2 method m_api_uuid/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index apimodel_v2 method m_ar_uuid/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index apimodel_v2 method m_base_url/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index apimodel_v2 method m_name/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index apimodel_v2 method m_org_name/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index apimodel_v2 method m_r_name/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index apimodel_v2 method m_r_uuid/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index apimodel_v2 method m_res_path/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index apimodel_v2 method m_rev_num/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index apimodel_v2 resource r_a_name/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index apimodel_v2 resource r_api_uuid/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index apimodel_v2 resource r_ar_uuid/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index apimodel_v2 resource r_base_url/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index apimodel_v2 resource r_name/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index apimodel_v2 resource r_org_name/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index apimodel_v2 resource r_res_path/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index apimodel_v2 resource r_rev_num/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index apimodel_v2 schemas s_api_uuid/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index apimodel_v2 schemas s_ar_uuid/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index apimodel_v2 security sa_api_uuid/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index apimodel_v2 security sa_ar_uuid/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index apimodel_v2 template t_a_name/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index apimodel_v2 template t_a_uuid/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index apimodel_v2 template t_entity/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index apimodel_v2 template t_name/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index apimodel_v2 template t_org_name/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index apimodel_v2 template_auth au_api_uuid/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index dek keys usecase_index/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index mint limits limits_created_date_idx
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index mint limits limits_id_idx/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index mint limits limits_org_id_idx/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index mint limits limits_updated_date_idx/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index mint suspended_developer_products suspended_developer_products_created_date_idx/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index mint suspended_developer_products suspended_developer_products_currency_idx/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index mint suspended_developer_products suspended_developer_products_dev_id_idx/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index mint suspended_developer_products suspended_developer_products_id_idx/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index mint suspended_developer_products suspended_developer_products_limit_id_idx/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index mint suspended_developer_products suspended_developer_products_org_id_idx/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index mint suspended_developer_products suspended_developer_products_prod_id_idx/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index mint suspended_developer_products suspended_developer_products_reason_code_idx/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index mint suspended_developer_products suspended_developer_products_sub_org_id_idx/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index mint invitations invitations_company_id_idx/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index mint invitations invitations_created_at_idx/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index mint invitations invitations_developer_id_idx/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index mint invitations invitations_lastmodified_at_idx/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index mint invitations invitations_org_id_idx/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index taurus triggers triggers_env_idx/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index taurus triggers triggers_job_id_idx/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index taurus triggers triggers_org_id_idx/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index taurus job_details job_details_job_class_name_idx/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index taurus job_details job_details_job_group_idx/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index taurus job_details job_details_job_name_idx/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index taurus org_triggers org_triggers_org_id_idx/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index taurus triggers_suite triggers_suite_group_idx/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index taurus triggers_suite triggers_suite_name_idx/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index taurus triggers_suite triggers_suite_suite_id_idx/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index notification notification_service_item notification_service_item_org_id_idx/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index notification notification_service_item notification_service_item_status_idx/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index notification notification_service_black_list_item notification_service_black_list_item_org_id_idx/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index notification notification_service_black_list_item notification_service_black_list_item_to_email_idx/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index notification notification_email_template_item notification_email_template_item_name_idx/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index notification notification_email_template_item notification_email_template_item_org_id_idx
ステップ 3: すべての管理ノードをアップグレードする
すべてのリージョンのすべての管理ノードを 1 つずつアップグレードします。
/opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile
ステップ 4: すべての Runtime ノードをアップグレードする
すべてのリージョンのすべての Router ノードと Message Processor ノードを 1 つずつアップグレードします。
/opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile
ステップ 5: 残りのすべての Edge for Private Cloud 4.53.00 コンポーネントをアップグレードする
すべてのリージョンで、残りの edge-qpid-server ノードと edge-postgres-server ノードを 1 つずつアップグレードします。
古いバージョンから Apigee SSO を更新する手順
Edge for Private Cloud 4.53.00 では、apigee-sso コンポーネントで使用される IDP 鍵と証明書がキーストアを介して構成されるようになりました。以前に使用した鍵と証明書をキーストアにエクスポートして構成し、通常どおり SSO の更新を進める必要があります。
-
IDP の構成に使用されている既存の鍵と証明書を特定します。
-
SSO インストール構成ファイルで SSO_SAML_SERVICE_PROVIDER_CERTIFICATE の値を検索するか、
apigee-ssoコンポーネントに conf_login_service_provider_certificate をクエリして、証明書を取得します。SSO ノードで次のコマンドを使用して、
apigee-ssoに IDP 証明書パスをクエリします。出力で、最後の行の値を探します。apigee-service apigee-sso configure -search conf_login_service_provider_certificate
-
SSO インストール構成ファイルで SSO_SAML_SERVICE_PROVIDER_KEY の値をルックアップするか、
apigee-ssoコンポーネントで conf_login_service_provider_key をクエリして、鍵を取得します。SSO ノードで次のコマンドを使用して、
apigee-ssoに IDP 鍵パスをクエリします。出力で、最後の行の値を探します。apigee-service apigee-sso configure -search conf_login_service_provider_key
-
-
鍵と証明書をキーストアにエクスポートします。
-
鍵と証明書を PKCS12 キーストアにエクスポートします。
sudo openssl pkcs12 -export -clcerts -in <certificate_path> -inkey <key_path> -out <keystore_path> -name <alias>
パラメータ:
certificate_path: ステップ 1.a で取得した証明書ファイルのパス。key_path: ステップ 1.b で取得した秘密鍵ファイルのパス。keystore_path: 証明書と秘密鍵を含む、新しく作成されたキーストアのパス。alias: キーストア内の鍵と証明書のペアに使用されるエイリアス。
詳しくは、OpenSSL のドキュメントをご覧ください。
-
(省略可)PKCS12 から JKS キーストアに鍵と証明書をエクスポートします。
sudo keytool -importkeystore -srckeystore <PKCS12_keystore_path> -srcstoretype PKCS12 -destkeystore <destination_keystore_path> -deststoretype JKS -alias <alias>
パラメータ:
PKCS12_keystore_path: 手順 2.a で作成した PKCS12 キーストアのパス。証明書と鍵が含まれています。destination_keystore_path: 証明書と鍵がエクスポートされる新しい JKS キーストアのパス。alias: JKS キーストア内の鍵と証明書のペアに使用されるエイリアス。
詳しくは、keytool のドキュメントをご覧ください。
-
鍵と証明書を PKCS12 キーストアにエクスポートします。
- 出力キーストア ファイルの所有者を「apigee」ユーザーに変更します。
sudo chown apigee:apigee <keystore_file>
-
Apigee SSO 構成ファイルに次のプロパティを追加し、キーストア ファイルのパス、パスワード、キーストア タイプ、エイリアスで更新します。
# Path to the keystore file SSO_SAML_SERVICE_PROVIDER_KEYSTORE_PATH=${APIGEE_ROOT}/apigee-sso/source/conf/keystore.jks # Keystore password SSO_SAML_SERVICE_PROVIDER_KEYSTORE_PASSWORD=Secret123 # Password for accessing the keystore # Keystore type SSO_SAML_SERVICE_PROVIDER_KEYSTORE_TYPE=JKS # Type of keystore, e.g., JKS, PKCS12 # Alias within keystore that stores the key and certificate SSO_SAML_SERVICE_PROVIDER_KEYSTORE_ALIAS=service-provider-cert
-
次のコマンドを使用して、通常どおり SSO ノードの Apigee SSO ソフトウェアを更新します。
/opt/apigee/apigee-setup/bin/update.sh -c sso -f /opt/silent.conf
新しい Edge UI
このセクションでは、Edge UI に関する考慮事項について説明します。詳細については、プライベート クラウド用の新しい Edge UI をご覧ください。
Edge UI のインストール
初期インストールが完了したら、Edge UI をインストールすることをおすすめします。これは、Apigee Edge for Private Cloud のデベロッパーと管理者向けの拡張ユーザー インターフェースです。
Edge UI では、基本認証を無効にして、SAML や LDAP などの IDP を使用する必要があります。
詳細については、新しい Edge UI をインストールするをご覧ください。
Apigee mTLS での更新
Apigee mTLS を更新する手順は次のとおりです。
更新のロールバック
更新に失敗した場合は、問題を修正してから update.sh を再度実行してみてください。更新は複数回実行できます。更新は、最後に中断したところから再開されます。
障害により、以前のバージョンに更新をロールバックする必要がある場合は、4.53.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 を更新するタイミングになったら、サーバー(Message Processor / Router)のネットワーク到達性の有効化と無効化の説明に従って、いずれか 1 つの Router を選択して到達不能にします。
- 選択した Router と、その Router と同じマシンにある他のすべての Edge コンポーネントを更新します。すべての Edge 構成で、Router と Message Processor が同じノードに表示されます。
- ルーターを再度到達可能にします。
- 残りのルーターについて、手順 2 ~ 4 を繰り返します。
- インストール環境内の残りのマシンに対して更新を続行します。
更新の前後に次の点に注意してください。
- Router と Message Processor の組み合わせノードの場合:
- 更新前 - 次の操作を行います。
- ルーターに到達できないようにします。
- Message Processor に到達できないようにします。
- 更新後 - 次の操作を行います。
- Message Processor を到達可能にします。
- Router にアクセスできるようにします。
- 更新前 - 次の操作を行います。
- 単一のルーターノードの場合:
- 更新する前に、Router にアクセスできないようにします。
- 更新後、Router にアクセスできるようにします。
- 単一の Message Processor ノードの場合:
- 更新する前に、Message Processor を到達不能にします。
- 更新後、Message Processor を到達可能にします。
サイレント構成ファイルの使用
update コマンドにサイレント構成ファイルを渡す必要があります。サイレント構成ファイルは、Edge for Private Cloud 4.52.02 のインストールに使用したものと同じである必要があります。
外部インターネット接続があるノードで 4.53.00 に更新する
ノード上の Edge コンポーネントを更新する手順は次のとおりです。
- 存在する場合は、更新が完了するまで、Cassandra で修復オペレーションを実行するように構成された
cronジョブを無効にします。 - Edge RPM をインストールするには、root としてノードにログインします。
- Edge apigee-setup ユーティリティのインストールの説明に従って、SELinux を無効にします。
- 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.52.02 を使用している場合:
- Edge
bootstrap_4.53.00.shファイルを/tmp/bootstrap_4.53.00.shにダウンロードします。curl https://software.apigee.com/bootstrap_4.53.00.sh -o /tmp/bootstrap_4.53.00.sh
- 次のコマンドを実行して、Edge 4.53.00
apigee-serviceユーティリティと依存関係をインストールします。sudo bash /tmp/bootstrap_4.53.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 コンポーネントです。有効な値は次のとおりです。
cs: Cassandraedge: Edge UI を除くすべての Edge コンポーネント(Management Server、Message Processor、Router、QPID Server、Postgres Server)ldap: OpenLDAPps: postgresqlqpid: qpiddsso: Apigee SSO(SSO をインストールした場合)ue: 新しい Edge UIui: 従来の Edge UIzk: Zookeeper
- configFile は、4.52.02 のインストール時に 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-management-ui|edge-ui] restart
- インストールのテストの説明に沿って、Management Server で
apigee-validateユーティリティを実行して、更新をテストします。
- Edge
後で更新をロールバックすることにした場合は、4.53.00 のロールバックの手順に沿ってください。
ローカル リポジトリから 4.53.00 に更新する
Edge ノードがファイアウォールの背後にあるか、インターネット経由での Apigee リポジトリ アクセスが禁止されている場合は、Apigee リポジトリのローカル リポジトリ(つまりミラー)から更新を行うことができます。
ローカル Edge リポジトリを作成したら、ローカル リポジトリから Edge を更新する方法が 2 つあります。
- リポジトリの .tar ファイルを作成し、その .tar ファイルをノードにコピーして、.tar ファイルから Edge を更新します。
- ローカル リポジトリを持つノードにウェブサーバーをインストールし、他のノードからアクセスできるようにします。Apigee から提供されているウェブサーバーは Nginx ですが、他のウェブサーバーを使用してもかまいません。
ローカルの 4.53.00 リポジトリから更新するには:
- Edge apigee-setup ユーティリティのインストールの「ローカルに Apigee リポジトリを作成する」の手順で 4.53.00 リポジトリをローカルに作成します。
- .tar ファイルから apigee-service をインストールするには:
- ローカル リポジトリがあるノードで、次のコマンドを使用して、ローカル リポジトリを
/opt/apigee/data/apigee-mirror/apigee-4.53.00.tar.gzという名前の単一の .tar ファイルにパッケージ化します。/opt/apigee/apigee-service/bin/apigee-service apigee-mirror package
- Edge を更新する対象のノードに .tar ファイルをコピーします。たとえば、新しいノードの
/tmpディレクトリにコピーします。 - 新しいノードで、ファイルを
/tmpディレクトリに解凍します。tar -xzf apigee-4.53.00.tar.gz
このコマンドにより、.tar ファイルを含むディレクトリに
reposという名前の新しいディレクトリが作成されます。例:/tmp/repos /tmp/reposから Edgeapigee-serviceユーティリティと依存関係をインストールします。sudo bash /tmp/repos/bootstrap_4.53.00.sh apigeeprotocol="file://" apigeerepobasepath=/tmp/repos
コマンドに repos ディレクトリへのパスが含まれている点に注意してください。
- ローカル リポジトリがあるノードで、次のコマンドを使用して、ローカル リポジトリを
- Nginx ウェブサーバーを使用して apigee-service をインストールするには:
- Edge apigee-setup ユーティリティのインストールの「Nginx ウェブサーバーを使用してリポジトリからインストールする」の手順に沿って、Nginx ウェブサーバーを構成します。
- リモートノードで、Edge
bootstrap_4.53.00.shファイルを/tmp/bootstrap_4.53.00.shにダウンロードします。/usr/bin/curl http://uName:pWord@remoteRepo:3939/bootstrap_4.53.00.sh -o /tmp/bootstrap_4.53.00.sh
ここで、uName:pWord は以前にリポジトリに設定したユーザー名とパスワード、remoteRepo はリポジトリ ノードの IP アドレスまたは DNS 名です。
- リモートノードで、Edge
apigee-setupユーティリティと依存関係をインストールします。sudo bash /tmp/bootstrap_4.53.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 コンポーネントです。通常、次のコンポーネントを更新します。
cs: Cassandraedge: Edge UI を除くすべての Edge コンポーネント(Management Server、Message Processor、Router、QPID Server、Postgres Server)ldap: OpenLDAPps: postgresqlqpid: qpiddsso: Apigee SSO(SSO をインストールした場合)ue新しい Edge UIui: 従来の 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.53.00 のロールバックの手順に沿ってください。
マシンの更新順序
Edge インストールでマシンを更新する順序は重要です。
- 他のノードを更新する前に、すべての Cassandra ノードと ZooKeeper ノードを更新する必要があります。
- 複数の Edge コンポーネント(Management Server、Message Processor、Router、QPID Server。Postgres Server は除く)がインストールされているマシンでは、
-c edgeオプションを使用して、すべてのコンポーネントを同時に更新します。 - 複数のマシンで実行する必要があるステップの場合は、指定されたマシンの順序で実行します。
- Monetization を更新するための個別のステップはありません。
-c edgeオプションを指定すると更新されます。
1 ノード 単体アップグレード
1 ノード スタンドアロン構成を 4.53.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 の 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 コンポーネントを再起動します。
- Classic UI: Classic 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
- Classic UI: Classic 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 コンポーネントを再起動します。
- Classic UI: Classic 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
- Classic UI: Classic 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 コンポーネントを再起動します。
- Classic UI: Classic 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
- Classic UI: Classic 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。つまり、すべてのノードの「-c edge」プロファイル。Qpid サーバー、Edge Postgres Server、Management Server、Message Processor、Router の順にノードをインストールします。
- qpidd
- Edge UI(Classic または New)
apigee-adminapi- Apigee SSO
更新が完了したら、Edge UI コンポーネントを実行しているすべてのマシンで Edge UI コンポーネントを再起動してください。