Apigee Edge 4.17.05 または 4.17.09 を 4.18.05 に更新する

Edge for Private Cloud v4.18.05

このセクションでは、次のアップグレードを行う方法について説明します。

  • 4.17.05 から 4.18.05 へ
  • 4.17.09 から 4.18.05 へ

更新を実行できるユーザー

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

Edge RPM をインストールした後は、どのユーザーでも構成できます。

更新が必要なコンポーネント

すべての Edge コンポーネントを更新する必要があります。Edge は、コンポーネントを含む設定をサポートしていません 使用できます。

互換性の維持

Apigee Edge for Private Cloud を 4.18.05 にアップグレードする場合は、 実装は、構成ファイル内でサポートされているプロパティのみを参照します。

<ph type="x-smartling-placeholder">
プロパティ 場所 説明
conf_load_balancing_load.balancing.
  driver.nginx.server.retry		 router.properties router.properties ファイルからこのプロパティを削除します。再試行オプションを設定するには 4.18.05 を使用する場合は、仮想アプライアンス ホスト構成プロパティをご覧ください。

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

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

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

Edge 4.17.05 では、有効にしたときに使用される構成ファイルに新しい必須パラメータが追加されました。 SMTP サーバーです

Postgres 9.6 へのアップグレードが必要

この Edge のリリースには、Postgres 9.6 へのアップグレードが含まれています。このアップグレードの一環として Postgres データは Postgres 9.6 に移行されます。

Edge の本番環境システムのほとんどは、マスター / スタンバイ レプリケーション用に構成された 2 つの Postgres ノードを使用します。 更新プロセス中は、Postgres ノードがアップデートのためにダウンしても、分析データは引き続き Qpid ノードに書き込まれます。Postgres ノードが更新されてオンラインに戻った後、分析データ Postgres ノードに push されます

Postgres を更新する方法は、 Postgres ノード:

  • Postgres ノードにローカル データ ストレージを使用する場合は、 アップグレード中に新しい Postgres スタンバイ ノードをインストールする アップグレードが完了したら、新しい Postgres スタンバイ ノードを廃止できます。

    更新をロールバックする必要がある場合は、Postgres スタンバイ ノードを追加する必要があります できます。更新をロールバックする必要がある場合は、新しい Postgres スタンバイ ノードに ロールバック後、Postgres のマスターノードになります。そのため、Python や Curl など、 すべてのハードウェアを満たすノード上に配置する必要があります。 Postgres サーバーの要件を満たす必要があります。 インストール要件

    1 ノードおよび 2 ノード構成の Edge（プロトタイピングとテストに使用するトポロジ）では、次の作業を行います。 Postgres ノードは 1 つだけですこれらの Postgres ノードは、 新しい Postgres ノードを作成します

  • Postgres ノードにネットワーク ストレージを使用している場合: 新しい Postgres ノードをインストールする必要はありません。 手順を実施する場合は、新しいコンテナをインストールして後で廃止することを指定する手順をスキップし、 Postgres スタンバイ ノード。

    更新プロセスを開始する前に、使用しているデータストアのネットワーク スナップショットを Postgres です更新中にエラーが発生してロールバックが必要になった場合は そのスナップショットから Postgres ノードを復元できます

新しい Postgres のインストール スタンバイ ノード

この手順では、新しいノードに Postgres スタンバイ サーバーを作成します。新しいソフトウェア インスタンスを Edge の既存バージョン（4.17.05 または 4.17.09）の Postgres スタンバイ サーバー バージョン 4.18.05 用ではありません

現在のバージョンのインストールに使用したものと同じ構成ファイルを使用して、インストールを行います。 説明します。

新しい Postgres スタンバイ ノードを作成するには:

  1. 現在の Postgres マスターで、/opt/apigee/customer/application/postgresql.properties を編集します。 次のトークンを設定します。このファイルが存在しない場合は作成します。 
    conf_pg_hba_replication.connection=host replication apigee existing_slave_ip/32 trust\ \nhost replication apigee new_slave_ip/32 trust

    ここで、existing_slave_ip は現在の Postgres の IP アドレスです。 new_slave_ip は、新しいスタンバイ ノードの IP アドレスです。

  2. Postgres マスターで apigee-postgresql を再起動します。 
    /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql restart
  3. 新しいスタンバイ ノードが追加されたことを確認するには、 マスターの /opt/apigee/apigee-postgresql/conf/pg_hba.conf ファイル。次のように表示されます。 そのファイルに次の行を追加します。 
    host replication apigee existing_slave_ip/32 trust
