Apigee Edge 4.17.05 または 4.17.09 から 4.18.05 への更新

Edge for Private Cloud v4.18.05

このセクションでは、次のアップグレードを行う場合の方法について説明します。

  • 4.17.05 から 4.18.05
  • 4.17.09 から 4.18.05

更新を行えるユーザー

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

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

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

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

互換性の維持

Apigee Edge for Private Cloud を 4.18.05 にアップグレードする場合、アップグレードの実行後、構成ファイルのプロパティでサポート対象のものだけが参照されていることを確認してください。

プロパティ 場所 説明
conf_load_balancing_load.balancing.
  driver.nginx.server.retry
router.properties router.properties ファイルからこのプロパティを削除します。4.18.05 で retry オプションを設定するには、仮想ホストの構成プロパティを使用します。

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

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

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

Edge 4.17.05 では、SMTP サーバーを有効にする場合に使用する必要のある構成ファイルが新しく追加されています。

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

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

本番環境の Edge システムの場合、通常は 2 台の Postgres ノードでマスター / スタンバイのレプリケーションを構成します。更新の際、Postgres ノードはダウンしますが、分析データは Qpid ノードに書き込まれます。Postgres が更新され、オンラインに復帰すると、分析データが Postgres ノードに送信されるようになります。

Postgres の更新方法は、Postgres ノードのデータ ストレージの構成方法によって異なります。

  • Postgres ノードにローカルのデータ ストレージを使用している場合は、アップグレード用に Postgres のスタンバイ ノードを新しくインストールする必要があります。アップグレードが完了したら、新たに用意した Postgres スタンバイ ノードは廃止できます。

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

    Edge を 1 ノード、2 ノードとしてインストールし、プロトタイピングやテストにトポロジを使用する場合は、単一の Postgres ノードのみが使用されます。このような Postgres ノードは、新たに Postgres ノードを作成することなく直接更新できます。

  • Postgres ノードにネットワーク ストレージを使用している場合は、Postgres ノードを新しくインストールする必要はありません。この方法は Apigee からも推奨されています。下の手順の新しい Postgres スタンバイ ノードのインストールとその後の廃止の手順は省略できます。

    更新を始める前に、Postgres で使用されるデータストアのネットワーク スナップショットを取得します。更新の際になんらかのエラーが発生し、ロールバックを行う必要が生じた場合は、スナップショットから Postgres ノードを復元できます。

Postgres スタンバイ ノードを新たにインストールする

この手順では、新しいノードに Postgres のスタンバイ サーバーを作成します。新たに Postgres スタンバイ サーバーをインストールするのは、Edge の既存のバージョン(4.17.05 または 4.17.09)であり、バージョン 4.18.05 でないことを確認してください。

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

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

  1. 現在の Postgres マスターで、/opt/apigee/customer/application/postgresql.properties ファイルを編集し、次のトークンを設定します。このファイルが存在しない場合は、作成します。
    conf_pg_hba_replication.connection=host replication apigee existing_slave_ip/32 trust\ \nhost replication apigee new_slave_ip/32 trust

    ここで、Iexisting_slave_ip は現在の Postgres スタンバイ サーバーの IP アドレスで、new_slave_ip は新しいスタンバイ ノードの 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 address of the current master:
          PG_MASTER=192.168.56.103
          # IP address of the new standby node
          PG_STANDBY=192.168.56.102
    2. Edge apigee-setup ユーティリティのインストールを参照し、SELinux を無効にします。
    3. Edge の bootstrap_4.17.0x.sh ファイル(x5(4.17.05)または 9(4.17.09)のいずれか)を /tmp/bootstrap_4.17.0x.sh にダウンロードします。
      curl https://software.apigee.com/bootstrap_4.17.0x.sh -o /tmp/bootstrap_4.17.0x.sh
    4. Edge apigee-service ユーティリティと依存関係をインストールします。
      sudo bash /tmp/bootstrap_4.17.0x.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 が表示されます。

    "type" : [ "postgres-server" ],
        "uUID" : "599e8ebf-5d69-4ae4-aa71-154970a8ec75"
  3. 新しいスタンバイ ノードで、次のコマンドを実行して、新しいスタンバイ ノードを停止させます。
    /opt/apigee/apigee-service/bin/apigee-all stop
  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 管理 API を呼び出して、ZooKeeper からスタンバイ ノードの UUID を削除します。
    curl -u sysAdminEmail:password -X DELETE http://ms_IP:8080/v1/servers/new_slave_uuid

