Apigee Edge 4.16.09 を 4.18.01 に更新する

Edge for Private Cloud v4.18.01

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

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

バージョン 4.16.01 より前の Edge バージョンの場合は、まずバージョン 4.16.01.x に移行してから、バージョン 4.18.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 トポロジで詳しく説明します。

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.09）用に新しい 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.09.sh ファイルを /tmp/bootstrap_4.16.09.sh にダウンロードします。
      > curl https://software.apigee.com/bootstrap_4.16.09.sh -o /tmp/bootstrap_4.16.09.sh
    4. Edge の apigee-service ユーティリティと依存関係をインストールします。
      > sudo bash /tmp/bootstrap_4.16.09.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>

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 サーバーを有効にするときに、構成ファイルで 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.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.18.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.18.01 に更新する手順

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

  1. 現在 Postgres のマスター / スタンバイ レプリケーションを使用している場合は、上記の新しい Postgres スタンバイ ノードをインストールするの説明に沿って、新しい Postgres スタンバイ ノードをインストールします。
  2. CRON ジョブが存在する場合は、更新が完了するまで、Cassandra で修復オペレーションを行うように構成された CRON ジョブを無効にします。
  3. ノードに root としてログインし、Edge RPM をインストールします。
    注: RPM のインストールには root 権限が必要ですが、Edge の構成には root 権限は不要です。
  4. yum-utils と yum-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 ユーティリティを更新します。
    > /opt/apigee/apigee-service/bin/apigee-service apigee-setup update
  12. Management Server で apigee-validate ユーティリティを更新します。
    > /opt/apigee/apigee-service/bin/apigee-service apigee-validate update
  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.09 リポジトリがすでにある場合は、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@remoteRepo1 が URL です。

    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 ユーティリティを更新します。
    > /opt/apigee/apigee-service/bin/apigee-service apigee-setup update
  6. Management Server で apigee-validate ユーティリティを更新します。
    > /opt/apigee/apigee-service/bin/apigee-service apigee-validate 更新
  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 = Baa Stack API と同じすべてのエッジ コンポーネント、Seba Portal および Baa Elastic Edge の同じプロファイルのみ、Seba Portal と Basa Elastic API をインストール





  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. 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. LDAP を更新します。
    > /opt/apigee/apigee-setup/bin/update.sh -c ldap -f configFile
  8. Postgres Server、Qpid サーバー、PostgreSQL を停止します。
    > > /opt/apigee/apigee-service/bin/apigee-service edge-postgres-serverstop
    > > /opt/apigee/apigee-service/bin/apigee-service edge-qpid-serverstop
  9. postgresql を更新します。
    > /opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile
  10. Postgres データベースを更新します。
    > /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql db_upgrade
  11. 残りの Edge コンポーネントを更新します。
    > /opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile
  12. 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. マシン 1 の LDAP を更新します。
    > /opt/apigee/apigee-setup/bin/update.sh -c ldap -f configFile
  8. マシン 1 の Edge コンポーネントを更新します。
    > /opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile
  9. マシン 1 の UI を更新します。
    > /opt/apigee/apigee-setup/bin/update.sh -c ui -f configFile?
  10. マシン 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. マシン 1、2、3 の Cassandra と ZooKeeper を更新します。
    > /opt/apigee/apigee-setup/bin/update.sh -c cs,zk -f configFile
  4. マシン 4 で次の iptables ルールを設定します。
    > sudo iptables -A INPUT -p tcp --destination-port 5672 !-s `hostname` -i eth0 -j DROP
  5. マシン 4 の Qpid メッセージ キューを確認します。
    > qpid-stat -q

    [msg] 列のカウントが 0 になるまでキューのチェックを続けます。すべてのメッセージを処理するまで、Qpid をアップグレードすることはできません。
  6. マシン 4 の qpidd を更新します。
    > /opt/apigee/apigee-setup/bin/update.sh -c qpid -f configFile
  7. マシン 4 の iptables をフラッシュします。
    > sudo iptables -F
  8. マシン 5 で手順 4 から 7 を繰り返します。
  9. マシン 1 の LDAP を更新します。
    > /opt/apigee/apigee-setup/bin/update.sh -c ldap -f configFile
  10. マシン 1、2、3 の 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
  12. マシン 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

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

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

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

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

    [msg] 列のカウントが 0 になるまでキューのチェックを続けます。すべてのメッセージを処理するまで、Qpid をアップグレードすることはできません。
  6. マシン 6 の qpidd を更新します。
    > /opt/apigee/apigee-setup/bin/update.sh -c qpid -f configFile
  7. マシン 6 の iptables をフラッシュします。
    > sudo iptables -F
  8. マシン 7 で手順 4 ～ 7 を繰り返します。
  9. マシン 1 の LDAP を更新します。
    > /opt/apigee/apigee-setup/bin/update.sh -c ldap -f configFile
  10. マシン 6、7、1、4、5 の 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
  12. マシン 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

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

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

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

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

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

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

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

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

  1. Edge で SMTP を有効にした場合は、構成ファイルで SMTP メール FROM を設定します。このパラメータの形式は次のようになります。
    SMTP メール FROM="My Company <myco@company.com>"
  2. 新しい Postgres スタンバイ ノードのインストールの説明に従って、新しい Postgres スタンバイ ノードがインストールされていることを確認します。
  3. 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
  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 ホストの 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 のインストールをご覧ください。

また、他のすべてのスタックノードからアクセスできるように、すべてのスタックノードでポート 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 インストールの場合

# 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 のインストールをご覧ください。

また、他のすべてのスタックノードからアクセスできるように、すべてのスタックノードでポート 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