host replication apigee new_slave_ip/32 trust
  4. 新しい Postgres スタンバイ サーバーをインストールします。 <ph type="x-smartling-placeholder">
      </ph>
    1. 現在のバージョンの 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
    2. SELinux を無効にする Edge apigee-setup ユーティリティをインストールします。
    3. Edge bootstrap_4.17.0x.sh ファイルをダウンロードします。ここで、x は次のいずれかです。 5（4.17.05 の場合）または 9（4.17.09 の場合）から /tmp/bootstrap_4.17.0x.sh : 
      curl https://software.apigee.com/bootstrap_4.17.0x.sh -o /tmp/bootstrap_4.17.0x.sh
    4. Edge apigee-service ユーティリティと依存関係をインストールします。 
      sudo bash /tmp/bootstrap_4.17.0x.sh apigeeuser=uName apigeepassword=pWord
    5. apigee-service を使用して apigee-setup ユーティリティをインストールします。 
      /opt/apigee/apigee-service/bin/apigee-service apigee-setup install
    6. Postgres をインストールします。 
      /opt/apigee/apigee-setup/bin/setup.sh -p ps -f configFile
    7. 新しいスタンバイ ノードで、次のコマンドを実行します。 
      /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql postgres-check-standby

      スタンバイと表示されることを確認します。

Postgres ノードの廃止

更新が完了したら、新しいスタンバイ ノードを廃止します。

  1. Postgres が実行されていることを確認します。 
    /opt/apigee/apigee-service/bin/apigee-all status

    Postgres が実行されていない場合は、起動します。 

    /opt/apigee/apigee-service/bin/apigee-all start
  2. 新しいスタンバイ ノードの UUID を取得するには、新しいスタンバイ ノードの スタンバイ ノード: 
    curl -u sysAdminEmail:password http://node_IP:8084/v1/servers/self

    出力の最後に、次の形式でノードの UUID が表示されます。 

    "type" : [ "postgres-server" ],
"uUID" : "599e8ebf-5d69-4ae4-aa71-154970a8ec75"
  3. 新しいスタンバイ ノードで次のコマンドを実行して、新しいスタンバイ ノードを停止します。 
    /opt/apigee/apigee-service/bin/apigee-all stop
  4. Postgres マスターノードで、/opt/apigee/customer/application/postgresql.properties を編集します。 conf_pg_hba_replication.connection から新しいスタンバイ ノードを削除します。 
    conf_pg_hba_replication.connection=host replication apigee existing_slave_ip/32 trust
  5. Postgres マスターで apigee-postgresql を再起動します。 
    /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql restart
  6. 新しいスタンバイ ノードが削除されたことを確認するには、 マスターの /opt/apigee/apigee-postgresql/conf/pg_hba.conf ファイル。次のように表示されます。 次の行だけを使用します。 
    host replication apigee existing_slave_ip/32 trust
  7. 次の Edge 管理を行って、ZooKeeper からスタンバイ ノードの UUID を削除します。 Management Server ノードでの API 呼び出し: 
    curl -u sysAdminEmail:password -X DELETE http://ms_IP:8080/v1/servers/new_slave_uuid

前提条件の更新

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

  • すべてのノードをバックアップする
    安全のために、更新前にすべてのノードを完全にバックアップすることをおすすめします できます。現在のバージョンの Edge の手順に沿ってバックアップを実行します。

    これにより、新しいバージョンに更新されなかった場合に備え、バックアップ プランを作成できます。 確認します。バックアップの詳細については、バックアップ および復元をご覧ください。

  • Edge が動作していることを確認する
    次のコマンドを使用して、更新プロセス中に Edge が稼働していることを確認します。 
    /opt/apigee/apigee-service/bin/apigee-all status

更新の失敗への対応

更新に失敗した場合は、問題を修正してから update.sh を実行する もう一度クリックします。更新は複数回実行でき、最後に終了したところから続行されます。 オフにします。

失敗した結果、前のバージョンに更新をロールバックする必要がある場合は、以下をご覧ください。 詳細については、4.18.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 つずつ負荷から削除することです。 内部 IP アドレスを使用します次に、ルーターとその同じマシン上にある他のコンポーネントを更新します。 Router をロードバランサに追加し直します

  1. 次の説明に沿って、設置方法に合わせてマシンを更新してください。 マシンの更新の順序。
  2. Router を更新するときは、任意の Router を 1 つ選択し、 詳しくは、サーバーの有効化と無効化に関する （Message Processor/Router）のネットワーク到達性。
  3. 選択した Router と、その Router と同じマシンにある他のすべての Edge コンポーネントを更新します。 すべての Edge 構成では、同じノード上に Router と Message Processor があります。
  4. Router を再び到達可能にします。
  5. 残りのルーターに手順 2 ～ 4 を繰り返します。
  6. インストール済みの残りのマシンについて、更新を続行してください。

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

  • Router ノードと Message Processor ノードが統合されている場合: <ph type="x-smartling-placeholder">
      </ph>
    • 更新前 – 次のことを行います。 <ph type="x-smartling-placeholder">
        </ph>
      1. Router を到達不能にします。
      2. Message Processor を到達不能な状態にします。
    • 更新後 - 次の操作を行います。 <ph type="x-smartling-placeholder">
        </ph>
      1. Message Processor を到達可能にします。
      2. Router を到達可能にします。
  • 単一の Router ノードの場合: <ph type="x-smartling-placeholder">
      </ph>
    • 更新する前に、Router を到達不能な状態にしてください。
    • 更新後、Router を到達可能にします。
  • 単一の Message Processor ノードの場合: <ph type="x-smartling-placeholder">
      </ph>
    • 更新前に、Message Processor を到達不能な状態にします。
    • 更新後、Message Processor を到達可能にします。

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

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

