Apigee Edge 4.16.09 を 4.17.01 に更新する

Edge for Private Cloud v4.17.01

4.17.01 に更新できる Edge のバージョン

次の手順で、Apigee Edge バージョン 4.16.09.0x を 4.17.01 に更新できます。

4.16.01 より前のバージョンの Edge を使用している場合は、まずバージョン 4.16.01.x に移行してから、バージョン 4.17.01 に更新する必要があります。

更新を行えるユーザー

更新を行うユーザーは、最初に Edge をインストールしたユーザーまたは root ユーザーである必要があります。

Edge RPM をインストールした後は、すべてのユーザーがそれを構成できます。

更新する必要のあるコンポーネント

すべての Edge コンポーネントを更新する必要があります。Edge では、コンポーネントのバージョンが混在する設定はサポートされません。

Qpid 1.35 へのアップグレードが必要

このリリースには、Qpid 1.35 への必要な更新が含まれています。Qpid ノードの更新の一環として、次のことを行う必要があります。

  • Qpid ノードのポート 5672 をブロックして、Router と Message Processor が Qpid ノードに一時的に書き込まないようにします。次のコマンドを使用して、Qpid ノードでこのポートをブロックできます。
    > sudo iptables -A INPUT -p tcp --destination-port 5672 !-s `hostname` -i eth0 -j DROP
  • Qpid ノードがメッセージが空になるまで待ってから、更新前に Qpid ノードがすべてのメッセージを処理したことを確認します。次のコマンドを使用して、Qpid メッセージ キューが空であることを確認します。
    > qpid-stat -q
  • Qpid ノードを更新します。
  • Qpid ノードのポート 5672 のブロックを解除して、Router と Message Processor からアクセスできるようにします。次のコマンドを使用して、このポートのブロックを解除できます。
    > sudo iptables -F

    他のルールに iptables を使用している場合は、-D オプションを使用して特定の変更を元に戻すことができます。
    > sudo iptables -D INPUT -p tcp --destination-port 5672 !-s `hostname` -i eth0 -j DROP

このプロセスは、各 Edge トポロジで詳しく説明します。

EPEL リポジトリを有効にするために必要

Edge をインストールまたは更新するには、Extra Packages for Enterprise Linux（EPEL）を有効にする必要があります。使用するコマンドは、RedHat または CentOS のバージョンによって異なります。

  • RedHat/CentOS 7.x の場合:
    > wget https://dl.fedoraproject.org/pub/epel/epel-release-latest-7.noarch.rpm; rpm -ivh epel-release-latest-7.noarch.rpm
  • RedHat/CentOS 6.x の場合:
    wget https://dl.fedoraproject.org/pub/epel/epel-release-latest-6.noarch.rpm; rpm -ivh epel-release-latest-6.noarch.rpm

外部認証を使用する場合に更新する場合は必須

外部ディレクトリ サービスを既存の Apigee Edge Private Cloud 環境に統合できます。この機能は、Active Directory、OpenLDAP など、LDAP をサポートするすべてのディレクトリ サービスで動作するように設計されています。外部 LDAP ソリューションを使用すると、システム管理者は、認証情報を使用する Apigee Edge などのシステムの外部にある一元化されたディレクトリ管理サービスからユーザー認証情報を管理できます。

詳細については、外部認証の構成をご覧ください。

外部認証を有効にすると、ほとんどのお客様は、Edge OpenLDAP サーバーで使用されるメールアドレスではなく、Active Directory SAM アカウント名フィールドを認証のユーザー名として使用します。

外部ディレクトリ サービスと統合している場合は、Edge を 4.17.01 に更新するときに、構成ファイルに次の行を追加します。

IS_EXTERNAL_AUTH="true"

この行により、Edge はユーザー名ではなく、アカウント名を使用するようにユーザー名を構成します。

プロパティ設定の自動伝播

/opt/apigee/customer/application の .properties ファイルを編集してプロパティを設定した場合、それらの値は更新の際にも保持されます。

更新の前提条件