更新の前提条件

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

  • すべてのノードをバックアップする
    安全上の理由により、更新を行う前にすべてのノードを完全にバックアップすることをおすすめしています。現在のバージョンの Edge でバックアップを行うには、次の手順を使用します。

    これにより、新しいバージョンへの更新が正常に行われなかった場合に備えて、バックアップ プランを用意できます。バックアップの詳細については、バックアップと復元をご覧ください。

  • Edge が実行中であることを確認する
    次のコマンドを使用して、Edge が更新中に起動していることを確認します。
    /opt/apigee/apigee-service/bin/apigee-all status

更新が失敗した場合の対応

更新に失敗した場合は、問題の解決を試みた上で update.sh を再度実行できます。更新は複数回実行でき、最後に終了したところから続行されます。

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

更新情報のログ記録

デフォルトでは、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 と同じマシンにあるすべてのコンポーネントを更新してから、Router をロードバランサに追加し直します。

  1. マシンの更新順序を参照して、正しいインストール順序で各マシンを更新します。
  2. Router の更新の順になったら、任意の Router を 1 台選択し、サーバー(Message Processor または Router)の到達可能性の有効化/無効化を参照して、その Router を到達不能な状態にします。
  3. 選択した Router と Router と同じマシンにあるすべてのコンポーネントを更新します。すべての 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.17.0x のインストールに使用したものと同じである必要があります。

外部とのインターネット接続があるノードで 4.18.05 に更新する

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

  1. 現在、ローカル ストレージで Postgres のマスター / スタンバイ レプリケーションを使用している場合は、Postgres スタンバイ ノードを新たにインストールするを参照して、Postgres スタンバイ ノードを新たにインストールします。

    ネットワーク ストレージを使用している場合は、新しいノードをインストールする必要はありません。Postgres で使用するデータストアのネットワーク スナップショットを取得します。詳細については、Postgres 9.6 へのアップグレードが必須を参照してください。

  2. Cassandra の修復オペレーションを行うように構成されている CRON ジョブがある場合は、更新が完了するまで無効にします。
  3. ノードに root としてログインし、Edge RPM をインストールします。
  4. yum-utilsyum-plugin-priorities をインストールします。
    sudo yum install yum-utils
        sudo yum install yum-plugin-priorities
  5. Edge apigee-setup ユーティリティのインストールを参照し、SELinux を無効にします。
  6. Oracle 7.x にインストールしている場合は、次のコマンドを実行します。
    sudo yum-config-manager --enable ol7_optional_latest
  7. 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
  8. Edge 4.18.05 の bootstrap_4.18.05.sh ファイルを /tmp/bootstrap_4.18.05.sh にダウンロードします。
    curl https://software.apigee.com/bootstrap_4.18.05.sh -o /tmp/bootstrap_4.18.05.sh
  9. Edge 4.18.05 の apigee-service ユーティリティと依存関係をインストールします。
    sudo bash /tmp/bootstrap_4.18.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 を自身でインストールする必要があります。
  10. apigee-service を使用して、apigee-setup ユーティリティを更新します。
    /opt/apigee/apigee-service/bin/apigee-service apigee-setup update
  11. Management Server で apigee-validate ユーティリティを更新します。
    /opt/apigee/apigee-service/bin/apigee-service apigee-validate update
  12. apigee-provision ユーティリティを更新します。
    /opt/apigee/apigee-service/bin/apigee-service apigee-provision update
  13. マシンの更新順序に記載の順序で、ノードの update ユーティリティを実行します。
    /opt/apigee/apigee-setup/bin/update.sh -c component -f configFile

    構成ファイルは、「apigee」ユーザーによってアクセス可能であり、読み取り可能である必要があります。

    -c オプションを使用して、更新するコンポーネントを指定します。利用可能なコンポーネントの一覧は、次のとおりです。

    • 「cs」= Cassandra
    • 「e」= ElasticSearch
    • 「edge」= Edge UI 以外のすべての Edge コンポーネント。「edge」を選択した場合のコンポーネントには、Management Server、Message Processor、Router、QPID Server、Edge Postgres Server が含まれます。
    • 「ldap」= OpenLDAP
    • 「ps」= postgresql
    • 「qpid」= qpidd
    • 「sso」= Edge SSO
    • 「ui」= Edge UI
    • 「zk」= Zookeeper

    -c オプションに「all」を設定することで、すべてのコンポーネントに対して update.sh を実行できます。ただし、利用できるのは、Edge のオールインワン型(aio)インストール プロファイルがある場合のみです。たとえば、次のようになります。

    /opt/apigee/apigee-setup/bin/update.sh -c all -f ./sa_silent_config
  14. Edge UI コンポーネントを実行しているマシンで、同コンポーネントをまだ再起動していない場合は、再起動します。
    /opt/apigee/apigee-service/bin/apigee-service edge-ui restart
  15. インストールのテストを参照して、Management Server で apigee-validate ユーティリティを実行して、更新のテストを行います。
  16. Postgres スタンバイ ノードを新たにインストールした場合は、Postgres ノードを廃止するを参照して、ノードを廃止します。

    ネットワーク ストレージを使用している場合は、新しいノードをインストールする必要はありません。詳細については、Postgres 9.6 へのアップグレードが必須を参照してください。