更新先 外部インターネット接続があるノード上の 4.18.05

ノード上の Edge コンポーネントを更新するには、次の操作を行います。

  1. 現在、ローカル ストレージで Postgres のマスター / スタンバイ レプリケーションを使用している場合は、 新しい Postgres スタンバイ ノードをインストールする手順については、新しい Postgres のインストール スタンバイ ノード。

    ネットワーク ストレージを使用している場合は、新しいノードをインストールする必要はありません。代わりに、 Postgres で使用されるデータストアのネットワーク スナップショット。詳細については、Postgres 9.6 へのアップグレードが必要をご覧ください。

  2. Cassandra の修復オペレーションを実行するように構成された CRON ジョブがある場合は、無効にします 更新が完了するまで表示されません。
  3. root としてノードにログインして Edge RPM をインストールします。
  4. yum-utils と yum-plugin-priorities をインストールします。 
    sudo yum install yum-utils
sudo yum install yum-plugin-priorities
  5. インストール Edge apigee-setup ユーティリティをご覧ください。
  6. Oracle 7.x にインストールする場合は、次のコマンドを実行します。 
    sudo yum-config-manager --enable ol7_optional_latest
  7. 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
  8. Edge 4.18.05 の bootstrap_4.18.05.sh ファイルを次の場所にダウンロードします。 /tmp/bootstrap_4.18.05.sh: 
    curl https://software.apigee.com/bootstrap_4.18.05.sh -o /tmp/bootstrap_4.18.05.sh
  9. Edge 4.18.05 の apigee-service ユーティリティと依存関係をインストールします。 
    sudo bash /tmp/bootstrap_4.18.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 を自分でインストールする必要があります。
  10. apigee-service を使用して apigee-setup ユーティリティを更新します。 
    /opt/apigee/apigee-service/bin/apigee-service apigee-setup update
  11. Management Server の apigee-validate ユーティリティを更新します。 
    /opt/apigee/apigee-service/bin/apigee-service apigee-validate update
  12. apigee-provision ユーティリティを更新します。 
    /opt/apigee/apigee-service/bin/apigee-service apigee-provision update
  13. 上記の順序で、各ノードで update ユーティリティを実行します。 マシンの更新の順序: 
    /opt/apigee/apigee-setup/bin/update.sh -c component -f configFile

    構成ファイルに対する唯一の要件は、構成ファイルにアクセスできること 「apigee」によって読み取られできます。

    -c オプションを使用して、更新するコンポーネントを指定します。リストには、 コンポーネントには以下が含まれます。

    • 「cs」= Cassandra
    • 「e」= ElasticSearch
    • "エッジ"=Edge UI を除くすべての Edge コンポーネント。「エッジ」コンポーネントに含まれるもの Management Server、Message Processor、Router、QPID Server、Edge Postgres Server です。
    • 「ldap」= OpenLDAP
    • 「ps」= postgresql
    • 「qpid」= qpidd
    • 「sso」= エッジ SSO
    • 「ui」= Edge UI
    • 「zk」= Zookeeper

    component を設定すると、すべてのコンポーネントに対して update.sh を実行できます。 ただし、Edge のオールインワン（AIO）インストール プロファイルがある場合に限られます。例:

    /opt/apigee/apigee-setup/bin/update.sh -c all -f ./sa_silent_config
  14. Edge UI コンポーネントを実行しているすべてのマシンで Edge UI コンポーネントを再起動します（まだ再起動していない場合）。 
    /opt/apigee/apigee-service/bin/apigee-service edge-ui restart
  15. Management API で apigee-validate ユーティリティを実行して、更新をテストします。 サーバー。インストールをテストするをご覧ください。
  16. 新しい Postgres スタンバイ ノードをインストールした場合は、前述の手順に沿ってノードを廃止します。 具体的には Postgres ノード。

    ネットワーク ストレージを使用している場合は、新しいノードをインストールする必要はありません。詳しくは、 詳細については、Postgres 9.6 へのアップグレードが必要です。

後で更新をロールバックするには、4.18.05 のロールバックで説明されている手順を行います。

ローカル リポジトリから 4.18.05 に更新する

