Apigee Edge 4.19.01 または 4.19.06 を 4.50.00 に更新する

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

• 4.19.01 から 4.50.00
• 4.19.06 から 4.50.00

更新を行えるユーザー

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

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

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

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

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

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

更新の前提条件

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

• すべてのノードをバックアップする
  更新する前に、安全上の理由から、すべてのノードの完全バックアップを実行することをおすすめします。現在の Edge バージョンのバックアップ手順に沿ってください。

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

• Edge が実行されていることを確認する
  更新プロセス中に Edge が稼働していることを確認するには、次のコマンドを使用します。

  /opt/apigee/apigee-service/bin/apigee-all status

新しい Edge UI

このセクションでは、Edge UI に関する考慮事項について説明します。詳細については、Private Cloud 用の新しい Edge UI をご覧ください。

Edge UI のインストール

初期インストールが完了したら、Edge UI をインストールすることをおすすめします。これは、Apigee Edge for Private Cloud のデベロッパーと管理者向けの拡張ユーザー インターフェースです。

Edge UI では、基本認証を無効にして、SAML や LDAP などの IDP を使用する必要があります。

詳細については、新しい Edge UI をインストールするをご覧ください。

Edge UI の更新

Edge UI コンポーネントを更新するには、アップグレード元の Edge for プライベート クラウド のバージョンを考慮してください。

• 4.18.0x から:4.18.0x のベータ版 Edge UI（旧称「新しい Edge エクスペリエンス」または「New UE」）をインストールした場合は、これをアンインストールし、新しい Edge UI をインストールするの手順で 4.19.06 バージョンの Edge UI を新規インストールする必要があります。
• 4.19.01 から（新しい Edge UI がすでにインストールされている場合）: edge-management-ui コンポーネントについては、このセクションのアップグレード手順を使用します。
• 4.19.01 から（従来の UI を使用している場合）: このセクションで説明する手順で Edge for プライベート クラウド をアップグレードした後、新しい Edge UI をインストールするの手順で Edge UI をインストールします。
• 4.19.06 から（新しい Edge UI がすでにインストールされている場合）: edge-management-ui コンポーネントについては、このセクションのアップグレード手順を使用します。

Apigee mTLS での更新

Apigee mTLS は、Apigee Edge for Private Cloud バージョン 4.19.01 ～ 4.19.06 でのみサポートされています。バージョン 4.18.* 以前の apigee-mtls はアップグレードできません。Apigee mTLS をアップグレードするをご覧ください。

更新が失敗した場合の処理

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

障害が発生したためにアップデートを以前のバージョンにロールバックする必要がある場合は、4.50.00 をロールバックするをご覧ください。

更新情報のロギング

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

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

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

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

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

ゼロダウンタイム アップデート（ローリング アップデート）を使用すると、Edge を停止することなく Edge のインストールを更新できます。

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

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

1. マシンの更新順序の説明に沿って、インストールに適した順序でマシンを更新します。
2. Router を更新するタイミングになったら、サーバー（Message Processor / Router）のネットワーク到達性の有効化と無効化の説明に従って、いずれか 1 つの 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 にアクセスできないようにします。
  • 更新後、Router をアクセス可能にします。
• 単一の Message Processor ノードの場合:
  • 更新する前に、Message Processor を到達不能にします。
  • 更新後、Message Processor を到達可能にします。

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

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

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

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

1. Cassandra で修復オペレーションを実行するように構成された cron ジョブがある場合は、更新が完了するまで無効にします。
2. root としてノードにログインし、Edge RPM をインストールします。
3. yum-utils と yum-plugin-priorities をインストールします。

   sudo yum install yum-utils
   sudo yum install yum-plugin-priorities

4. Edge apigee-setup ユーティリティのインストールの説明に従って、SELinux を無効にします。
5. Oracle 7.x にインストールする場合は、次のコマンドを実行します。

   sudo yum-config-manager --enable ol7_optional_latest

6. 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

7. Edge 4.50.00 bootstrap_4.50.00.sh ファイルを /tmp/bootstrap_4.50.00.sh にダウンロードします。

   curl https://software.apigee.com/bootstrap_4.50.00.sh -o /tmp/bootstrap_4.50.00.sh

8. 次のコマンドを実行して、Edge 4.50.00 apigee-service ユーティリティと依存関係をインストールします。

   sudo bash /tmp/bootstrap_4.50.00.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 を自分でインストールする必要があります。