後で更新をロールバックする場合は、4.18.05 のロールバックに記載の手順を使用してください。

ローカル リポジトリから 4.18.05 へ更新する

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

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

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

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

  1. 現在、Postgres のマスター / スタンバイ レプリケーションを使用している場合は、Postgres スタンバイ ノードを新たにインストールするを参照して、Postgres スタンバイ ノードを新たにインストールします。

    ネットワーク ストレージを使用している場合は、新しいノードをインストールする必要はありません。Postgres で使用するデータストアのネットワーク スナップショットを取得します。詳細については、Postgres 9.6 へのアップグレードが必須を参照してください。

  2. Edge apigee-setup ユーティリティのインストールの「ローカルに Apigee リポジトリを作成する」を参照し、ローカルに 4.18.05 リポジトリを作成します。
  3. .tar ファイルから apigee-service をインストールするには:
    1. ノードのローカル リポジトリで次のコマンドを使用し、ローカル リポジトリを /opt/apigee/data/apigee-mirror/apigee-4.18.05.tar.gz という名前の単一の .tar ファイルにパッケージします。
      /opt/apigee/apigee-service/bin/apigee-service apigee-mirror package
    2. .tar ファイルを Edge を更新するノードにコピーします。たとえば、新しいノードの /tmp ディレクトリにコピーします。
    3. 新しいノードで、tar ファイルを解凍し、/tmp ディレクトリに展開します。
      tar -xzf apigee-4.18.05tar.gz

      このコマンドにより、repos という名前の新しいディレクトリが作成されます。ディレクトリには .tar ファイルが含まれます。たとえば、/tmp/repos のようになります。

    4. /tmp/repos から Edge apigee-service ユーティリティと依存関係をインストールします。
      sudo bash /tmp/repos/bootstrap_4.18.05.sh apigeeprotocol="file://" apigeerepobasepath=/tmp/repos

      コマンドに、repos ディレクトリへのパスが含まれている点に注意してください。

  4. Nginx ウェブサーバーを使用して apigee-service をインストールするには:
    1. Edge apigee-setup ユーティリティのインストールの「Nginx ウェブサーバーを使用してリポジトリからインストールする」を参照し、Nginx ウェブサーバーを構成します。
    2. リモートノードで、Edge の bootstrap_4.18.05.sh ファイルを /tmp/bootstrap_4.18.05.sh にダウンロードします。
      /usr/bin/curl http://uName:pWord@remoteRepo:3939/bootstrap_4.18.05.sh -o /tmp/bootstrap_4.18.05.sh

      uName:pWord は、以前にリポジトリに設定したユーザー名とパスワードです。remoteRepo は、リポジトリのあるノードの IP アドレスまたは DNS 名です。

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

      uName:pWord は、リポジトリのユーザー名とパスワードです。

  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 update
  7. apigee-provision ユーティリティを更新します。
    /opt/apigee/apigee-service/bin/apigee-service apigee-provision update
  8. マシンの更新順序に記載の順序で、ノードの update ユーティリティを実行します。
    /opt/apigee/apigee-setup/bin/update.sh -c component -f configFile

    構成ファイルは、「apigee」ユーザーによってアクセス可能であり、読み取り可能である必要があります。

    -c オプションを使用して、更新するコンポーネントを指定します。利用可能なコンポーネントの一覧は、次のとおりです。

    • 「cs」= Cassandra
    • 「e」= ElasticSearch
    • 「edge」= Edge UI 以外のすべての Edge コンポーネント。「edge」を選択した場合のコンポーネントには、Management Server、Message Processor、Router、QPID Server、Edge Postgres Server が含まれます。
    • 「ldap」= OpenLDAP
    • 「ps」= postgresql
    • 「qpid」= qpidd
    • 「sso」= Edge SSO
    • 「ui」= Edge UI
    • 「zk」= Zookeeper

    -c オプションに「all」を設定することで、すべてのコンポーネントに対して update.sh を実行できます。ただし、利用できるのは、Edge のオールインワン型(aio)インストール プロファイルがある場合のみです。たとえば、次のようになります。

    /opt/apigee/apigee-setup/bin/update.sh -c all -f ./sa_silent_config
  9. Edge UI コンポーネントを実行しているマシンで、同コンポーネントをまだ再起動していない場合は、再起動します。
    /opt/apigee/apigee-service/bin/apigee-service edge-ui restart
  10. インストールのテストを参照して、Management Server で apigee-validate ユーティリティを実行して、更新のテストを行います。
  11. Postgres スタンバイ ノードを新たにインストールした場合は、Postgres ノードを廃止するを参照して、ノードを廃止します。

    ネットワーク ストレージを使用している場合は、新しいノードをインストールする必要はありません。詳細については、Postgres 9.6 へのアップグレードが必須を参照してください。