Edge ノードがファイアウォールの内側にあるか、なんらかの理由でアクセスが禁止されている場合は ローカル リポジトリから更新を実行できます。 またはミラーを作成します。

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

  • リポジトリの .tar ファイルを作成し、その .tar ファイルをノードにコピーして、 .tar ファイルです。
  • ローカル リポジトリのあるノードにウェブサーバーをインストールし、他のノードがアクセスできるようにします。 Apigee が提供する Nginx ウェブサーバーを使用することも、独自のウェブサーバーを使用することもできます。 使用します。

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

  1. 現在 Postgres のマスター / スタンバイ レプリケーションを使用している場合は、新しい Postgres をインストールする 説明があります。詳しくは、新しい Postgres のインストール スタンバイ ノード。

    ネットワーク ストレージを使用している場合は、新しいノードをインストールする必要はありません。代わりに、 Postgres で使用されるデータストアのネットワーク スナップショット。詳細については、Postgres 9.6 へのアップグレードが必要をご覧ください。

  2. 「ローカルの Apigee リポジトリを作成する」の説明に沿って、ローカルに 4.18.05 リポジトリを作成するEdge apigee-setup ユーティリティのインストールをご覧ください。
  3. .tar ファイルから apigee-service をインストールするには: <ph type="x-smartling-placeholder">
      </ph>
    1. ローカル リポジトリがあるノードで、次のコマンドを使用してローカル リポジトリをパッケージ化します。 /opt/apigee/data/apigee-mirror/apigee-4.18.05.tar.gz という名前の単一の .tar ファイルに変換します。 
      /opt/apigee/apigee-service/bin/apigee-service apigee-mirror package
    2. Edge を更新するノードに .tar ファイルをコピーします。たとえば、 新しいノードの /tmp ディレクトリ。
    3. 新しいノードで、ファイルを /tmp ディレクトリに展開します。 
      tar -xzf apigee-4.18.05tar.gz

      このコマンドを実行すると、.tar が含まれるディレクトリに repos という新しいディレクトリが作成されます 表示されます。例: /tmp/repos

    4. /tmp/repos から Edge apigee-service ユーティリティと依存関係をインストールします。
      sudo bash /tmp/repos/bootstrap_4.18.05.sh apigeeprotocol="file://" apigeerepobasepath=/tmp/repos

      このコマンドには、Repo ディレクトリのパスが含まれています。

  4. Nginx ウェブサーバーを使用して apigee-service をインストールするには: <ph type="x-smartling-placeholder">
      </ph>
    1. 「Nginx を使用してリポジトリからインストールする」の説明に沿って、Nginx ウェブサーバーを構成します。 webserver&quot;Edge のインストール apigee-setup ユーティリティ。
    2. リモートノードで、Edge bootstrap_4.18.05.sh ファイルを次の場所にダウンロードします。 /tmp/bootstrap_4.18.05.sh: 
      /usr/bin/curl http://uName:pWord@remoteRepo:3939/bootstrap_4.18.05.sh -o /tmp/bootstrap_4.18.05.sh

      ここで、uName:pWord は、以前に設定したユーザー名とパスワードです。 remoteRepo は、リポジトリ ノードの IP アドレスまたは DNS 名です。

    3. リモートノードで、Edge apigee-service ユーティリティをインストールします。 : 
      sudo bash /tmp/bootstrap_4.18.05.sh apigeerepohost=remoteRepo:3939 apigeeuser=uName apigeepassword=pWord apigeeprotocol=http://

      ここで、uName:pWord はリポジトリのユーザー名とパスワードです。

  5. apigee-service を使用して apigee-setup ユーティリティを更新します。 
    /opt/apigee/apigee-service/bin/apigee-service apigee-setup update
  6. Management Server の apigee-validate ユーティリティを更新します。 
    /opt/apigee/apigee-service/bin/apigee-service apigee-validate update
  7. apigee-provision ユーティリティを更新します。 
    /opt/apigee/apigee-service/bin/apigee-service apigee-provision update
  8. 次の順序で、ノードで update ユーティリティを実行します。 マシンの更新の順序: 
    /opt/apigee/apigee-setup/bin/update.sh -c component -f configFile

    構成ファイルに対する唯一の要件は、構成ファイルがアクセスでき、 「apigee」によって読み取れます。できます。

    -c オプションを使用して、更新するコンポーネントを指定します。リストには、 コンポーネントには以下が含まれます。

    • 「cs」= Cassandra
    • 「e」= ElasticSearch
    • "エッジ"=Edge UI を除くすべての Edge コンポーネント。「エッジ」コンポーネントに含まれるもの Management Server、Message Processor、Router、QPID Server、Edge Postgres Server です。
    • 「ldap」= OpenLDAP
    • 「ps」= postgresql
    • 「qpid」= qpidd
    • 「sso」= エッジ SSO
    • 「ui」= Edge UI
    • 「zk」= Zookeeper

    component を設定すると、すべてのコンポーネントに対して update.sh を実行できます。 ただし、Edge のオールインワン（AIO）インストール プロファイルがある場合に限られます。例:

    /opt/apigee/apigee-setup/bin/update.sh -c all -f ./sa_silent_config
  9. Edge UI コンポーネントを実行しているすべてのマシンで Edge UI コンポーネントを再起動します（まだ再起動していない場合）。 
    /opt/apigee/apigee-service/bin/apigee-service edge-ui restart
  10. Management API で apigee-validate ユーティリティを実行して、更新をテストします。 サーバー。インストールをテストするをご覧ください。
  11. 新しい Postgres スタンバイ ノードをインストールした場合は、前述の手順に沿ってノードを廃止します。 の廃止 Postgres ノードです。

    ネットワーク ストレージを使用している場合は、新しいノードをインストールする必要はありません。詳細については、Postgres 9.6 へのアップグレードが必要をご覧ください。

