Apigee Edge を 4.16.09 に更新する

Edge for Private Cloud v. 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 の「Default Disabled Cipher Suites」セクションをご覧ください。

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

ユーザーが /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 スタンバイ サーバーを作成します。新しい Postgres スタンバイ サーバーは、バージョン 4.16.09 ではなく、既存のバージョンの Edge(4.16.01 または 4.16.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

    ここで、existing_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 アドレス:
      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

      注: 4.16.01 から更新する場合は、Edge bootstrap.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 が表示されます。
    "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 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 をロードバランサに再び追加します。

  1. 「マシンの更新順序」で説明されているように、インストールに適した順序でマシンを更新します。
  2. Router を更新する時期になったら、サーバー(Message Processor/Router)のネットワーク到達性の有効化/無効化の説明に従って、いずれかの Router を選択して到達不能にします。
  3. 選択した Router と、その Router と同じマシンにある他のすべての Edge コンポーネントを更新します。すべての Edge 構成で、Router と Message Processor が同じノードに表示されます。
  4. ルーターを再び到達可能にします。
  5. 残りのルーターについて、手順 2 ~ 4 を繰り返します。
  6. インストール環境内の残りのマシンで更新を続行します。

更新の前後に次の点に注意してください。

  • Router と Message Processor の組み合わせノードの場合:
    • 更新前 - 次の操作を行います。
      1. ルーターを到達不能にします。
      2. Message Processor に到達できないようにします。
    • 更新後 - 次の操作を行います。
      1. Message Processor を到達可能にします。
      2. ルーターにアクセスできるようにします。
  • 単一のルーターノードの場合:
    • 更新前に、ルーターにアクセスできないようにします。
    • 更新後、Router にアクセスできるようにします。
  • 単一の Message Processor ノードの場合:
    • 更新する前に、Message Processor にアクセスできないようにします。
    • 更新後、Message Processor にアクセスできるようにします。

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

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

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

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

  1. 現在 Postgres のマスター / スタンバイ レプリケーションを使用している場合は、上記の新しい Postgres スタンバイ ノードをインストールするの説明に従って、新しい Postgres スタンバイ ノードをインストールします。
  2. 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_FIX オプションを使用して、Java のインストールを処理する方法を指定します。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

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

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

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

      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 を使用している場合: Management Server に apigee-validate ユーティリティをインストールします。
      > /opt/apigee/apigee-service/bin/apigee-service apigee-validate install

      注: 4.16.01 のインストール時に Message Processor ノードに apigee-validate ユーティリティをインストールした場合は、そのノードで次のコマンドを使用して更新できます。
      > /opt/apigee/apigee-service/bin/apigee-service apigee-validate update

      ただし、4.16.05 以降では、Management Server に apigee-validate ユーティリティをインストールして実行することをおすすめします。
    3. 4.16.01 からアップグレードする場合: apigee-validate ユーティリティに渡される構成ファイルを編集します。Edge リリース 4.16.01 では、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 =Edge UI を除くすべての Edge コンポーネント: Management Server、Message Processor、Router、QPID Server、Postgres Server
    ui = Edge UI
    all = マシン上のすべてのコンポーネントを更新(Edge aio インストール プロファイルまたは API BaaS asa インストール プロファイルでのみ使用)
    e = ElasticSearch
    b = API BaaS Stack
    p = API BaaS Portal
    ebp = 同じノード上の ElasticSearch、API BaaS Stack、API BaaS Portal
  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 -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 ファイルを /tmp/bootstrap_4.16.09.sh にダウンロードします。
      > /usr/bin/curl http://uName:pWord@remoteRepo:3939/bootstrap_4.16.09.sh -o /tmp/bootstrap_4.16.09.sh

      ここで、uName:pWord は、上記でリポジトリに設定したユーザー名とパスワードです。remoteRepo は、リポジトリノードの IP アドレスまたは DNS 名です。
    3. リモートノードで、Edge apigee-service ユーティリティと依存関係をインストールします。
      > sudo bash /tmp/bootstrap_4.16.09.sh apigeerepohost=remoteRepo:3939 apigeeuser=uName apigeepassword=pWord apigeeprotocol=http://

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

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

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

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

      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 を使用している場合: Management Server に apigee-validate ユーティリティをインストールします。
      > /opt/apigee/apigee-service/bin/apigee-service apigee-validate install

      注: 4.16.01 のインストール時に Message Processor ノードに apigee-validate ユーティリティをインストールした場合は、そのノードで次のコマンドを使用して更新できます。
      > /opt/apigee/apigee-service/bin/apigee-service apigee-validate update

      ただし、4.16.05 以降では、Management Server に apigee-validate ユーティリティをインストールして実行することをおすすめします。
    3. 4.16.01 からアップグレードする場合: apigee-validate ユーティリティに渡される構成ファイルを編集します。Edge リリース 4.16.01 では、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 =Edge UI を除くすべての Edge コンポーネント: Management Server、Message Processor、Router、QPID Server、Postgres Server
    ui = Edge UI
    all = マシン上のすべてのコンポーネントを更新(Edge aio インストール プロファイルまたは API BaaS asa インストール プロファイルでのみ使用)
    e = ElasticSearch
    b = API BaaS Stack
    p = API BaaS Portal
    ebp = 同じノード上の ElasticSearch、API BaaS Stack、API BaaS Portal
  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 オプションを使用して、すべてのコンポーネントを同時に更新します。
  • 複数のマシンで実行する必要があるステップの場合は、指定されたマシンの順序で実行します。
  • Monetization を更新するための個別のステップはありません。「-c edge」オプションを指定すると更新されます。

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

  1. 4.16.01 から更新する場合は、Zookeeper をダウングレードします。
    > yum downgrade 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-server stop
    > /opt/apigee/apigee-service/bin/apigee-service edge-qpid-server stop
    > /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql stop
  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 downgrade 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-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 とマシン 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 downgrade 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-server stop
      > /opt/apigee/apigee-service/bin/apigee-service edge-qpid-server stop
    2. マシン 5 で Postgres サーバー、Qpid サーバー、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 サーバーと 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 サーバーと 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/pgdata
      > rm -rf *
      > /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql setup-replication-on-standby -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 downgrade 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-server stop
    2. マシン 9 で Postgres サーバーと 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 サーバーを停止します。
      > /opt/apigee/apigee-service/bin/apigee-service edge-qpid-server stop
    4. ロールバック用に追加した新しいスタンバイ ノードで Postgres サーバーと 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 サーバーを起動します。
      > /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/pgdata
      > 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 downgrade 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-server stop
    2. マシン 9 で Postgres サーバーと 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 サーバーを停止します。
      > /opt/apigee/apigee-service/bin/apigee-service edge-qpid-server stop
    4. ロールバック用に追加した新しいスタンバイ ノードで Postgres サーバーと 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 サーバーを起動します。
      > /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/pgdata
      > 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 をダウングレードします。
      > yum downgrade 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 をダウングレードします。
      > yum downgrade 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 のマシン 6 とデータセンター 2 のマシン 12 を更新します。
    1. マシン 6 で Postgres サーバーを停止します。
      > /opt/apigee/apigee-service/bin/apigee-service edge-postgres-server stop
    2. マシン 12 で Postgres サーバーと 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 サーバーを停止します。
      > /opt/apigee/apigee-service/bin/apigee-service edge-qpid-server stop
    4. ロールバック用に追加した新しいスタンバイ ノードで Postgres サーバーと 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 サーバーを起動します。
      > /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/pgdata
      > rm -rf *
      > /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql 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 スタックを更新します。
    > /opt/apigee/apigee-setup/bin/update.sh -c e,b -f configFile
  3. マシン 4 の API BaaS Portal を更新します。
    > /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 Stack を更新します。
    > /opt/apigee/apigee-setup/bin/update.sh -c b -f configFile
  4. マシン 7 の API BaaS Portal を更新します。
    > /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 サーバーと Postgres サーバーの両方がインストールされている場合は、ステップ 8 の一部として「-c edge」プロファイル ステップを実行します。
  6. Edge UI
  7. postgresql を管理します。
  8. Postgres スタンバイで postgresql を起動します。
  9. Edge。つまり、すべての Qpid ノードと Postgres ノードの組み合わせ、またはスタンドアロンの Postgres ノードの「-c edge」プロファイル。