Apigee Edge 4.16.09 を 4.17.09 に更新する

Edge for Private Cloud v. 4.17.09

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

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

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

更新を行えるユーザー

更新を行うユーザーは、最初に 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/Oracle 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/Oracle 6.x の場合:
    wget https://dl.fedoraproject.org/pub/epel/epel-release-latest-6.noarch.rpm; rpm -ivh epel-release-latest-6.noarch.rpm

SMTPMAILFROM 構成パラメータの追加が必要

Edge 4.17.05 では、SMTP サーバーを有効にする場合に使用する必要のある構成ファイルが新しく追加されています。4.17.01 からアップデートする場合は、SMTP サーバーを有効にするときに構成ファイルで SMTPMAILFROM を設定する必要があります。

API BaaS バージョン 4.17.09 では、SMTPMAILFROM プロパティのサポートも追加されました。API BaaS を更新する場合は、構成ファイルで SMTPMAILFROM を設定する必要があります。

このパラメータの形式は次のとおりです。

SMTPMAILFROM="My Company <myco@company.com>"

外部認証を使用している場合に更新する場合に必要

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

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

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

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

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.09 のロールバック プロセスをご覧ください。

更新情報のロギング

デフォルトでは、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. 残りの Router に対し、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.09 のインストールに使用したものと同じである必要があります。

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

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

  1. Cassandra の修復オペレーションを行う CRON ジョブが構成されている場合は、更新が完了するまでそのジョブを無効にします。
  2. ノードに root としてログインし、Edge RPM をインストールします。
    注: RPM のインストールには root 権限が必要ですが、Edge の構成には root 権限は不要です。
  3. yum-utils と yum-plugin-priorities をインストールします。
    > sudo yum install yum-utils
    > sudo yum install yum-plugin-priorities
  4. Edge apigee-setup ユーティリティのインストールの説明に従って、SELinux を無効にします。
  5. 上記の手順に沿って、EPEL リポジトリを有効にします。
  6. AWS にインストールしている場合は、次の yum-configure-manager コマンドを実行します。
    > sudo yum-config-manager --enable rhui-REGION-rhel-server-extras rhui-REGION-rhel-server-optional
  7. Edge 4.17.09 の bootstrap_4.17.09.sh ファイルを /tmp/bootstrap_4.17.09.sh にダウンロードします。
    > curl https://software.apigee.com/bootstrap_4.17.09.sh -o /tmp/bootstrap_4.17.09.sh
  8. Edge 4.17.09 apigee-service ユーティリティと依存関係をインストールします。
    > sudo bash /tmp/bootstrap_4.17.09.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 を自身でインストールする必要があります。
  9. apigee-service を使用して、apigee-setup ユーティリティを更新します。
    > /opt/apigee/apigee-service/bin/apigee-service apigee-setup update
  10. Management Server で apigee-validate ユーティリティを更新します。
    > /opt/apigee/apigee-service/bin/apigee-service apigee-validate update
  11. apigee-provision ユーティリティを更新します。
    > /opt/apigee/apigee-service/bin/apigee-service apigee-provision update
  12. マシンの更新順序に記載された順に、各ノードで update ユーティリティを実行します。
    > /opt/apigee/apigee-setup/bin/update.sh -c component -f configFile

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

    「-c」オプションを使用して、更新するコンポーネントを指定します。使用可能なコンポーネントのリストには、次のコンポーネントが含まれます。
    ldap = OpenLDAP だけのコンポーネントのリストに含まれるコンポーネントは次のとおりです。
    ldap = OpenLDAP だけのコンポーネント インストールの利用可能なコンポーネントのリストには、次のコンポーネントが含まれます。
    ldap = OpenLDAP のみの Elastic UI インストールのコンポーネント -








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

後で更新をロールバックする場合は、4.17.09 のロールバック プロセスの手順に沿って操作します。

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

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

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

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

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

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

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

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

      ここで、uName:pWord は、上記でリポジトリに設定したユーザー名とパスワードであり、remoteRepo はリポジトリ ノードの IP アドレスまたは DNS 名です。
    3. リモートノードで、Edge apigee-service ユーティリティと依存関係をインストールします。
      > sudo bash /tmp/bootstrap_4.17.09.sh apigeerepohost=remoteRepo:3939 apigeeuser=uName apigeepassword=pWord apigeepassword=pWord username: apigeeprotocol=http://

      repou
  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. 次の「マシンの更新順序」に記載されている順序で、各ノードで update ユーティリティを実行します。
    > /opt/apigee/apigee-setup/bin/update.sh -c component -f configFile

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

    「-c」オプションを使用して、更新するコンポーネントを指定します。使用可能なコンポーネントのリストは次のとおりです。
    ldap = OpenLDAP
    cs = Cassandra
    zk = Zookeeper
    qpid = qpidd
    ps = postgresql
    edge =Edge UI 以外のすべての Edge コンポーネント: Management Server、Message Processor、Router、QPID Server、Postgres Server
    ui = Edge UI
    all = マシン上のすべてのコンポーネントを更新します（Edge aio インストール プロファイルまたは API BaaS asa インストール プロファイルにのみ使用）。
    e = ElasticSearch
    b = API BaaS スタック
    p = API BaaS Portal
    ebp = 同じノード上の ElasticSearch、API BaaS スタック、API BaaS Portal
  8. インストールのテストの説明に従って、Management Server で apigee-validate ユーティリティを実行し、更新をテストします。