後で更新をロールバックするには、4.18.05 のロールバックで説明されている手順を行います。

マシンの更新の順序

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

  • いずれかの Cassandra ノードと ZooKeeper ノードを更新する前に、すべての Cassandra ノードを更新する必要があります。 他のノードで使用できます。
  • 複数の Edge コンポーネント（Management Server、Message Processor、 Postgres Server ではなく、Router、QPID Server など）、「-c edge」を使用します。すべて更新するオプションが できます。
  • ステップが複数のマシンで実行されるように指定されている場合、そのステップは マシン順序を指定します。
  • Monetization を更新するための個別の手順はありません。これは、"-c" エッジ"選択します。
で確認できます。

1 ノードのスタンドアロン インストール

  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
  3. LDAP を更新します。 
    /opt/apigee/apigee-setup/bin/update.sh -c ldap -f configFile
  4. 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
  5. postgresql を更新します。 
    /opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile
  6. Postgres データベースを更新します。 
    /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql db_upgrade
  7. 残りの Edge コンポーネントを更新します。 
    /opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile
  8. Edge UI を更新します。 
    /opt/apigee/apigee-setup/bin/update.sh -c ui -f configFile
  9. Edge SSO がインストールされている場合は、Edge SSO を更新します。 
    /opt/apigee/apigee-setup/bin/update.sh -c sso -f sso_config_file

    ここで、sso_config_file は、コマンドの実行時に作成した構成ファイルです。 SSO がインストール済み。

  10. Edge UI コンポーネントを再起動します。 
    /opt/apigee/apigee-service/bin/apigee-service edge-ui restart

2 ノード スタンドアロン インストール

Edge のリストについては、インストール トポロジをご覧ください。 トポロジとノード数を表します。

  1. マシン 1 の Cassandra と ZooKeeper を更新します。 
    /opt/apigee/apigee-setup/bin/update.sh -c cs,zk -f configFile
  2. マシン 2 の Qpid を更新します。 
    /opt/apigee/apigee-setup/bin/update.sh -c qpid -f configFile
  3. マシン 1 の LDAP を更新します。 
    /opt/apigee/apigee-setup/bin/update.sh -c ldap -f configFile
  4. マシン 1 の Edge コンポーネントを更新します。 
    /opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile
  5. マシン 1 の UI を更新します。 
    /opt/apigee/apigee-setup/bin/update.sh -c ui -f configFile
  6. Edge SSO がインストールされている場合は、マシン 1 の Edge SSO を更新します。 
    /opt/apigee/apigee-setup/bin/update.sh -c sso -f sso_config_file

    ここで、sso_config_file は、コマンドの実行時に作成した構成ファイルです。 SSO がインストール済み。

  7. マシン 2 の postgresql を更新します。 <ph type="x-smartling-placeholder">
      </ph>
    1. 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
    2. postgresql を更新します。 
      /opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile
    3. Postgres データベースを更新します。 
      /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql db_upgrade
    4. マシン 2 の Edge コンポーネントを更新します。 
      /opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile
  8. マシン 1 の Edge UI コンポーネントを再起動します。 
    /opt/apigee/apigee-service/bin/apigee-service edge-ui restart

5 ノード インストール

