Edge のインストールの概要

一般的な Edge インストール環境は、複数のノードに分散された Edge コンポーネントで構成されます。Edge をノードにインストールした後、そのノードに 1 つ以上の Edge コンポーネントをインストールして構成します。

インストール プロセス

ノードへの Edge のインストールは、複数のステップから成ります。

1. ノードで SELinux を無効にするか、permissive モードに設定します。詳細については、Edge apigee-setup ユーティリティをインストールするをご覧ください。
2. Cassandra 認証を有効にするかどうかを決定します。
3. Postgres にマスター / スタンバイ レプリケーションを設定するかどうかを決定します。
4. 推奨トポロジのリストから Edge 構成を選択します。たとえば、テスト用には単一ノードに Edge をインストールし、本番環境用には 13 個のノードにインストールできます。詳細については、インストール トポロジをご覧ください。
5. 選択したトポロジの各ノードに、Edge apigee-setup ユーティリティをインストールします。
   • Edge bootstrap_4.52.02.sh ファイルを /tmp/bootstrap_4.52.02.sh にダウンロードします。
   • Edge apigee-service ユーティリティと依存関係をインストールします。
   • Edge apigee-setup ユーティリティと依存関係をインストールします。

     詳細については、Edge apigee-setup ユーティリティをインストールするをご覧ください。

6. apigee-setup ユーティリティを使用して、選択したトポロジに基づいて各ノードに 1 つ以上の Edge コンポーネントをインストールします。

   ノードに Edge コンポーネントをインストールするをご覧ください。

7. Management Server ノードで、apigee-setup ユーティリティを使用して apigee-provision をインストールします。これは、Edge 組織の作成と管理に使用するユーティリティです。

   詳細については、組織のオンボーディングをご覧ください。

8. 次の例に示すように、インストールの完了後に各ノードで Classic UI コンポーネントを再起動します。

   /opt/apigee/apigee-service/bin/apigee-service edge-ui restart

9. （推奨）最初のインストールが完了したら、新しい Edge UI（コンポーネント名は edge-management-ui）をインストールすることをおすすめします。これは、Apigee Edge for Private Cloud のデベロッパーと管理者向けの拡張ユーザー インターフェースです。

   詳細については、新しい Edge UI をインストールするをご覧ください。

インストールが完了したら、インストール後の一般的なアクションのリストをご覧ください。

インストールを実行できるユーザー

Apigee Edge 配布ファイルは、一連の RPM と依存関係としてインストールされます。Edge RPM をインストール、アンインストール、更新するには、root ユーザーまたは sudo の完全なアクセス権を持つユーザーがコマンドを実行する必要があります。完全な sudo アクセス権とは、ユーザーに root と同じ操作を行うための sudo アクセス権があることを意味します。

次のコマンドまたはスクリプトを実行するユーザーは、root であるか、sudo の完全なアクセス権を持つユーザーである必要があります。

• apigee-service ユーティリティ:
  • apigee-service コマンド: install, uninstall, update
  • apigee-all コマンド: install, uninstall, update
• Edge コンポーネントをインストールする setup.sh スクリプト（必要な RPM をインストールするために「apigee-service install」をすでに使用していない場合）。次に root または sudo フルアクセス権が必要です）。
• Edge コンポーネントを更新する update.sh スクリプト

また、Edge インストーラによって、システム上に「apigee」という名前の新しいユーザーが作成されます。多くの Edge コマンドは、sudo を呼び出して「apigee」ユーザーとして実行します。

上記以外のすべてのコマンドを実行するユーザーは、「apigee」ユーザーに対する sudo フル権限を持つユーザーである必要があります。たとえば、次のようなコマンドです。

• 以下の apigee-service ユーティリティ コマンド:
  • apigee-service コマンド（start, stop, restart, configure など）。
  • apigee-all コマンド（start, stop, restart, configure など）。

「apigee」ユーザーに対する sudo フルアクセスを持つユーザーの作成

「apigee」ユーザーに対する sudo フルアクセス権限が付与されるようにユーザーを構成するには、「visudo」コマンドを使用して sudoers ファイルを編集し、以下を追加します。

installUser        ALL=(apigee)      NOPASSWD: ALL

ここで、installUser は Edge を使用するユーザーのユーザー名です。

構成ファイルの権限を設定する

Edge コマンドで使用されるファイルやリソースには、「apigee」ユーザーがアクセスできる必要があります。これには、Edge ライセンス ファイルとすべての構成ファイルが含まれます。

構成ファイルを作成するときに、オーナーを「apigee:apigee」に変更して、Edge コマンドからアクセス可能にできます。

