Apigee Edge 4.16.09 を 4.17.05 に更新する

Edge for Private Cloud v. 4.17.05

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

この手順を使用すると、Apigee Edge バージョン 4.16.09.0x を 4.17.05 に更新できます。

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

更新を行えるユーザー

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

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

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

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

Qpid 1.35 への必須アップグレード

このリリースには、Qpid 1.35 への必須のアップデートが含まれています。Qpid ノードを更新する一環として、次の操作を行う必要があります。

• Qpid ノードのポート 5672 をブロックして、Router と Message Processor が Qpid ノードに書き込めないようにします。Qpid ノードでこのポートをブロックするには、次のコマンドを使用します。
  > sudo iptables -A INPUT -p tcp --destination-port 5672 ! -s `hostname` -i eth0 -j DROP
• Qpid キューのメッセージが空になるまで待って、Qpid ノードが更新前にすべてのメッセージを処理したことを確認します。次のコマンドを使用して、Qpid メッセージ キューが空であることを確認します。
  > qpid-stat -q
• Qpid ノードを更新します。
• Qpid ノードのポート 5672 のブロックを解除して、Router と Message Processor からのアクセスを許可します。このポートのブロックを解除するには、次のコマンドを使用します。
  > sudo iptables -F
  
  iptables を他のルールに使用している場合は、-D オプションを使用して特定の変更を元に戻すことができます。
  > sudo iptables -D INPUT -p tcp --destination-port 5672 ! -s `hostname` -i eth0 -j DROP

このプロセスについては、Edge トポロジごとに以下で詳しく説明します。

EPEL リポジトリを有効にするために必要

Edge をインストールまたは更新するには、Extra Packages for Enterprise Linux（EPEL）を有効にする必要があります。使用するコマンドは、RedHat/CentOS のバージョンによって異なります。

• RedHat/CentOS 7.x の場合:
  > wget https://dl.fedoraproject.org/pub/epel/epel-release-latest-7.noarch.rpm; rpm -ivh epel-release-latest-7.noarch.rpm
• RedHat/CentOS 6.x の場合:
  wget https://dl.fedoraproject.org/pub/epel/epel-release-latest-6.noarch.rpm; rpm -ivh epel-release-latest-6.noarch.rpm

SMTPMAILFROM 構成パラメータの追加が必要

Edge 4.17.05 では、SMTP サーバーを有効にするときに使用する構成ファイルに、新しい必須パラメータが追加されました。SMTP サーバーを有効にする場合は、構成ファイルで SMTPMAILFROM を設定する必要があります。このパラメータの形式は次のとおりです。

SMTPMAILFROM="My Company <myco@company.com>"

外部認証を使用しているときに更新する場合は必須

外部ディレクトリ サービスを既存の Apigee Edge プライベート クラウド インストールに統合できます。この機能は、Active Directory や OpenLDAP など、LDAP をサポートするすべてのディレクトリ サービスで動作するように設計されています。外部 LDAP ソリューションを使用すると、システム管理者は、認証情報を使用する Apigee Edge などのシステムとは別の、一元化されたディレクトリ管理サービスからユーザー認証情報を管理できます。

詳細については、インストール トポロジをご覧ください。

外部認証が有効になっている場合、ほとんどのお客様は、Edge OpenLDAP サーバーで使用されるメールアドレスではなく、Active Directory SAM アカウント名フィールドを認証用のユーザー名として使用します。

外部ディレクトリ サービスと統合している場合は、Edge を 4.17.05 に更新するときに、構成ファイルに次の行を追加します。

IS_EXTERNAL_AUTH="true"

この行は、ユーザー名としてメールアドレスではなくアカウント名をサポートするように Edge を構成します。

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

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

更新の前提条件

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

• すべてのノードをバックアップする
  更新する前に、安全上の理由から、すべてのノードの完全バックアップを実行することをおすすめします。現在の Edge バージョンのバックアップ手順に沿ってください。
  
  これにより、新しいバージョンへの更新が正常に機能しない場合に備えて、バックアップ プランを用意できます。バックアップの詳細については、バックアップと復元をご覧ください。
• Edge が実行されていることを確認する
  更新プロセス中に Edge が稼働していることを確認するには、次のコマンドを使用します。
  
  > /opt/apigee/apigee-service/bin/apigee-all status

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

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

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

更新情報のロギング