Apigee Edge をアップグレードする前に、次の前提条件を確認してください。

  • すべてのノードをバックアップする
    安全上の理由から、更新する前にすべてのノードの完全なバックアップを行うことをおすすめします。現在の Edge バージョンのバックアップ手順に沿ってください。

    これにより、新しいバージョンへの更新が失敗した場合に備えてバックアップ計画を立てることができます。バックアップの詳細については、バックアップと復元をご覧ください。
  • Edge が実行中であることを確認する
    更新プロセス中に、次のコマンドを使用して Edge が実行中であることを確認します。

    > /opt/apigee/apigee-service/bin/apigee-all status

失敗した更新の処理

アップデートが失敗した場合は、問題を修正してから update.sh を再度実行してください。更新を複数回実行することができ、最後に終了したところから続行されます。

失敗した結果、前のバージョンへのロールバックが必要になった場合は、4.17.01 ロールバック プロセスをご覧ください。

更新情報のロギング

デフォルトでは、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 をロードバランサに再び追加します。

  1. 以下の「マシンの更新順序」に記載された正しい順序でマシンを更新してください。
  2. Router を更新するときには、任意の Router を 1 つ選択し、サーバー（Message Processor または Router）のネットワーク到達性の有効化 / 無効化の説明に従ってその Router を到達不能な状態にします。
  3. 選択した Router と、その Router と同じマシンにあるすべての Edge コンポーネントを更新します。すべての Edge 構成で、同じノードに Router と Message Processor が表示されます。
  4. Router を到達可能な状態に戻します。
  5. 残りのルーターについても、手順 2 ～ 4 を繰り返します。
  6. インストール中の残りのすべてのマシンで更新を続行します。

更新の前後で次の点に注意してください。

  • Router と Message Processor の共存ノード:
    • 更新する前に、以下を行います。
      1. Router を到達不能な状態にします。
      2. Message Processor を到達不能な状態にします。
    • 更新したら、次の操作を行います。
      1. Message Processor を到達可能な状態にします。
      2. Router を到達可能な状態にします。
  • Router 単独のノード:
    • 更新前に、Router を到達不能な状態にします。
    • 更新後に Router を到達可能な状態にします。
  • Message Processor 単独のノード:
    • 更新前に、Message Processor を到達不能な状態にします。
    • 更新後に、Message Processor を到達可能な状態にします。

サイレント構成ファイルの使用

サイレント構成ファイルを更新コマンドに渡す必要があります。サイレント構成ファイルは、Edge 4.16.01 または 4.16.05 のインストールに使用したものと同じである必要があります。

外部インターネット接続があるノードで 4.17.01 に更新する手順

ノードで Edge コンポーネントを更新する手順は次のとおりです。

  1. 更新が完了するまで、Cassandra で修復オペレーションを行うように構成された CRON ジョブがあれば無効にします。
  2. root としてノードにログインし、Edge RPM をインストールします。
    注: RPM のインストールには root 権限が必要ですが、Edge の構成には root 権限は不要です。
  3. Edge apigee-setup ユーティリティのインストールの説明に従って、SELinux を無効にします。
  4. Edge 4.17.01 の bootstrap_4.17.01.sh ファイルを /tmp/bootstrap_4.17.01.sh にダウンロードします。
    > curl https://software.apigee.com/bootstrap_4.17.01.sh -o /tmp/bootstrap_4.17.01.
  5. Edge 4.17.01 の apigee-service ユーティリティと依存関係をインストールします。
    > sudo bash /tmp/bootstrap_4.17.01.sh apigeeuser=uName apigeepassword=pWord

    uName:pWord は Apigee から取得したユーザー名とパスワードです。pWord を省略すると、パスワードの入力を求められます。

    デフォルトでは、インストーラが Java 1.8 の有無を確認します。インストールされていない場合は、自動的にインストールされます。Java インストールの処理方法を指定するには、JAVA_FIX オプションを使用します。JAVA_FIX は次の値を取ります。

    I = OpenJDK 1.8 をインストール（デフォルト）
    C = Java をインストールせずに続行
    Q = 終了。このオプションでは、Java を自分でインストールする必要があります。
  6. （CentOS-6.x と RedHat-6.x のみ）すべての Qpid ノードで次のコマンドを実行し、正しい Qpid バージョンをダウンロードします。
    > yum install apigee-qpidd --disablerepo=epel
  7. apigee-service を使用して apigee-setup ユーティリティを更新します。
    > /opt/apigee/apigee-service/bin/apigee-service apigee-setup update
  8. Management Server の apigee-validate ユーティリティを更新します。
    > /opt/apigee/apigee-service/bin/apigee-service apigee-validate update
  9. apigee-provision ユーティリティを更新します。
    > /opt/apigee/apigee-service/bin/apigee-service apigee-provision update
  10. 以下のアップデートのマシンの更新順序に記載された順序でノードにアップデート ユーティリティを実行します。
    > /opt/apigee/apigee-setup/bin/update.sh -c component -f configFile
    構成ファイルに関する唯一の要件として、構成ファイルが「apigee」ユーザーがアクセス可能または読み取り可能である必要があります。


    「-c」オプションを使用して、更新するコンポーネントを指定します。




    OpenLDAP



    cs = Cassandra

    zk = Zoo
  11. インストールのテストの説明に従って、Management Server で apigee-validate ユーティリティを実行して更新をテストします。

