Apigee Edge を 4.16.09 に更新する

Edge for Private Cloud バージョン 4.16.09

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

Apigee Edge バージョン 4.16.01.0x および 4.16.05.x は 4.16.09 に更新できます。

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

更新を行えるユーザー

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

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

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 の「デフォルトで無効になっている暗号スイート」セクションをご覧ください。

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 が起動および実行されていることを確認します。

    > /<inst_root>/apigee/apigee-service/bin/apigee-all status

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

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

失敗したため前のバージョンへのロールバックが必要になった場合は、4.16.09 ロールバック プロセスをご覧ください。

更新情報のロギング

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

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

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

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

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

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

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

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

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

この手順では、新しいノードに Postgres スタンバイ サーバーを作成します。バージョン 4.16.09 ではなく、既存の 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.16.09 に更新する手順

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

  1. 現在 Postgres のマスター / スタンバイ レプリケーションを使用している場合は、上記の新しい Postgres スタンバイ ノードをインストールするの説明に沿って、新しい Postgres スタンバイ ノードをインストールします。
  2. CRON ジョブが存在する場合は、更新が完了するまで、Cassandra で修復オペレーションを行うように構成された CRON ジョブを無効にします。
  3. ノードに root としてログインし、Edge RPM をインストールします。
    : RPM のインストールには root 権限が必要ですが、Edge の構成には root 権限は不要です。
  4. Edge apigee-setup ユーティリティのインストールの説明に従って、SELinux を無効にします。
  5. Edge 4.16.09 の 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
  6. Edge 4.16.09 の apigee-service ユーティリティと依存関係をインストールします。
    > sudo bash /tmp/bootstrap_4.16.09.sh apigeeuser=uName apigeepassword=pWord


    uName:pWord は Apigee から受け取ったユーザー名とパスワードです。pWord を省略した場合は、入力するように求められます。

    デフォルトでは、インストーラによって Java 1.8 がインストールされているかどうかが確認されます。インストールされていない場合は、自動的にインストールされます。Java のインストール処理方法を指定するには、JAVA_FIX オプションを使用します。JAVA_FIX には次の値を指定できます。

    I = OpenJDK 1.8 をインストールする(デフォルト)
    C = Java をインストールせずに続行
    Q = 終了。このオプションでは、Java をユーザー自身でインストールする必要があります。
  7. 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

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

      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.apigee/apigee_dir ユーティリティが <inst/
    3. 4.16.05 を直接または更新によってインストールした場合は、apigee-setup ユーティリティを更新する必要があります
      > /opt/apigee/apigee-service/bin/apigee-service apigee-setup アップデート

      apigee-service への更新により、update.sh ユーティリティが <inst_dir>/apigee/apigee-setup/bin にインストールされます。
  8. 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

      : 4.16.01 で、apigee-validate4 ユーティリティを次のとおりインストールし、apigee-validate ユーティリティを apigee/apigee/apigee-service/bin/apigee-service apigee-validate install

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


      このリリースでは、構成ファイルに APIGEE_ADMINPW プロパティのみが必要です。他の 2 つのプロパティはファイルから削除できます。
  9. apigee-provision ユーティリティを更新します。
    > /opt/apigee/apigee-service/bin/apigee-service apigee-provision update
  10. 以下のマシンの更新順序に記載されている順序で、ノードで更新ユーティリティを実行します。
    > /opt/apigee/apigee-setup/bin/update.sh -c component -f configFile

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

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





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

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

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

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

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

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

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

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

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

      このコマンドには repos ディレクトリへのパスを指定します。
  4. Nginx ウェブサーバーを使用して apigee-service をインストールするには:
    1. Edge apigee-setup ユーティリティのインストールの「Nginx ウェブサーバーを使用してリポジトリからインストールする」の手順に沿って、Nginx ウェブサーバーを構成します。
    2. リモートノードで、Edge bootstrap_4.16.09.sh ファイルを <ph type="x-smartling-void-element"><wbr /></ph> <ph type="x-smartling-void-element"><wbr /></ph>


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

      ここで、uNameuName です。
  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

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

      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 ユーティリティが <inst_dir>/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.16.09 ロールバック プロセスで説明されている手順を使用します。

