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 で再試行オプションを設定するには、仮想ホストの構成プロパティを使用します。

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

/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 ノードに push されます。

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

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

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

    Edge の 1 ノード構成と 2 ノード構成(プロトタイピングとテストに使用するトポロジ)では、Postgres ノードは 1 つだけです。これらの Postgres ノードは、新しい Postgres ノードを作成しなくても直接更新できます。

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

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

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

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

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

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

  1. 現在の Postgres マスターで、/opt/apigee/customer/application/postgresql.properties ファイルを編集して次のトークンを設定します。このファイルが存在しない場合は作成します。
    conf_pg_hba_replication.connection=host replication apigee existing_slave_ip/32 trust\ \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 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 ファイルを /tmp/bootstrap_4.17.0x.sh にダウンロードします。ここで、x5(4.17.05 の場合)または 9(4.17.09 の場合)です。
      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

    出力の最後に、

    "type" : [ "postgres-server" ],
    "uUID" : "599e8ebf-5d69-4ae4-aa71-154970a8ec75"
    という形式でノードの UUID が表示されます。

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

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

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

ゼロ ダウンタイム アップデート(ローリング アップデート)を使用すると、Edge をダウンさせることなく Edge インストール環境を更新できます。

ゼロ ダウンタイムの更新は、5 ノード以上の構成でのみ可能です。

ダウンタイムなしでアップグレードするための鍵は、各 Router をロードバランサから 1 つずつ削除することです。次に、Router と、Router と同じマシン上のすべてのコンポーネントを更新してから、Router をロードバランサに再び追加します。

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

アップデート前とアップデート後の次の点に注意してください。

  • Router と Message Processor ノードの組み合わせ:
    • 更新前 - 次のことを行います。
      1. Router を到達不能にします。
      2. Message Processor をアクセス不能にします。
    • 更新後 - 以下の手順を行います。
      1. Message Processor を到達可能にする
      2. Router が到達可能になるようにします。
  • Router の単一ノードの場合:
    • 更新前に、Router をアクセス不能にしてください。
    • 更新後、Router が到達可能になるようにします。
  • 単一の Message Processor ノードの場合:
    • 更新前に、Message Processor をアクセス不能にします。
    • 更新後、Message Processor を到達可能にする

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

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

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

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

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

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

  2. CRON ジョブが存在する場合は、更新が完了するまで、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_FIX オプションを使用して、Java のインストールの処理方法を指定します。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 コンポーネント。「エッジ」コンポーネントには、Management Server、Message Processor、Router、QPID Server、Edge Postgres Server が含まれます。
    • 「ldap」= OpenLDAP
    • ps = postgresql
    • 「qpid」= qpidd
    • 「sso」= Edge SSO
    • 「ui」 = Edge UI
    • 「zk」= Zookeeper

    component を「all」に設定すると、すべてのコンポーネントに対して update.sh を実行できますが、これは Edge オールインワン(aio)インストール プロファイルがある場合に限られます。例:

    /opt/apigee/apigee-setup/bin/update.sh -c all -f ./sa_silent_config
  14. Edge UI コンポーネントを実行するすべてのマシンで 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 ファイルをノードにコピーして、.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. Edge を更新する対象のノードに .tar ファイルをコピーします。たとえば、新しいノードの /tmp ディレクトリにコピーします。
    3. 新しいノードで、/tmp ディレクトリに tar ファイルを解凍します。
      tar -xzf apigee-4.18.05tar.gz

      このコマンドにより、.tar ファイルを含むディレクトリに repos という新しいディレクトリが作成されます。(例: /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 コンポーネント。「エッジ」コンポーネントには、Management Server、Message Processor、Router、QPID Server、Edge Postgres Server が含まれます。
    • 「ldap」= OpenLDAP
    • ps = postgresql
    • 「qpid」= qpidd
    • 「sso」= Edge SSO
    • 「ui」 = Edge UI
    • 「zk」= Zookeeper

    component を「all」に設定すると、すべてのコンポーネントに対して update.sh を実行できますが、これは Edge オールインワン(aio)インストール プロファイルがある場合に限られます。例:

    /opt/apigee/apigee-setup/bin/update.sh -c all -f ./sa_silent_config
  9. Edge UI コンポーネントを実行するすべてのマシンで 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" オプションを使用することですべてを同時に更新します。
  • 複数のマシンで行うよう指定されたステップは、指定されたマシン順に実行します。
  • 収益化の更新に特別な手順はありません。「-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_fileSSO をインストールしたときに作成した構成ファイルです。

  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_fileSSO をインストールしたときに作成した構成ファイルです。

  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_fileSSO をインストールしたときに作成した構成ファイルです。

  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 サーバーと 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(マスターノード)で、次のコマンドを実行します。
        /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_fileSSO をインストールしたときに作成した構成ファイルです。

  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 サーバーを停止します。
      /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 Server を起動します。
      /opt/apigee/apigee-service/bin/apigee-service edge-postgres-server start
    9. マシン 6、7 で Qpid Server 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(マスターノード)で、次のコマンドを実行します。
        /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_fileSSO をインストールしたときに作成した構成ファイルです。

  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 サーバーを停止します。
      /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 Server を起動します。
      /opt/apigee/apigee-service/bin/apigee-service edge-postgres-server start
    9. マシン 12、13 で Qpid Server 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(マスターノード)で、次のコマンドを実行します。
        /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(データセンター 1)
      /opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile
    2. データセンター 2 のマシン 10、11、7、8、9(データセンター 2)
      /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_fileSSO をインストールしたときに作成した構成ファイルです。

  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 サーバーを停止します。
      /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 Server を起動します。
      /opt/apigee/apigee-service/bin/apigee-service edge-postgres-server start
    9. マシン 4、5、10、11 で Qpid Server 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(マスターノード)で、次のコマンドを実行します。

      /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 コンポーネントを実行しているすべてのマシンで Edge UI コンポーネントを再起動してください。