Apigee Edge 4.16.09 を 4.17.05 に更新する

Edge for Private Cloud バージョン 4.17.05

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

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

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

更新を行えるユーザー

更新を行うユーザーは、最初に 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

必要な SMTPMailFROM 構成パラメータ

Edge 4.17.05 では、SMTP サーバーを有効にするときに使用する構成ファイルに新しい必須パラメータが追加されました。SMTP サーバーを有効にするときに、構成ファイルで SMTP メール FROM を設定する必要があります。このパラメータの形式は次のとおりです。

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.05 に更新するときに、構成ファイルに次の行を追加します。

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 ユーティリティを実行しているユーザーがこのディレクトリにアクセスできない場合は、ログが update_username.log という名前のファイルとして /tmp ディレクトリに書き込まれます。

ユーザーに /tmp へのアクセス権がない場合、update.sh ユーティリティは失敗します。

ゼロダウンタイムでの更新

ゼロ ダウンタイム アップデート（ローリング アップデート）を使用すると、Edge をダウンさせることなく Edge インストール環境を更新できます。

ゼロ ダウンタイムの更新は、5 ノード以上の構成でのみ可能です。

ダウンタイムなしでアップグレードするための鍵は、各 Router をロードバランサから 1 つずつ削除することです。次に、Router と、Router と同じマシン上のすべてのコンポーネントを更新してから、Router をロードバランサに再び追加します。

  1. 後述の「マシンの更新順序」の説明に従って、インストール環境に適した順序でマシンを更新します。
  2. Router を更新するときは、サーバー（Message Processor/Router）の到達可能性の有効化/無効化の説明に従って、Router を 1 台選択して到達不能にします。
  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 を到達可能にする

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

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

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

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

  1. CRON ジョブが存在する場合は、更新が完了するまで、Cassandra で修復オペレーションを行うように構成された CRON ジョブを無効にします。
  2. ノードに root としてログインし、Edge RPM をインストールします。
    注: RPM のインストールには root 権限が必要ですが、Edge の構成には root 権限は不要です。
  3. Edge apigee-setup ユーティリティのインストールの説明に従って、SELinux を無効にします。
  4. Edge 4.17.05 の bootstrap_4.17.05.sh ファイルを /tmp/bootstrap_4.17.05.sh にダウンロードします。
    > curl https://software.apigee.com/bootstrap_4.17.05.sh -o /tmp/bootstrap_4.17.05.sh
  5. Edge 4.17.05 の apigee-service ユーティリティと依存関係をインストールします。
    > sudo bash /tmp/bootstrap_4.17.05.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」オプションを使用して、更新するコンポーネントを指定します。可能なコンポーネントは次のとおりです。
    ldap = OpenLDAP
    cs = Cassandra
    zk = Zookeeper
    qpid = qpidd
    ps = postgresql
    edge = Ba Elastic Stack = Basa Stack API と同じすべてのエッジ コンポーネント、Seba Portal と Baa Elastic Edge の同じプロファイルのみ、Seba Portal または Basa Elastic Edge をインストールするためのすべてのコンポーネント





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

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

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

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

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

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

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

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

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

      このコマンドには repos ディレクトリへのパスを指定します。
  3. Nginx ウェブサーバーを使用して apigee-service をインストールするには:
    1. Edge apigee-setup ユーティリティのインストールの「Nginx ウェブサーバーを使用してリポジトリからインストールする」の手順に沿って、Nginx ウェブサーバーを構成します。
    2. リモートノードで、Edge の bootstrap_4.17.05.sh ファイルを /tmp/bootstrap_4.17.05.sh にダウンロードします。
      > /usr/bin/curl または http://uName:pWord@remoteRepo/re: repo.trap_node.mp4 アドレスです。

    3. リモートノードに、Edge apigee-service ユーティリティと依存関係をインストールします。
      > sudo bash /tmp/bootstrap_4.17.05.sh apigeerepohost=remoteRepo:3939 apigeeuser=uName apigeepassword=pWord apigeepassword=http://

      ここで、uName は、ユーザー名です。uName
  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 更新
  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」オプションを使用して、更新するコンポーネントを指定します。可能なコンポーネントは次のとおりです。
    ldap = OpenLDAP
    cs = Cassandra
    zk = Zookeeper
    qpid = qpidd
    ps = postgresql
    edge = Ba Elastic Stack = Basa Stack API と同じすべてのエッジ コンポーネント、Seba Portal と Baa Elastic Edge の同じプロファイルのみ、Seba Portal または Basa Elastic Edge をインストールするためのすべてのコンポーネント





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

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

マシンの更新順序

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 ホストのスタンドアロン インストールの場合

  1. Edge で SMTP を有効にした場合は、構成ファイルで SMTP メール FROM を設定します。このパラメータの形式は次のようになります。
    SMTP メール FROM="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 を有効にした場合は、構成ファイルで SMTP メール FROM を設定します。このパラメータの形式は次のようになります。
    SMTP メール FROM="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 を有効にした場合は、構成ファイルで SMTP メール FROM を設定します。このパラメータの形式は次のようになります。
    SMTP メール FROM="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 を有効にした場合は、構成ファイルで SMTP メール FROM を設定します。このパラメータの形式は次のようになります。
    SMTP メール FROM="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 を有効にした場合は、構成ファイルで SMTP メール FROM を設定します。このパラメータの形式は次のようになります。
    SMTP メール FROM="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 を有効にした場合は、構成ファイルで SMTP メール FROM を設定します。このパラメータの形式は次のようになります。
    SMTP メール FROM="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 をインストールする場合

アップグレード手順を実行する前に、構成ファイルに次の 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 のインストールをご覧ください。

また、他のすべてのスタックノードからアクセスできるように、すべてのスタックノードでポート 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 のインストールをご覧ください。

また、他のすべてのスタックノードからアクセスできるように、すべてのスタックノードでポート 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 サーバー、Postgres サーバー、Management Server、Message Processor、Router の順です。
    注: ノードに Qpid Server と Postgres Server の両方がインストールされている場合は、「-c edge」プロファイルの手順を実施してください。
  6. Edge UI