Apigee Edge 4.50.00 のロールバック

Edge 4.50.00 への更新中にエラーが発生した場合は、エラーの原因となったコンポーネントをロールバックしてから、更新を再試行できます。

Edge 4.50.00 は、次の機能リリース バージョンにロールバックできます。

  • バージョン 4.19.06
  • バージョン 4.19.01
  • バージョン 4.18.05

ロールバックが必要になるシナリオは次の 2 つです。

  1. 以前の機能リリースにロールバックする。たとえば、4.50.00 から 4.18.05 にダウングレードします。
  2. 同じリリースの以前の更新バージョンにロールバックする。たとえば、4.19.01.02 から 4.19.01.01 にダウングレードします。

詳細については、Apigee Edge のリリース プロセスをご覧ください。

ロールバックを実行できるユーザー

ロールバックを実行するユーザーは、Edge を最初に更新したユーザー、または root として実行しているユーザーと同じである必要があります。

デフォルトでは、Edge コンポーネントはユーザー「apigee」として実行されます。場合によっては、Edge コンポーネントを別のユーザーとして実行することがあります。たとえば、Router が 1000 未満の特権ポートにアクセスする必要がある場合は、Router を root として、またはそれらのポートにアクセスできるユーザーとして実行する必要があります。また、1 つのコンポーネントを 1 人のユーザーとして実行し、別のコンポーネントを別のユーザーとして実行することもできます。

共通コードを含むコンポーネント

次の Edge コンポーネントは共通のコードを共有しています。したがって、ノード上のこれらのコンポーネントのいずれかをロールバックするには、そのノード上にあるこれらのコンポーネントをすべてロールバックする必要があります。

  • edge-management-server（Management Server）
  • edge-message-processor（Message Processor）
  • edge-router（ルーター）
  • edge-postgres-server（Postgres サーバー）
  • edge-qpid-server（Qpid サーバー）

たとえば、Management Server、Router、Message Processor がノードにインストールされている場合、そのうちの 1 つをロールバックするには、3 つすべてをロールバックする必要があります。

以前の機能リリースにロールバックする

以前の機能リリースにロールバックするには、コンポーネントをホストする各ノードで次の操作を行います。

  1. ロールバックするバージョンの bootstrap.sh ファイルをダウンロードします。

    • 4.19.06 にロールバックするには、bootstrap_4.19.06.sh をダウンロードします。
      curl https://software.apigee.com/bootstrap_4.19.06.sh -o /tmp/bootstrap_4.19.06.sh
    • 4.19.01 にロールバックするには、bootstrap_4.19.01.sh をダウンロードします。
      curl https://software.apigee.com/bootstrap_4.19.01.sh -o /tmp/bootstrap_4.19.01.sh
    • 4.18.05 にロールバックするには、bootstrap_4.18.05.sh をダウンロードします。
      curl https://software.apigee.com/bootstrap_4.18.05.sh -o /tmp/bootstrap_4.18.05.sh
  2. ロールバックするコンポーネントを停止します。
    1. ノード上の共通コードを含むコンポーネントをロールバックするには、次の例に示すように、すべてのコンポーネントを停止する必要があります。
      /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
    2. ノード上の他のコンポーネントをロールバックするには、そのコンポーネントのみを停止します。 
      • /opt/apigee/apigee-service/bin/apigee-service component stop
  3. Monetization をロールバックする場合は、すべての Management Server ノードと Message Processor ノードからアンインストールします。
    /opt/apigee/apigee-service/bin/apigee-service edge-mint-gateway uninstall
  4. ノードでロールバックするコンポーネントをアンインストールします。
    1. ノード上の共通コードを含むコンポーネントをロールバックするには、次の例に示すように、edge-gateway コンポーネント グループをアンインストールして、すべてをアンインストールする必要があります。
      /opt/apigee/apigee-service/bin/apigee-service edge-gateway uninstall
    2. ノード上の他のコンポーネントをロールバックするには、次の例に示すように、そのコンポーネントのみをアンインストールします。
      /opt/apigee/apigee-service/bin/apigee-service component uninstall

      ここで、component はコンポーネント名です。

    3. Edge Router をロールバックするには、edge-gateway コンポーネント グループをアンインストールするだけでなく、/opt/nginx/conf.d ファイルの内容を削除する必要があります。
      cd /opt/nginx/conf.d
rm -rf *
  5. 4.50.00 バージョンの apigee-setup をアンインストールします。
    /opt/apigee/apigee-service/bin/apigee-service apigee-setup uninstall
  6. apigee-service ユーティリティのバージョン 4.19.01 または 4.18.05 とその依存関係をインストールします。次の例では、4.18.05 バージョンの apigee-service をインストールします。
    sudo bash /tmp/bootstrap_4.18.05.sh apigeeuser=uName apigeepassword=pWord

    ここで、uName と pWord は Apigee から受け取ったユーザー名とパスワードです。pWord を省略すると、入力するよう求められます。

    エラーが発生した場合は、ステップ 1 で bootstrap.sh ファイルをダウンロードしたことを確認してください。

  7. apigee-setup のインストール: 
    /opt/apigee/apigee-service/bin/apigee-service apigee-setup install
  8. 古いバージョンのコンポーネントをインストールします。
    /opt/apigee/apigee-setup/bin/setup.sh -p component -f configFile

    ここで、component はインストールするコンポーネント、configFile は古いバージョンの構成ファイルです。

  9. Qpid をロールバックする場合は、iptables をフラッシュします。
    sudo iptables -F
  10. ロールバックするコンポーネントをホストするノードごとに、このプロセスを繰り返します。

以前のアップデート バージョンにロールバックする

コンポーネントを特定のバージョンのリリースにロールバックするには、コンポーネントをホストする各ノードで次の操作を行います。

  1. 特定のコンポーネント バージョンをダウンロードします。
    /opt/apigee/apigee-service/bin/apigee-service component_version install

    ここで、component_version はインストールするコンポーネントと更新バージョンです。例:

    /opt/apigee/apigee-service/bin/apigee-service edge-ui-4.18.05-0.0.3749 install

    Apigee オンライン リポジトリを使用している場合は、次のコマンドを使用して、使用可能なコンポーネントのバージョンを確認できます。

    yum --showduplicates list comp

    次に例を示します。

    yum --showduplicates list edge-ui
  2. apigee-setup を使用してコンポーネントをインストールします。
    /opt/apigee/apigee-setup/bin/setup.sh -p comp -f configFile

    次に例を示します。

    /opt/apigee/apigee-setup/bin/setup.sh -p ui -f configFile

    インストール時に指定するのはコンポーネント名のみで、バージョンは指定しません。

  3. ロールバックするコンポーネントをホストするノードごとに、このプロセスを繰り返します。