後で更新をロールバックする場合は、4.18.05 のロールバックに記載の手順を使用してください。

マシンの更新順序

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

  • すべての Cassandra ノードと ZooKeeper ノードを、それ以外のノードよりも先に更新してください。
  • 複数の Edge コンポーネント(Management Server、Message Processor、Router、QPID Server。Postgres Server は該当せず)を搭載しているマシンでは、「-c edge」オプションを使用して、それらのコンポーネントをすべて同時に更新します。
  • 複数のマシンで行う必要がある手順に関しては、所定のマシン順序に従って実施します。
  • Monetization の更新に関して、別に用意された手順はありません。「-c edge」オプションを指定した場合に更新されます。

1 ノード スタンドアロン インストール

  1. Cassandra および ZooKeeper を更新します。
    /opt/apigee/apigee-setup/bin/update.sh -c cs,zk -f configFile
  2. Qpid を更新します。
    /opt/apigee/apigee-setup/bin/update.sh -c qpid -f configFile
  3. LDAP を更新します。
    /opt/apigee/apigee-setup/bin/update.sh -c ldap -f configFile
  4. Postgres Server、Qpid Server、PostgreSQL を停止させます。
    /opt/apigee/apigee-service/bin/apigee-service edge-postgres-server stop
        /opt/apigee/apigee-service/bin/apigee-service edge-qpid-server stop
        /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql stop
  5. postgresql を更新します。
    /opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile
  6. Postgres データベースを更新します。
    /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql db_upgrade
  7. 残りの Edge コンポーネントを更新します。
    /opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile
  8. Edge UI を更新します。
    /opt/apigee/apigee-setup/bin/update.sh -c ui -f configFile
  9. Edge SSO をインストールしている場合は、Edge SSO を更新します。
    /opt/apigee/apigee-setup/bin/update.sh -c sso -f sso_config_file

    sso_config_file は、SSO をインストールした際に作成した構成ファイルになります。

  10. Edge UI コンポーネントを再起動します。
    /opt/apigee/apigee-service/bin/apigee-service edge-ui restart

