Apigee Edge 4.16.01/4.16.05 を 4.18.01 に更新する

Edge for Private Cloud v4.18.01

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

Apigee Edge バージョン 4.16.01.0x および 4.16.05.x を 4.18.01 に更新する手順は次のとおりです。

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

  • Apigee Edge バージョン 4.15.07 は 4.16.01 に移行できます。
  • バージョン 4.15.07 より前の Edge バージョンの場合は、まずバージョン 4.15.07 に移行してから、バージョン 4.16.01 に移行する必要があります。
    • Edge バージョン 4.14.04 以降から移行する場合: バージョン 4.15.07 に直接移行します。
    • Edge バージョン 4.14.01 から移行する場合: まずバージョン 4.14.04 に移行してから、バージョン 4.15.07 に移行する必要があります。

更新を行えるユーザー

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

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

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

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

4.16.01 から更新する場合の Zookeeper のダウングレード

Edge for Private Cloud 4.16.01 の Zookeeper RPM のバージョンは apigee-zookeeper-3.4.5-1.0.905.noarch.rpm です。Edge のその後のバージョンでは、Zookeeper のバージョンを apigee-zookeeper-3.4.5-0.0.94x に戻しました。これにより、yum が Zookeeper を 4.16.01 から新しいバージョンにアップグレードできなくなります。この状況を修正するには、Zookeeper を更新する前に、yum ダウングレード apigee-zookeeper を実行します。

Zookeeper のバージョンは、次のコマンドを使用して確認できます。

> rpm -qa |grep apigee-zookeeper

このコマンドで Zookeeper のバージョンが返された場合:

apigee-zookeeper-3.4.5-1.0.905

その後、ダウングレードを行う必要があります。

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

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

更新の前提条件

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

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

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

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

失敗したアップデートの処理

更新に失敗した場合は、問題を修正してから update.sh を再度実行できます。更新は複数回実行でき、最後に中断したところから続行されます。

失敗したため更新を前のバージョンにロールバックする必要がある場合は、4.18.01 ロールバック プロセスをご覧ください。

更新情報のロギング

デフォルトでは、update.sh ユーティリティはログ情報を次の場所に書き込みます。

/opt/apigee/var/log/apigee-setup/update.log

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

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

Java JDK バージョン 8 への必須アップグレード

この Edge リリースでは、すべての Edge 処理ノードに Java JDK バージョン 8 がインストールされている必要があります。Oracle JDK 8 または OpenJDK 8 をインストールできます。Java JDK 8 がまだインストールされていない場合は、更新スクリプトを使用してインストールできます。

Java 8 へのアップデートの一環として、一部の TLS 暗号は Oracle JDK 8 で使用できなくなりました。完全なリストについては、http://docs.oracle.com/javase/8/docs/technotes/guides/security/SunProviders.html の「デフォルトで無効になっている暗号スイート」セクションをご覧ください。

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 サーバーを有効にするときに使用する構成ファイルに新しい必須パラメータが追加されました。4.17.01 から更新する場合は、SMTP サーバーを有効にするときに、構成ファイルで SMTPPHONEFROM を設定する必要があります。

API BaaS バージョン 4.17.09 では、SMTPMailFROM プロパティのサポートも追加されています。API BaaS を更新するときは、構成ファイルで 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.18.01 に更新するときに、構成ファイルに次の行を追加します。

IS_EXTERNAL_AUTH="true"

この行により、メールアドレスではなくアカウント名をユーザー名としてサポートするように 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 トポロジで詳しく説明します。

Postgres 9.6 への必須アップグレード

この Edge リリースには、Postgres 9.6 へのアップグレードが含まれています。このアップグレードの一環として、すべての Postgres データが Postgres 9.6 に移行されます。

更新プロセス中、Postgres ノードが更新のために停止している間、分析データは Qpid ノードに書き込まれます。Postgres ノードが更新されてオンラインに戻ると、分析データが Postgres ノードに push されます。

なんらかの理由で更新をロールバックする必要がある場合は、追加の Postgres スタンバイ ノードが必要です。更新をロールバックする必要がある場合は、ロールバック後に、新しい Postgres スタンバイ ノードがマスター Postgres ノードになります。したがって、新しい Postgres スタンバイ ノードは、Edge のインストール要件で定義されている Postgres サーバーのハードウェア要件をすべて満たすノードにインストールする必要があります。

新しい Postgres スタンバイ ノードをインストールする

この手順では、新しいノードに Postgres スタンバイ サーバーを作成します。バージョン 4.18.01 ではなく、既存のバージョンの Edge(4.16.01 または 4.16.05)用に、新しい Postgres スタンバイ サーバーをインストールしてください。

