Apigee コンポーネントと NGINX のダウングレード

現在、Apigee Edge のドキュメントを表示しています。
Apigee X のドキュメントをご確認ください
情報

2021 年 3 月のパッチリリース

Apigee 本番環境リポジトリに push された Edge for Private Cloud の 2021 年 3 月のパッチリリースの RPM に、apigee-nginx-1.18 の依存関係が意図せず更新されていました。その結果、リポジトリから RPM を削除し、正しい RPM に置き換えました。無効な RPM は、2021 年 3 月 25 日の午前 8 時 45 分から午後 3 時 45 分(太平洋標準時)の間、リポジトリに保存されました。 この日に Edge RPM をダウンロードしてインストールした場合は、次の Apigee コンポーネントを以前のバージョンにダウングレードする必要があります。

  • エッジ ゲートウェイ
  • エッジ管理サーバー
  • Edge メッセージ プロセッサ
  • edge-postgres-server
  • エッジ qpid-server
  • エッジルーター
  • nginx

以降のセクションでは、ダウングレードが必要かどうかを確認する方法と、必要に応じて Apigee コンポーネントをダウングレードする方法について説明します。

ダウングレードが必要かどうかを確認する

Apigee コンポーネントまたは NGINX をダウングレードする必要があるかどうかを確認するには、Edge for Private Cloud 4.50.00 と 4.19.06 のどちらを使用しているかに応じて、次のいずれかの手順を行います。

Edge 4.50.00 での手順

各ノードで、次のコマンドを入力してゲートウェイのバージョンを確認します。

-- apigee-service edge-gateway version

edge-gateway のバージョン番号が次の場合:

  • 20113 未満であれば、特に何もする必要はありません。
  • 20113 に相当し、Apigee コンポーネントNGINX をダウングレードする必要があります。
  • 20113 より大きい場合は、次のように入力して NGINX のバージョンを確認します。
    -- sudo yum list installed apigee-nginx

    コマンドの出力例を次に示します。

    Installed Packages
    apigee-nginx.x86_64 1.18.0-1.el7
    @apigee-thirdparty

    NGINX バージョンが apigee-nginx.x86_64 1.18.0-XXX の場合は、NGINX をダウングレードすることのみが必要です。

Edge 4.19.06 での手順

各ノードで、次のコマンドを入力してゲートウェイのバージョンを確認します。

-- apigee-service edge-gateway version

edge-gateway のバージョン番号が次の場合:

  • 20114 未満であれば、特に何もする必要はありません。
  • 20114 に相当し、Apigee コンポーネントをダウングレードし、NGINX をダウングレードする必要があります。
  • 20114 より大きい場合は、次のコマンドを入力して NGINX のバージョンを確認します。
    -- sudo yum list installed apigee-nginx

    コマンドの出力例を次に示します。

    Installed Packages
    apigee-nginx.x86_64 1.18.0-1.el7
    @apigee-thirdparty

    NGINX バージョンが apigee-nginx.x86_64 1.18.0-XXX の場合は、NGINX をダウングレードすることのみが必要です。

    ダウングレードするコンポーネント

    次のリストにある RPM のいずれかをインストールしている場合は、その RPM を以前のバージョンにダウングレードする必要があります。

    Edge for Private Cloud 4.50.00 にダウングレードするコンポーネント

    edge-gateway-4.50.00-0.0.20113.noarch.rpm
    edge-management-server-4.50.00-0.0.20113.noarch.rpm
    edge-message-processor-4.50.00-0.0.20113.noarch.rpm
    edge-postgres-server-4.50.00-0.0.20113.noarch.rpm
    edge-qpid-server-4.50.00-0.0.20113.noarch.rpm
    edge-router-4.50.00-0.0.20113.noarch.rpm

    Edge for Private Cloud 4.19.06 にダウングレードするコンポーネント

    edge-gateway-4.19.06-0.0.20114.noarch.rpm
    edge-management-server-4.19.06-0.0.20114.noarch.rpm
    edge-message-processor-4.19.06-0.0.20114.noarch.rpm
    edge-postgres-server-4.19.06-0.0.20114.noarch.rpm
    edge-qpid-server-4.19.06-0.0.20114.noarch.rpm
    edge-router-4.19.06-0.0.20114.noarch.rpm

    これらの RPM がインストールされているかどうかを確認するには、上記のリスト内のいずれかのコンポーネントがインストールされている各ノードで、コンポーネントごとに次のコマンドを入力します。

    -- apigee-service component version

    Apigee コンポーネントのダウングレード

    Apigee コンポーネントをダウングレードするには、次の操作を行います。

    次のいずれかのコンポーネントがインストールされている各ノード:

    • エッジ ゲートウェイ
    • エッジ管理サーバー
    • Edge メッセージ プロセッサ
    • edge-postgres-server
    • エッジ qpid-server
    • エッジルーター

    次のコマンドを入力してコンポーネントを停止します。

    --apigee-service component stop

    コンポーネントをダウングレードします。

    -- sudo yum downgrade 

    以下に例を挙げます。

    ゲートウェイと Edge-Message- Processor がインストールされている場合:

    -- sudo yum downgrade edge-gateway edge-message-processor

    ゲートウェイとエッジルーターがインストールされている場合:

    -- sudo yum downgrade edge-gateway edge-router

    AIO がセットアップされた場合:

    -- sudo yum downgrade edge-gateway edge-postgres-server edge-router edge-management-server edge-message-processor edge-qpid-server

    ダウングレードが完了したら、コンポーネントごとに configure を実行して再起動します。

    --apigee-service  component configure
    --apigee-service  component start

    ダウングレード後に作成される RPM の正しいバージョンは、以下のとおりです。

    Edge for Private Cloud 4.50.00

    edge-gateway-4.50.00-0.0.20110
    Edge-management-server-4.50.00-0.0.20110
    edge-message-processor-4.50.00-0.0.20110
    edge-postgres-server-4.50.00-0.0.20110
    edge-qpid-server-4.50.00-0.0.20110
    edge-router-4.50.00-0.0.20110

    Edge for Private Cloud 4.19.06

    edge-gateway-4.19.06-0.0.20112
    Edge-management-server-4.19.06-0.0.20112
    edge-message-processor-4.19.06-0.0.20112
    edge-postgres-server-4.19.06-0.0.20112
    edge-qpid-server-4.19.06-0.0.20112
    edge-router-4.19.06-0.0.20112

    NGINX のダウングレード

    apigee-nginx をダウングレードするには、一度に 1 つずつエッジルーターで次の操作を行います。

    1. ルーターを停止します。
      --apigee-service edge-router stop
    2. apigee-ngix をダウングレードします。
       -- sudo yum downgrade apigee-nginx
      ダウングレード後に想定される apigee-nginx バージョン:
      -- yum list installed apigee-nginx
      apigee-nginx.x86_64 -1.16.1-6.el7
    3. ルーターを構成します。
      apigee-service edge-router configure
    4. ルーターを起動します。
      apigee-service edge-router start