Edge のリストについては、インストール トポロジをご覧ください。 トポロジとノード数を表します。

  1. 新しい Postgres スタンバイ ノードが、 インストール 新しい Postgres スタンバイ ノードを作成します。

    ネットワーク ストレージを使用している場合は、新しいノードをインストールする必要はありません。代わりに、 Postgres で使用されるデータストアのネットワーク スナップショット。詳細については、Postgres 9.6 へのアップグレードが必要をご覧ください。

  2. マシン 1、2、3 の Cassandra と ZooKeeper を更新します。 
    /opt/apigee/apigee-setup/bin/update.sh -c cs,zk -f configFile
  3. マシン 4、5 の Qpid を更新します。 
    /opt/apigee/apigee-setup/bin/update.sh -c qpid -f configFile
  4. マシン 1 の LDAP を更新します。 
    /opt/apigee/apigee-setup/bin/update.sh -c ldap -f configFile
  5. マシン 1、2、3 の Edge コンポーネントを更新します。 
    /opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile
  6. マシン 1 の UI を更新します。 
    /opt/apigee/apigee-setup/bin/update.sh -c ui -f configFile
  7. Edge SSO がインストールされている場合は、マシン 1 の Edge SSO を更新します。 
    /opt/apigee/apigee-setup/bin/update.sh -c sso -f sso_config_file

    ここで、sso_config_file は、コマンドの実行時に作成した構成ファイルです。 SSO がインストール済み。

  8. マシン 4 と 5 を更新します。 <ph type="x-smartling-placeholder">
      </ph>
    1. マシン 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
    2. マシン 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
    3. インストールされている場合は、新しいスタンバイで 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. マシン 4 の postgresql を更新します。 
      /opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile
    5. マシン 4 の Postgres データベースを更新します（Postgres マスターのみ）。 
      /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql db_upgrade
    6. マシン 5 の postgresql を更新します。 
      /opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile
    7. マシン 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
    8. マシン 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
    9. 両方のサーバーで次のスクリプトを発行して、レプリケーションのステータスを確認します。「 両方のサーバーで同じ結果が表示され、レプリケーションが成功していることを確認します。 <ph type="x-smartling-placeholder">
        </ph>
      • マシン 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

        スタンバイと表示されることを確認します。

  9. マシン 4、5 の Edge コンポーネントを更新します。 
    /opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile
  10. 説明に沿って、新しいスタンバイ ノードを廃止していることを確認します。 の廃止 Postgres ノードです。

    ネットワーク ストレージを使用している場合は、新しいノードをインストールする必要はありません。詳細については、Postgres 9.6 へのアップグレードが必要をご覧ください。

  11. マシン 1 の Edge UI コンポーネントを再起動します。 
    /opt/apigee/apigee-service/bin/apigee-service edge-ui restart

9 ノードクラスタ化 設置

Edge のリストについては、インストール トポロジをご覧ください。 トポロジとノード数を表します。

  1. 説明に沿って、新しい Postgres スタンバイ ノードがインストールされていることを確認する インストール 新しい Postgres スタンバイ ノードを作成します。

    ネットワーク ストレージを使用している場合は、新しいノードをインストールする必要はありません。代わりに、 Postgres で使用されるデータストアのネットワーク スナップショット。詳細については、Postgres 9.6 へのアップグレードが必要をご覧ください。

  2. マシン 1、2、3 の Cassandra と ZooKeeper を更新します。 
    /opt/apigee/apigee-setup/bin/update.sh -c cs,zk -f configFile
  3. マシン 6、7 の Qpid を更新します。 
    /opt/apigee/apigee-setup/bin/update.sh -c qpid -f configFile
  4. マシン 1 の LDAP を更新します。 
    /opt/apigee/apigee-setup/bin/update.sh -c ldap -f configFile
  5. マシン 6、7、1、4、5 の順序で Edge コンポーネントを更新します。 
    /opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile
  6. マシン 1 の UI を更新します。 
    /opt/apigee/apigee-setup/bin/update.sh -c ui -f configFile
  7. Edge SSO がインストールされている場合は、マシン 1 の Edge SSO を更新します。 
    /opt/apigee/apigee-setup/bin/update.sh -c sso -f sso_config_file

    ここで、sso_config_file は、コマンドの実行時に作成した構成ファイルです。 SSO がインストール済み。

  8. マシン 8、9 を更新します。 <ph type="x-smartling-placeholder">
      </ph>
    1. マシン 8 の Postgres Server を停止します。 
      /opt/apigee/apigee-service/bin/apigee-service edge-postgres-server stop
    2. マシン 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
    3. マシン 6 と 7 で Qpid Server を停止します。 
      /opt/apigee/apigee-service/bin/apigee-service edge-qpid-server stop
    4. インストールされている場合は、新しいスタンバイで Postgres Server と postgresql を停止します。 ロールバックのために追加したノードです。 
      /opt/apigee/apigee-service/bin/apigee-service edge-postgres-server stop
/opt/apigee/apigee-service/bin/apigee-service apigee-postgresql stop
    5. マシン 8 の postgresql を更新します。 
      /opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile
    6. マシン 8 の Postgres データベースを更新します（Postgres マスターのみ）。 
      /-->