後で更新をロールバックするには、4.16.09 ロールバック プロセスで説明されている手順を行います。

ローカル リポジトリから 4.17.01 に更新する手順

Edge ノードがファイアウォールの内側にあるか、インターネット経由での Apigee リポジトリ アクセスが禁止されている場合は、Apigee リポジトリのローカル リポジトリ（つまりミラー）から更新を行うことができます。

ローカル Edge リポジトリを作成した後、ローカル リポジトリから Edge を更新するには、次の 2 つの方法があります。

  • リポジトリの .tar ファイルを作成してノードにコピーし、その .tar ファイルから Edge を更新します。
  • ローカル リポジトリを持つノードにウェブサーバーをインストールし、他のノードからアクセスできるようにします。Apigee から提供されているウェブサーバーは Nginx ですが、他のウェブサーバーを使用してもかまいません。

ローカルの 4.17.01 リポジトリから更新するには:

  1. Edge apigee-setup ユーティリティのインストールの「ローカルに Apigee リポジトリを作成する」の手順で 4.17.01 リポジトリをローカルに作成します。
    注: 4.16.09 リポジトリがすでに存在する場合は、Edge apigee-setup ユーティリティのインストールの「ローカルの Apigee リポジトリを更新する」の手順に沿って、4.17.01 リポジトリを追加できます。
  2. .tar ファイルから apigee-service をインストールするには:
    1. ローカル リポジトリが存在するノードで次のコマンドを使用し、ローカル リポジトリを /opt/apigee/data/apigee-mirror/apigee-4 .17.01.tar.gz という名前の単一の.tar ファイルにパッケージ化します。
      > /opt/apigee/apigee-service/bin/apigee-service apigee-mirror package
    2. Edge を更新する対象のノードに .tar ファイルをコピーします。たとえば、新しいノードの /tmp ディレクトリにコピーします。
    3. 新しいノードで、tar ファイルを解凍し、/tmp ディレクトリに展開します。
      > tar -xzf apigee-4.17.01.tar.gz

      このコマンドにより、.tar ファイルを含むディレクトリに repos という名前の新しいディレクトリが作成されます。たとえば、/tmp/repos のようになります。
    4. /tmp/repos から Edge apigee-service ユーティリティと依存関係をインストールします。
      > sudo bash /tmp/repos/bootstrap_4.17.01.sh apigeeprotocol="file://" apigeerepobasepath=/tmp/repos

      このコマンドに repos ディレクトリへのパスが含まれていることに注意してください。
  3. Nginx ウェブサーバーを使用して apigee-service をインストールするには:
    1. Edge apigee-setup ユーティリティのインストールの「Nginx ウェブサーバーを使用してリポジトリからインストールする」の手順に沿って、Nginx ウェブサーバーを構成します。
    2. リモートノードで、Edge bootstrap_4.17.01.sh ファイルを /tmp/bootstrap_4.17.01.sh にダウンロードします。
      > /usr/bin/curl http://uName:pWord@remoteRepo:3939/bootstrap.47.17.17.17.01.sh passwordremoteremote:3939/bootstrap.47.17.17.17.01.sh password

    3. リモートノードで、Edge apigee-service ユーティリティと依存関係をインストールします。
      > sudo bash /tmp/bootstrap_4.17.01.sh apigeerepohost=remoteRepo:3939 apigeeuser=uName apigeepassword=pWord apigeeprotocol=http://
      :
      p と <パスワード>
  4. apigee-service を使用して apigee-setup ユーティリティを更新します。
    > /opt/apigee/apigee-service/bin/apigee-service apigee-setup update
  5. Management Server の apigee-validate ユーティリティを更新します。
    > /opt/apigee/apigee-service/bin/apigee-service apigee-validate update
  6. apigee-provision ユーティリティを更新します。
    > /opt/apigee/apigee-service/bin/apigee-service apigee-provision update
  7. ノードの更新ユーティリティを、以下の「マシンの更新順序」に記載された順序で実行します。
    > /opt/apigee/apigee-setup/bin/update.sh -c component -f configFile

    構成ファイルに関する唯一の要件は、構成ファイルが「apigee」ユーザーがアクセス可能または読み取り可能であることです。

    「-c」オプションを使用して、更新するコンポーネントを指定します。




    OpenLDAP



    cs = Cassandra

    zk = Zoo
  8. インストールのテストの説明に従って、Management Server で apigee-validate ユーティリティを実行して更新をテストします。