デフォルトでは、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）のネットワーク到達性の有効化と無効化の説明に従って、いずれかの 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.09 のインストールに使用したものと同じである必要があります。

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

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

1. Cassandra で修復オペレーションを実行するように構成された CRON ジョブがある場合は、更新が完了するまで無効にします。
2. root としてノードにログインし、Edge RPM をインストールします。
   注: RPM のインストールには root アクセス権が必要ですが、Edge の構成は root アクセス権がなくても実行できます。
3. Edge apigee-setup ユーティリティのインストールの説明に従って、SELinux を無効にします。
4. Edge 4.17.05 の bootstrap_4.17.05.sh ファイルを /tmp/bootstrap_4.17.05.sh にダウンロードします。
   > curl https://software.apigee.com/bootstrap_4.17.05.sh -o /tmp/bootstrap_4.17.05.sh
5. Edge 4.17.05 の apigee-service ユーティリティと依存関係をインストールします。
   > sudo bash /tmp/bootstrap_4.17.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 を自分でインストールする必要があります。
6. （CentOS-6.x および RedHat-6.x のみ）すべての Qpid ノードで、次のコマンドを実行して、正しい Qpid バージョンをダウンロードします。
   > yum install apigee-qpidd --disablerepo=epel
7. apigee-service を使用して apigee-setup ユーティリティを更新します。
   > /opt/apigee/apigee-service/bin/apigee-service apigee-setup update
8. Management Server で apigee-validate ユーティリティを更新します。
   > /opt/apigee/apigee-service/bin/apigee-service apigee-validate update
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 ユーティリティを実行して、更新をテストします。

後で更新をロールバックするには、4.17.05 のロールバック プロセスの手順に沿ってください。

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

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

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

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

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

1. Edge apigee-setup ユーティリティのインストールの「ローカルに Apigee リポジトリを作成する」の手順で 4.17.05 リポジトリをローカルに作成します。
   注: すでに 4.16.09 リポジトリが存在する場合は、Edge apigee-setup ユーティリティのインストールの「ローカルの Apigee リポジトリを更新する」の手順に沿って、4.17.05 リポジトリを追加できます。
2. .tar ファイルから apigee-service をインストールするには:
   1. ローカル リポジトリがあるノードで、次のコマンドを使用して、ローカル リポジトリを /opt/apigee/data/apigee-mirror/apigee-4.17.05.tar.gz という名前の単一の.tar ファイルにパッケージ化します。
      > /opt/apigee/apigee-service/bin/apigee-service apigee-mirror package
   2. Edge を更新する対象のノードに .tar ファイルをコピーします。たとえば、新しいノードの /tmp ディレクトリにコピーします。
   3. 新しいノードで、ファイルを /tmp ディレクトリに解凍します。
      > tar -xzf apigee-4.17.05.tar.gz
      
      このコマンドは、.tar ファイルを含むディレクトリに repos という名前の新しいディレクトリを作成します。（例: /tmp/repos）。
   4. /tmp/repos から Edge apigee-service ユーティリティと依存関係をインストールします。
      > sudo bash /tmp/repos/bootstrap_4.17.05.sh apigeeprotocol="file://" apigeerepobasepath=/tmp/repos
      
      コマンドに repos ディレクトリへのパスが含まれている点に注意してください。
3. Nginx ウェブサーバーを使用して apigee-service をインストールするには:
   1. Edge apigee-setup ユーティリティのインストールの「Nginx ウェブサーバーを使用してリポジトリからインストールする」の手順に沿って、Nginx ウェブサーバーを構成します。
   2. リモートノードで、Edge bootstrap_4.17.05.sh ファイルを /tmp/bootstrap_4.17.05.sh にダウンロードします。
      > /usr/bin/curl http://uName:pWord@remoteRepo:3939/bootstrap_4.17.05.sh -o /tmp/bootstrap_4.17.05.sh
      
      ここで、uName:pWord は、上記でリポジトリに設定したユーザー名とパスワードです。remoteRepo は、リポジトリノードの IP アドレスまたは DNS 名です。
   3. リモートノードで、Edge apigee-service ユーティリティと依存関係をインストールします。
      > sudo bash /tmp/bootstrap_4.17.05.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. apigee-provision ユーティリティを更新します。
   > /opt/apigee/apigee-service/bin/apigee-service apigee-provision update