マシンの更新順序

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

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

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

  1. 4.16.01 から更新する場合は、Zookeeper をダウングレードします。
    > yumgrade apigee-zookeeper
  2. Cassandra と ZooKeeper を更新します。
    > /opt/apigee/apigee-setup/bin/update.sh -c cs,zk -f configFile
  3. qpidd を更新します。
    > /opt/apigee/apigee-setup/bin/update.sh -c qpid -f configFile
  4. LDAP を更新します。
    > /opt/apigee/apigee-setup/bin/update.sh -c ldap -f configFile
  5. Postgres Server、Qpid サーバー、PostgreSQL を停止します。
    > > /opt/apigee/apigee-service/bin/apigee-service edge-postgres-serverstop
    > > /opt/apigee/apigee-service/bin/apigee-service edge-qpid-serverstop
  6. postgresql を更新します。
    > /opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile
  7. Postgres データベースを更新します。
    > /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql db_upgrade
  8. 残りの Edge コンポーネントを更新します。
    > /opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile
  9. Edge UI を更新します。
    > /opt/apigee/apigee-setup/bin/update.sh -c ui -f configFile

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

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

  1. 4.16.01 からアップデートする場合は、マシン 1 で Zookeeper をダウングレードします。
    > yum ければ apigee-zookeeper をダウングレードします
  2. マシン 1 の Cassandra と ZooKeeper を更新します。
    > /opt/apigee/apigee-setup/bin/update.sh -c cs,zk -f configFile
  3. マシン 2 の qpidd を更新します。
    > /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 の 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. マシン 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 とマシン 1 の Edge コンポーネントを更新します。
      > /opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile
  8. マシン 2 の Edge コンポーネントを更新します。
    > /opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile

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

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

  1. 新しい Postgres スタンバイ ノードのインストールの説明に従って、新しい Postgres スタンバイ ノードがインストールされていることを確認します。
  2. 4.16.01 から更新する場合は、マシン 1、2、3 で Zookeeper をダウングレードします。
    > yum ければ apigee-zookeeper をダウングレードします
  3. マシン 1、2、3 の Cassandra と ZooKeeper を更新します。
    > /opt/apigee/apigee-setup/bin/update.sh -c cs,zk -f configFile
  4. マシン 4 と 5 の qpidd を更新します。
    > /opt/apigee/apigee-setup/bin/update.sh -c qpid -f configFile
  5. マシン 1 の LDAP を更新します。
    > /opt/apigee/apigee-setup/bin/update.sh -c ldap -f configFile
  6. マシン 1、2、3 の Edge コンポーネントを更新します。
    > /opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile
  7. マシン 1 の UI を更新します。
    > /opt/apigee/apigee-setup/bin/update.sh -c ui -f configFile
  8. マシン 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

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

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

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

  1. 新しい Postgres スタンバイ ノードのインストールの説明に従って、新しい Postgres スタンバイ ノードがインストールされていることを確認します。
  2. 4.16.01 から更新する場合は、マシン 1、2、3 で Zookeeper をダウングレードします。
    > yum apigee-zookeeper をダウングレードします
  3. マシン 1、2、3 の Cassandra と ZooKeeper を更新します。
    > /opt/apigee/apigee-setup/bin/update.sh -c cs,zk -f configFile
  4. マシン 6、7 の qpidd を更新します。
    > /opt/apigee/apigee-setup/bin/update.sh -c qpid -f configFile
  5. マシン 1 の LDAP を更新します。
    > /opt/apigee/apigee-setup/bin/update.sh -c ldap -f configFile
  6. マシン 6、7、1、4、5 の Edge コンポーネントをこの順序で更新します。
    > /opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile
  7. マシン 1 の UI を更新します。
    > /opt/apigee/apigee-setup/bin/update.sh -c ui -f configFile
  8. マシン 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

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

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

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

  1. 新しい Postgres スタンバイ ノードのインストールの説明に従って、新しい Postgres スタンバイ ノードがインストールされていることを確認します。
  2. 4.16.01 から更新する場合は、マシン 1、2、3 で Zookeeper をダウングレードします。
    > yum apigee-zookeeper をダウングレードします
  3. マシン 1、2、3 の Cassandra と ZooKeeper を更新します。
    > /opt/apigee/apigee-setup/bin/update.sh -c cs,zk -f configFile
  4. マシン 12、13 の qpidd を更新します。
    > /opt/apigee/apigee-setup/bin/update.sh -c qpid -f configFile
  5. マシン 4 と 5 の LDAP を更新します。
    > /opt/apigee/apigee-setup/bin/update.sh -c ldap -f configFile
  6. マシン 12、13、6、7、10、11 の Edge コンポーネントをこの順序で更新します。
    > /opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile
  7. マシン 6、7 の UI を更新します。
    > /opt/apigee/apigee-setup/bin/update.sh -c ui -f configFile
  8. マシン 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

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

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

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

  1. 新しい Postgres スタンバイ ノードのインストールの説明に従って、新しい Postgres スタンバイ ノードがインストールされていることを確認します。
  2. Cassandra と ZooKeeper を更新します。
    1. 4.16.01 から更新する場合は、データセンター 1 のマシン 1、2、3 の Zookeeper をダウングレードします。
      > yumulation apigee-zookeeper をダウングレードします。
    2. データセンター 1 のマシン 1、2、3 で、次のコマンドを実行します。
      > /opt/apigee/apigee-setup/bin/update.sh -c cs,zk -f configFile
    3. 4.16.01 から更新する場合は、データセンター 2 のマシン 7、8、9 で Zookeeper をダウングレードします。
      > yumulation apigee-zookeeper をダウングレードします。
    4. データセンター 2 のマシン 7、8、9 の場合
      > /opt/apigee/apigee-setup/bin/update.sh -c cs,zk -f configFile
  3. qpidd を更新します。
    1. データセンター 1 のマシン 4、5
      > /opt/apigee/apigee-setup/bin/update.sh -c qpid -f configFile
    2. データセンター 2 のマシン 10、11
      > /opt/apigee/apigee-setup/bin/update.sh -c qpid -f configFile
  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. データセンター 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

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

7 ホストの API BaaS をインストールする場合

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 インストールの場合

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
  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」プロファイル)。