後で更新をロールバックする場合は、4.17.09 のロールバック プロセスの手順に沿ってください。

マシンの更新順序

Edge インストールでは、マシンを更新する順序が重要です。更新時に特に考慮すべき事項は次のとおりです。

  • 他のノードを更新する前に、すべての Cassandra ノードと ZooKeeper ノードを更新する必要があります。
  • 複数の Edge コンポーネント（Management Server、Message Processor、Router、QPID Server、ただし Postgres Server は含まない）を搭載したマシンの場合は、「-c edge」オプションを使用して、すべてのコンポーネントを同時に更新します。
  • ステップが複数のマシンで実行するように指定されている場合は、指定されたマシン順序で実行します。
  • Monetization の更新に関して特別な手順はありません。「-c edge」オプションを指定した場合に更新されます。

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

  1. Edge で SMTP を有効にしている場合は、構成ファイルで SMTPMailFROM を設定します。このパラメータの形式は次のとおりです。
    SMTPMAILFROM="My Company <myco@company.com>"
  2. Cassandra と ZooKeeper を更新します。
    > /opt/apigee/apigee-setup/bin/update.sh -c cs,zk -f configFile
  3. 次の iptables ルールを設定します。
    > sudo iptables -A INPUT -p tcp --destination-port 5672 !-s `hostname` -i eth0 -j DROP
  4. Qpid メッセージ キューを確認します。
    > qpid-stat -q

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

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

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

  1. Edge で SMTP を有効にしている場合は、構成ファイルで SMTPMAILFROM を設定します。このパラメータの形式は次のとおりです。
    SMTPMAILFROM="My Company <myco@company.com>"
  2. マシン 1 の Cassandra と ZooKeeper を更新します。
    > /opt/apigee/apigee-setup/bin/update.sh -c cs,zk -f configFile
  3. マシン 2 に次の iptables ルールを設定します。
    > sudo iptables -A INPUT -p tcp --destination-port 5672 !-s `hostname` -i eth0 -j DROP
  4. マシン 2 の Qpid メッセージ キューを確認します。
    > qpid-stat -q

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

5 ホストクラスタ構成の場合

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

  1. Edge で SMTP を有効にしている場合は、構成ファイルで SMTPMailFROM を設定します。このパラメータの形式は次のとおりです。
    SMTPMAILFROM="My Company <myco@company.com>"
  2. マシン 1、2、3 の Cassandra と ZooKeeper を更新します。
    > /opt/apigee/apigee-setup/bin/update.sh -c cs,zk -f configFile
  3. マシン 4 で次の iptables ルールを設定します。
    > sudo iptables -A INPUT -p tcp --destination-port 5672 ! -s `hostname` -i eth0 -j DROP
  4. マシン 4 の Qpid メッセージ キューを確認します。
    > qpid-stat -q

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

9 ホストクラスタ構成の場合

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

  1. Edge で SMTP を有効にしている場合は、構成ファイルで SMTPMAILFROM を設定します。このパラメータの形式は次のとおりです。
    SMTPMAILFROM="My Company <myco@company.com>"
  2. マシン 1、2、3 の Cassandra と ZooKeeper を更新します。
    > /opt/apigee/apigee-setup/bin/update.sh -c cs,zk -f configFile
  3. マシン 6 で次の iptables ルールを設定します。
    > sudo iptables -A INPUT -p tcp --destination-port 5672 ! -s `hostname` -i eth0 -j DROP
  4. マシン 6 の Qpid メッセージ キューを確認します。
    > qpid-stat -q

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

13 ホストクラスタ構成の場合

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

  1. Edge で SMTP を有効にしている場合は、構成ファイルで SMTPMAILFROM を設定します。このパラメータの形式は次のとおりです。
    SMTPMAILFROM="My Company <myco@company.com>"
  2. マシン 1、2、3 の Cassandra と ZooKeeper を更新します。
    > /opt/apigee/apigee-setup/bin/update.sh -c cs,zk -f configFile
  3. マシン 12 で次の iptables ルールを設定します。
    > sudo iptables -A INPUT -p tcp --destination-port 5672 !-s `hostname` -i eth0 -j DROP
  4. マシン 12 の Qpid メッセージ キューを確認します。
    > qpid-stat -q

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

12 ホストクラスタ構成の場合

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

  1. Edge で SMTP を有効にしている場合は、構成ファイルで SMTPMailFROM を設定します。このパラメータの形式は次のとおりです。
    SMTPMailFROM="My Company <myco@company.com>"
  2. 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
  3. 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 を繰り返します。
  4. 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
  5. 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
  6. 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
  7. 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 インストールの場合

# 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"

# Specify the from address of generated emails.
SMTPMAILFROM="My Company <myco@company.com>"

構成ファイルの完全な例については、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 スタックを更新します。
    > /opt/apigee/apigee-setup/bin/update.sh -c e,b -f configFile

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

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

# 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"

# Specify the from address of generated emails.
SMTPMAILFROM="My Company <myco@company.com>"

構成ファイルの完全な例については、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 スタックを更新します。
    > /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（すべてのノードの「-c edge」プロファイルを意味します）。順序は Qpid Server ノード、Postgres Server ノード、Management Server ノード、Message Processor ノード、Router ノードの順です。
    注: ノードに Qpid Server と Postgres Server の両方がインストールされている場合は、「-c edge」プロファイルの手順を実行してください。
  6. Edge UI