Edge のインストールの概要

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

インストール プロセス

ノードへの Edge のインストールは、複数のステップからなるプロセスです。

  1. SELinux をノードで無効にするか、permissive モードに設定します。詳細については、Edge apigee-setup ユーティリティのインストールをご覧ください。
  2. Cassandra 認証を有効にするかどうかを決定します。
  3. Postgres にマスター / スタンバイ レプリケーションを設定するかどうかを決定します。
  4. 推奨トポロジのリストから Edge 構成を選択します。たとえば、テスト用には 1 つのノードに、本番環境用には 13 個のノードに Edge をインストールできます。詳細については、インストール トポロジをご覧ください。
  5. 選択したトポロジの各ノードに、Edge apigee-setup ユーティリティをインストールします。
    • Edge bootstrap_4.50.00.sh ファイルを /tmp/bootstrap_4.50.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)をインストールすることをおすすめします。この 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 ユーティリティ コマンド(以下を含む):
    • start, stop, restart, configure などの apigee-service コマンド。
    • start, stop, restart, configure などの apigee-all コマンド。

「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.50.00.sh ファイルをダウンロードして実行します。
      curl https://software.apigee.com/bootstrap_4.50.00.sh -o /tmp/bootstrap_4.50.00.sh
      sudo bash /tmp/bootstrap_4.50.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 ファイルのセットとしてインストールされます。各 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-setupsetup.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 Server

/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
Qpidd /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
Qpidd /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」で、このチェックは無効になります。