Edge for Private Cloud v4.19.01
このセクションでは、次のアップグレードを行う方法について説明します。
- 4.17.09 から 4.19.01 へのアップグレード
更新を行えるユーザー
更新を行うユーザーは、Edge をインストールしたユーザーか root として実行するユーザーである必要があります。
Edge RPM をインストールした後は、すべてのユーザーが構成できます。
更新する必要のあるコンポーネント
すべての Edge コンポーネントを更新する必要があります。Edge では、コンポーネントのバージョンが複数になる設定はサポートしていません。
互換性の維持
Apigee Edge for Private Cloud を 4.19.01 にアップグレードする場合、アップグレード後に構成ファイルを開き、サポートされているプロパティだけが参照されていることを確認してください。
プロパティ | 場所 | 説明 |
---|---|---|
conf_load_balancing_load.balancing. |
router.properties |
router.properties ファイルからこのプロパティを削除します。4.19.01 で retry オプションを設定するには、仮想ホストの構成プロパティを使用します。 |
プロパティ設定の自動伝播
/opt/apigee/customer/application
にある .properties
ファイルを編集してプロパティを設定した場合、それらの値は更新の際にも保持されます。
Postgres 9.6 へのアップグレードが必須
Edge のこのリリースでは、Postgres 9.6 へのアップグレードが含まれています。アップグレードの際に、すべての Postgres のデータが Postgres 9.6 に移行されます。
本番環境の Edge システムの場合、通常は 2 台の Postgres ノードでマスター / スタンバイのレプリケーションを構成します。更新の際、Postgres ノードはダウンしますが、分析データは Qpid ノードに書き込まれます。Postgres が更新され、オンラインに復帰すると、分析データが Postgres ノードに送信されるようになります。
Postgres の更新方法は、Postgres ノードのデータ ストレージの構成方法によって異なります。
- Postgres ノードにローカルのデータ ストレージを使用している場合は、アップグレード用に Postgres のスタンバイ ノードを新しくインストールする必要があります。アップグレードが完了したら、新たに用意した Postgres スタンバイ ノードは廃止できます。
なんらかの理由で更新をロールバックする場合は、Postgres スタンバイ ノードを追加する必要があります。ロールバック後に、新たに作成した Postgres スタンバイ ノードがマスター Postgres ノードになります。そのため、Postgres スタンバイ ノードを新たにインストールする際は、Edge のインストール要件に定められた Postgres サーバーのハードウェア要件をすべて満たすノードにインストールする必要があります。
Edge の 1 ノードまたは 2 ノード構成(プロトタイピングやテストに使用するトポロジ)では、Postgres ノードは 1 つだけです。このような Postgres ノードは、新しい Postgres ノードを作成せずに直接更新できます。
- Postgres ノードにネットワーク ストレージを使用している場合は、Postgres ノードを新しくインストールする必要はありません。この方法は Apigee からも推奨されています。下の手順の新しい Postgres スタンバイ ノードのインストールとその後の廃止の手順は省略できます。
更新を始める前に、Postgres で使用されるデータストアのネットワーク スナップショットを取得します。更新の際になんらかのエラーが発生し、ロールバックを行う必要が生じた場合は、スナップショットから Postgres ノードを復元できます。
Postgres スタンバイ ノードを新たにインストールする
この手順では、新しいノードに Postgres のスタンバイ サーバーを作成します。新しい Postgres スタンバイ サーバーは、(バージョン 4.19.01 のものではなく)既存の Edge バージョン(4.17.09)のものをインストールしてください。
インストールには、Edge の現行バージョンのインストールに使用したものと同じ構成ファイルを使用します。
Postgres スタンバイ ノードを新たに作成するには:
- 現在の Postgres マスターで、
/opt/apigee/customer/application/postgresql.properties
ファイルを編集し、次のトークンを設定します。このファイルが存在しない場合は作成します。conf_pg_hba_replication.connection=host replication apigee existing_standby_ip/32 trust\ \nhost replication apigee new_standby_ip/32 trust
ここで、existing_standby_ip は現在の Postgres スタンバイ サーバーの IP アドレスで、new_standby_ip は新しいスタンバイ ノードの IP アドレスです。
- Postgres マスターで、
apigee-postgresql
を再起動します。/opt/apigee/apigee-service/bin/apigee-service apigee-postgresql restart
- マスターの
/opt/apigee/apigee-postgresql/conf/pg_hba.conf
ファイルを見て、スタンバイ ノードが新たに追加されたことを確認します。ファイルに次の行が確認できるはずです。host replication apigee existing_standby_ip/32 trust host replication apigee new_standby_ip/32 trust
- Postgres スタンバイ サーバーを新たにインストールします。
- 現在のバージョンの 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
- Edge apigee-setup ユーティリティのインストールの説明に従って、SELinux を無効にします。
- Edge bootstrap_4.17.09.sh ファイルを
/tmp/bootstrap_4.17.09.sh
にダウンロードします。curl https://software.apigee.com/bootstrap_4.17.09.sh -o /tmp/bootstrap_4.17.09.sh
- Edge
apigee-service
ユーティリティと依存関係をインストールします。sudo bash /tmp/bootstrap_4.17.09.sh apigeeuser=uName apigeepassword=pWord
apigee-service
を使用して、apigee-setup
ユーティリティをインストールします。/opt/apigee/apigee-service/bin/apigee-service apigee-setup install
- Postgres をインストールします。
/opt/apigee/apigee-setup/bin/setup.sh -p ps -f configFile
- スタンバイ ノードで、次のコマンドを実行します。
/opt/apigee/apigee-service/bin/apigee-service apigee-postgresql postgres-check-standby
スタンバイと表示されるか確認します。
- 現在のバージョンの Edge をインストールする際に使用した構成ファイルを編集し、次の内容を指定します。
Postgres ノードを廃止する
更新が完了したら、新たに用意したスタンバイ ノードを廃止します。
- Postgres が実行中であることを確認します。
/opt/apigee/apigee-service/bin/apigee-all status
Postgres が実行中でない場合は、起動させます。
/opt/apigee/apigee-service/bin/apigee-all start
- 新しいスタンバイ ノードで次の
curl
コマンドを実行して、新しいスタンバイ ノードの UUID を取得します。curl -u sysAdminEmail:password http://node_IP:8084/v1/servers/self
出力結果の最後の行に、次の形式でノードの UUID が表示されます。
"type" : [ "postgres-server" ], "uUID" : "599e8ebf-5d69-4ae4-aa71-154970a8ec75"
- 新しいスタンバイ ノードで、次のコマンドを実行して、新しいスタンバイ ノードを停止させます。
/opt/apigee/apigee-service/bin/apigee-all stop
- Postgres マスターノードで、
/opt/apigee/customer/application/postgresql.properties
ファイルを編集してconf_pg_hba_replication.connection
から新しく作成したスタンバイ ノードを削除します。conf_pg_hba_replication.connection=host replication apigee existing_standby_ip/32 trust
- Postgres マスターで、apigee-postgresql を再起動します。
/opt/apigee/apigee-service/bin/apigee-service apigee-postgresql restart
- マスターの
/opt/apigee/apigee-postgresql/conf/pg_hba.conf
ファイルを見て、新しく作成したスタンバイ ノードが削除されたことを確認します。ファイルには、次の行だけが表示されます。host replication apigee existing_standby_ip/32 trust
- Management Server ノードで、次の Edge 管理 API を呼び出して、ZooKeeper からスタンバイ ノードの UUID を削除します。
curl -u sysAdminEmail:password -X DELETE http://ms_IP:8080/v1/servers/new_standby_uuid
更新の前提条件
Apigee Edge をアップグレードする前に、次の前提条件を確認してください。
- すべてのノードをバックアップする
安全上の理由により、更新を行う前にすべてのノードを完全にバックアップすることをおすすめします。現在のバージョンの Edge でバックアップを行うには、次の手順を使用します。これにより、新しいバージョンへの更新が正常に行われなかった場合に備えて、バックアップ プランを用意できます。バックアップの詳細については、バックアップと復元をご覧ください。
- Edge が実行中であることを確認する
次のコマンドを使用して、Edge が更新中に起動していることを確認します。/opt/apigee/apigee-service/bin/apigee-all status
更新が失敗した場合の対応
更新に失敗した場合は、問題の解決を試みた上で update.sh を再度実行できます。更新は複数回実行でき、最後に終了したところから続行させることができます。
失敗した結果、前のバージョンへのロールバックが必要になった場合は、4.19.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 と同じマシンにあるすべてのコンポーネントを更新してから、Router をロードバランサに追加し直します。
- 構成に応じた正しい順序でマシンを更新します。更新順序については、マシンの更新順序をご覧ください。
- Router を更新するときは、任意の Router を 1 台選択し、サーバー(Message Processor または Router)の到達可能性の有効化 / 無効化の説明に従ってその Router を到達不能な状態にします。
- 選択した Router と、Router と同じマシンにある他のすべての Edge コンポーネントを更新します。すべての Edge 構成で、Router と Message Processor が同じノードに表示されます。
- Router を到達可能な状態に戻します。
- 残りの Router に対し、2~4 の手順を繰り返します。
- 構成内の残りすべてのマシンで更新を続行します。
更新の前後で次の点に注意してください。
- Router と Message Processor ノードが混在している場合
- 更新前 – 次の内容を実施します。
- Router を到達不能な状態にします。
- Message Processor を到達不能な状態にします。
- 更新後 - 次の内容を実施します。
- Message Processor を到達可能な状態にします。
- Router を到達可能な状態にします。
- 更新前 – 次の内容を実施します。
- 単一 Router ノードの場合
- 更新前に、Router を到達不能な状態にします。
- 更新後に、Router を到達可能な状態にします。
- 単一 Message Processor ノードの場合
- 更新前に、Message Processor を到達不能な状態にします。
- 更新後に、Message Processor を到達可能な状態にします。
サイレント構成ファイルの使用
サイレント構成ファイルを更新コマンドに渡す必要があります。サイレント構成ファイルは、Edge 4.17.09 のインストールに使用したものと同じである必要があります。
外部インターネット接続があるノードで 4.19.01 に更新する
ノードで Edge コンポーネントを更新する手順は次のとおりです。
- 現在、ローカル ストレージで Postgres のマスター / スタンバイ レプリケーションを使用している場合は、Postgres スタンバイ ノードを新たにインストールするを参照して、Postgres スタンバイ ノードを新たにインストールします。
ネットワーク ストレージを使用している場合は、新しいノードをインストールする必要はありません。Postgres で使用するデータストアのネットワーク スナップショットを取得します。詳細については、Postgres 9.6 へのアップグレードが必須をご覧ください。
- Cassandra の修復オペレーションを行うように構成されている CRON ジョブがある場合は、更新が完了するまで無効にします。
- ノードに root としてログインし、Edge RPM をインストールします。
yum-utils
とyum-plugin-priorities
をインストールします。sudo yum install yum-utils
sudo yum install yum-plugin-priorities
- Edge apigee-setup ユーティリティをインストールするを参照し、SELinux を無効にします。
- Oracle 7.x にインストールしている場合は、次のコマンドを実行します。
sudo yum-config-manager --enable ol7_optional_latest
- 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
- Edge 4.19.01 の
bootstrap_4.19.01.sh
ファイルを/tmp/bootstrap_4.19.01.sh
にダウンロードします。curl https://software.apigee.com/bootstrap_4.19.01.sh -o /tmp/bootstrap_4.19.01.sh
- Edge 4.19.01 の
apigee-service
ユーティリティと依存関係をインストールします。sudo bash /tmp/bootstrap_4.19.01.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 を自身でインストールする必要があります。
apigee-service
を使用して、apigee-setup
ユーティリティを更新します。/opt/apigee/apigee-service/bin/apigee-service apigee-setup update
- Management Server で
apigee-validate
ユーティリティを更新します。/opt/apigee/apigee-service/bin/apigee-service apigee-validate update
apigee-provision
ユーティリティを更新します。/opt/apigee/apigee-service/bin/apigee-service apigee-provision update
- マシンの更新順序に記載された順に、各ノードで update ユーティリティを実行します。
/opt/apigee/apigee-setup/bin/update.sh -c component -f configFile
構成ファイルは、「apigee」ユーザーによってアクセス可能であり、読み取り可能である必要があります。
-c
オプションを使用して、更新するコンポーネントを指定します。利用可能なコンポーネントの一覧は、次のとおりです。- 「cs」= Cassandra
- 「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
- Edge UI コンポーネントを実行しているマシンで、同コンポーネントをまだ再起動していない場合は、再起動します。
/opt/apigee/apigee-service/bin/apigee-service edge-ui restart
- インストールのテストの説明に従って Management Server で
apigee-validate
ユーティリティを実行し、更新をテストします。 - Postgres スタンバイ ノードを新たにインストールした場合は、Postgres ノードを廃止するを参照して、ノードを廃止します。
ネットワーク ストレージを使用している場合は、新しいノードをインストールする必要はありません。詳細については、Postgres 9.6 へのアップグレードが必須をご覧ください。
後で更新をロールバックする場合は、4.19.01 のロールバックの手順に従ってください。
ローカル リポジトリから 4.19.01 に更新する
Edge ノードがファイアウォールの内側にあるか、インターネット経由での Apigee リポジトリへのアクセスが禁止されている場合は、Apigee リポジトリのローカル リポジトリ(ミラー)から更新を行うことができます。
ローカル Edge リポジトリを作成したら、Edge をローカル リポジトリから更新するには、2 つの方法があります。
- リポジトリの .tar ファイルを作成して、ノードにコピーします。そして、.tar ファイル Edge を更新します。
- ローカル リポジトリを使用してノードにウェブサーバーをインストールし、他のノードからアクセスできるようにします。Apigee から提供されているウェブサーバーは Nginx ですが、他のウェブサーバーを使用してもかまいません。
ローカルの 4.19.01 リポジトリから更新するには:
- 現在 Postgres のマスター / スタンバイ レプリケーションを使用している場合は、Postgres スタンバイ ノードを新たにインストールするの手順に従って、新しい Postgres スタンバイ ノードをインストールします。
ネットワーク ストレージを使用している場合は、新しいノードをインストールする必要はありません。Postgres で使用するデータストアのネットワーク スナップショットを取得します。詳細については、Postgres 9.6 へのアップグレードが必須をご覧ください。
- Edge apigee-setup ユーティリティのインストールの「ローカルに Apigee リポジトリを作成する」の手順に従って、4.19.01 リポジトリをローカルに作成します。
- .tar ファイルから apigee-service をインストールするには:
- ローカル リポジトリが存在するノードで次のコマンドを使用し、ローカル リポジトリを
/opt/apigee/data/apigee-mirror/apigee-4.19.01.tar.gz
という名前の単一の .tar ファイルにパッケージ化します。/opt/apigee/apigee-service/bin/apigee-service apigee-mirror package
- Edge を更新するノードに .tar ファイルをコピーします。たとえば、新しいノードの
/tmp
ディレクトリにコピーします。 - 新しいノードで、tar ファイルを解凍し、/tmp ディレクトリに展開します。
tar -xzf apigee-4.19.01tar.gz
このコマンドにより、repos という名前の新しいディレクトリが作成されます。ディレクトリには .tar ファイルが含まれます。たとえば、/tmp/repos のようになります。
- /tmp/repos から Edge apigee-service ユーティリティと依存関係をインストールします。
sudo bash /tmp/repos/bootstrap_4.19.01.sh apigeeprotocol="file://" apigeerepobasepath=/tmp/repos
コマンドに、repos ディレクトリへのパスが含まれている点に注意してください。
- ローカル リポジトリが存在するノードで次のコマンドを使用し、ローカル リポジトリを
- Nginx ウェブサーバーを使用して apigee-service をインストールするには:
- Edge
apigee-setup
ユーティリティのインストールの「Nginx ウェブサーバーを使用してリポジトリからインストールする」の手順に従って、Nginx ウェブサーバーを構成します。 - リモートノードで、Edge の
bootstrap_4.19.01.sh
ファイルを/tmp/bootstrap_4.19.01.sh
にダウンロードします。/usr/bin/curl http://uName:pWord@remoteRepo:3939/bootstrap_4.19.01.sh -o /tmp/bootstrap_4.19.01.sh
ここで、uName:pWord は以前にリポジトリに設定したユーザー名とパスワードで、remoteRepo はリポジトリが存在するノードの IP アドレスまたは DNS 名です。
- リモートノードで、Edge
apigee-service
ユーティリティと依存関係をインストールします。sudo bash /tmp/bootstrap_4.19.01.sh apigeerepohost=remoteRepo:3939 apigeeuser=uName apigeepassword=pWord apigeeprotocol=http://
uName:pWord は、リポジトリのユーザー名とパスワードです。
- Edge
apigee-service
を使用して、apigee-setup
ユーティリティを更新します。/opt/apigee/apigee-service/bin/apigee-service apigee-setup update
- Management Server で
apigee-validate
ユーティリティを更新します。/opt/apigee/apigee-service/bin/apigee-service apigee-validate update
apigee-provision
ユーティリティを更新します。/opt/apigee/apigee-service/bin/apigee-service apigee-provision update
- マシンの更新順序に記載された順に、各ノードで
update
ユーティリティを実行します。/opt/apigee/apigee-setup/bin/update.sh -c component -f configFile
構成ファイルは、「apigee」ユーザーによってアクセス可能であり、読み取り可能である必要があります。
-c
オプションを使用して、更新するコンポーネントを指定します。利用可能なコンポーネントの一覧は、次のとおりです。- 「cs」= Cassandra
- 「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
- Edge UI コンポーネントを実行しているマシンで、同コンポーネントをまだ再起動していない場合は、再起動します。
/opt/apigee/apigee-service/bin/apigee-service edge-ui restart
- インストールのテストの説明に従って Management Server で
apigee-validate
ユーティリティを実行し、更新をテストします。 - Postgres スタンバイ ノードを新たにインストールした場合は、Postgres ノードを廃止するを参照して、ノードを廃止します。
ネットワーク ストレージを使用している場合は、新しいノードをインストールする必要はありません。詳細については、Postgres 9.6 へのアップグレードが必須をご覧ください。
後で更新をロールバックする場合は、4.19.01 のロールバックの手順に従ってください。
マシンの更新順序
Edge 構成内のマシンの更新順序は重要です。更新時に特に考慮すべき事項を以下に示します。
- すべての Cassandra ノードと ZooKeeper ノードを、それ以外のノードよりも先に更新してください。
- 複数の Edge コンポーネント(Management Server、Message Processor、Router、QPID Server。Postgres Server は該当せず)を搭載しているマシンでは、「-c edge」オプションを使用して、それらのコンポーネントをすべて同時に更新します。
- 複数のマシンで行う必要がある手順に関しては、所定のマシン順序に従って実施します。
- Monetization の更新に関して、特別の手順はありません。「-c edge」オプションを指定した場合に更新されます。
1 ノード スタンドアロン構成のアップグレード
- Cassandra と ZooKeeper を更新します。
/opt/apigee/apigee-setup/bin/update.sh -c cs,zk -f configFile
- Qpid を更新します。
/opt/apigee/apigee-setup/bin/update.sh -c qpid -f configFile
- LDAP を更新します。
/opt/apigee/apigee-setup/bin/update.sh -c ldap -f configFile
- 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
- postgresql を更新します。
/opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile
- 残りの Edge コンポーネントを更新します。
/opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile
- Edge UI を更新します。
/opt/apigee/apigee-setup/bin/update.sh -c ui -f configFile
apigee-adminapi
がインストールされている場合は、apigee-adminapi
ユーティリティを更新します。/opt/apigee/apigee-service/bin/apigee-service apigee-adminapi update
- Edge SSO がインストールされている場合は、Edge SSO を更新します。
/opt/apigee/apigee-setup/bin/update.sh -c sso -f sso_config_file
ここで、sso_config_file は SSO をインストールしたときに作成した構成ファイルです。
- Edge UI コンポーネントを再起動します。
/opt/apigee/apigee-service/bin/apigee-service edge-ui restart
2 ノード スタンドアロン構成のアップグレード
Edge のトポロジとノード番号の一覧については、インストール トポロジをご覧ください。
- マシン 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
- マシン 1 の LDAP を更新します。
/opt/apigee/apigee-setup/bin/update.sh -c ldap -f configFile
- マシン 1 の Edge コンポーネントを更新します。
/opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile
- マシン 1 の UI を更新します。
/opt/apigee/apigee-setup/bin/update.sh -c ui -f configFile
apigee-adminapi
がインストールされている場合は、マシン 1 のapigee-adminapi
ユーティリティを更新します。/opt/apigee/apigee-service/bin/apigee-service apigee-adminapi update
- Edge SSO がインストールされている場合は、マシン 1 の Edge SSO を更新します。
/opt/apigee/apigee-setup/bin/update.sh -c sso -f sso_config_file
ここで、sso_config_file は SSO をインストールしたときに作成した構成ファイルです。
- マシン 2 の postgresql を更新します。
- 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
- postgresql を更新します。
/opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile
- マシン 2 の Edge コンポーネントを更新します。
/opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile
- Postgres Server、Qpid Server、postgresql を停止させます。
- マシン 1 の Edge UI コンポーネントを再起動します。
/opt/apigee/apigee-service/bin/apigee-service edge-ui restart
5 ノード構成のアップグレード
Edge のトポロジとノード番号の一覧については、インストール トポロジをご覧ください。
- Postgres スタンバイ ノードを新たにインストールするの手順に従って、新しい Postgres スタンバイ ノードをインストールします。
ネットワーク ストレージを使用している場合は、新しいノードをインストールする必要はありません。Postgres で使用するデータストアのネットワーク スナップショットを取得します。詳細については、Postgres 9.6 へのアップグレードが必須をご覧ください。
- マシン 1、2、3 の Cassandra および ZooKeeper を更新します。
/opt/apigee/apigee-setup/bin/update.sh -c cs,zk -f configFile
- マシン 4、5 の Qpid を更新します。
/opt/apigee/apigee-setup/bin/update.sh -c qpid -f configFile
- マシン 1 の LDAP を更新します。
/opt/apigee/apigee-setup/bin/update.sh -c ldap -f configFile
- マシン 1、2、3 の Edge コンポーネントを更新します。
/opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile
- マシン 1 の UI を更新します。
/opt/apigee/apigee-setup/bin/update.sh -c ui -f configFile
apigee-adminapi
がインストールされている場合は、マシン 1 のapigee-adminapi
ユーティリティを更新します。/opt/apigee/apigee-service/bin/apigee-service apigee-adminapi update
- Edge SSO がインストールされている場合は、マシン 1 の Edge SSO を更新します。
/opt/apigee/apigee-setup/bin/update.sh -c sso -f sso_config_file
ここで、sso_config_file は SSO をインストールしたときに作成した構成ファイルです。
- マシン 4、5 を更新します。
- マシン 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
- マシン 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
- ロールバックに備えて新たに追加したスタンバイ ノードに、Postgres Server と postgresql がインストールされている場合は、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 の postgresql を更新します。
/opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile
- マシン 5 の postgresql を更新します。
/opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile
- マシン 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
- マシン 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
- マシン 4、5 の両方で、次のスクリプトを実行してレプリケーションの状況を確認します。レプリケーションが成功していることを確認するには、両方で同じ結果が表示されていなければなりません。
- マシン 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
スタンバイと表示されるか確認します。
- マシン 4(マスターノード)で、次のコマンドを実行します。
- マシン 4 の Postgres Server、Qpid Server を停止させます。
- マシン 4、5 の Edge コンポーネントを更新します。
/opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile
- Postgres ノードを廃止するの手順に従って、新しいスタンバイ ノードの使用を停止します。
ネットワーク ストレージを使用している場合は、新しいノードをインストールする必要はありません。詳細については、Postgres 9.6 へのアップグレードが必須をご覧ください。
- マシン 1 の Edge UI コンポーネントを再起動します。
/opt/apigee/apigee-service/bin/apigee-service edge-ui restart
9 ノードクラスタ構成のアップグレード
Edge のトポロジとノード番号の一覧については、インストール トポロジをご覧ください。
- Postgres スタンバイ ノードを新たにインストールするの手順に従って、新しい Postgres スタンバイ ノードをインストールします。
ネットワーク ストレージを使用している場合は、新しいノードをインストールする必要はありません。Postgres で使用するデータストアのネットワーク スナップショットを取得します。詳細については、Postgres 9.6 へのアップグレードが必須をご覧ください。
- マシン 1、2、3 の Cassandra および ZooKeeper を更新します。
/opt/apigee/apigee-setup/bin/update.sh -c cs,zk -f configFile
- マシン 6、7 の Qpid を更新します。
/opt/apigee/apigee-setup/bin/update.sh -c qpid -f configFile
- マシン 1 の LDAP を更新します。
/opt/apigee/apigee-setup/bin/update.sh -c ldap -f configFile
- マシン 6、7、1、4、5 の順に Edge コンポーネントを更新します。
/opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile
- マシン 1 の UI を更新します。
/opt/apigee/apigee-setup/bin/update.sh -c ui -f configFile
apigee-adminapi
がインストールされている場合は、マシン 1 のapigee-adminapi
ユーティリティを更新します。/opt/apigee/apigee-service/bin/apigee-service apigee-adminapi update
- Edge SSO がインストールされている場合は、マシン 1 の Edge SSO を更新します。
/opt/apigee/apigee-setup/bin/update.sh -c sso -f sso_config_file
ここで、sso_config_file は SSO をインストールしたときに作成した構成ファイルです。
- マシン 8、9 を更新します。
- マシン 8 の Postgres Server を停止させます。
/opt/apigee/apigee-service/bin/apigee-service edge-postgres-server stop
- マシン 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
- マシン 6、7 の Qpid Server を停止させます。
/opt/apigee/apigee-service/bin/apigee-service edge-qpid-server stop
- ロールバックに備えて新たに追加したスタンバイ ノードに、Postgres Server と postgresql がインストールされている場合は、Postgres Server と postgresql も停止させます。
/opt/apigee/apigee-service/bin/apigee-service edge-postgres-server stop
/opt/apigee/apigee-service/bin/apigee-service apigee-postgresql stop
- マシン 8 の postgresql を更新します。
/opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile
- マシン 9 の postgresql を更新します。
/opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile
- マシン 8、9 の Postgres Server を起動させます。
/opt/apigee/apigee-service/bin/apigee-service edge-postgres-server start
- マシン 6、7 の Qpid Server を起動させます。
/opt/apigee/apigee-service/bin/apigee-service edge-qpid-server start
- マシン 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
- マシン 8、9 の両方で、次のスクリプトを実行してレプリケーションの状況を確認します。レプリケーションが成功していることを確認するには、両方で同じ結果が表示されていなければなりません。
- マシン 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
スタンバイと表示されるか確認します。
- マシン 8(マスターノード)で、次のコマンドを実行します。
- マシン 8 の Postgres Server を停止させます。
- マシン 8、9 の Edge コンポーネントを更新します。
/opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile
- Postgres ノードを廃止するの手順に従って、新しいスタンバイ ノードの使用を停止します。
ネットワーク ストレージを使用している場合は、新しいノードをインストールする必要はありません。詳細については、Postgres 9.6 へのアップグレードが必須をご覧ください。
- マシン 1 の Edge UI コンポーネントを再起動します。
/opt/apigee/apigee-service/bin/apigee-service edge-ui restart
13 ノードクラスタ構成のアップグレード
Edge のトポロジとノード番号の一覧については、インストール トポロジをご覧ください。
- Postgres スタンバイ ノードを新たにインストールするの手順に従って、新しい Postgres スタンバイ ノードをインストールします。
ネットワーク ストレージを使用している場合は、新しいノードをインストールする必要はありません。Postgres で使用するデータストアのネットワーク スナップショットを取得します。詳細については、Postgres 9.6 へのアップグレードが必須をご覧ください。
- マシン 1、2、3 の Cassandra および ZooKeeper を更新します。
/opt/apigee/apigee-setup/bin/update.sh -c cs,zk -f configFile
- マシン 12、13 の Qpid を更新します。
/opt/apigee/apigee-setup/bin/update.sh -c qpid -f configFile
- マシン 4、5 の LDAP を更新します。
/opt/apigee/apigee-setup/bin/update.sh -c ldap -f configFile
- マシン 12、13、6、7、10、11 の順に Edge コンポーネントを更新します。
/opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile
- マシン 6、7 の UI を更新します。
/opt/apigee/apigee-setup/bin/update.sh -c ui -f configFile
apigee-adminapi
がインストールされている場合は、マシン 6、7 のapigee-adminapi
ユーティリティを更新します。/opt/apigee/apigee-service/bin/apigee-service apigee-adminapi update
- Edge SSO がインストールされている場合は、マシン 6、7 の Edge SSO を更新します。
/opt/apigee/apigee-setup/bin/update.sh -c sso -f sso_config_file
ここで、sso_config_file は SSO をインストールしたときに作成した構成ファイルです。
- マシン 8、9 を更新します。
- マシン 8 の Postgres Server を停止させます。
/opt/apigee/apigee-service/bin/apigee-service edge-postgres-server stop
- マシン 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
- マシン 12、13 の Qpid Server を停止させます。
/opt/apigee/apigee-service/bin/apigee-service edge-qpid-server stop
- ロールバックに備えて新たに追加したスタンバイ ノードに、Postgres Server と postgresql がインストールされている場合は、Postgres Server と postgresql も停止させます。
/opt/apigee/apigee-service/bin/apigee-service edge-postgres-server stop
/opt/apigee/apigee-service/bin/apigee-service apigee-postgresql stop
- マシン 8 の postgresql を更新します。
/opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile
- マシン 9 の postgresql を更新します。
/opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile
- マシン 8、9 の Postgres Server を起動させます。
/opt/apigee/apigee-service/bin/apigee-service edge-postgres-server start
- マシン 12、13 の Qpid Server を起動させます。
/opt/apigee/apigee-service/bin/apigee-service edge-qpid-server start
- マシン 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
- マシン 8、9 の両方で、次のスクリプトを実行してレプリケーションの状況を確認します。レプリケーションが成功していることを確認するには、両方で同じ結果が表示されていなければなりません。
- マシン 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
スタンバイと表示されるか確認します。
- マシン 8(マスターノード)で、次のコマンドを実行します。
- マシン 8 の Postgres Server を停止させます。
- マシン 8、9 の Edge コンポーネントを更新します。
/opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile
- Postgres ノードを廃止するの手順に従って、新しいスタンバイ ノードの使用を停止します。
ネットワーク ストレージを使用している場合は、新しいノードをインストールする必要はありません。詳細については、Postgres 9.6 へのアップグレードが必須をご覧ください。
- マシン 6、7 の Edge UI コンポーネントを再起動します。
/opt/apigee/apigee-service/bin/apigee-service edge-ui restart
12 ノードクラスタ構成のアップグレード
Edge のトポロジとノード番号の一覧については、インストール トポロジをご覧ください。
- Postgres スタンバイ ノードを新たにインストールするの手順に従って、新しい Postgres スタンバイ ノードをインストールします。
ネットワーク ストレージを使用している場合は、新しいノードをインストールする必要はありません。Postgres で使用するデータストアのネットワーク スナップショットを取得します。詳細については、Postgres 9.6 へのアップグレードが必須をご覧ください。
- Cassandra と ZooKeeper を更新します。
- データセンター 1 のマシン 1、2、3 で、次のコマンドを実行します。
/opt/apigee/apigee-setup/bin/update.sh -c cs,zk -f configFile
- データセンター 2 のマシン 7、8、9 で、次のコマンドを実行します。
/opt/apigee/apigee-setup/bin/update.sh -c cs,zk -f configFile
- データセンター 1 のマシン 1、2、3 で、次のコマンドを実行します。
- qpidd を更新します。
- データセンター 1 のマシン 4、5 で、次の手順を実施します。
- マシン 4 の
qpidd
を更新します。/opt/apigee/apigee-setup/bin/update.sh -c qpid -f configFile
- マシン 5 で、手順 1 を繰り返します。
- マシン 4 の
- データセンター 2 のマシン 10、11 で、次の手順を実施します。
- マシン 10 の
qpidd
を更新します。/opt/apigee/apigee-setup/bin/update.sh -c qpid -f configFile
- マシン 11 で、手順 1 を繰り返します。
- マシン 10 の
- データセンター 1 のマシン 4、5 で、次の手順を実施します。
- LDAP を更新します。
- データセンター 1 のマシン 1 で、次のコマンドを実行します。
/opt/apigee/apigee-setup/bin/update.sh -c ldap -f configFile
- データセンター 2 のマシン 7 で、次のコマンドを実行します。
/opt/apigee/apigee-setup/bin/update.sh -c ldap -f configFile
- データセンター 1 のマシン 1 で、次のコマンドを実行します。
- Edge コンポーネントを更新します。
- データセンター 1 のマシン 4、5、1、2、3 で、次のコマンドを実行します。
/opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile
- データセンター 2 の 10、11、7、8、9 で、次のコマンドを実行します。
/opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile
- データセンター 1 のマシン 4、5、1、2、3 で、次のコマンドを実行します。
- UI を更新します。
- データセンター 1 のマシン 1 で、次のコマンドを実行します。
/opt/apigee/apigee-setup/bin/update.sh -c ui -f configFile
- データセンター 2 のマシン 7 で、次のコマンドを実行します。
/opt/apigee/apigee-setup/bin/update.sh -c ui -f configFile
- データセンター 1 のマシン 1 で、次のコマンドを実行します。
apigee-adminapi
がインストールされている場合は、apigee-adminapi
ユーティリティを更新します。- データセンター 1 のマシン 1 で、次のコマンドを実行します。
/opt/apigee/apigee-service/bin/apigee-service apigee-adminapi update
- データセンター 2 のマシン 7 で、次のコマンドを実行します。
/opt/apigee/apigee-service/bin/apigee-service apigee-adminapi update
- データセンター 1 のマシン 1 で、次のコマンドを実行します。
- Edge SSO がインストールされている場合は、Edge SSO を更新します。
- データセンター 1 のマシン 1 で、次のコマンドを実行します。
/opt/apigee/apigee-setup/bin/update.sh -c sso -f sso_config_file
- データセンター 2 のマシン 7 で、次のコマンドを実行します。
/opt/apigee/apigee-setup/bin/update.sh -c sso -f sso_config_file
ここで、sso_config_file は SSO をインストールしたときに作成した構成ファイルです。
- データセンター 1 のマシン 1 で、次のコマンドを実行します。
- データセンター 1 のマシン 6 とデータセンター 2 のマシン 12 を更新します。
- マシン 6 の Postgres Server を停止させます。
/opt/apigee/apigee-service/bin/apigee-service edge-postgres-server stop
- マシン 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
- マシン 4、5、10、11 の Qpid Server を停止させます。
/opt/apigee/apigee-service/bin/apigee-service edge-qpid-server stop
- ロールバックに備えて新たに追加したスタンバイ ノードに、Postgres Server と postgresql がインストールされている場合は、Postgres Server と postgresql も停止させます。
/opt/apigee/apigee-service/bin/apigee-service edge-postgres-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
- マシン 12 の postgresql を更新します。
/opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile
- マシン 6、12 の Postgres Server を起動させます。
/opt/apigee/apigee-service/bin/apigee-service edge-postgres-server start
- マシン 4、5、10、11 の Qpid Server を起動させます。
/opt/apigee/apigee-service/bin/apigee-service edge-qpid-server start
- マシン 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
- マシン 6、12 の両方で、次のスクリプトを実行してレプリケーションの状況を確認します。レプリケーションが成功していることを確認するには、両方で同じ結果が表示されていなければなりません。
マシン 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
スタンバイと表示されるか確認します。
- マシン 6 の Postgres Server を停止させます。
- マシン 6、12 の Edge コンポーネントを更新します。
/opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile
- 新たに用意されたスタンバイ ノードが Postgres ノードを廃止するの手順に沿って廃止されているか確認します。
ネットワーク ストレージを使用している場合は、新しいノードをインストールする必要はありません。詳細については、Postgres 9.6 へのアップグレードが必須をご覧ください。
- マシン 1、7 の Edge UI コンポーネントを再起動します。
/opt/apigee/apigee-service/bin/apigee-service edge-ui restart
非標準構成のアップグレード
実装している構成が標準外の場合は、次の順に Edge コンポーネントを更新します。
- ZooKeeper
- Cassandra
- qpidd、ps
- LDAP
- Edge、すべてのノードで「-c edge」プロファイルの順に従ってください。つまり、Qpid Server、Edge Postgres Server、Management Server、Message Processor、Router の順になります。
- Edge UI
apigee-adminapi
- Edge SSO
更新が完了したら、Edge UI コンポーネントを実行しているすべてのマシンで Edge UI コンポーネントを再起動してください。