後で更新をロールバックするには、4.16.09 ロールバック プロセスで説明されている手順を行います。

マシンの更新順序

Edge インストールのマシンを更新する順序は重要です。更新に関する最も重要な考慮事項は次のとおりです。

  • 他のノードを更新する前に、すべての Cassandra ノードと ZooKeeper ノードを更新する必要があります。
  • 複数の Edge コンポーネント（Management Server、Message Processor、Router、QPID Server。Postgres Server は除く）を使用するマシンでは、「-c edge」オプションを使用して、それらをすべて同時に更新します。
  • あるステップが複数のマシンで実行されるように指定した場合は、指定されたマシン順に実行します。
  • 収益化を更新するステップはありません。これは、「-c edge」オプションを指定すると更新されます。
  • （CentOS-6.x と RedHat-6.x のみ）外部インターネット接続があるすべての Qpid ノードで、次のコマンドを実行して正しい Qpid バージョンをダウンロードしました。
    > yum install apigee-qpidd --disablerepo=epel

単一ホストのスタンドアロン インストールの場合

  1. Cassandra と ZooKeeper を更新します。
    > /opt/apigee/apigee-setup/bin/update.sh -c cs,zk -f configFile
  2. iptables ルールを次のように設定します。
    > sudo iptables -A INPUT -p tcp --destination-port 5672 !-s `hostname` -i eth0 -j DROP
  3. Qpid メッセージ キューを確認します。
    > qpid-stat -q

    「msg」列の数が 0 になるまでキューを引き続き確認します。Qpid は、すべてのメッセージを処理するまでアップグレードできません。
  4. qpidd を更新します。
    > /opt/apigee/apigee-setup/bin/update.sh -c qpid -f configFile
  5. iptables をフラッシュします。
    > sudo iptables -F
  6. postgresql を更新します。
    > /opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile
  7. postgresql を起動します。
    > /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql start
  8. LDAP を更新します。
    > /opt/apigee/apigee-setup/bin/update.sh -c ldap -f configFile
  9. 残りの Edge コンポーネントを更新します。
    > /opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile
  10. Edge UI を更新します。
    > /opt/apigee/apigee-setup/bin/update.sh -c ui -f configFile

2 ホスト スタンドアロン インストールの場合