9. 次の例のように、apigee-service を使用して apigee-setup ユーティリティを更新します。

   /opt/apigee/apigee-service/bin/apigee-service apigee-setup update

10. 次の例のように、Management Server の apigee-validate ユーティリティを更新します。

    /opt/apigee/apigee-service/bin/apigee-service apigee-validate update

11. 次の例のように、Management Server の apigee-provision ユーティリティを更新します。

    /opt/apigee/apigee-service/bin/apigee-service apigee-provision update

12. 次のコマンドを実行して、ノードで update ユーティリティを実行します。

    /opt/apigee/apigee-setup/bin/update.sh -c component -f configFile

    これは、マシンの更新順序で説明されている順序で行います。

    ここで

    • component は、更新する Edge コンポーネントです。有効な値は次のとおりです。
      • cs: Cassandra
      • edge: Edge UI を除くすべての Edge コンポーネント（Management Server、Message Processor、Router、QPID Server、Postgres Server）
      • ldap: OpenLDAP
      • ps: postgresql
      • qpid: qpidd
      • sso: Apigee SSO（SSO をインストールした場合）
      • ue: 新しい Edge UI
      • ui: 従来の Edge UI
      • zk: Zookeeper
    • configFile は、4.19.01 または 4.19.06 のインストール時に Edge コンポーネントを定義するために使用した構成ファイルと同じです。

    component を「all」に設定すると、すべてのコンポーネントに対して update.sh を実行できます。ただし、Edge オールインワン（AIO）インストール プロファイルがある場合に限ります。次に例を示します。

    /opt/apigee/apigee-setup/bin/update.sh -c all -f ./sa_silent_config

13. Edge UI コンポーネントを実行するすべてのノードで Edge UI コンポーネントを再起動します（まだ再起動していない場合）。

    /opt/apigee/apigee-service/bin/apigee-service edge-ui restart

14. インストールのテストの説明に沿って、Management Server で apigee-validate ユーティリティを実行して更新をテストします。

後で更新をロールバックすることにした場合は、4.50.00 のロールバックの手順に沿ってください。

ローカル リポジトリから 4.50.00 に更新する

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

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

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

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

1. Edge apigee-setup ユーティリティのインストールの「ローカルに Apigee リポジトリを作成する」の手順で 4.50.00 リポジトリをローカルに作成します。
2. .tar ファイルから apigee-service をインストールするには:
   1. ローカル リポジトリがあるノードで、次のコマンドを使用して、ローカル リポジトリを /opt/apigee/data/apigee-mirror/apigee-4.50.00.tar.gz という名前の単一の .tar ファイルにパッケージ化します。

      /opt/apigee/apigee-service/bin/apigee-service apigee-mirror package

   2. Edge を更新する対象のノードに .tar ファイルをコピーします。たとえば、新しいノードの /tmp ディレクトリにコピーします。
   3. 新しいノードで、ファイルを /tmp ディレクトリに解凍します。

      tar -xzf apigee-4.50.00.tar.gz

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

   4. /tmp/repos から Edge apigee-service ユーティリティと依存関係をインストールします。

      sudo bash /tmp/repos/bootstrap_4.50.00.sh apigeeprotocol="file://" apigeerepobasepath=/tmp/repos

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

3. Nginx ウェブサーバーを使用して apigee-service をインストールするには:
   1. Edge apigee-setup ユーティリティのインストールの「Nginx ウェブサーバーを使用してリポジトリからインストールする」の手順に沿って、Nginx ウェブサーバーを構成します。
   2. リモートノードで、Edge bootstrap_4.50.00.sh ファイルを /tmp/bootstrap_4.50.00.sh にダウンロードします。

      /usr/bin/curl http://uName:pWord@remoteRepo:3939/bootstrap_4.50.00.sh -o /tmp/bootstrap_4.50.00.sh

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

   3. リモートノードで、Edge apigee-setup ユーティリティと依存関係をインストールします。

      sudo bash /tmp/bootstrap_4.50.00.sh apigeerepohost=remoteRepo:3939 apigeeuser=uName apigeepassword=pWord apigeeprotocol=http://

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

4. 次の例のように、apigee-service を使用して apigee-setup ユーティリティを更新します。

   /opt/apigee/apigee-service/bin/apigee-service apigee-setup update 

5. 次の例のように、Management Server の apigee-validate ユーティリティを更新します。

   /opt/apigee/apigee-service/bin/apigee-service apigee-validate update

