Google は AI 技術を使用して、コンテンツをご希望の言語に翻訳しています。AI 翻訳には誤りが含まれる場合があります。

Apigee Edge 4.17.01/4.17.05 を 4.17.09 に更新する

Edge for Private Cloud v. 4.17.09

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

この手順を使用して、Apigee Edge バージョン 4.17.01.0x/4.17.05.0x を 4.17.09 に更新できます。

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

更新を行えるユーザー

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

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

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

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

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

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

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

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

API BaaS バージョン 4.17.09 では、SMTPMAILFROM プロパティのサポートも追加されました。4.17.01 または 4.17.05 から API BaaS を更新する場合は、構成ファイルで SMTPMAILFROM を設定する必要があります。

このパラメータの形式は次のとおりです。

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

更新の前提条件

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

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

これにより、新しいバージョンへの更新が正常に機能しない場合に備えて、バックアッププランを用意できます。バックアップの詳細については、バックアップと復元をご覧ください。
Edge が実行されていることを確認する
更新プロセス中に Edge が稼働していることを確認するには、次のコマンドを使用します。

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

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

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

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

更新情報のロギング

デフォルトでは、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 を更新する時期になったら、サーバー（Message Processor/Router）のネットワーク到達性の有効化/無効化の説明に従って、いずれかの Router を選択して到達不能にします。
選択した Router と、その Router と同じマシンにある他のすべての Edge コンポーネントを更新します。すべての Edge 構成で、Router と Message Processor が同じノードに表示されます。
ルーターを再び到達可能にします。
残りのルーターについて、手順 2 ～ 4 を繰り返します。
インストール環境内の残りのマシンで更新を続行します。

更新の前後に次の点に注意してください。

Router と Message Processor の組み合わせノードの場合:
- 更新前 - 次の操作を行います。
  1. ルーターを到達不能にします。
  2. Message Processor に到達できないようにします。
- 更新後 - 次の操作を行います。
  1. Message Processor を到達可能にします。
  2. ルーターにアクセスできるようにします。
単一のルーターノードの場合:
- 更新前に、ルーターにアクセスできないようにします。
- 更新後、Router にアクセスできるようにします。
単一の Message Processor ノードの場合:
- 更新する前に、Message Processor にアクセスできないようにします。
- 更新後、Message Processor にアクセスできるようにします。

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

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

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

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

Cassandra で修復オペレーションを実行するように構成された CRON ジョブがある場合は、更新が完了するまで無効にします。
root としてノードにログインし、Edge RPM をインストールします。
注: RPM のインストールには root アクセス権が必要ですが、Edge の構成は root アクセス権がなくても実行できます。
yum-utils と yum-plugin-priorities をインストールします。
> sudo yum install yum-utils
> sudo yum install yum-plugin-priorities
Edge apigee-setup ユーティリティのインストールの説明に従って、SELinux を無効にします。
AWS にインストールする場合は、次の yum-configure-manager コマンドを実行します。
> sudo yum-config-manager --enable rhui-REGION-rhel-server-extras rhui-REGION-rhel-server-optional
Edge 4.17.09 の 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 4.17.09 の apigee-service ユーティリティと依存関係をインストールします。
> sudo bash /tmp/bootstrap_4.17.09.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 を自分でインストールする必要があります。
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 =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
インストールのテストの説明に従って、Management Server で apigee-validate ユーティリティを実行して、更新をテストします。

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

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

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

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

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

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

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

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

マシンの更新順序

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

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