2 ノード スタンドアロン インストール

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

  1. マシン 1 の Cassandra および ZooKeeper を更新します。
    /opt/apigee/apigee-setup/bin/update.sh -c cs,zk -f configFile
  2. マシン 2 の Qpid を更新します。
    /opt/apigee/apigee-setup/bin/update.sh -c qpid -f configFile
  3. マシン 1 の LDAP を更新します。
    /opt/apigee/apigee-setup/bin/update.sh -c ldap -f configFile
  4. マシン 1 の Edge コンポーネントを更新します。
    /opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile
  5. マシン 1 の UI を更新します。
    /opt/apigee/apigee-setup/bin/update.sh -c ui -f configFile
  6. Edge SSO をインストールしている場合は、マシン 1 の Edge SSO を更新します。
    /opt/apigee/apigee-setup/bin/update.sh -c sso -f sso_config_file

    sso_config_file は、SSO をインストールした際に作成した構成ファイルになります。

  7. マシン 2 の postgresql を更新します。
    1. Postgres Server、Qpid Server、postgresql を停止させます。
      /opt/apigee/apigee-service/bin/apigee-service edge-postgres-server stop
          /opt/apigee/apigee-service/bin/apigee-service edge-qpid-server stop
          /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql stop
    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
  8. マシン 1 の Edge UI コンポーネントを再起動します。
    /opt/apigee/apigee-service/bin/apigee-service edge-ui restart

5 ノード インストール

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

  1. Postgres ノードを新たにインストールするの手順に沿って、Postgres スタンバイ ノードがインストールされていることを確認します。

    ネットワーク ストレージを使用している場合は、新しいノードをインストールする必要はありません。Postgres で使用するデータストアのネットワーク スナップショットを取得します。詳細については、Postgres 9.6 へのアップグレードが必須を参照してください。

  2. マシン 1、2、3 の Cassandra および ZooKeeper を更新します。
    /opt/apigee/apigee-setup/bin/update.sh -c cs,zk -f configFile
  3. マシン 4、5 の Qpid を更新します。
    /opt/apigee/apigee-setup/bin/update.sh -c qpid -f configFile
  4. マシン 1 の LDAP を更新します。
    /opt/apigee/apigee-setup/bin/update.sh -c ldap -f configFile
  5. マシン 1、2、3 の Edge コンポーネントを更新します。
    /opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile
  6. マシン 1 の UI を更新します。
    /opt/apigee/apigee-setup/bin/update.sh -c ui -f configFile
  7. Edge SSO をインストールしている場合は、マシン 1 の Edge SSO を更新します。
    /opt/apigee/apigee-setup/bin/update.sh -c sso -f sso_config_file

    sso_config_file は、SSO をインストールした際に作成した構成ファイルになります。

  8. マシン 4、5 を更新します。
    1. マシン 4 の Postgres Server、Qpid Server を停止させます。
      /opt/apigee/apigee-service/bin/apigee-service edge-postgres-server stop
          /opt/apigee/apigee-service/bin/apigee-service edge-qpid-server stop
    2. マシン 5 の Postgres Server、Qpid Server、postgresql を停止させます。
      /opt/apigee/apigee-service/bin/apigee-service edge-postgres-server stop
          /opt/apigee/apigee-service/bin/apigee-service edge-qpid-server stop
          /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql stop
    3. ロールバックに備えて新たに追加したスタンバイ ノードに、Postgres Server と postgresql がインストールされている場合は、Postgres Server と postgresql も停止させます。
      /opt/apigee/apigee-service/bin/apigee-service edge-postgres-server stop
          /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql stop
    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 Server、Qpid Server を起動させます。
      /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/pgdata
          rm -rf *
          /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql setup-replication-on-standby -f configFile
    9. マシン 4、5 の両方で、次のスクリプトを実行してレプリケーションの状況を確認します。レプリケーションが成功していることを確認するには、両方で同じ結果が表示されていなければなりません。
      • マシン 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

        スタンバイと表示されるか確認します。

  9. マシン 4、5 の Edge コンポーネントを更新します。
    /opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile
  10. 新たに用意されたスタンバイ ノードが Postgres ノードを廃止するの手順に沿って廃止されているか確認します。

    ネットワーク ストレージを使用している場合は、新しいノードをインストールする必要はありません。詳細については、Postgres 9.6 へのアップグレードが必須を参照してください。

  11. マシン 1 の Edge UI コンポーネントを再起動します。
    /opt/apigee/apigee-service/bin/apigee-service edge-ui restart