1. エディタで、任意のユーザーとしてファイルを作成します。
2. chown: ファイルのオーナーを「apigee:apigee」に変更するか、Edge サービスを実行しているユーザーを「apigee」ユーザーから変更した場合は、Edge サービスを実行しているユーザーに chown します。

root ユーザーと root 以外のユーザーの Edge インストール タスクの分離

Edge のインストール プロセス全体を root として実行するか、sudo の完全なアクセス権を持つユーザーが実行するのが最も簡単ですが、必ずしも可能とは限りません。代わりに、root で実行するタスクと、「apigee」ユーザーに対する sudo フル権限を持つユーザーが実行するタスクに分離できます。

1. root が実行するタスク:
   1. bootstrap_4.52.02.sh ファイルをダウンロードして実行します。

      curl https://software.apigee.com/bootstrap_4.52.02.sh -o /tmp/bootstrap_4.52.02.sh
      sudo bash /tmp/bootstrap_4.52.02.sh apigeeuser=uName apigeepassword=pWord

      このステップでは、apigee-service ユーティリティをインストールして、「apigee」ユーザーを作成します。

   2. 「apigee」ユーザーに対する sudo フルアクセス権を持つユーザーの作成の説明に沿って、「apigee」ユーザーに対する完全な sudo アクセス権を持つユーザーを構成します。
   3. apigee-setup ユーティリティをインストールします。

      /opt/apigee/apigee-service/bin/apigee-service apigee-setup install

   4. apigee-setup ユーティリティを使用してノードに Edge RPM をインストールします。

      /opt/apigee/apigee-service/bin/apigee-service compName install

      ノードにインストールする Edge RPM は、トポロジによって異なります。使用可能なコンポーネントとしては、apigee-provision, apigee-validate, apigee-zookeeper, apigee-cassandra, apigee-openldap, edge-management-server, edge-ui, edge-router, edge-message-processor, apigee-postgresql, apigee-qpidd, edge-postgres-server, edge-qpid-server があります。

2. root ユーザーがノードに Edge RPM をインストールしたら、「apigee」ユーザーに対する sudo フルアクセス権を持つユーザーが構成プロセスを完了します。
   1. setup.sh ユーティリティを使用して、ノード上の Edge コンポーネントの構成を完了します。コマンドの形式は、ノードにインストールしたコンポーネントによって異なります。完全なリストについては、ノードに Edge コンポーネントをインストールするをご覧ください。

      たとえば、ZooKeeper と Cassandra のインストールを完了するには、次のコマンドを使用します。

      /opt/apigee/apigee-setup/bin/setup.sh -p ds -f configFile

      ここで、configFile は Edge 構成ファイルです。

      オールインワン インストールを実行するには、次のコマンドを使用します。

      /opt/apigee/apigee-setup/bin/setup.sh -p aio -f configFile

インストール構成ファイルの場所

Edge のインストールに関する情報を含む構成ファイルを apigee-setup ユーティリティに渡す必要があります。サイレント インストールの唯一の要件は、構成ファイルが apigee ユーザーによってアクセス可能または読み取り可能であることです。たとえば、ノードの /usr/local/var または /usr/local/share ディレクトリにファイルを配置し、chown で「apigee:apigee」にします。

Edge システム管理者のパスワードを除き、構成ファイル内のすべての情報が必要です。パスワードを省略すると、apigee-setup ユーティリティによってコマンドラインでのパスワードの入力を求められます。

詳細については、ノードに Edge コンポーネントをインストールするをご覧ください。

インストール エラーの処理

Edge コンポーネントのインストール中にエラーが発生した場合は、問題を修正してからインストーラを再度実行できます。インストーラは、障害を検出した場合や、インストール後にコンポーネントの変更または更新が必要になった場合に、繰り返し実行されるように設計されています。

インストールまたはアップグレード後は、必ず Edge UI コンポーネントが実行されている各ノードで Edge UI コンポーネントを再起動してください。

インターネットまたはインターネット以外のインストール

Edge をノードにインストールするには、そのノードが Apigee リポジトリにアクセスできる必要があります。

• 外部インターネット接続があるノード

  外部インターネット接続があるノードは、Apigee リポジトリにアクセスして Edge RPM と依存関係をインストールします。

• 外部インターネット接続がないノード

  外部インターネット接続がないノードでも、内部に設定した Apigee リポジトリのミラーリング バージョンにアクセスできます。このリポジトリにはすべての Edge RPM が含まれていますが、内部ネットワーク上のリポジトリから、他のすべての依存関係が使用可能であることを確認する必要があります。

  内部 Apigee リポジトリを作成するには、Edge RPM と依存関係をダウンロードできる、外部インターネット アクセスが可能なノードが必要です。内部リポジトリを作成したら、それを別のノードに移動できます。また、インストールのために、そのノードに Edge ノードからアクセスすることもできます。