6. 次の例のように、Management Server の apigee-provision ユーティリティを更新します。

   /opt/apigee/apigee-service/bin/apigee-service apigee-provision update

7. マシンの更新順序で説明されている順序で、ノードで update ユーティリティを実行します。

   /opt/apigee/apigee-setup/bin/update.sh -c component -f configFile

   ここで

   • component は、更新する Edge コンポーネントです。通常、次のコンポーネントを更新します。
     • cs: Cassandra
     • edge: Edge UI を除くすべての Edge コンポーネント（Management Server、Message Processor、Router、QPID Server、Postgres Server）
     • ldap: OpenLDAP
     • ps: postgresql
     • qpid: qpidd
     • sso: Apigee SSO（SSO をインストールした場合）
     • ue 新しい Edge UI
     • ui: 従来の Edge UI
     • zk: Zookeeper
   • configFile は、4.19.01 または 4.19.06 のインストール時に Edge コンポーネントを定義するために使用した構成ファイルと同じです。

   component を「all」に設定すると、すべてのコンポーネントに対して update.sh を実行できます。ただし、Edge オールインワン（AIO）インストール プロファイルがある場合に限ります。次に例を示します。

   /opt/apigee/apigee-setup/bin/update.sh -c all -f /tmp/sa_silent_config

8. UI コンポーネントを実行するすべてのノードで UI コンポーネントを再起動します（まだ再起動していない場合）。

   /opt/apigee/apigee-service/bin/apigee-service [edge-management-ui|edge-ui] restart

9. インストールのテストの説明に沿って、Management Server で apigee-validate ユーティリティを実行して更新をテストします。

後で更新をロールバックすることにした場合は、4.50.00 のロールバックの手順に沿ってください。

マシンの更新順序

Edge インストールでマシンを更新する順序は重要です。

• 他のノードを更新する前に、すべての Cassandra ノードと ZooKeeper ノードを更新する必要があります。
• 複数の Edge コンポーネント（Management Server、Message Processor、Router、QPID Server。Postgres Server は除く）がインストールされているマシンでは、-c edge オプションを使用して、すべてのコンポーネントを同時に更新します。
• 複数のマシンで実行する必要があるステップの場合は、指定されたマシンの順序で実行します。
• Monetization を更新するための個別のステップはありません。-c edge オプションを指定すると更新されます。

1 ノード スタンドアロン構成のアップグレード

1 ノード スタンドアロン構成を 4.50.00 にアップグレードするには:

1. すべてのコンポーネントを更新します。

   /opt/apigee/apigee-setup/bin/update.sh -c all -f configFile

2. （apigee-adminapi をインストールした場合） apigee-adminapi ユーティリティを更新しました。

   /opt/apigee/apigee-service/bin/apigee-service apigee-adminapi update

2 ノード スタンドアロン構成のアップグレード

2 ノードのスタンドアロン インストール用に次のコンポーネントを更新します。

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

1. マシン 1 で Cassandra と ZooKeeper を更新します。

   /opt/apigee/apigee-setup/bin/update.sh -c cs,zk -f configFile

2. マシン 2 で Qpid と Postgres を更新します。

   /opt/apigee/apigee-setup/bin/update.sh -c qpid,ps -f configFile

3. マシン 1 で LDAP を更新します。

   /opt/apigee/apigee-setup/bin/update.sh -c ldap -f configFile

4. マシン 2 と 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. （apigee-adminapi がインストールされている場合）マシン 1 の apigee-adminapi ユーティリティを更新します。

   /opt/apigee/apigee-service/bin/apigee-service apigee-adminapi update

7. Apigee SSO がインストールされている場合は、マシン 1 の Apigee SSO を更新します。

   /opt/apigee/apigee-setup/bin/update.sh -c sso -f sso_config_file

   ここで、sso_config_file は SSO をインストールしたときに作成した構成ファイルです。

8. マシン 1 の Edge UI コンポーネントを再起動します。

   /opt/apigee/apigee-service/bin/apigee-service edge-ui restart

5 ノード構成のアップグレード

5 ノード インストール用に次のコンポーネントを更新します。

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

1. マシン 1、2、3 で Cassandra と ZooKeeper を更新します。

   /opt/apigee/apigee-setup/bin/update.sh -c cs,zk -f configFile

2. マシン 4 の Qpid と Postgres を更新します。

   /opt/apigee/apigee-setup/bin/update.sh -c qpid, ps -f configFile