Edge のトポロジとノード番号の一覧については、インストール トポロジをご覧ください。

  1. マシン 1 の Cassandra と ZooKeeper を更新します。
    > /opt/apigee/apigee-setup/bin/update.sh -c cs,zk -f configFile
  2. マシン 2 で次の iptables ルールを設定します。
    > sudo iptables -A INPUT -p tcp --destination-port 5672 !-s `hostname` -i eth0 -j DROP
  3. マシン 2 の Qpid メッセージ キューを確認します。
    > qpid-stat -q

    「msg」列の数が 0 になるまでキューの確認を続けます。Qpid は、すべてのメッセージを処理するまでアップグレードできません。
  4. マシン 2 の qpidd を更新します。
    > /opt/apigee/apigee-setup/bin/update.sh -c qpid -f configFile
  5. マシン 2 の iptables をフラッシュします。
    > sudo iptables -F
  6. マシン 2 の postgresql を更新します。
    > /opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile
  7. マシン 2 で postgresql を起動します。
    > /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql start
  8. マシン 1 の LDAP を更新します。
    > /opt/apigee/apigee-setup/bin/update.sh -c ldap -f configFile
  9. マシン 2 と 1 の Edge コンポーネントを更新します。
    > /opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile
  10. マシン 1 の UI を更新します。
    > /opt/apigee/apigee-setup/bin/update.sh -c ui -f configFile

5 ホストクラスタ インストールの場合

Edge のトポロジとノード番号の一覧については、インストール トポロジをご覧ください。

  1. マシン 1、2、3 の Cassandra と ZooKeeper を更新します。
    > /opt/apigee/apigee-setup/bin/update.sh -c cs,zk -f configFile
  2. マシン 4 で次の iptables ルールを設定します。
    > sudo iptables -A INPUT -p tcp --destination-port 5672 !-s `hostname` -i eth0 -j DROP
  3. マシン 4 の Qpid メッセージ キューを確認します。
    > qpid-stat -q

    「msg」列の数が 0 になるまでキューの確認を続けます。Qpid は、すべてのメッセージを処理するまでアップグレードできません。
  4. マシン 4 の qpidd を更新します。
    > /opt/apigee/apigee-setup/bin/update.sh -c qpid -f configFile
  5. マシン 4 の iptables をフラッシュする:
    > sudo iptables -F
  6. マシン 5 でステップ 2 ～ 5 を繰り返します。
  7. マシン 4 の postgresql を更新します。
    > /opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile
  8. マシン 4 で postgresql を起動します。
    > /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql start
  9. マシン 5 でステップ 7 と 8 を繰り返します。
  10. マシン 1 の LDAP を更新します。
    > /opt/apigee/apigee-setup/bin/update.sh -c ldap -f configFile
  11. マシン 4、5、1、2、3 の Edge コンポーネントを更新します。
    > /opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile
  12. マシン 1 の UI を更新します。
    > /opt/apigee/apigee-setup/bin/update.sh -c ui -f configFile

9 ホストクラスタ インストールの場合

Edge のトポロジとノード番号の一覧については、インストール トポロジをご覧ください。

  1. マシン 1、2、3 の Cassandra と ZooKeeper を更新します。
    > /opt/apigee/apigee-setup/bin/update.sh -c cs,zk -f configFile
  2. マシン 6 で次の iptables ルールを設定します。
    > sudo iptables -A INPUT -p tcp --destination-port 5672 !-s `hostname` -i eth0 -j DROP
  3. マシン 6 の Qpid メッセージ キューを確認します。
    > qpid-stat -q

    「msg」列の数が 0 になるまでキューの確認を続けます。Qpid は、すべてのメッセージを処理するまでアップグレードできません。
  4. マシン 6 の qpidd を更新します。
    > /opt/apigee/apigee-setup/bin/update.sh -c qpid -f configFile
  5. マシン 6 の iptables をフラッシュする:
    > sudo iptables -F
  6. マシン 7 でステップ 2 ～ 5 を繰り返します。
  7. マシン 6 の postgresql を更新します。
    > /opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile
  8. マシン 6 で postgresql を起動します。
    > /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql start
  9. マシン 7 でステップ 7 と 8 を繰り返します。
  10. マシン 1 の LDAP を更新します。
    > /opt/apigee/apigee-setup/bin/update.sh -c ldap -f configFile
  11. マシン 6、7、8、9、1、4、5 の Edge コンポーネントを次の順序で更新します。
    > /opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile
  12. マシン 1 の UI を更新します。
    > /opt/apigee/apigee-setup/bin/update.sh -c ui -f configFile