インストールには、現バージョンの Edge のインストールに使用したものと同じ構成ファイルを使用します。

新しい Postgres スタンバイ ノードを作成するには:

  1. 現在の Postgres マスターで、/opt/apigee/customer/application/postgresql.properties ファイルを編集して、次のトークンを設定します。このファイルが存在しない場合は作成します。

    conf_pg_hba_replication.connection=host replication apigee existing_slave_ip/32 trust\ \n ホスト レプリケーション apigee new_slave_ip/32 trust



    existing_slave_ip は新しいスタンバイ ノードの IP アドレス、new_iplave サーバーの新しい IP アドレスは新しい Postgres_s サーバーの IP アドレスです。
  2. Postgres マスターで apigee-postgresql を再起動します。
    > /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql restart
  3. マスターの /opt/apigee/apigee-postgresql/conf/pg_hba.conf ファイルを表示して、新しいスタンバイ ノードが追加されたことを確認します。ファイルに次の行が表示されます。
    host replication apigee existing_slave_ip/32 trust
    host replication apigee new_slave_ip/32 trust
  4. 新しい Postgres スタンバイ サーバーをインストールします。
    1. Edge の現在のバージョンのインストールに使用した構成ファイルを編集して、次の項目を指定します。

      # 現在のマスターの IP アドレス:
      PG_MASTER=192.168.56.103
      # 新しいスタンバイ ノードの IP アドレス
      PG_STANDBY=192.168.56.102
    2. Edge apigee-setup ユーティリティのインストールの説明に従って、SELinux を無効にします。
    3. Edge bootstrap_4.16.05.sh ファイルを /tmp/bootstrap_4.16.05.sh にダウンロードします。
      > curl https://software.apigee.com/bootstrap_4.16.05.sh -o /tmp/bootstrap_4.16.05.sh

      :/tmp/bootstrap_4.16.05.sh
    4. Edge の apigee-service ユーティリティと依存関係をインストールします。
      > sudo bash /tmp/bootstrap_4.16.05.sh apigeeuser=uName apigeepassword=pWord
    5. apigee-service を使用して、apigee-setup ユーティリティをインストールします。
      > /opt/apigee/apigee-service/bin/apigee-service apigee-setup install
    6. Postgres をインストールします。
      > /opt/apigee/apigee-setup/bin/setup.sh -p ps -f configFile
    7. 新しいスタンバイ ノードで、次のコマンドを実行します。
      > /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql postgres-check-standby

      スタンバイ ノードであることが示されていることを確認します。

Postgres ノードを廃止する

更新が完了したら、新しいスタンバイ ノードを廃止します。

  1. Postgres が実行中であることを確認します。
    > /opt/apigee/apigee-service/bin/apigee-all status

    Postgres が実行されていない場合は起動します。
    > /opt/apigee/apigee-service/bin/apigee-all start
  2. 新しいスタンバイ ノードで次の cURL コマンドを実行して、新しいスタンバイ ノードの UUID を取得します。
    > curl -u sysAdminEmail:password http://<node_IP>:8084/v1/servers/self


    出力の最後に、ノードの UUID が「" ecserver "UID "UID " UID " UID " という形式で表示されます。
    "
  3. 新しいスタンバイ ノードで次のコマンドを実行して、新しいスタンバイ ノードを停止します。
    > /opt/apigee/apigee-service/bin/apigee-allstop
  4. Postgres マスターノードで、/opt/apigee/customer/application/postgresql.properties を編集して、conf_pg_hba_replication.connection から新しいスタンバイ ノードを削除します。
    conf_pg_hba_replication.connection=host replication apigee existing_slave_ip/32 trust
  5. Postgres マスターで apigee-postgresql を再起動します。
    > /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql restart
  6. マスターの /opt/apigee/apigee-postgresql/conf/pg_hba.conf ファイルを表示して、新しいスタンバイ ノードが削除されたことを確認します。このファイルには次の行のみが表示されます。
    host replication apigee existing_slave_ip/32 trust
  7. Management Server ノードで次の Edge Management API 呼び出しを行い、ZooKeeper からスタンバイ ノードの UUID を削除します。
    > curl -u sysAdminEmail:password -X DELETE http://<ms_IP>:8080/v1/servers/<new_slave_uuid>

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