7. 以下の「マシンの更新順序」で説明されている順序で、ノードで更新ユーティリティを実行します。
   > /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
8. インストールのテストの説明に従って、Management Server で apigee-validate ユーティリティを実行して、更新をテストします。

後で更新をロールバックするには、4.17.05 のロールバック プロセスの手順に沿ってください。

マシンの更新順序

Edge インストールでマシンを更新する順序は重要です。更新に関する最も重要な考慮事項は次のとおりです。

• 他のノードを更新する前に、すべての Cassandra ノードと ZooKeeper ノードを更新する必要があります。
• 複数の Edge コンポーネント（Management Server、Message Processor、Router、QPID Server。Postgres Server は除く）がインストールされているマシンでは、-c edge オプションを使用して、すべてのコンポーネントを同時に更新します。
• 複数のマシンで実行する必要があるステップの場合は、指定されたマシンの順序で実行します。
• Monetization を更新するための個別のステップはありません。「-c edge」オプションを指定すると更新されます。
• （CentOS-6.x と RedHat-6.x のみ）外部インターネット接続があるすべての Qpid ノードで、次のコマンドを実行して、上記のように正しい Qpid バージョンをダウンロードしたことを確認します。
  > yum install apigee-qpidd --disablerepo=epel

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

1. Edge で SMTP を有効にしている場合は、構成ファイルで SMTPMAILFROM を設定します。このパラメータの形式は
   です。 SMTPMAILFROM="My Company <myco@company.com>"
2. Cassandra と ZooKeeper を更新します。
   > /opt/apigee/apigee-setup/bin/update.sh -c cs,zk -f configFile
3. 次の iptables ルールを設定します。
   > sudo iptables -A INPUT -p tcp --destination-port 5672 ! -s `hostname` -i eth0 -j DROP
4. Qpid メッセージ キューを確認します。
   > qpid-stat -q
   
   [msg] 列の数が 0 になるまで、キューの確認を続けます。すべてのメッセージが処理されるまで、Qpid をアップグレードすることはできません。
5. qpidd を更新します。
   > /opt/apigee/apigee-setup/bin/update.sh -c qpid -f configFile
6. iptables をフラッシュします。
   > sudo iptables -F
7. postgresql を更新します。
   > /opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile
8. postgresql を起動します。
   > /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql start
9. LDAP を更新します。
   > /opt/apigee/apigee-setup/bin/update.sh -c ldap -f configFile
10. 残りの Edge コンポーネントを更新します。
    > /opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile
11. Edge UI を更新します。
    > /opt/apigee/apigee-setup/bin/update.sh -c ui -f configFile

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

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

1. Edge で SMTP を有効にしている場合は、構成ファイルで SMTPMAILFROM を設定します。このパラメータの形式は
   です。 SMTPMAILFROM="My Company <myco@company.com>"
2. マシン 1 で Cassandra と ZooKeeper を更新します。
   > /opt/apigee/apigee-setup/bin/update.sh -c cs,zk -f configFile
3. マシン 2 で次の iptables ルールを設定します。
   > sudo iptables -A INPUT -p tcp --destination-port 5672 ! -s `hostname` -i eth0 -j DROP
4. マシン 2 の Qpid メッセージ キューを確認します。
   > qpid-stat -q
   
   [msg] 列の数が 0 になるまで、キューの確認を続けます。すべてのメッセージが処理されるまで、Qpid をアップグレードすることはできません。
5. マシン 2 の qpidd を更新します。
   > /opt/apigee/apigee-setup/bin/update.sh -c qpid -f configFile
6. マシン 2 で iptables をフラッシュします。
   > sudo iptables -F
7. マシン 2 で postgresql を更新します。
   > /opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile
8. マシン 2 で postgresql を起動します。
   > /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql start
9. マシン 1 で LDAP を更新します。
   > /opt/apigee/apigee-setup/bin/update.sh -c ldap -f configFile
10. マシン 2 と 1 の Edge コンポーネントを更新します。
    > /opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile
11. マシン 1 の UI を更新します。
    > /opt/apigee/apigee-setup/bin/update.sh -c ui -f configFile

5 ホストのクラスタ化されたインストールの場合

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

1. Edge で SMTP を有効にしている場合は、構成ファイルで SMTPMAILFROM を設定します。このパラメータの形式は
   です。 SMTPMAILFROM="My Company <myco@company.com>"