13 ホストクラスタ インストールの場合

Edge のトポロジとノード番号の一覧については、インストール トポロジをご覧ください。

  1. マシン 1、2、3 の Cassandra と ZooKeeper を更新します。
    > /opt/apigee/apigee-setup/bin/update.sh -c cs,zk -f configFile
  2. マシン 12 で次の iptables ルールを設定します。
    > sudo iptables -A INPUT -p tcp --destination-port 5672 !-s `hostname` -i eth0 -j DROP
  3. マシン 12 の Qpid メッセージ キューを確認します。
    > qpid-stat -q

    「msg」列の数が 0 になるまでキューの確認を続けます。Qpid は、すべてのメッセージを処理するまでアップグレードできません。
  4. マシン 12 の qpidd を更新します。
    > /opt/apigee/apigee-setup/bin/update.sh -c qpid -f configFile
  5. マシン 12 の iptables をフラッシュする:
    > sudo iptables -F
  6. マシン 13 でステップ 2 ～ 5 を繰り返します。
  7. マシン 12 の postgresql を更新します。
    > /opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile
  8. マシン 12 で postgresql を起動します。
    > /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql start
  9. マシン 13 でステップ 7 と 8 を繰り返します。
  10. マシン 4 と 5 の LDAP を更新します。
    > /opt/apigee/apigee-setup/bin/update.sh -c ldap -f configFile
  11. マシン 12、13、8、9、6、7、10、11 の Edge コンポーネントを次の順序で更新します。
    > /opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile
  12. マシン 6 と 7 の UI を更新します。
    > /opt/apigee/apigee-setup/bin/update.sh -c ui -f configFile

12 ホストクラスタ インストールの場合

Edge のトポロジとノード番号の一覧については、インストール トポロジをご覧ください。

  1. Cassandra と ZooKeeper を更新します。
    1. データセンター 1 のマシン 1、2、3:
      > /opt/apigee/apigee-setup/bin/update.sh -c cs,zk -f configFile
    2. データセンター 2 のマシン 7、8、9 で次のコマンドを実行します。
      > /opt/apigee/apigee-setup/bin/update.sh -c cs,zk -f configFile
  2. qpidd を更新します。
    1. データセンター 1 のマシン 4、5 で、
      1. マシン 4 で次の iptables ルールを設定します。
        > sudo iptables -A INPUT -p tcp --destination-port 5672 !-s `hostname` -i eth0 -j DROP
      2. マシン 4 の Qpid メッセージ キューを確認します。
        > qpid-stat -q

        「msg」列の数が 0 になるまでキューの確認を続けます。Qpid は、すべてのメッセージを処理するまでアップグレードできません。
      3. マシン 4 の qpidd を更新します。
        > /opt/apigee/apigee-setup/bin/update.sh -c qpid -f configFile
      4. マシン 4 の iptables をフラッシュする:
        > sudo iptables -F
      5. マシン 5 でステップ 1 ～ 4 を繰り返します。
    2. データセンター 2 のマシン 10、11
      1. マシン 10 で次の iptables ルールを設定します。
        > sudo iptables -A INPUT -p tcp --destination-port 5672 !-s `hostname` -i eth0 -j DROP
      2. マシン 10 の Qpid メッセージ キューを確認します。
        > qpid-stat -q

        「msg」列の数が 0 になるまでキューの確認を続けます。Qpid は、すべてのメッセージを処理するまでアップグレードできません。
      3. マシン 10 の qpidd を更新します。
        > /opt/apigee/apigee-setup/bin/update.sh -c qpid -f configFile
      4. マシン 10 の iptables をフラッシュする:
        > sudo iptables -F
      5. マシン 11 でステップ 1 ～ 4 を繰り返します。
  3. postgresql を更新します。
    1. データセンター 1 のマシン 6
      > /opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile
      > /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql start
    2. データセンター 2 のマシン 12
      > /opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile
      > /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql start
  4. LDAP を更新します。
    1. データセンター 1 のマシン 1
      > /opt/apigee/apigee-setup/bin/update.sh -c ldap -f configFile
    2. データセンター 2 のマシン 7
      > /opt/apigee/apigee-setup/bin/update.sh -c ldap -f configFile
  5. Edge コンポーネントを更新します。
    1. データセンター 1 のマシン 4、5、6、1、2、3
      > /opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile
    2. データセンター 2 のマシン 10、11、12、7、8、9
      > /opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile
  6. UI を更新します。
    1. データセンター 1 のマシン 1:
      > /opt/apigee/apigee-setup/bin/update.sh -c ui -f configFile
    2. データセンター 2 のマシン 7:
      > /opt/apigee/apigee-setup/bin/update.sh -c ui -f configFile

