4.16.05 ロールバック プロセス

Edge for Private Cloud v. 4.16.05

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

  1. 古いリリースにロールバックする。たとえば、4.16.05 から 4.16.01 にダウングレードします。
  2. 同じリリースの古いバージョンにロールバックする。

以下の手順に沿って、両方のシナリオでロールバックを行います。

ロールバックを行えるユーザー

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

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

ロールバックできるコンポーネント

ロールバックを実行する際は、次の条件に注意してください。

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

    5 つのコンポーネントは次のとおりです。
    • 管理サーバー
    • ルーター
    • Message Processor
    • Qpid サーバー
    • Postgres サーバー
  • Cassandra をロールバックしないでください。このリリースの Edge には、4.16.01 リリースと互換性のある Cassandra の更新バージョンが含まれています。コンポーネントをロールバックする場合は、Cassandra を 4.16.05 バージョンのままにして、最新の機能を利用できるようにします。
  • このリリースには、postgresql または qpidd の新しいバージョンは含まれていません。したがって、ロールバックする必要はありません。

4.16.05 をロールバックするには

Apigee Edge をロールバックするには、次のロールバック手順を行います。

  1. ロールバックするコンポーネントを停止します。
    1. 次のコンポーネントのいずれかをロールバックする場合は、Management Server、Router、Message Processor、Qpid Server、Postgres Server のすべてを停止する必要があります。
      > apigee-service edge-management-server stop
      > apigee-service edge-router stop
      > apigee-service edge-message-processor stop
      > apigee-service edge-qpid-server stop
      > apigee-service edge-postgres-server stop
    2. 他のコンポーネントをロールバックする場合は、そのコンポーネントのみを停止します。
      > apigee-service comp stop
  2. 収益化をロールバックする場合は、アンインストールします。
    > apigee-service edge-mint-gateway uninstall
  3. コンポーネントをアンインストールしてロールバックします。
    1. Management Server、Router、Message Processor、Qpid Server、Postgres Server のいずれかのコンポーネントをロールバックする場合は、それらをすべてアンインストールします。
      > apigee-service edge-gateway uninstall
    2. 他のコンポーネントをロールバックする場合は、そのコンポーネントのみをアンインストールします。
      > apigee-service comp uninstall
  4. Router をロールバックする場合は、/opt/nginx/conf.d の内容を削除する必要があります。
    > cd /opt/nginx/conf.d
    > rm -rf *
  5. コンポーネントを 4.16.01 リリースにロールバックするには：
    1. 4.16.05 バージョンの apigee-setup をアンインストールします。
      > /opt/apigee/apigee-service/bin/apigee-service apigee-setup uninstall
    2. 4.16.01 リリースの bootstrap.sh をダウンロードします。
      > curl https://software.apigee.com/bootstrap.sh -o /tmp/bootstrap.sh
    3. 4.16.01 Edge apigee-service ユーティリティと依存関係をインストールします。
      > sudo bash /tmp/bootstrap.sh apigeeuser=uName apigeepassword=pWord
      ここで、uName と pWord は Apigee から受け取ったユーザー名とパスワードです。pWord を省略すると、入力を求められます。
    4. apigee-setup のバージョン 4.16.01 をインストールします。
      > /opt/apigee/apigee-service/bin/apigee-service apigee-setup install
    5. コンポーネントのバージョン 4.16.01 をインストールします:
      > /<instal_dir>/apigee/apigee-setup/bin/setup.sh -p comp -f configFile
      ここで、comp はインストールするコンポーネント、configFile は 4.16.01 の構成ファイルです。
  6. コンポーネントを 4.16.05 リリースの特定のバージョンにロールバックするには:
    1. 特定のコンポーネント バージョンをダウンロードします。
      > /<instal_dir>/apigee/apigee-service/bin/apigee-service comp-version install
      ここで、comp-version は、インストールするコンポーネントとバージョンです。例:
      > /<instal_dir>/apigee/apigee-service/bin/apigee-service edge-ui-4.16.05-0.0.3649 install
      Apigee オンライン リポジトリを使用している場合は、次のコマンドを使用して、使用可能なコンポーネントのバージョンを確認できます。
      > yum --showduplicates list comp
      例:
      > yum --showduplicates list edge-ui
    2. apigee-setup を使用してコンポーネントをインストールします。
      > /<install_dir>/apigee/apigee-setup/bin/setup.sh -p comp -f configFile
      例:
      > /<install_dir>/apigee/apigee-setup/bin/setup.sh -p ui -f configFile
      インストール時にコンポーネント名のみを指定する方法に注意してください。

ロールバック時に問題が発生した場合は、Apigee サポートにお問い合わせください。