Edge のインストールの概要

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

インストール プロセス

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

1. ノード上の SELinux を無効にするか、制限なしモードに設定します。詳細については、Edge apigee-setup ユーティリティをインストールするをご覧ください。
2. Cassandra 認証を有効にするかどうかを決定します。
3. Postgres 用のマスター / スタンバイ レプリケーションを設定するかどうかを決定します。
4. 推奨されるトポロジのリストから、Edge 構成を選択します。たとえば、テスト用として単一のノードへの Edge をインストールしたり、本番用として 13 個のノードにインストールしたりできます。詳細については、インストール トポロジをご覧ください。
5. 選択したトポロジの各ノードに、Edge apigee-setup ユーティリティをインストールします。
   • Edge bootstrap_4.53.00.sh ファイルを /tmp/bootstrap_4.53.00.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）をインストールすることをおすすめします。新しい Edge 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」から変更した場合は、chown を使用して、ファイルのオーナーを Edge サービスを実行しているユーザーにします。

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

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

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

      curl https://software.apigee.com/bootstrap_4.53.00.sh -o /tmp/bootstrap_4.53.00.sh
      sudo bash /tmp/bootstrap_4.53.00.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 をノードにインストールするには、そのノードが Apigee リポジトリにアクセスできる必要があります。

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

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

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

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

  Apigee の内部リポジトリを作成するには、Edge RPM と依存関係がダウンロードできるように、ノードが外部とインターネット接続できるようにする必要があります。内部リポジトリを作成したら、そのリポジトリを別のノードに移動したり、そのノードを Edge ノードからアクセスできるようしたりして、インストールに使用できます。

ローカル Edge リポジトリを使用した Edge バージョンの管理

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

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

Apigee Edge 配布ファイルは、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

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

データ

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

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

ENABLE_SYSTEM_CHECK=y

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