opt/apigee/apigee-service/bin/apigee-service apigee-postgresql db_upgrade
    7. マシン 9 の postgresql を更新します。 
      /opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile
    8. マシン 8、9 の Postgres Server Server を起動します。 
      /opt/apigee/apigee-service/bin/apigee-service edge-postgres-server start
    9. マシン 6 と 7 で Qpid Server Server を起動します。 
      /opt/apigee/apigee-service/bin/apigee-service edge-qpid-server start
    10. マシン 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
    11. 両方のサーバーで次のスクリプトを発行して、レプリケーションのステータスを確認します。「 両方のサーバーで同じ結果が表示され、レプリケーションが成功していることを確認します。 <ph type="x-smartling-placeholder">
        </ph>
      • マシン 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

        スタンバイと表示されることを確認します。

  9. マシン 8 と 9 の Edge コンポーネントを更新します。 
    /opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile
  10. 説明に沿って、新しいスタンバイ ノードを廃止していることを確認します。 廃止の Postgres ノードです。

    ネットワーク ストレージを使用している場合は、新しいノードをインストールする必要はありません。詳細については、Postgres 9.6 へのアップグレードが必要をご覧ください。

  11. マシン 1 の Edge UI コンポーネントを再起動します。 
    /opt/apigee/apigee-service/bin/apigee-service edge-ui restart

13 ノードクラスタ インストール

Edge のリストについては、インストール トポロジをご覧ください。 トポロジとノード数を表します。

  1. 説明に沿って、新しい Postgres スタンバイ ノードがインストールされていることを確認する インストール 新しい Postgres スタンバイ ノードを作成します。

    ネットワーク ストレージを使用している場合は、新しいノードをインストールする必要はありません。代わりに、 Postgres で使用されるデータストアのネットワーク スナップショット。詳細については、Postgres 9.6 へのアップグレードが必要をご覧ください。

  2. マシン 1、2、3 の Cassandra と ZooKeeper を更新します。 
    /opt/apigee/apigee-setup/bin/update.sh -c cs,zk -f configFile
  3. マシン 12、13 の Qpid を更新します。 
    /opt/apigee/apigee-setup/bin/update.sh -c qpid -f configFile
  4. マシン 4、5 の LDAP を更新します。 
    /opt/apigee/apigee-setup/bin/update.sh -c ldap -f configFile
  5. マシン 12、13、6、7、10、11 の順序で Edge コンポーネントを更新します。 
    /opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile
  6. マシン 6、7 の UI を更新します。 
    /opt/apigee/apigee-setup/bin/update.sh -c ui -f configFile
  7. Edge SSO がインストールされている場合は、マシン 6、7 の Edge SSO を更新します。 
    /opt/apigee/apigee-setup/bin/update.sh -c sso -f sso_config_file

    ここで、sso_config_file は、コマンドの実行時に作成した構成ファイルです。 SSO がインストール済み。

  8. マシン 8、9 を更新します。 <ph type="x-smartling-placeholder">
      </ph>
    1. マシン 8 の Postgres Server を停止します。 
      /opt/apigee/apigee-service/bin/apigee-service edge-postgres-server stop
    2. マシン 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
    3. マシン 12 と 13 で Qpid Server を停止します。 
      /opt/apigee/apigee-service/bin/apigee-service edge-qpid-server stop
    4. インストールされている場合は、新しいスタンバイで Postgres Server と postgresql を停止します。 ロールバックのために追加したノードです。 
      /opt/apigee/apigee-service/bin/apigee-service edge-postgres-server stop
/opt/apigee/apigee-service/bin/apigee-service apigee-postgresql stop
    5. マシン 8 の postgresql を更新します。 
      /opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile
    6. マシン 8 の Postgres データベースを更新します（Postgres マスターのみ）。 
      /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql db_upgrade
    7. マシン 9 の postgresql を更新します。 
      /opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile
    8. マシン 8、9 の Postgres Server を起動します。 
      /opt/apigee/apigee-service/bin/apigee-service edge-postgres-server start
    9. マシン 12 と 13 で Qpid Server Server を起動します。 
      /opt/apigee/apigee-service/bin/apigee-service edge-qpid-server start
    10. マシン 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
    11. 両方のサーバーで次のスクリプトを発行して、レプリケーションのステータスを確認します。「 両方のサーバーで同じ結果が表示され、レプリケーションが成功していることを確認します。 <ph type="x-smartling-placeholder">
        </ph>
      • マシン 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

        スタンバイと表示されることを確認します。

  9. マシン 8 と 9 の Edge コンポーネントを更新します。 
    /opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile
  10. 説明に沿って、新しいスタンバイ ノードを廃止していることを確認します。 廃止の Postgres ノードです。

    ネットワーク ストレージを使用している場合は、新しいノードをインストールする必要はありません。詳細については、Postgres 9.6 へのアップグレードが必要をご覧ください。

  11. マシン 6、7 の Edge UI コンポーネントを再起動します。 
    /opt/apigee/apigee-service/bin/apigee-service edge-ui restart

12 ノードクラスタ構成