ゼロ ダウンタイム アップデート(ローリング アップデート)を使用すると、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.01 または 4.16.05 のインストールに使用したものと同じである必要があります。

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

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

  1. 現在 Postgres のマスター / スタンバイ レプリケーションを使用している場合は、上記の新しい Postgres スタンバイ ノードをインストールするの説明に沿って、新しい Postgres スタンバイ ノードをインストールします。
  2. CRON ジョブが存在する場合は、更新が完了するまで、Cassandra で修復オペレーションを行うように構成された CRON ジョブを無効にします。
  3. ノードに root としてログインし、Edge RPM をインストールします。
    : RPM のインストールには root 権限が必要ですが、Edge の構成には root 権限は不要です。
  4. yum-utilsyum-plugin-priorities をインストールします。
    > sudo yum install yum-utils
    > sudo yum install yum-plugin-priorities
  5. Edge apigee-setup ユーティリティのインストールの説明に従って、SELinux を無効にします。
  6. 上記のように EPEL リポジトリを有効にします。
  7. Oracle 7.x にインストールする場合は、次のコマンドを実行します。
    > sudo yum-config-manager --enable ol7_optional_latest
  8. AWS にインストールする場合は、次の yum-configure-manager コマンドを実行します。
    > yum update rh-amazon-rhui-client.noarch
    > sudo yum-config-manager --enable rhui-REGION-rhel-server-extras rhui-REGION-rhel-server-optional
  9. Edge 4.18.01 の bootstrap_4.18.01.sh ファイルを /tmp/bootstrap_4.18.01.sh にダウンロードします。
    > curl https://software.apigee.com/bootstrap_4.18.01.sh -o /tmp/bootstrap_4.18.01.sh
  10. Edge 4.18.01 の apigee-service ユーティリティと依存関係をインストールします。
    > sudo bash /tmp/bootstrap_4.18.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 をユーザー自身でインストールする必要があります。
  11. apigee-service を使用して、apigee-setup ユーティリティを更新します。
    1. Edge バージョン 4.15.07.0x をアップグレードして 4.16.01 をインストールした場合は、apigee-setup ユーティリティをインストールする必要があります。
      > /opt/apigee/apigee-service/bin/apigee-service apigee-setup install

      このコマンドにより、update.sh ユーティリティが /opt/apigee/apigee-setup/bin にインストールされます。

      apigee-setup ユーティリティがすでにインストールされている場合は、次のように更新します。
      > /opt/apigee/apigee-service/bin/apigee-service apigee-setup update
    2. 4.16.01 を直接インストールした場合、4.15.07.0x からのアップグレードを実施していない場合は、apigee-setup ユーティリティを更新する必要があります
      > /opt/apigee/apigee-service/bin/apigee-service apigee-setup の更新

      apigee-service への更新により、update-opt/apigee.sh ユーティリティが /setup/apigee.sh にインストールされます。
    3. 4.16.05 を直接または更新によってインストールした場合は、apigee-setup ユーティリティを更新する必要があります
      > /opt/apigee/apigee-service/bin/apigee-service apigee-setup の更新

      apigee-service への更新により、update.sh ユーティリティが /opt/apigee/apigee-setup/bin にインストールされます。
  12. Edge の現在のバージョンに応じて、Management Server に apigee-validate ユーティリティをインストールまたは更新する必要があります。
    1. 現在 Edge 4.16.05 を使用している場合: Management Server で apigee-validate ユーティリティを更新します。
      > /opt/apigee/apigee-service/bin/apigee-service apigee-validate update
    2. 現在 Edge 4.16.01 を使用している場合: apigee-validate ユーティリティを Management Server にインストールします。
      > /opt/apigee/apigee-service/bin/apigee-service apigee-service apigee-validate install

      : apigee-validate ユーティリティを apigee/apigee/apigee-service/bin/apigee-service apigee-validate install

      : 4.16.01 のインストール時に、apigee-validate Server を
      .apigee/apigee.service ノードにインストールし、
      apigee-validate
    3. 4.16.01 からアップグレードする場合: apigee-validate ユーティリティに渡された構成ファイルを編集します。4.16.01 Edge リリースでは、apigee-validate が使用する構成ファイルに次のプロパティが必要でした。
      APIGEE_ADMINPW=sysAdminPword
      MP_POD=gateway
      REGION=dc-1


      このリリースでは、構成ファイルに APIGEE_ADMINPW プロパティのみが必要です。他の 2 つのプロパティはファイルから削除できます。
  13. apigee-provision ユーティリティを更新します。
    > /opt/apigee/apigee-service/bin/apigee-service apigee-provision update
  14. 以下のマシンの更新順序に記載されている順序で、ノードで更新ユーティリティを実行します。
    > /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 をインストールするためのすべてのコンポーネント





  15. インストールをテストするの説明に沿って、Management Server で apigee-validate ユーティリティを実行し、更新をテストします。
  16. 新しい Postgres スタンバイ ノードをインストールした場合は、上記の Postgres ノードを廃止するの説明に従い、ノードを廃止します。

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

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

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

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

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

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

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

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

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

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

      uName は、username と次です。uName
  5. apigee-service を使用して、apigee-setup ユーティリティを更新します。
    1. Edge バージョン 4.15.07.0x をアップグレードして 4.16.01 をインストールした場合は、apigee-setup ユーティリティをインストールする必要があります。
      > /opt/apigee/apigee-service/bin/apigee-service apigee-setup install

      このコマンドにより、update.sh ユーティリティが /opt/apigee/apigee-setup/bin にインストールされます。

      apigee-setup ユーティリティがすでにインストールされている場合は、次のように更新します。
      > /opt/apigee/apigee-service/bin/apigee-service apigee-setup update
    2. 4.16.01 を直接インストールした場合、4.15.07.0x からのアップグレードを実施していない場合は、apigee-setup ユーティリティを更新する必要があります。
      >

    3. 4.16.05 を直接または更新によってインストールした場合は、apigee-setup ユーティリティを更新する必要があります。
      > /opt/apigee/apigee-service/bin/apigee-service apigee-setup の更新

      apigee-service の更新により、update.sh ユーティリティが /opt/apigee/apigee-setup/bin にインストールされます。
  6. Edge の現在のバージョンに応じて、Management Server に apigee-validate ユーティリティをインストールまたは更新する必要があります。
    1. 現在 Edge 4.16.05 を使用している場合: Management Server で apigee-validate ユーティリティを更新します。
      > /opt/apigee/apigee-service/bin/apigee-service apigee-validate update
    2. 現在 Edge 4.16.01 を使用している場合: apigee-validate ユーティリティを Management Server にインストールします。
      > /opt/apigee/apigee-service/bin/apigee-service apigee-validate install

      : 4.16.01 のインストール時に apigee-validate1 ユーティリティ、
      Apigee / apigee サービス
      を使用して更新できます。
    3. 4.16.01 からアップグレードする場合: apigee-validate ユーティリティに渡された構成ファイルを編集します。4.16.01 Edge リリースでは、apigee-validate が使用する構成ファイルに次のプロパティが必要でした。
      APIGEE_ADMINPW=sysAdminPword
      MP_POD=gateway
      REGION=dc-1


      このリリースでは、構成ファイルに APIGEE_ADMINPW プロパティのみが必要です。他の 2 つのプロパティはファイルから削除できます。
  7. apigee-provision ユーティリティを更新します。
    > /opt/apigee/apigee-service/bin/apigee-service apigee-provision update
  8. 以下の「マシンの更新順序」に記載されている順序で、ノードで更新ユーティリティを実行します。
    > /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 をインストールするためのすべてのコンポーネント





  9. インストールをテストするの説明に沿って、Management Server で apigee-validate ユーティリティを実行し、更新をテストします。
  10. 新しい Postgres スタンバイ ノードをインストールした場合は、上記の Postgres ノードを廃止するの説明に従い、ノードを廃止します。

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