2. マシン 1、2、3 で Cassandra と ZooKeeper を更新します。
   > /opt/apigee/apigee-setup/bin/update.sh -c cs,zk -f configFile
3. マシン 4 で次の iptables ルールを設定します。
   > sudo iptables -A INPUT -p tcp --destination-port 5672 ! -s `hostname` -i eth0 -j DROP
4. マシン 4 の Qpid メッセージ キューを確認します。
   > qpid-stat -q
   
   [msg] 列の数が 0 になるまで、キューの確認を続けます。すべてのメッセージが処理されるまで、Qpid をアップグレードすることはできません。
5. マシン 4 の qpidd を更新します。
   > /opt/apigee/apigee-setup/bin/update.sh -c qpid -f configFile
6. マシン 4 で iptables をフラッシュします。
   > sudo iptables -F
7. マシン 5 でステップ 3 ～ 6 を繰り返します。
8. マシン 4 の postgresql を更新します。
   > /opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile
9. マシン 4 で postgresql を起動します。
   > /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql start
10. マシン 5 でステップ 8 と 9 を繰り返します。
11. マシン 1 で LDAP を更新します。
    > /opt/apigee/apigee-setup/bin/update.sh -c ldap -f configFile
12. マシン 4、5、1、2、3 の Edge コンポーネントを更新します。
    > /opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile
13. マシン 1 の UI を更新します。
    > /opt/apigee/apigee-setup/bin/update.sh -c ui -f configFile

9 ホストのクラスタ化されたインストールの場合

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

1. Edge で SMTP を有効にしている場合は、構成ファイルで SMTPMAILFROM を設定します。このパラメータの形式は
   です。 SMTPMAILFROM="My Company <myco@company.com>"
2. マシン 1、2、3 で Cassandra と ZooKeeper を更新します。
   > /opt/apigee/apigee-setup/bin/update.sh -c cs,zk -f configFile
3. マシン 6 で次の iptables ルールを設定します。
   > sudo iptables -A INPUT -p tcp --destination-port 5672 ! -s `hostname` -i eth0 -j DROP
4. マシン 6 の Qpid メッセージ キューを確認します。
   > qpid-stat -q
   
   [msg] 列の数が 0 になるまで、キューの確認を続けます。すべてのメッセージが処理されるまで、Qpid をアップグレードすることはできません。
5. マシン 6 の qpidd を更新します。
   > /opt/apigee/apigee-setup/bin/update.sh -c qpid -f configFile
6. マシン 6 で iptables をフラッシュします。
   > sudo iptables -F
7. マシン 7 でステップ 3 ～ 6 を繰り返します。
8. マシン 6 の postgresql を更新します。
   > /opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile
9. マシン 6 で postgresql を起動します。
   > /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql start
10. マシン 7 でステップ 8 と 9 を繰り返します。
11. マシン 1 で LDAP を更新します。
    > /opt/apigee/apigee-setup/bin/update.sh -c ldap -f configFile
12. マシン 6、7、8、9、1、4、5 の順に Edge コンポーネントを更新します。
    > /opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile
13. マシン 1 の UI を更新します。
    > /opt/apigee/apigee-setup/bin/update.sh -c ui -f configFile

13 ホストのクラスタ化されたインストールの場合

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

1. Edge で SMTP を有効にしている場合は、構成ファイルで SMTPMAILFROM を設定します。このパラメータの形式は
   です。 SMTPMAILFROM="My Company <myco@company.com>"
2. マシン 1、2、3 で Cassandra と ZooKeeper を更新します。
   > /opt/apigee/apigee-setup/bin/update.sh -c cs,zk -f configFile
3. マシン 12 に次の iptables ルールを設定します。
   > sudo iptables -A INPUT -p tcp --destination-port 5672 ! -s `hostname` -i eth0 -j DROP
4. マシン 12 の Qpid メッセージ キューを確認します。
   > qpid-stat -q
   
   [msg] 列の数が 0 になるまで、キューの確認を続けます。すべてのメッセージが処理されるまで、Qpid をアップグレードすることはできません。
5. マシン 12 の qpidd を更新します。
   > /opt/apigee/apigee-setup/bin/update.sh -c qpid -f configFile
6. マシン 12 で iptables をフラッシュします。
   > sudo iptables -F