Edge のリストについては、インストール トポロジをご覧ください。 トポロジとノード数を表します。

  1. 説明に沿って、新しい Postgres スタンバイ ノードがインストールされていることを確認する をご覧ください。 新しい Postgres スタンバイ ノードを作成します。

    ネットワーク ストレージを使用している場合は、新しいノードをインストールする必要はありません。代わりに、 Postgres で使用されるデータストアのネットワーク スナップショット。詳しくは、 詳細については、Postgres 9.6 へのアップグレードが必要です。

  2. Cassandra と ZooKeeper を更新します。 <ph type="x-smartling-placeholder">
      </ph>
    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 を更新します。 <ph type="x-smartling-placeholder">
      </ph>
    1. データセンター 1 のマシン 4、5 <ph type="x-smartling-placeholder">
        </ph>
      1. マシン 4 の qpidd を更新します。 
        /opt/apigee/apigee-setup/bin/update.sh -c qpid -f configFile
      2. マシン 5 で手順 1 を繰り返します。
    2. データセンター 2 のマシン 10、11 <ph type="x-smartling-placeholder">
        </ph>
      1. マシン 10 の qpidd を更新します。 
        /opt/apigee/apigee-setup/bin/update.sh -c qpid -f configFile
      2. マシン 11 で手順 1 を繰り返します。
  4. LDAP を更新します。 <ph type="x-smartling-placeholder">
      </ph>
    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
  5. Edge コンポーネントを更新します。 <ph type="x-smartling-placeholder">
      </ph>
    1. データセンター 1 のマシン 4、5、1、2、3 
      /opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile
    2. データセンター 2 のマシン 10、11、7、8、9 
      /opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile
  6. UI を更新します。 <ph type="x-smartling-placeholder">
      </ph>
    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. Edge SSO がインストールされている場合は、Edge SSO を更新します。 <ph type="x-smartling-placeholder">
      </ph>
    1. データセンター 1 のマシン 1 で、 
      /opt/apigee/apigee-setup/bin/update.sh -c sso -f sso_config_file
    2. データセンター 2 のマシン 7 で、 
      /opt/apigee/apigee-setup/bin/update.sh -c sso -f sso_config_file

      3. ここで、sso_config_file は、コマンドの実行時に作成した構成ファイルです。 SSO がインストール済み。

  8. データセンター 1 のマシン 6 とデータセンター 2 のマシン 12 を更新します。 <ph type="x-smartling-placeholder">
      </ph>
    1. マシン 6 の Postgres Server を停止します。 
      /opt/apigee/apigee-service/bin/apigee-service edge-postgres-server stop
    2. マシン 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
    3. マシン 4、5、10、11 で Qpid Server を停止します。 
      /opt/apigee/apigee-service/bin/apigee-service edge-qpid-server stop
    4. インストールされている場合は、新しいスタンバイで Postgres Server と postgresql を停止します。 ロールバックのために追加したノードです。 
      /opt/apigee/apigee-service/bin/apigee-service edge-postgres-server stop
/opt/apigee/apigee-service/bin/apigee-service apigee-postgresql stop
    5. マシン 6 の postgresql を更新します。 
      /opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile
    6. マシン 6 の Postgres データベースを更新します（Postgres マスターのみ）。 
      /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql db_upgrade
    7. マシン 12 の postgresql を更新します。 
      /opt/apigee/apigee-setup/bin/update.sh -c ps -f configFile
    8. マシン 6 と 12 の Postgres Server Server を起動します。 
      /opt/apigee/apigee-service/bin/apigee-service edge-postgres-server start
    9. マシン 4、5、10、11 で Qpid Server Server を起動します。 
      /opt/apigee/apigee-service/bin/apigee-service edge-qpid-server start
    10. マシン 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
    11. 両方のサーバーで次のスクリプトを発行して、レプリケーションのステータスを確認します。「 両方のサーバーで同じ結果が表示されるはずです。 レプリケーション:

      マシン 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

      スタンバイと表示されることを確認します。

  9. マシン 6、12 の Edge コンポーネントを更新します。 
    /opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile
  10. 次の説明に沿って、新しいスタンバイ ノードを廃止していることを確認します。 Postgres の廃止 Node.js のものです。

    ネットワーク ストレージを使用している場合は、新しいノードをインストールする必要はありません。詳しくは、 詳細については、Postgres 9.6 へのアップグレードが必要です。

  11. マシン 1 と 7 の Edge UI コンポーネントを再起動します。 
    /opt/apigee/apigee-service/bin/apigee-service edge-ui restart

非標準インストールの場合

非標準インストールの場合は、次の順序で Edge コンポーネントを更新します。

  1. ZooKeeper
  2. Cassandra
  3. qpidd、ps
  4. LDAP
  5. Edge（「-c edge」の意味）すべてのノードのプロファイルを、次の順序で配置します。 Edge Postgres Server、Management Server、Message Processor、Router。
  6. Edge UI
  7. エッジ SSO

更新が完了したら、実行中のすべてのマシンで Edge UI コンポーネントを再起動してください。 できます。