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-gateway
  • edge-management-server
  • edge-message-processor
  • edge-postgres-server
  • edge-qpid-server
  • edge-router
  • nginx

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

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

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

Edge 4.50.00 の手順

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

-- 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 の手順

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

-- 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-gateway
    • edge-management-server
    • edge-message-processor
    • edge-postgres-server
    • edge-qpid-server
    • edge-router

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

    --apigee-service component stop

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

    -- sudo yum downgrade

    次に例を示します。

    gateway と 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 をダウングレードするには、Edge Router で次の手順を 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