Edge for Private Cloud バージョン 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 サーバーを有効にするときに、構成ファイルで SMTP メール FROM を設定する必要があります。このパラメータの形式は次のとおりです。
SMTPMAILFROM="My Company <myco@company.com>"
外部認証の使用時に更新する場合は必須です
外部ディレクトリ サービスを既存の Apigee Edge Private Cloud インストールに統合できます。この機能は、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 ユーティリティを実行しているユーザーがこのディレクトリにアクセスできない場合は、ログが update_username.log という名前のファイルとして /tmp ディレクトリに書き込まれます。
ユーザーに /tmp へのアクセス権がない場合、update.sh ユーティリティは失敗します。
ゼロダウンタイムでの更新
ゼロ ダウンタイム アップデート(ローリング アップデート)を使用すると、Edge をダウンさせることなく Edge インストール環境を更新できます。
ゼロ ダウンタイムの更新は、5 ノード以上の構成でのみ可能です。
ダウンタイムなしでアップグレードするための鍵は、各 Router をロードバランサから 1 つずつ削除することです。次に、Router と、Router と同じマシン上のすべてのコンポーネントを更新してから、Router をロードバランサに再び追加します。
- 後述の「マシンの更新順序」の説明に従って、インストール環境に適した順序でマシンを更新します。
- Router を更新するときは、サーバー(Message Processor/Router)の到達可能性の有効化/無効化の説明に従って、Router を 1 台選択して到達不能にします。
- 選択した 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 を到達可能にする
サイレント構成ファイルの使用
update コマンドにサイレント構成ファイルを渡す必要があります。サイレント構成ファイルは、Edge 4.16.09 のインストールに使用したものと同じである必要があります。
外部インターネット接続があるノードを 4.17.05 に更新する手順
ノード上の Edge コンポーネントを更新する手順は次のとおりです。
- CRON ジョブが存在する場合は、更新が完了するまで、Cassandra で修復オペレーションを行うように構成された CRON ジョブを無効にします。
- ノードに root としてログインし、Edge RPM をインストールします。
注: RPM のインストールには root 権限が必要ですが、Edge の構成には root 権限は不要です。 - Edge apigee-setup ユーティリティのインストールの説明に従って、SELinux を無効にします。
- 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 - 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 のインストール処理方法を指定するには、JAVA_FIX オプションを使用します。JAVA_FIX には次の値を指定できます。
I = OpenJDK 1.8 をインストールする(デフォルト)
C = Java をインストールせずに続行
Q = 終了。このオプションでは、Java をユーザー自身でインストールする必要があります。 - (CentOS-6.x と RedHat-6.x のみ)すべての Qpid ノードで次のコマンドを実行して、正しい Qpid バージョンをダウンロードします。
> yum install apigee-qpidd --disablerepo=epel - 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 - 以下のマシンの更新順序に記載されている順序で、ノードで更新ユーティリティを実行します。
> /opt/apigee/apigee-setup/bin/update.sh -c component -f configFile
構成ファイルに対する唯一の要件は、「apigee」ユーザーが構成ファイルにアクセスまたは読み取り可能であることです。
「-c」オプションを使用して、更新するコンポーネントを指定します。可能なコンポーネントは次のとおりです。
ldap = OpenLDAP
cs = Cassandra
zk = Zookeeper
qpid = qpidd
ps = postgresql
edge = Ba Elastic Stack = Basa Stack API と同じすべてのエッジ コンポーネント、Seba Portal と Baa Elastic Edge の同じプロファイルのみ、Seba Portal または Basa Elastic Edge をインストールするためのすべてのコンポーネント
- インストールをテストするの説明に沿って、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 リポジトリから更新するには:
- Edge apigee-setup ユーティリティのインストールの「ローカルに Apigee リポジトリを作成する」の手順で 4.17.05 リポジトリをローカルに作成します。
注: 4.16.09 リポジトリがすでにある場合は、Edge apigee-setup ユーティリティのインストールの「ローカルの Apigee リポジトリを更新する」の手順で 4.17.05 リポジトリを追加できます。 -
.tar ファイルから apigee-service をインストールするには:
- ローカル リポジトリがあるノードで、次のコマンドを使用して、ローカル リポジトリを /opt/apigee/data/apigee-mirror/apigee-4.17.05.tar.gz という名前の単一の.tar ファイルにパッケージ化します。
> /opt/apigee/apigee-service/bin/apigee-service apigee-mirror package - Edge を更新する対象のノードに .tar ファイルをコピーします。たとえば、新しいノードの /tmp ディレクトリにコピーします。
- 新しいノードで、/tmp ディレクトリに tar ファイルを解凍します。
> tar -xzf apigee-4.17.05.tar.gz
このコマンドにより、.tar ファイルを含むディレクトリに repos という新しいディレクトリが作成されます。(例: /tmp/repos)。 - /tmp/repos から Edge apigee-service ユーティリティと依存関係をインストールします。
> sudo bash /tmp/repos/bootstrap_4.17.05.sh apigeeprotocol="file://" apigeerepobasepath=/tmp/repos
このコマンドには repos ディレクトリへのパスを指定します。
- ローカル リポジトリがあるノードで、次のコマンドを使用して、ローカル リポジトリを /opt/apigee/data/apigee-mirror/apigee-4.17.05.tar.gz という名前の単一の.tar ファイルにパッケージ化します。
-
Nginx ウェブサーバーを使用して apigee-service をインストールするには:
- Edge apigee-setup ユーティリティのインストールの「Nginx ウェブサーバーを使用してリポジトリからインストールする」の手順に沿って、Nginx ウェブサーバーを構成します。
- リモートノードで、Edge の bootstrap_4.17.05.sh ファイルを /tmp/bootstrap_4.17.05.sh にダウンロードします。
> /usr/bin/curl または http://uName:pWord@remoteRepo/re: repo.trap_node.mp4 アドレスです。 - リモートノードに、Edge apigee-service ユーティリティと依存関係をインストールします。
> sudo bash /tmp/bootstrap_4.17.05.sh apigeerepohost=remoteRepo:3939 apigeeuser=uName apigeepassword=pWord apigeepassword=http://
ここで、uName は、ユーザー名です。uName
- 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 更新 - apigee-provision ユーティリティを更新します。
> /opt/apigee/apigee-service/bin/apigee-service apigee-provision 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 = Ba Elastic Stack = Basa Stack API と同じすべてのエッジ コンポーネント、Seba Portal と Baa Elastic Edge の同じプロファイルのみ、Seba Portal または Basa Elastic Edge をインストールするためのすべてのコンポーネント
- インストールをテストするの説明に沿って、Management Server で apigee-validate ユーティリティを実行し、更新をテストします。
後で更新をロールバックするには、4.17.05 ロールバック プロセスで説明されている手順を使用します。
マシンの更新順序
Edge インストール環境でマシンを更新する順序は重要です。アップデートでは以下の点を考慮してください。
- 他のノードを更新する前に、すべての Cassandra ノードと ZooKeeper ノードを更新する必要があります。
- 複数の Edge コンポーネント(Management Server、Message Processor、Router、QPID Server。ただし Postgres Server は除く)を搭載したマシンの場合は、"-c edge" オプションを使用することですべてを同時に更新します。
- 複数のマシンで行うよう指定されたステップは、指定されたマシン順に実行します。
- 収益化の更新に特別な手順はありません。「-c edge」オプションを指定すると更新されます。
- (CentOS-6.x と RedHat-6.x のみ)外部インターネット接続があるすべての Qpid ノードで、次のコマンドを実行して上記の正しい Qpid バージョンをダウンロードします。
> yum install apigee-qpidd --disablerepo=epel
1 ホストのスタンドアロン インストールの場合
- Edge で SMTP を有効にした場合は、構成ファイルで SMTP メール FROM を設定します。このパラメータの形式は次のようになります。
SMTP メール FROM="My Company <myco@company.com>" - Cassandra と ZooKeeper を更新します。
> /opt/apigee/apigee-setup/bin/update.sh -c cs,zk -f configFile - 次の iptables ルールを設定します。
> sudo iptables -A INPUT -p tcp --destination-port 5672 !-s `hostname` -i eth0 -j DROP - Qpid メッセージ キューを確認します。
> qpid-stat -q
msg 列のカウントが 0 になるまでキューのチェックを続けます。すべてのメッセージを処理するまで、Qpid をアップグレードすることはできません。 - qpidd を更新します。
> /opt/apigee/apigee-setup/bin/update.sh -c qpid -f configFile - iptables をフラッシュします。
> sudo iptables -F - postgresql を更新します。
> /opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile - postgresql を起動します。
> /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql start - LDAP を更新します。
> /opt/apigee/apigee-setup/bin/update.sh -c ldap -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
2 ホストのスタンドアロン インストールの場合
Edge トポロジとノード番号のリストについては、インストール トポロジをご覧ください。
- Edge で SMTP を有効にした場合は、構成ファイルで SMTP メール FROM を設定します。このパラメータの形式は次のようになります。
SMTP メール FROM="My Company <myco@company.com>" - マシン 1 の Cassandra と ZooKeeper を更新します。
> /opt/apigee/apigee-setup/bin/update.sh -c cs,zk -f configFile - マシン 2 で次の iptables ルールを設定します。
> sudo iptables -A INPUT -p tcp --destination-port 5672 !-s `hostname` -i eth0 -j DROP - マシン 2 の Qpid メッセージ キューを確認します。
> qpid-stat -q
[msg] 列のカウントが 0 になるまでキューのチェックを続けます。すべてのメッセージを処理するまで、Qpid をアップグレードすることはできません。 - マシン 2 の qpidd を更新します。
> /opt/apigee/apigee-setup/bin/update.sh -c qpid -f configFile - マシン 2 の iptables をフラッシュします。
> sudo iptables -F - マシン 2 の postgresql を更新します。
> /opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile - マシン 2 で postgresql を起動します。
> /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql start - マシン 1 の LDAP を更新します。
> /opt/apigee/apigee-setup/bin/update.sh -c ldap -f configFile - マシン 2 と 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
5 つのホストからなるクラスタ構成の場合
Edge トポロジとノード番号のリストについては、インストール トポロジをご覧ください。
- Edge で SMTP を有効にした場合は、構成ファイルで SMTP メール FROM を設定します。このパラメータの形式は次のようになります。
SMTP メール FROM="My Company <myco@company.com>" - マシン 1、2、3 の Cassandra と ZooKeeper を更新します。
> /opt/apigee/apigee-setup/bin/update.sh -c cs,zk -f configFile - マシン 4 で次の iptables ルールを設定します。
> sudo iptables -A INPUT -p tcp --destination-port 5672 !-s `hostname` -i eth0 -j DROP - マシン 4 の Qpid メッセージ キューを確認します。
> qpid-stat -q
[msg] 列のカウントが 0 になるまでキューのチェックを続けます。すべてのメッセージを処理するまで、Qpid をアップグレードすることはできません。 - マシン 4 の qpidd を更新します。
> /opt/apigee/apigee-setup/bin/update.sh -c qpid -f configFile - マシン 4 の iptables をフラッシュします。
> sudo iptables -F - マシン 5 で手順 3 から 6 を繰り返します。
- マシン 4 の postgresql を更新します。
> /opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile - マシン 4 で postgresql を起動します。
> /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql start - マシン 5 で手順 8 と 9 を繰り返します。
- マシン 1 の LDAP を更新します。
> /opt/apigee/apigee-setup/bin/update.sh -c ldap -f configFile - マシン 4、5、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
9 つのホストからなるクラスタ構成の場合
Edge トポロジとノード番号のリストについては、インストール トポロジをご覧ください。
- Edge で SMTP を有効にした場合は、構成ファイルで SMTP メール FROM を設定します。このパラメータの形式は次のようになります。
SMTP メール FROM="My Company <myco@company.com>" - マシン 1、2、3 の Cassandra と ZooKeeper を更新します。
> /opt/apigee/apigee-setup/bin/update.sh -c cs,zk -f configFile - マシン 6 で次の iptables ルールを設定します。
> sudo iptables -A INPUT -p tcp --destination-port 5672 !-s `hostname` -i eth0 -j DROP - マシン 6 の Qpid メッセージ キューを確認します。
> qpid-stat -q
[msg] 列のカウントが 0 になるまでキューのチェックを続けます。すべてのメッセージを処理するまで、Qpid をアップグレードすることはできません。 - マシン 6 の qpidd を更新します。
> /opt/apigee/apigee-setup/bin/update.sh -c qpid -f configFile - マシン 6 の iptables をフラッシュします。
> sudo iptables -F - マシン 7 で手順 3 から 6 を繰り返します。
- マシン 6 の postgresql を更新します。
> /opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile - マシン 6 で postgresql を起動します。
> /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql start - マシン 7 で手順 8 と 9 を繰り返します。
- マシン 1 の LDAP を更新します。
> /opt/apigee/apigee-setup/bin/update.sh -c ldap -f configFile - マシン 6、7、8、9、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
13 ホストのクラスタ インストールの場合
Edge トポロジとノード番号のリストについては、インストール トポロジをご覧ください。
- Edge で SMTP を有効にした場合は、構成ファイルで SMTP メール FROM を設定します。このパラメータの形式は次のようになります。
SMTP メール FROM="My Company <myco@company.com>" - マシン 1、2、3 の Cassandra と ZooKeeper を更新します。
> /opt/apigee/apigee-setup/bin/update.sh -c cs,zk -f configFile - マシン 12 で次の iptables ルールを設定します。
> sudo iptables -A INPUT -p tcp --destination-port 5672 !-s `hostname` -i eth0 -j DROP - マシン 12 の Qpid メッセージ キューを確認します。
> qpid-stat -q
[msg] 列のカウントが 0 になるまでキューのチェックを続けます。すべてのメッセージを処理するまで、Qpid をアップグレードすることはできません。 - マシン 12 の qpidd を更新します。
> /opt/apigee/apigee-setup/bin/update.sh -c qpid -f configFile - マシン 12 の iptables をフラッシュします。
> sudo iptables -F - マシン 13 で手順 3 ~ 6 を繰り返します。
- マシン 12 の postgresql を更新します。
> /opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile - マシン 12 で postgresql を起動します。
> /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql start - マシン 13 で手順 8 と 9 を繰り返します。
- マシン 4 と 5 の LDAP を更新します。
> /opt/apigee/apigee-setup/bin/update.sh -c ldap -f configFile - マシン 12、13、8、9、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
12 ホストのクラスタ インストールの場合
Edge トポロジとノード番号のリストについては、インストール トポロジをご覧ください。
- Edge で SMTP を有効にした場合は、構成ファイルで SMTP メール FROM を設定します。このパラメータの形式は次のようになります。
SMTP メール FROM="My Company <myco@company.com>" - 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 で次の iptables ルールを設定します。
> sudo iptables -A INPUT -p tcp --destination-port 5672 !-s `hostname` -i eth0 -j DROP - マシン 4 の Qpid メッセージ キューを確認します。
> qpid-stat -q
[msg] 列のカウントが 0 になるまでキューのチェックを続けます。すべてのメッセージを処理するまで Qpid をアップグレードすることはできません。 - マシン 4 の qpidd を更新します。
> /opt/apigee/apigee-setup/bin/update.sh -c qpid -f configFile - マシン 4 の iptables をフラッシュします。
> sudo iptables -F - マシン 5 で手順 1 ~ 4 を繰り返します。
- マシン 4 で次の iptables ルールを設定します。
- データセンター 2 のマシン 10、11 で、
- マシン 10 で次の iptables ルールを設定します。
> sudo iptables -A INPUT -p tcp --destination-port 5672 !-s `hostname` -i eth0 -j DROP - マシン 10 の Qpid メッセージ キューを確認します。
> qpid-stat -q
[msg] 列のカウントが 0 になるまでキューのチェックを続けます。すべてのメッセージを処理するまで Qpid をアップグレードすることはできません。 - マシン 10 の qpidd を更新します。
> /opt/apigee/apigee-setup/bin/update.sh -c qpid -f configFile - マシン 10 の iptables をフラッシュします。
> sudo iptables -F - マシン 11 で手順 1 ~ 4 を繰り返します。
- マシン 10 で次の iptables ルールを設定します。
- データセンター 1 のマシン 4、5 で、次のコマンドを実行します。
-
postgresql を更新します。
-
データセンター 1 のマシン 6
> /opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile
> /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql start -
データセンター 2 のマシン 12
> /opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile
> /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql start
-
- 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、6、1、2、3
> /opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile - データセンター 2 のマシン 10、11、12、7、8、9
> /opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile
- データセンター 1 のマシン 4、5、6、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:
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 のインストールをご覧ください。
また、他のすべてのスタックノードからアクセスできるように、すべてのスタックノードでポート 2551 が開いていることを確認する必要があります。
Edge トポロジとノード番号のリストについては、インストール トポロジをご覧ください。
- マシン 5、6、7 の Cassandra を更新します。
> /opt/apigee/apigee-setup/bin/update.sh -c cs -f configFile -
マシン 1、2、3 の ElasticSearch と API BaaS Stack を更新します。
> /opt/apigee/apigee-setup/bin/update.sh -c e,b -f configFile - マシン 4 の API BaaS ポータルを更新します。
> /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 のインストールをご覧ください。
また、他のすべてのスタックノードからアクセスできるように、すべてのスタックノードでポート 2551 が開いていることを確認する必要があります。
Edge トポロジとノード番号のリストについては、インストール トポロジをご覧ください。
- マシン 8、9、10 の Cassandra を更新します。
> /opt/apigee/apigee-setup/bin/update.sh -c cs -f configFile - マシン 1、2、3 の ElasticSearch を更新します。
> /opt/apigee/apigee-setup/bin/update.sh -c e -f configFile - マシン 4、5、6 の API BaaS スタックを更新します。
> /opt/apigee/apigee-setup/bin/update.sh -c b -f configFile - マシン 7 の API BaaS ポータルを更新します。
> /opt/apigee/apigee-setup/bin/update.sh -c p -f configFile
標準以外のインストールの場合
標準以外の環境がある場合は、次の順序で Edge コンポーネントを更新します。
- ZooKeeper
- Cassandra
- qpidd、ps
- LDAP
- Edge(すべてのノードにある「-c edge」プロファイル)。この順序は、Qpid サーバー、Postgres サーバー、Management Server、Message Processor、Router の順です。
注: ノードに Qpid Server と Postgres Server の両方がインストールされている場合は、「-c edge」プロファイルの手順を実施してください。 - Edge UI