9 ノードクラスタ インストール

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

  1. Postgres スタンバイ ノードを新たにインストールするの手順に沿って、Postgres スタンバイ ノードがインストールされていることを確認します。

    ネットワーク ストレージを使用している場合は、新しいノードをインストールする必要はありません。Postgres で使用するデータストアのネットワーク スナップショットを取得します。詳細については、Postgres 9.6 へのアップグレードが必須を参照してください。

  2. マシン 1、2、3 の Cassandra および ZooKeeper を更新します。
    /opt/apigee/apigee-setup/bin/update.sh -c cs,zk -f configFile
  3. マシン 6、7 の Qpid を更新します。
    /opt/apigee/apigee-setup/bin/update.sh -c qpid -f configFile
  4. マシン 1 の LDAP を更新します。
    /opt/apigee/apigee-setup/bin/update.sh -c ldap -f configFile
  5. マシン 6、7、1、4、5 の順に Edge コンポーネントを更新します。
    /opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile
  6. マシン 1 の UI を更新します。
    /opt/apigee/apigee-setup/bin/update.sh -c ui -f configFile
  7. Edge SSO をインストールしている場合は、マシン 1 の Edge SSO を更新します。
    /opt/apigee/apigee-setup/bin/update.sh -c sso -f sso_config_file

    sso_config_file は、SSO をインストールした際に作成した構成ファイルになります。

  8. マシン 8、9 を更新します。
    1. マシン 8 の Postgres Server を停止させます。
      /opt/apigee/apigee-service/bin/apigee-service edge-postgres-server stop
    2. マシン 9 の Postgres Server、postgresql を停止させます。
      /opt/apigee/apigee-service/bin/apigee-service edge-postgres-server stop
          /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql stop
    3. マシン 6、7 の Qpid Server を停止させます。
      /opt/apigee/apigee-service/bin/apigee-service edge-qpid-server stop
    4. ロールバックに備えて新たに追加したスタンバイ ノードに、Postgres Server と postgresql がインストールされている場合は、Postgres Server と postgresql も停止させます。
      /opt/apigee/apigee-service/bin/apigee-service edge-postgres-server stop
          /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql stop
    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 Server を起動させます。
      /opt/apigee/apigee-service/bin/apigee-service edge-postgres-server start
    9. マシン 6、7 の Qpid Server を起動させます。
      /opt/apigee/apigee-service/bin/apigee-service edge-qpid-server start
    10. マシン 9 で、次のコマンドを実行して、スタンバイ ノードとして Postgres を構成します。
      cd /opt/apigee/data/apigee-postgresql/pgdata
          rm -rf *
          /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql setup-replication-on-standby -f configFile
    11. マシン 8、9 の両方で、次のスクリプトを実行してレプリケーションの状況を確認します。レプリケーションが成功していることを確認するには、両方で同じ結果が表示されていなければなりません。
      • マシン 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

        スタンバイと表示されるか確認します。

  9. マシン 8、9 の Edge コンポーネントを更新します。
    /opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile
  10. 新たに用意されたスタンバイ ノードが Postgres ノードを廃止するの手順に沿って廃止されているか確認します。

    ネットワーク ストレージを使用している場合は、新しいノードをインストールする必要はありません。詳細については、Postgres 9.6 へのアップグレードが必須を参照してください。

  11. マシン 1 の Edge UI コンポーネントを再起動します。
    /opt/apigee/apigee-service/bin/apigee-service edge-ui restart