3. マシン 5 で Qpid と Postgres を更新します。

   /opt/apigee/apigee-setup/bin/update.sh -c qpid, ps -f configFile

4. マシン 1 で LDAP を更新します。

   /opt/apigee/apigee-setup/bin/update.sh -c ldap -f configFile

5. マシン 4、5、1、2、3 の Edge コンポーネントを更新します。

   /opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile

6. Edge UI を更新します。
   • クラシック UI: クラシック UI を使用している場合は、次の例に示すように、マシン 1 の ui コンポーネントを更新します。

     /opt/apigee/apigee-setup/bin/update.sh -c ui -f configFile

   • 新しい Edge UI: 新しい Edge UI をインストールした場合は、適切なマシン（マシン 1 ではない場合があります）で ue コンポーネントを更新します。

     /opt/apigee/apigee-setup/bin/update.sh -c ue -f /opt/silent.conf

7. （apigee-adminapi がインストールされている場合）マシン 1 の apigee-adminapi ユーティリティを更新します。

   /opt/apigee/apigee-service/bin/apigee-service apigee-adminapi update

8. Apigee SSO がインストールされている場合は、マシン 1 の Apigee SSO を更新します。

   /opt/apigee/apigee-setup/bin/update.sh -c sso -f sso_config_file

   ここで、sso_config_file は SSO をインストールしたときに作成した構成ファイルです。

9. UI コンポーネントを再起動します。
   • Classic UI: Classic UI を使用している場合は、次の例に示すように、マシン 1 の edge-ui コンポーネントを再起動します。

     /opt/apigee/apigee-service/bin/apigee-service edge-ui restart

   • 新しい Edge UI: 新しい Edge UI をインストールした場合は、適切なマシン（マシン 1 ではない場合があります）で edge-management-ui コンポーネントを再起動します。

     /opt/apigee/apigee-service/bin/apigee-service edge-management-ui restart

9 ノードクラスタ構成のアップグレード

9 ノードのクラスタ インストール用に次のコンポーネントを更新します。

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

1. マシン 1、2、3 で Cassandra と ZooKeeper を更新します。

   /opt/apigee/apigee-setup/bin/update.sh -c cs,zk -f configFile

2. マシン 6 と 7 で Qpid を更新します。

   /opt/apigee/apigee-setup/bin/update.sh -c qpid -f configFile

3. マシン 8 で Postgres を更新します。

   /opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile

4. マシン 9 で Postgres を更新します。

   /opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile

5. マシン 1 で LDAP を更新します。

   /opt/apigee/apigee-setup/bin/update.sh -c ldap -f configFile

6. マシン 6、7、8、9、1、4、5 の順に Edge コンポーネントを更新します。

   /opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile

7. マシン 1 で新しい UI（ue）または従来の UI（ui）を更新します。

   /opt/apigee/apigee-setup/bin/update.sh -c [ui|ue] -f configFile

8. （apigee-adminapi がインストールされている場合）マシン 1 の apigee-adminapi ユーティリティを更新します。

   /opt/apigee/apigee-service/bin/apigee-service apigee-adminapi update

9. Apigee SSO がインストールされている場合は、マシン 1 の Apigee SSO を更新します。

   /opt/apigee/apigee-setup/bin/update.sh -c sso -f sso_config_file

   ここで、sso_config_file は SSO をインストールしたときに作成した構成ファイルです。

10. UI コンポーネントを再起動します。
    • クラシック UI: クラシック UI を使用している場合は、次の例に示すように、マシン 1 で edge-ui コンポーネントを再起動します。

      /opt/apigee/apigee-service/bin/apigee-service edge-ui restart

    • 新しい Edge UI: 新しい Edge UI をインストールした場合は、適切なマシン（マシン 1 ではない場合があります）で edge-management-ui コンポーネントを再起動します。

      /opt/apigee/apigee-service/bin/apigee-service edge-management-ui restart

13 ノードクラスタ構成のアップグレード

13 ノードのクラスタ インストール用に次のコンポーネントを更新します。

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

1. マシン 1、2、3 で Cassandra と ZooKeeper を更新します。

   /opt/apigee/apigee-setup/bin/update.sh -c cs,zk -f configFile

2. マシン 12 と 13 で Qpid を更新します。

   /opt/apigee/apigee-setup/bin/update.sh -c qpid -f configFile

3. マシン 8 で Postgres を更新します。

   /opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile

4. マシン 9 で Postgres を更新します。

   /opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile

5. マシン 4 と 5 で LDAP を更新します。

   /opt/apigee/apigee-setup/bin/update.sh -c ldap -f configFile

6. マシン 12、13、8、9、6、7、10、11 の順に Edge コンポーネントを更新します。

   /opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile

7. マシン 6 と 7 で、新しい UI（ue）または従来の UI（ui）を更新します。

   /opt/apigee/apigee-setup/bin/update.sh -c [ui|ue] -f configFile

8. （apigee-adminapi がインストールされている場合）マシン 6 と 7 の apigee-adminapi ユーティリティを更新します。

   /opt/apigee/apigee-service/bin/apigee-service apigee-adminapi update

9. Apigee SSO がインストールされている場合は、マシン 6、7 の Apigee SSO を更新します。

   /opt/apigee/apigee-setup/bin/update.sh -c sso -f sso_config_file

   ここで、sso_config_file は SSO をインストールしたときに作成した構成ファイルです。

10. UI コンポーネントを再起動します。
    • Classic UI: Classic UI を使用している場合は、次の例に示すように、マシン 6 と 7 で edge-ui コンポーネントを再起動します。

      /opt/apigee/apigee-service/bin/apigee-service edge-ui restart

    • 新しい Edge UI: 新しい Edge UI をインストールした場合は、マシン 6 と 7 で edge-management-ui コンポーネントを再起動します。

      /opt/apigee/apigee-service/bin/apigee-service edge-management-ui restart

12 ノードクラスタ構成のアップグレード

12 ノードのクラスタ インストール用に次のコンポーネントを更新します。

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

1. 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

2. qpidd を更新します。
   1. データセンター 1 のマシン 4、5 で、次のコマンドを実行します。
      1. マシン 4 の qpidd を更新します。

         /opt/apigee/apigee-setup/bin/update.sh -c qpid -f configFile

      2. マシン 5 の qpidd を更新します。

         /opt/apigee/apigee-setup/bin/update.sh -c qpid -f configFile

   2. データセンター 2 のマシン 10、11
      1. マシン 10 の qpidd を更新します。

         /opt/apigee/apigee-setup/bin/update.sh -c qpid -f configFile

      2. マシン 11 の qpidd を更新します。

         /opt/apigee/apigee-setup/bin/update.sh -c qpid -f configFile

3. Postgres を更新します。
   1. データセンター 1 のマシン 6 で、次のコマンドを実行します。

      /opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile

   2. データセンター 2 のマシン 12

      /opt/apigee/apigee-setup/bin/update.sh -c ps -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、6、1、2、3 で、次のコマンドを実行します。

      /opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile

   2. データセンター 2 のマシン 10、11、12、7、8、9

      /opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile

6. 新しい UI（ue）または従来の UI（ui）を更新します。
   1. データセンター 1 のマシン 1 で、次のコマンドを実行します。

      /opt/apigee/apigee-setup/bin/update.sh -c [ui|ue] -f configFile

   2. データセンター 2 のマシン 7 で、次のコマンドを実行します。

      /opt/apigee/apigee-setup/bin/update.sh -c [ui|ue] -f configFile

7. （apigee-adminapi をインストールした場合）apigee-adminapi ユーティリティを更新しました。
   1. データセンター 1 のマシン 1 で、次のコマンドを実行します。

      /opt/apigee/apigee-service/bin/apigee-service apigee-adminapi update

   2. データセンター 2 のマシン 7 で、次のコマンドを実行します。

      /opt/apigee/apigee-service/bin/apigee-service apigee-adminapi update

8. Apigee SSO がインストールされている場合は、Apigee 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

   ここで、sso_config_file は SSO をインストールしたときに作成した構成ファイルです。

9. マシン 1 と 7 で、新しい Edge UI（edge-management-ui）または従来の Edge UI（edge-ui）コンポーネントを再起動します。

   /opt/apigee/apigee-service/bin/apigee-service [edge-ui|edge-management-ui] restart

非標準構成のアップグレード

標準以外の構成を使用している場合は、次の順序で Edge コンポーネントを更新します。

1. ZooKeeper
2. Cassandra
3. qpidd、ps
4. LDAP
5. Edge。つまり、すべてのノードの「-c edge」プロファイル。Qpid サーバー、Edge Postgres Server、Management Server、Message Processor、Router の順にノードを停止します。
6. Edge UI（Classic または New）
7. apigee-adminapi
8. Apigee SSO

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