マシンの更新順序

Edge インストール環境でマシンを更新する順序は重要です。アップデートでは以下の点を考慮してください。

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

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

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

    msg 列のカウントが 0 になるまでキューのチェックを続けます。すべてのメッセージを処理するまで、Qpid をアップグレードすることはできません。
  6. qpidd を更新します。
    > /opt/apigee/apigee-setup/bin/update.sh -c qpid -f configFile
  7. iptables をフラッシュします。
    > sudo iptables -F
  8. LDAP を更新します。
    > /opt/apigee/apigee-setup/bin/update.sh -c ldap -f configFile
  9. Postgres Server、Qpid サーバー、PostgreSQL を停止します。
    > > /opt/apigee/apigee-service/bin/apigee-service edge-postgres-serverstop
    > > /opt/apigee/apigee-service/bin/apigee-service edge-qpid-serverstop
  10. postgresql を更新します。
    > /opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile
  11. Postgres データベースを更新します。
    > /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql db_upgrade
  12. 残りの Edge コンポーネントを更新します。
    > /opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile
  13. 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. 4.16.01 から更新する場合は、マシン 1 で Zookeeper をダウングレードします。
    > yumgrade apigee-zookeeper
  3. マシン 1 の Cassandra と ZooKeeper を更新します。
    > /opt/apigee/apigee-setup/bin/update.sh -c cs,zk -f configFile
  4. マシン 2 で次の iptables ルールを設定します。
    > sudo iptables -A INPUT -p tcp --destination-port 5672 !-s `hostname` -i eth0 -j DROP
  5. マシン 2 の Qpid メッセージ キューを確認します。
    > qpid-stat -q

    [msg] 列のカウントが 0 になるまでキューのチェックを続けます。すべてのメッセージを処理するまで、Qpid をアップグレードすることはできません。
  6. マシン 2 の qpidd を更新します。
    > /opt/apigee/apigee-setup/bin/update.sh -c qpid -f configFile
  7. マシン 2 の iptables をフラッシュします。
    > sudo iptables -F
  8. マシン 1 の LDAP を更新します。
    > /opt/apigee/apigee-setup/bin/update.sh -c ldap -f configFile
  9. マシン 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
  11. マシン 2 の postgresql を更新します。
    1. Postgres Server、Qpid サーバー、postgresql を停止します。
      > /opt/apigee/apigee-service/bin/apigee-service edge-postgres-serverstop
      > /opt/apigee/apigee-service/bin/apigee-service edge-qpid-serverstop
      > /opt/apigee/apigee-service/bin/apigee-service apigee-postgresqlstop
    2. postgresql を更新します。
      > /opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile
    3. Postgres データベースを更新します。
      > /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql db_upgrade
    4. マシン 2 の Edge コンポーネントを更新します。
      > /opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile

5 つのホストからなるクラスタ構成の場合

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

  1. Edge で SMTP を有効にした場合は、構成ファイルで SMTP メール FROM を設定します。このパラメータの形式は次のようになります。
    SMTP メール FROM="My Company <myco@company.com>"
  2. 前述の新しい Postgres スタンバイ ノードをインストールするの説明に沿って、新しい Postgres スタンバイ ノードがインストールされていることを確認します。
  3. 4.16.01 から更新する場合は、マシン 1、2、3 で Zookeeper をダウングレードします。
    > yum ければ apigee-zookeeper をダウングレードします
  4. マシン 1、2、3 の Cassandra と ZooKeeper を更新します。
    > /opt/apigee/apigee-setup/bin/update.sh -c cs,zk -f configFile
  5. マシン 4 で次の iptables ルールを設定します。
    > sudo iptables -A INPUT -p tcp --destination-port 5672 !-s `hostname` -i eth0 -j DROP
  6. マシン 4 の Qpid メッセージ キューを確認します。
    > qpid-stat -q

    [msg] 列のカウントが 0 になるまでキューのチェックを続けます。すべてのメッセージを処理するまで、Qpid をアップグレードすることはできません。
  7. マシン 4 の qpidd を更新します。
    > /opt/apigee/apigee-setup/bin/update.sh -c qpid -f configFile
  8. マシン 4 の iptables をフラッシュします。
    > sudo iptables -F
  9. マシン 5 で手順 5 から 8 を繰り返します。
  10. マシン 1 の LDAP を更新します。
    > /opt/apigee/apigee-setup/bin/update.sh -c ldap -f configFile
  11. マシン 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
  13. マシン 4、5 を更新します。
    1. マシン 4 で Postgres サーバーと Qpid サーバーを停止します。
      > /opt/apigee/apigee-service/bin/apigee-service edge-postgres-serverstop
      > /opt/apigee/apigee-service/bin/apigee-service edge-qpid-serverstop
    2. マシン 5 で Postgres サーバー、Qpid サーバー、postgresql を停止します。
      > /opt/apigee/apigee-service/bin/apigee-service edge-postgres-serverstop
      > > /opt/apigee/apigee-service/bin/apigee-service edge-qpid-serverstop
      > > /opt/apigee/apigee-service/bin/apigee-service apigee-service
    3. ロールバック用に追加した新しいスタンバイ ノードで Postgres サーバーと postgresql を停止します。
      > /opt/apigee/apigee-service/bin/apigee-service edge-postgres-serverstop
      > /opt/apigee/apigee-service/bin/apigee-service apigee-postgresqlstop
    4. マシン 4 の postgresql を更新します。
      > /opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile
    5. マシン 4 の Postgres データベースを更新します(Postgres マスターのみ)。
      > /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql db_upgrade
    6. マシン 5 の postgresql を更新します。
      > /opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile
    7. マシン 4 と 5 で Postgres サーバーと Qpid サーバーを起動します。
      > /opt/apigee/apigee-service/bin/apigee-service edge-postgres-server start
      > /opt/apigee/apigee-service/bin/apigee-service edge-qpid-server start
    8. マシン 5 で次のコマンドを実行して、Postgres をスタンバイ ノードとして構成します。
      > cd /opt/apigee/data/apigee-postgresql/p'></
      > rm -rf *
      > > /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql setup-replication-on-standby -f -f
      configFile
    9. 両方のサーバーで次のスクリプトを発行して、レプリケーションのステータスを確認します。レプリケーションが正常に行われるように、両方のサーバーで同じ結果が表示されるはずです。

      マシン 4(マスターノード)で、次のコマンドを実行します。
      > /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql postgres-check-master

      マスターノードであることが示されていることを確認します。

      マシン 5(スタンバイ ノード)で、次の操作を行います。
      > /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql postgres-check-standby

      スタンバイ ノードが表示されていることを確認します。
  14. マシン 4、5 の Edge コンポーネントを更新します。
    > /opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile
  15. 前述の Postgres ノードを廃止するの手順に沿って、新しいスタンバイ ノードを廃止します。