13 ノードクラスタ インストール

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

  1. Postgres スタンバイ ノードを新たにインストールするの手順に沿って、Postgres スタンバイ ノードがインストールされていることを確認します。

    ネットワーク ストレージを使用している場合は、新しいノードをインストールする必要はありません。Postgres で使用するデータストアのネットワーク スナップショットを取得します。詳細については、Postgres 9.6 へのアップグレードが必須を参照してください。

  2. マシン 1、2、3 の Cassandra および ZooKeeper を更新します。
    /opt/apigee/apigee-setup/bin/update.sh -c cs,zk -f configFile
  3. マシン 12、13 の Qpid を更新します。
    /opt/apigee/apigee-setup/bin/update.sh -c qpid -f configFile
  4. マシン 4、5 の LDAP を更新します。
    /opt/apigee/apigee-setup/bin/update.sh -c ldap -f configFile
  5. マシン 12、13、6、7、10、11 の順に Edge コンポーネントを更新します。
    /opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile
  6. マシン 6、7 の UI を更新します。
    /opt/apigee/apigee-setup/bin/update.sh -c ui -f configFile
  7. Edge SSO をインストールしている場合は、マシン 6、7 の Edge SSO を更新します。
    /opt/apigee/apigee-setup/bin/update.sh -c sso -f sso_config_file

    sso_config_file は、SSO をインストールした際に作成した構成ファイルになります。

  8. マシン 8、9 を更新します。
    1. マシン 8 の Postgres Server を停止させます。
      /opt/apigee/apigee-service/bin/apigee-service edge-postgres-server stop
    2. マシン 9 の Postgres Server、postgresql を停止させます。
      /opt/apigee/apigee-service/bin/apigee-service edge-postgres-server stop
          /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql stop
    3. マシン 12、13 の Qpid Server を停止させます。
      /opt/apigee/apigee-service/bin/apigee-service edge-qpid-server stop
    4. ロールバックに備えて新たに追加したスタンバイ ノードに、Postgres Server と postgresql がインストールされている場合は、Postgres Server と postgresql も停止させます。
      /opt/apigee/apigee-service/bin/apigee-service edge-postgres-server stop
          /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql stop
    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 Server を起動させます。
      /opt/apigee/apigee-service/bin/apigee-service edge-postgres-server start
    9. マシン 12、13 の Qpid Server を起動させます。
      /opt/apigee/apigee-service/bin/apigee-service edge-qpid-server start
    10. マシン 9 で、次のコマンドを実行して、スタンバイ ノードとして Postgres を構成します。
      cd /opt/apigee/data/apigee-postgresql/pgdata
          rm -rf *
          /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql setup-replication-on-standby -f configFile
    11. マシン 8、9 の両方で、次のスクリプトを実行してレプリケーションの状況を確認します。レプリケーションが成功していることを確認するには、両方で同じ結果が表示されていなければなりません。
      • マシン 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

        スタンバイと表示されるか確認します。

  9. マシン 8、9 の Edge コンポーネントを更新します。
    /opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile
  10. 新たに用意されたスタンバイ ノードが Postgres ノードを廃止するの手順に沿って廃止されているか確認します。

    ネットワーク ストレージを使用している場合は、新しいノードをインストールする必要はありません。詳細については、Postgres 9.6 へのアップグレードが必須を参照してください。

  11. マシン 6、7 の Edge UI コンポーネントを再起動します。
    /opt/apigee/apigee-service/bin/apigee-service edge-ui restart

