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

Apigee Edge 4.16.01 を 4.16.05 に更新する

Edge for Private Cloud v. 4.16.05

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

Apigee Edge バージョン 4.16.01.x から 4.16.05 への更新のみが可能です。

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

更新を行えるユーザー

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

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

Java JDK バージョン 8 への必須アップグレード

このリリースの Edge では、すべての Edge 処理ノードに Java JDK バージョン 8 をインストールする必要があります。Oracle JDK 8 または OpenJDK 8 をインストールできます。Java JDK 8 がまだインストールされていない場合は、更新スクリプトでインストールできます。

Java 8 へのアップデートの一環として、一部の TLS 暗号が Oracle JDK 8 で使用できなくなりました。完全なリストについては、http://docs.oracle.com/javase/8/docs/technotes/guides/security/SunProviders.html の「Default Disabled Cipher Suites」セクションをご覧ください。

警告: このリリースの Edge は JDK 7 をサポートしていません。現在 JDK 7 を使用している場合は、JDK 8 にアップグレードする必要があります。Edge 4.16.05 のインストールをロールバックする場合は、必要に応じて、Java JDK 7 を使用するように Edge を再構成できます。

ZooKeeper のダウングレード

Edge for Private Cloud 4.16.01 の Zookeeper RPM のバージョンは apigee-zookeeper-3.4.5-1.0.905.noarch.rpm です。Edge の以降のバージョンでは、ZooKeeper のバージョンが apigee-zookeeper-3.4.5-0.0.948 に戻されました。これにより、yum が Zookeeper を 4.16.01 からそれ以降のバージョンにアップグレードするのを防ぐことができます。この状況を修正するには、Zookeeper を更新する前に yum downgrade apigee-zookeeper を実行します。

Zookeeper のバージョンを確認するには、次のコマンドを使用します。

> rpm -qa |grep apigee-zookeeper

このコマンドが Zookeeper のバージョンを返す場合:

apigee-zookeeper-3.4.5-1.0.905

その後、ダウングレードする必要があります。

アップデートに必要なディスク容量

更新を行う前に、ディスク容量に 1 GB 以上の空きがあることを確認してください。

4.16.01.x からのプロパティ設定の自動伝播

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

apigee-validate ユーティリティの更新

4.16.01 では、Message Processor ノードに apigee-validate ユーティリティをインストールして実行しました。4.16.05 では、apigee-validate ユーティリティが更新され、Management Server ノードで実行されるようになりました。

4.16.05 に更新する場合、apigee-validate ユーティリティを更新する方法は 2 つあります。

Apigee の推奨 - Management Server ノードに apigee-validate ユーティリティをインストールして実行します。

必要に応じて、Message Processor ノードから apigee-validate ユーティリティをアンインストールできます。Message Processor ノードに残す場合は、4.16.05 に更新する必要があります。
または、Message Processor ノードで apigee-validate ユーティリティを更新し、そこから実行します。ただし、Apigee では、Management Server からインストールして実行することをおすすめします。

更新の前提条件

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

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

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

> /<inst_root>/apigee/apigee-service/bin/apigee-all status

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

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

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

更新情報のロギング

デフォルトでは、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.16.01 のインストールに使用したものと同じである必要があります。

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

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

Cassandra で修復オペレーションを実行するように構成された CRON ジョブがある場合は、更新が完了するまで無効にします。
root としてノードにログインし、Edge RPM をインストールします。
注: RPM のインストールには root アクセスが必要ですが、Edge の構成は root アクセスなしで実行できます。
Edge apigee-setup ユーティリティのインストールの説明に従って、SELinux を無効にします。
Edge 4.16.05 の bootstrap_4.16.05.sh ファイルを /tmp/bootstrap_4.16.05.sh にダウンロードします。
> curl https://software.apigee.com/bootstrap_4.16.05.sh -o /tmp/bootstrap_4.16.05.sh
Edge 4.16.05 の apigee-service ユーティリティと依存関係をインストールします。
> sudo bash /tmp/bootstrap_4.16.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 を自分でインストールする必要があります。
apigee-service を使用して、apigee-setup ユーティリティを更新します。
1. Edge バージョン 4.15.07.0x をアップグレードして 4.16.01 をインストールした場合は、apigee-setup ユーティリティをインストールする必要があります。
  > /opt/apigee/apigee-service/bin/apigee-service apigee-setup install
  このコマンドにより、update.sh ユーティリティが <inst_dir>/apigee/apigee-setup/bin にインストールされます。
  
  apigee-setup ユーティリティがすでにインストールされている場合は、次のように更新します。
  > /opt/apigee/apigee-service/bin/apigee-service apigee-setup update
