Apigee Edge を 4.16.09 に更新する

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 を更新するときは、任意の Router を 1 台選択し、サーバー（Message Processor または Router）の到達可能性の有効化 / 無効化の説明に従ってその Router を到達不能な状態にします。
3. 選択した 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 を到達可能にします。

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

サイレント構成ファイルを更新コマンドに渡す必要があります。サイレント構成ファイルは、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 のインストールの処理方法について指定する場合は、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/bin に update.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 update
      
      apigee-service へのこの更新により、<inst_dir>/apigee/apigee-setup/bin に update.sh ユーティリティがインストールされます。
   3. 4.16.05 を直接または更新によってインストールした場合は、apigee-setup ユーティリティを更新する必要があります。
      > /opt/apigee/apigee-service/bin/apigee-service apigee-setup update
      
      この apigee-service の更新により、<inst_dir>/apigee/apigee-setup/bin に update.sh ユーティリティがインストールされます。
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 ユーティリティをインストールします。
      > /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 以降では、管理サーバーに apigee-validate ユーティリティをインストールして実行することをおすすめします。
   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. マシンの更新順序に記載された順に、各ノードで update ユーティリティを実行します。
    > /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 スタック
    p = API BaaS Portal
    ebp = 同じノード上の ElasticSearch、API BaaS スタック、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 ファイルから 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
      
      このコマンドは、<inst_dir>/apigee/apigee-setup/bin に update.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 update
      
      apigee-service のこの更新により、<inst_dir>/apigee/apigee-setup/bin に update.sh ユーティリティがインストールされます。
   3. 4.16.05 を直接または更新してインストールした場合は、apigee-setup ユーティリティを更新する必要があります。
      > /opt/apigee/apigee-service/bin/apigee-service apigee-setup update
      
      この apigee-service の更新により、<inst_dir>/apigee/apigee-setup/bin に update.sh ユーティリティがインストールされます。
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 ユーティリティをインストールします。
      > /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 以降では、管理サーバーに apigee-validate ユーティリティをインストールして実行することをおすすめします。
   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. 次の「マシンの更新順序」に記載されている順序で、各ノードで update ユーティリティを実行します。
   > /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 スタック
   p = API BaaS Portal
   ebp = 同じノード上の ElasticSearch、API BaaS スタック、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 down 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 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
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 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 とマシン 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 Server、Qpid Server、postgresql を停止させます。
      > /opt/apigee/apigee-service/bin/apigee-service edge-postgres-server stop
      > /opt/apigee/apigee-service/bin/apigee-service edge-qpid-server stop
      > /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql stop
   3. ロールバック用に追加した新しいスタンバイ ノードで Postgres Server と postgresql を停止します。
      > /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 ノードを廃止するの手順に沿って、新しいスタンバイ ノードの使用を停止します。

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 Server と postgresql を停止します。
      > /opt/apigee/apigee-service/bin/apigee-service edge-postgres-server stop
      > /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql stop
   3. マシン 6 と 7 で Qpid Server を停止します。
      > /opt/apigee/apigee-service/bin/apigee-service edge-qpid-server stop
   4. ロールバックのために追加した新しいスタンバイ ノードで Postgres サーバーと 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 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 ノードを廃止するの手順に沿って、新しいスタンバイ ノードを廃止します。

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 Server と postgresql を停止します。
      > /opt/apigee/apigee-service/bin/apigee-service edge-postgres-server stop
      > /opt/apigee/apigee-service/bin/apigee-service apigee-postgresqlstop
   3. マシン 12 と 13 で Qpid Server を停止します。
      > /opt/apigee/apigee-service/bin/apigee-service edge-qpid-server stop
   4. ロールバック用に追加した新しいスタンバイ ノードで Postgres Server と postgresql を停止します。
      > /opt/apigee/apigee-service/bin/apigee-service edge-postgres-server stop
      > /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql stop
   5. マシン 8 の postgresql を更新します。
      > /opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile
   6. マシン 8 の Postgres データベースを更新します（Postgres マスターのみ）。
      > /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql db_upgrade
   7. マシン 9 の postgresql を更新します。
      > /opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile
   8. マシン 8、9 で Postgres Server を起動します。
      > /opt/apigee/apigee-service/bin/apigee-service edge-postgres-server start
   9. マシン 12 と 13 で Qpid Server を起動します。
      > /opt/apigee/apigee-service/bin/apigee-service edge-qpid-server start
   10. マシン 9 で次のコマンドを実行して、スタンバイ ノードとして Postgres を構成します。
       > cd /opt/apigee/data/apigee-postgresql/pgdata
       > rm -rf *
       > /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql setup-replication-on-standby -f configFile
   11. 両方のサーバーで次のスクリプトを発行して、レプリケーションのステータスを確認します。両方のサーバーで同じ結果が表示され、レプリケーションが成功していることを確認します。
       マシン 8 のマスターノードで、次のコマンドを実行します。
       > /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 Server と postgresql を停止します。
      > /opt/apigee/apigee-service/bin/apigee-service edge-postgres-server stop
      > /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql stop
   3. マシン 4、5、10、11 で Qpid Server を停止します。
      > /opt/apigee/apigee-service/bin/apigee-service edge-qpid-server stop
   4. ロールバック用に追加した新しいスタンバイ ノードで Postgres Server と postgresql を停止します。
      > /opt/apigee/apigee-service/bin/apigee-service edge-postgres-server stop
      > /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql stop
   5. マシン 6 の postgresql を更新します。
      > /opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile
   6. マシン 6 の Postgres データベースを更新します（Postgres マスターのみ）。
      > /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql db_upgrade
   7. マシン 12 で postgresql を更新します。
      > /opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile
   8. マシン 6、12 の Postgres Server を起動します。
      > /opt/apigee/apigee-service/bin/apigee-service edge-postgres-server start
   9. マシン 4、5、10、11 の Qpid Server を起動します。
      > /opt/apigee/apigee-service/bin/apigee-service edge-qpid-server start
   10. マシン 12 で次のコマンドを実行して、Postgres をスタンバイ ノードとして構成します。
       > cd /opt/apigee/data/apigee-postgresql/pgroups
       > 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 スタックを更新します。
   > /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 Server ノード（Postgres Server ノードは除く）、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」プロファイルを指定することを意味します）。