7. マシン 13 でステップ 3 ～ 6 を繰り返します。
8. マシン 12 の postgresql を更新します。
   > /opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile
9. マシン 12 で postgresql を起動します。
   > /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql start
10. マシン 13 でステップ 8 と 9 を繰り返します。
11. マシン 4 と 5 で LDAP を更新します。
    > /opt/apigee/apigee-setup/bin/update.sh -c ldap -f configFile
12. マシン 12、13、8、9、6、7、10、11 の順に Edge コンポーネントを更新します。
    > /opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile
13. マシン 6 と 7 の UI を更新します。
    > /opt/apigee/apigee-setup/bin/update.sh -c ui -f configFile

12 ホストのクラスタ化されたインストールの場合

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

1. Edge で SMTP を有効にしている場合は、構成ファイルで SMTPMAILFROM を設定します。このパラメータの形式は
   です。 SMTPMAILFROM="My Company <myco@company.com>"
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 で次の iptables ルールを設定します。
         > sudo iptables -A INPUT -p tcp --destination-port 5672 ! -s `hostname` -i eth0 -j DROP
      2. マシン 4 の Qpid メッセージ キューを確認します。
         > qpid-stat -q
         
         [msg] 列の数が 0 になるまで、キューの確認を続けます。すべてのメッセージが処理されるまで、Qpid をアップグレードすることはできません。
      3. マシン 4 の qpidd を更新します。
         > /opt/apigee/apigee-setup/bin/update.sh -c qpid -f configFile
      4. マシン 4 で iptables をフラッシュします。
         > sudo iptables -F
      5. マシン 5 で手順 1 ～ 4 を繰り返します。
   2. データセンター 2 のマシン 10、11
      1. マシン 10 に次の iptables ルールを設定します。
         > sudo iptables -A INPUT -p tcp --destination-port 5672 ! -s `hostname` -i eth0 -j DROP
      2. マシン 10 の Qpid メッセージ キューを確認します。
         > qpid-stat -q
         
         [msg] 列の数が 0 になるまで、キューの確認を続けます。すべてのメッセージが処理されるまで、Qpid をアップグレードすることはできません。
      3. マシン 10 の qpidd を更新します。
         > /opt/apigee/apigee-setup/bin/update.sh -c qpid -f configFile
      4. マシン 10 で iptables をフラッシュします。
         > sudo iptables -F
      5. マシン 11 でステップ 1 ～ 4 を繰り返します。
4. postgresql を更新します。
   1. データセンター 1 のマシン 6
      > /opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile
      > /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql start
   2. データセンター 2 のマシン 12
      > /opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile
      > /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql start
5. 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
6. 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
7. 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 ホストの API BaaS インストールの場合

アップグレード手順を実行する前に、構成ファイルに 2 つの新しいプロパティを追加する必要があります。

# For a single data center, specify the same value as BAAS_CASS_LOCALDC.
BAAS_CASS_DC_LIST="dc-1"

# Defines the initial contact points for members of the BaaS cluster. 
# Specify the IP address of no more than two Stack nodes. 
BAAS_CLUSTER_SEEDS="dc-1:$IP4,dc-1:$IP5"

構成ファイルの完全な例については、API BaaS のインストールをご覧ください。

また、他のすべての Stack ノードからアクセスできるように、すべての Stack ノードでポート 2551 が開いていることを確認する必要があります。

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

アップグレード手順を実行する前に、構成ファイルに 2 つの新しいプロパティを追加する必要があります。

# For a single data center, specify the same value as BAAS_CASS_LOCALDC.
BAAS_CASS_DC_LIST="dc-1"

# Defines the initial contact points for members of the BaaS cluster. 
# Specify the IP address of no more than two Stack nodes. 
BAAS_CLUSTER_SEEDS="dc-1:$IP4,dc-1:$IP5"

構成ファイルの完全な例については、API BaaS のインストールをご覧ください。

また、他のすべての Stack ノードからアクセスできるように、すべての Stack ノードでポート 2551 が開いていることを確認する必要があります。

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、ps
4. LDAP
5. Edge。すべてのノードで「-c edge」プロファイルを次の順序でインストールします。Qpid サーバー、Postgres サーバー、Management Server、Message Processor、Router を含むノード。
   注: ノードに Qpid サーバーと Postgres サーバーの両方がインストールされている場合は、「-c edge」プロファイルの手順を実行します。
6. Edge UI