12 ノードクラスタ インストール

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

  1. Postgres スタンバイ ノードを新たにインストールするの手順に沿って、Postgres スタンバイ ノードがインストールされていることを確認します。

    ネットワーク ストレージを使用している場合は、新しいノードをインストールする必要はありません。Postgres で使用するデータストアのネットワーク スナップショットを取得します。詳細については、Postgres 9.6 へのアップグレードが必須を参照してください。

  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 の qpidd を更新します。
        /opt/apigee/apigee-setup/bin/update.sh -c qpid -f configFile
      2. マシン 5 で、手順 1 を繰り返します。
    2. データセンター 2 のマシン 10、11 で、次の手順を実施します。
      1. マシン 10 の qpidd を更新します。
        /opt/apigee/apigee-setup/bin/update.sh -c qpid -f configFile
      2. マシン 11 で、手順 1 を繰り返します。
  4. LDAP を更新します。
    1. データセンター 1 のマシン 1 で、次のコマンドを実行します。
      /opt/apigee/apigee-setup/bin/update.sh -c ldap -f configFile
    2. データセンター 2 のマシン 7 で、次のコマンドを実行します。
      /opt/apigee/apigee-setup/bin/update.sh -c ldap -f configFile
  5. Edge コンポーネントを更新します。
    1. データセンター 1 のマシン 4、5、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
  6. UI を更新します。
    1. データセンター 1 のマシン 1 で、次のコマンドを実行します。
      /opt/apigee/apigee-setup/bin/update.sh -c ui -f configFile
    2. データセンター 2 のマシン 7 で、次のコマンドを実行します。
      /opt/apigee/apigee-setup/bin/update.sh -c ui -f configFile
  7. Edge SSO をインストールしている場合は、Edge SSO を更新します。
    1. データセンター 1 のマシン 1 で、次のコマンドを実行します。
      /opt/apigee/apigee-setup/bin/update.sh -c sso -f sso_config_file
    2. データセンター 2 のマシン 7 で、次のコマンドを実行します。
      /opt/apigee/apigee-setup/bin/update.sh -c sso -f sso_config_file
    3. sso_config_file は、SSO をインストールした際に作成した構成ファイルになります。

  8. データセンター 1 のマシン 6 とデータセンター 2 のマシン 12 を更新します。
    1. マシン 6 の Postgres Server を停止させます。
      /opt/apigee/apigee-service/bin/apigee-service edge-postgres-server stop
    2. マシン 12 の Postgres Server、postgresql を停止させます。
      /opt/apigee/apigee-service/bin/apigee-service edge-postgres-server stop
          /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql stop
    3. マシン 4、5、10、11 の Qpid Server を停止させます。
      /opt/apigee/apigee-service/bin/apigee-service edge-qpid-server stop
    4. ロールバックに備えて新たに追加したスタンバイ ノードに、Postgres Server と postgresql がインストールされている場合は、Postgres Server と postgresql も停止させます。
      /opt/apigee/apigee-service/bin/apigee-service edge-postgres-server stop
          /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql stop
    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 Server を起動させます。
      /opt/apigee/apigee-service/bin/apigee-service edge-postgres-server start
    9. マシン 4、5、10、11 の Qpid Server を起動させます。
      /opt/apigee/apigee-service/bin/apigee-service edge-qpid-server start
    10. マシン 12 で、次のコマンドを実行して、スタンバイ ノードとして Postgres を構成します。
      cd /opt/apigee/data/apigee-postgresql/pgdata
          rm -rf *
          /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql setup-replication-on-standby -f configFile
    11. マシン 6、12 の両方で、次のスクリプトを実行してレプリケーションの状況を確認します。レプリケーションが成功していることを確認するには、両方で同じ結果が表示されていなければなりません。

      マシン 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 ノードを廃止するの手順に沿って廃止されているか確認します。

    ネットワーク ストレージを使用している場合は、新しいノードをインストールする必要はありません。詳細については、Postgres 9.6 へのアップグレードが必須を参照してください。

  11. マシン 1、7 の Edge UI コンポーネントを再起動します。
    /opt/apigee/apigee-service/bin/apigee-service edge-ui restart

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

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

  1. ZooKeeper
  2. Cassandra
  3. qpidd、ps
  4. LDAP
  5. Edge、すべてのノードで「-c edge」プロファイルの順に従ってください。つまり、Qpid Server、Edge Postgres Server、Management Server、Message Processor、Router の順になります。
  6. Edge UI
  7. Edge SSO

更新が終了したら、Edge UI コンポーネントを実行しているすべてのマシンを再起動するようにしてください。