ローカルの Edge リポジトリを使用して Edge のバージョンを維持する

ローカル リポジトリ（ミラーリングされたリポジトリ）を使用する理由の一つは、前のセクションで説明したように、外部インターネット接続がないノードに Edge をインストールするためです。

RPM インストールの依存関係を解決する

Apigee Edge 配布ファイルは、RPM ファイルのセットとしてインストールされます。各 RPM ファイルには、独自のインストール依存関係のチェーンを設定できます。これらの依存関係の多くは、Apigee の管理外にあるサードパーティ コンポーネントによって定義されており、いつでも変更される可能性があります。したがって、このドキュメントには各依存関係の明示的なバージョン番号は記載されていません。

インターネットにアクセスできるマシンにインストールを実行する場合、ノードは必要な RPM と依存関係をダウンロードできます。ただし、インターネットにアクセスできないノードからインストールする場合は、通常、必要な依存関係をすべて含む内部リポジトリを設定します。すべての依存関係がローカル リポジトリに含まれていることを保証する唯一の方法は、インストールを試行し、不足している依存関係を特定して、インストールが成功するまでローカル リポジトリにコピーすることです。

一般的な Yum コマンド

Linux 用の Edge インストール ツールは、Yum を使用してコンポーネントのインストールと更新を行います。ノードでのインストールを管理するには、複数の Yum コマンドが必要になる場合があります。

• すべての Yum キャッシュを削除します。

  sudo yum clean all

• Edge コンポーネントを更新するには:

  sudo yum update componentName

  次に例を示します。

  sudo yum update apigee-setup
  sudo yum update edge-management-server

ファイル システム構造

Edge では、すべてのファイルが /opt/apigee ディレクトリにインストールされます。

このガイドと Edge オペレーション ガイドでは、ルート インストール ディレクトリは次のように記載されています。

/opt/apigee

インストールでは、次のファイル システム構造を使用して Apigee Edge for Private Cloud をデプロイします。

ログファイル

apigee-setup と setup.sh スクリプトのログファイルが /tmp/setup-root.log に書き込まれます。

各コンポーネントのログファイルは /opt/apigee/var/log ディレクトリに格納されます。コンポーネントごとに独自のサブディレクトリがあります。たとえば、Management Server のログは次のディレクトリにあります。

/opt/apigee/var/log/edge-management-server

次の表に、ログファイルの場所を示します。

コンポーネント	ロケーション
管理サーバー	/opt/apigee/var/log/edge-management-server
ルーター	/opt/apigee/var/log/edge-router Edge Router は Nginx を使用して実装されています。その他のログについては、以下をご覧ください。 /opt/apigee/var/log/edge-router/nginx /opt/nginx/logs
Message Processor	/opt/apigee/var/log/edge-message-processor
Apigee Qpid サーバー	/opt/apigee/var/log/edge-qpid-server
Apigee Postgres サーバー	/opt/apigee/var/log/edge-postgres-server
Classic UI（コンポーネント名が edge-management-ui の新しい Edge UI ではありません）	/opt/apigee/var/log/edge-ui
ZooKeeper	/opt/apigee/var/log/apigee-zookeeper
OpenLDAP	/opt/apigee/var/log/apigee-openldap
Cassandra	/opt/apigee/var/log/apigee-cassandra/system.log
クピッド	/opt/apigee/var/log/apigee-qpidd
PostgreSQL データベース	/opt/apigee/var/log/apigee-postgresql
apigee-monit	/opt/apigee/var/log/apigee-monit

データ

コンポーネント	ロケーション
管理サーバー	/opt/apigee/data/edge-management-server
ルーター	/opt/apigee/data/edge-router
Message Processor	/opt/apigee/data/edge-message-processor
Apigee Qpid エージェント	/opt/apigee/data/edge-qpid-server
Apigee Postgres エージェント	/opt/apigee/data/edge-postgres-server
ZooKeeper	/opt/apigee/data/apigee-zookeeper
OpenLDAP	/opt/apigee/data/apigee-openldap
Cassandra	/opt/apigee/data/apigee-cassandra/data
クピッド	/opt/apigee/data/apigee-qpid/data
PostgreSQL データベース	/opt/apigee/data/apigee-postgres/pgdata
apigee-monit	/opt/apigee/data/apigee-monit

インストール時のシステム チェックを有効にする

Edge のインストール構成ファイルでは、次のプロパティがサポートされています。

ENABLE_SYSTEM_CHECK=y

このプロパティを「y」に設定すると、インストールするコンポーネントの CPU とメモリの要件を満たしているかどうかがインストーラによってチェックされます。デフォルト値は「n」で、チェックを無効にします。