7 ホストの API BaaS のインストールの場合

アップグレード手順を実行する前に、構成ファイルに 2 つの新しいプロパティを追加する必要があります。

# For a single data center, specify the same value as BAAS_CASS_LOCALDC.
BAAS_CASS_DC_LIST="dc-1"

# Defines the initial contact points for members of the BaaS cluster. 
# Specify the IP address of no more than two Stack nodes. 
BAAS_CLUSTER_SEEDS="dc-1:$IP4,dc-1:$IP5"

構成ファイルの例については、API BaaS のインストールをご覧ください。

また、他のすべての Stack ノードからアクセスできるように、すべての Stack ノードでポート 2551 が開いている必要があります。

Edge のトポロジとノード番号の一覧については、インストール トポロジをご覧ください。

  1. マシン 5、6、7 の Cassandra を更新します。
    > /opt/apigee/apigee-setup/bin/update.sh -c cs -f configFile

  2. マシン 1、2、3 の ElasticSearch と API BaaS Stack を更新します。
    > /opt/apigee/apigee-setup/bin/update.sh -c e,b -f configFile

  3. マシン 4 の API BaaS ポータルを更新します。
    > /opt/apigee/apigee-setup/bin/update.sh -c p -f configFile

10 ホストの API BaaS インストールの場合

アップグレード手順を実行する前に、構成ファイルに 2 つの新しいプロパティを追加する必要があります。

# For a single data center, specify the same value as BAAS_CASS_LOCALDC.
BAAS_CASS_DC_LIST="dc-1"

# Defines the initial contact points for members of the BaaS cluster. 
# Specify the IP address of no more than two Stack nodes. 
BAAS_CLUSTER_SEEDS="dc-1:$IP4,dc-1:$IP5"

構成ファイルの例については、API BaaS のインストールをご覧ください。

また、他のすべての Stack ノードからアクセスできるように、すべての Stack ノードでポート 2551 が開いている必要があります。

Edge のトポロジとノード番号の一覧については、インストール トポロジをご覧ください。

  1. マシン 8、9、10 の Cassandra を更新します。
    > /opt/apigee/apigee-setup/bin/update.sh -c cs -f configFile
  2. マシン 1、2、3 の ElasticSearch を更新します。
    > /opt/apigee/apigee-setup/bin/update.sh -c e -f configFile
  3. マシン 4、5、6 の API BaaS Stack を更新します。
    > /opt/apigee/apigee-setup/bin/update.sh -c b -f configFile
  4. マシン 7 の API BaaS ポータルを更新します。
    > /opt/apigee/apigee-setup/bin/update.sh -c p -f configFile

標準以外のインストールの場合

標準以外のインストールの場合は、次の順序で Edge コンポーネントを更新します。

  1. ZooKeeper
  2. Cassandra
  3. qpidd、ps
  4. LDAP
  5. Edge。つまり、Qpid Server、Postgres Server、Management Server、Message Processor、Router があるすべてのノードの「-c edge」プロファイルを、この順序で並べます。
    注: ノードに Qpid サーバーと Postgres サーバーの両方がインストールされている場合は、「-c edge」プロファイルの手順を実行します。
  6. Edge UI