9 つのホストからなるクラスタ構成の場合

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

  1. Edge で SMTP を有効にした場合は、構成ファイルで SMTP メール FROM を設定します。このパラメータの形式は次のようになります。
    SMTP メール FROM="My Company <myco@company.com>"
  2. 前述の新しい Postgres スタンバイ ノードをインストールするの説明に沿って、新しい Postgres スタンバイ ノードがインストールされていることを確認します。
  3. 4.16.01 から更新する場合は、Macine 1、2、3 で Zookeeper をダウングレードします。
    > yum subscription apigee-zookeeper をダウングレードします。
  4. マシン 1、2、3 の Cassandra と ZooKeeper を更新します。
    > /opt/apigee/apigee-setup/bin/update.sh -c cs,zk -f configFile
  5. マシン 6 で次の iptables ルールを設定します。
    > sudo iptables -A INPUT -p tcp --destination-port 5672 !-s `hostname` -i eth0 -j DROP
  6. マシン 6 の Qpid メッセージ キューを確認します。
    > qpid-stat -q

    [msg] 列のカウントが 0 になるまでキューのチェックを続けます。すべてのメッセージを処理するまで、Qpid をアップグレードすることはできません。
  7. マシン 6 の qpidd を更新します。
    > /opt/apigee/apigee-setup/bin/update.sh -c qpid -f configFile
  8. マシン 6 の iptables をフラッシュします。
    > sudo iptables -F
  9. マシン 7 で手順 5 ~ 8 を繰り返します。
  10. マシン 1 の LDAP を更新します。
    > /opt/apigee/apigee-setup/bin/update.sh -c ldap -f configFile
  11. マシン 6、7、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. マシン 8、9 を更新します。
    1. マシン 8 で Postgres サーバーを停止します。
      > /opt/apigee/apigee-service/bin/apigee-service edge-postgres-serverstop
    2. マシン 9 で Postgres サーバーと postgresql を停止します。
      > /opt/apigee/apigee-service/bin/apigee-service edge-postgres-serverstop
      > /opt/apigee/apigee-service/bin/apigee-postgresqlstop
    3. マシン 6、7 の Qpid サーバーを停止します。
      > /opt/apigee/apigee-service/bin/apigee-service edge-qpid-serverstop
    4. ロールバック用に追加した新しいスタンバイ ノードで Postgres サーバーと postgresql を停止します。
      > /opt/apigee/apigee-service/bin/apigee-service edge-postgres-serverstop
      > /opt/apigee/apigee-service/bin/apigee-service apigee-postgresqlstop
    5. マシン 8 の postgresql を更新します。
      > /opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile
    6. マシン 8 の Postgres データベースを更新します(Postgres マスターのみ)。
      > /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql db_upgrade
    7. マシン 9 の postgresql を更新します。
      > /opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile
    8. マシン 8、9 で Postgres サーバーを起動します。
      > /opt/apigee/apigee-service/bin/apigee-service edge-postgres-server start
    9. マシン 6 と 7 で Qpid サーバー サーバーを起動します。
      > /opt/apigee/apigee-service/bin/apigee-service edge-qpid-server start
    10. マシン 9 で次のコマンドを実行して、Postgres をスタンバイ ノードとして構成します。
      > cd /opt/apigee/data/apigee-postgresql/p'></
      > rm -rf *
      > > /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql setup-replication-on-standby -f
      configFile
    11. 両方のサーバーで次のスクリプトを発行して、レプリケーションのステータスを確認します。レプリケーションが正常に行われるように、両方のサーバーで同じ結果が表示されるはずです。
      マスターノードであるマシン 8 で、次のコマンドを実行します。
      > /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql postgres-check-master

      マスターノードであることが示されていることを確認します。

      マシン 9(スタンバイ ノード)で、次の操作を行います。
      > /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql postgres-check-standby

      スタンバイ ノードが表示されていることを確認します。
  14. マシン 8、9 の Edge コンポーネントを更新します。
    > /opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile
  15. 前述の Postgres ノードを廃止するの手順に沿って、新しいスタンバイ ノードを廃止します。

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

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

  1. Edge で SMTP を有効にした場合は、構成ファイルで SMTP メール FROM を設定します。このパラメータの形式は次のようになります。
    SMTP メール FROM="My Company <myco@company.com>"
  2. 前述の新しい Postgres スタンバイ ノードをインストールするの説明に沿って、新しい Postgres スタンバイ ノードがインストールされていることを確認します。
  3. 4.16.01 から更新する場合は、Macine 1、2、3 で Zookeeper をダウングレードします。
    > yum subscription apigee-zookeeper をダウングレードします。
  4. マシン 1、2、3 の Cassandra と ZooKeeper を更新します。
    > /opt/apigee/apigee-setup/bin/update.sh -c cs,zk -f configFile
  5. マシン 12 で次の iptables ルールを設定します。
    > sudo iptables -A INPUT -p tcp --destination-port 5672 !-s `hostname` -i eth0 -j DROP
  6. マシン 12 の Qpid メッセージ キューを確認します。
    > qpid-stat -q

    [msg] 列のカウントが 0 になるまでキューのチェックを続けます。すべてのメッセージを処理するまで、Qpid をアップグレードすることはできません。
  7. マシン 12 の qpidd を更新します。
    > /opt/apigee/apigee-setup/bin/update.sh -c qpid -f configFile
  8. マシン 12 の iptables をフラッシュします。
    > sudo iptables -F
  9. マシン 13 で手順 5 ~ 8 を繰り返します。
  10. マシン 4 と 5 の LDAP を更新します。
    > /opt/apigee/apigee-setup/bin/update.sh -c ldap -f configFile
  11. マシン 12、13、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
  13. マシン 8、9 を更新します。
    1. マシン 8 で Postgres サーバーを停止します。
      > /opt/apigee/apigee-service/bin/apigee-service edge-postgres-serverstop
    2. マシン 9 で Postgres サーバーと postgresql を停止します。
      > /opt/apigee/apigee-service/bin/apigee-service edge-postgres-serverstop
      > /opt/apigee/apigee-service/bin/apigee-postgresqlstop
    3. マシン 12 と 13 の Qpid サーバーを停止します。
      > /opt/apigee/apigee-service/bin/apigee-service edge-qpid-serverstop
    4. ロールバック用に追加した新しいスタンバイ ノードで Postgres サーバーと postgresql を停止します。
      > /opt/apigee/apigee-service/bin/apigee-service edge-postgres-serverstop
      > /opt/apigee/apigee-service/bin/apigee-service apigee-postgresqlstop
    5. マシン 8 の postgresql を更新します。
      > /opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile
    6. マシン 8 の Postgres データベースを更新します(Postgres マスターのみ)。
      > /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql db_upgrade
    7. マシン 9 の postgresql を更新します。
      > /opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile
    8. マシン 8、9 で Postgres サーバーを起動します。
      > /opt/apigee/apigee-service/bin/apigee-service edge-postgres-server start
    9. マシン 12 と 13 で Qpid サーバー サーバーを起動します。
      > /opt/apigee/apigee-service/bin/apigee-service edge-qpid-server start
    10. マシン 9 で次のコマンドを実行して、Postgres をスタンバイ ノードとして構成します。
      > cd /opt/apigee/data/apigee-postgresql/p'></
      > rm -rf *
      > > /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql setup-replication-on-standby -f
      configFile
    11. 両方のサーバーで次のスクリプトを発行して、レプリケーションのステータスを確認します。レプリケーションが正常に行われるように、両方のサーバーで同じ結果が表示されるはずです。
      マスターノードであるマシン 8 で、次のコマンドを実行します。
      > /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql postgres-check-master

      マスターノードであることが示されていることを確認します。

      マシン 9(スタンバイ ノード)で、次の操作を行います。
      > /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql postgres-check-standby

      スタンバイ ノードが表示されていることを確認します。
  14. マシン 8、9 の Edge コンポーネントを更新します。
    > /opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile
  15. 前述の Postgres ノードを廃止するの手順に沿って、新しいスタンバイ ノードを廃止します。

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

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

  1. Edge で SMTP を有効にした場合は、構成ファイルで SMTP メール FROM を設定します。このパラメータの形式は次のようになります。
    SMTP メール FROM="My Company <myco@company.com>"
  2. 前述の新しい Postgres スタンバイ ノードをインストールするの説明に沿って、新しい Postgres スタンバイ ノードがインストールされていることを確認します。
  3. Cassandra と ZooKeeper を更新します。
    1. 4.16.01 から更新する場合は、データセンター 1 の macine 1、2、3 で Zookeeper をダウングレードします。
      > yum index apigee-zookeeper をダウングレードします。
    2. データセンター 1 のマシン 1、2、3 で、次のコマンドを実行します。
      > /opt/apigee/apigee-setup/bin/update.sh -c cs,zk -f configFile
    3. 4.16.01 から更新する場合は、データセンター 2 の Macine 7、8、9 で Zookeeper をダウングレードします。
      > yumulation apigee-zookeeper をダウングレードします。
    4. データセンター 2 のマシン 7、8、9 の場合
      > /opt/apigee/apigee-setup/bin/update.sh -c cs,zk -f configFile
  4. 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 を繰り返します。
  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、1、2、3
      > /opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile
    2. データセンター 2 のマシン 10、11、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
  8. データセンター 1 とデータセンター 2 のマシン 6 と 12 を更新します。
    1. マシン 6 で Postgres サーバーを停止します。
      > /opt/apigee/apigee-service/bin/apigee-service edge-postgres-serverstop
    2. マシン 12 で Postgres サーバーと postgresql を停止します。
      > /opt/apigee/apigee-service/bin/apigee-service edge-postgres-serverstop
      > /opt/apigee/apigee-service/bin/apigee-postgresqlstop
    3. マシン 4、5、10、11 の Qpid サーバーを停止します。
      > /opt/apigee/apigee-service/bin/apigee-service edge-qpid-serverstop
    4. ロールバック用に追加した新しいスタンバイ ノードで Postgres サーバーと postgresql を停止します。
      > /opt/apigee/apigee-service/bin/apigee-service edge-postgres-serverstop
      > /opt/apigee/apigee-service/bin/apigee-service apigee-postgresqlstop
    5. マシン 6 の postgresql を更新します。
      > /opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile
    6. マシン 6 の Postgres データベースを更新します(Postgres マスターのみ)。
      > /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql db_upgrade
    7. マシン 12 の postgresql を更新します。
      > /opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile
    8. マシン 6 と 12 で Postgres サーバー サーバーを起動します。
      > /opt/apigee/apigee-service/bin/apigee-service edge-postgres-server start
    9. マシン 4、5、10、11 で Qpid サーバー サーバーを起動します。
      > /opt/apigee/apigee-service/bin/apigee-service edge-qpid-server start
    10. マシン 12 で次のコマンドを実行して、Postgres をスタンバイ ノードとして構成します。
      > cd /opt/apigee/data/apigee-postgresql/p'></
      > rm -rf *
      > > /opt/apigee/apigee-service/bin/apigee-service apigee-rf *
      setup-replication-on-standby -f
      configFile
    11. 両方のサーバーで次のスクリプトを発行して、レプリケーションのステータスを確認します。レプリケーションが正常に行われるように、両方のサーバーで同じ結果が表示されるはずです。
      マスターノードであるマシン 6 で、次のコマンドを実行します。
      > /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql postgres-check-master

      マスターノードであることが示されていることを確認します。

      マシン 12(スタンバイ ノード)で、次の操作を行います。
      > /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql postgres-check-standby

      スタンバイ ノードが表示されていることを確認します。
  9. マシン 6 と 12 の Edge コンポーネントを更新します。
    > /opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile
  10. 前述の Postgres ノードを廃止するの手順に沿って、新しいスタンバイ ノードを廃止します。

7 ホストまたは 10 ホストの API BaaS インストールの場合

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

標準以外の環境がある場合は、次の順序で Edge コンポーネントを更新します。

  1. ZooKeeper
  2. Cassandra
  3. Qpidd
  4. LDAP
  5. Edge(すべてのノードにある「-c edge」プロファイル)。Qpid サーバーがあるが、Postgres サーバー、Management Server、Message Processor、Router は存在しないノードです。
    : ノードに Qpid Server と Postgres Server の両方がインストールされている場合は、ステップ 8 で「-c edge」プロファイルの手順を実施してください。
  6. Edge UI
  7. Postgres マスター上の postgresql(アップグレードを含む)。
  8. Postgres スタンバイ上の postgresql。
  9. Edge(Qpid と Postgres を組み合わせたすべてのノード、またはスタンドアロンの Postgres ノードにある「-c edge」プロファイル)。