2. 4.16.01 を直接インストールした場合（4.15.07.0x からのアップグレードを行わなかった場合）は、apigee-setup ユーティリティを更新する必要があります。
  > /opt/apigee/apigee-service/bin/apigee-service apigee-setup update
  この apigee-service への更新により、update.sh ユーティリティが <inst_dir>/apigee/apigee-setup/bin にインストールされます。
Management Server に apigee-validate ユーティリティをインストールします。
> /opt/apigee/apigee-service/bin/apigee-service apigee-validate install
注: Message Processor ノードに apigee-validate ユーティリティをインストールしている場合は、そのノードで次のコマンドを使用して更新できます。
> /opt/apigee/apigee-service/bin/apigee-service apigee-validate update
ただし、4.16.05 の場合は、Management Server に apigee-validate ユーティリティをインストールして実行することをおすすめします。
apigee-validate ユーティリティに渡される構成ファイルを編集します。以前の Edge リリースでは、apigee-validate で使用される構成ファイルに次のプロパティが必要でした。
APIGEE_ADMINPW=sysAdminPword
MP_POD=gateway
REGION=dc-1
このリリースでは、構成ファイルに APIGEE_ADMINPW プロパティのみが必要です。他の 2 つのプロパティはファイルから削除できます。
後述の「マシンの更新順序」に記載されている順序で、ノードで更新ユーティリティを実行します。
> /opt/apigee/apigee-setup/bin/update.sh -c component -f configFile
構成ファイルに関する唯一の要件は、構成ファイルが「apigee」ユーザーによってアクセス可能または読み取り可能であることです。たとえば、ノードの /tmp ディレクトリにファイルを配置します。
更新するコンポーネントを指定するには、-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 スタック
- p = API BaaS Portal
- ebp = ElasticSearch、API BaaS Stack、API BaaS Portal を同じノードにインストール
インストールのテストの説明に従って、Management Server で apigee-validate ユーティリティを実行して、更新をテストします。

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

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

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

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

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

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

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

> /opt/apigee/apigee-service/bin/apigee-service apigee-validate update
ただし、4.16.05 の場合は、Management Server に apigee-validate ユーティリティをインストールして実行することをおすすめします。
apigee-validate ユーティリティに渡される構成ファイルを編集します。以前の Edge リリースでは、apigee-validate で使用される構成ファイルに次のプロパティが必要でした。
APIGEE_ADMINPW=sysAdminPword
MP_POD=gateway
REGION=dc-1
このリリースでは、構成ファイルに APIGEE_ADMINPW プロパティのみが必要です。他の 2 つのプロパティはファイルから削除できます。
後述の「マシンの更新順序」に記載されている順序で、ノードで更新ユーティリティを実行します。
> /opt/apigee/apigee-setup/bin/update.sh -c component -f configFile
構成ファイルに関する唯一の要件は、構成ファイルが「apigee」ユーザーによってアクセス可能または読み取り可能であることです。たとえば、ノードの /tmp ディレクトリにファイルを配置します。
更新するコンポーネントを指定するには、-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 スタック
- p = API BaaS Portal
- ebp = ElasticSearch、API BaaS Stack、API BaaS Portal を同じノードにインストール
インストールのテストの説明に従って、Management Server で apigee-validate ユーティリティを実行して、更新をテストします。

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

マシンの更新順序

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

他のノードを更新する前に、すべての Cassandra ノードと ZooKeeper ノードを更新する必要があります。
Router ノードと Message Processor ノードを更新する前に、すべての qpidd ノードと postgresql ノードを更新する必要があります。
複数の Edge コンポーネント（Management Server、Message Processor、Router、QPID Server、Postgres Server）がインストールされているマシンでは、-c edge オプションを使用して、すべてのコンポーネントを同時に更新します。
複数のマシンで実行する必要があるステップの場合は、指定されたマシンの順序で実行します。
Monetization を更新するための個別のステップはありません。「-c edge」オプションを指定すると更新されます。
Router ノードを更新したら、/opt/nginx/conf.d ディレクトリからすべてのファイルを削除し、Router を再起動する必要があります。