Edge のインストールの概要

Edge for Private Cloud v4.19.01

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

インストール プロセス

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

  1. ノードで SELinux を無効にするか、permissive モードに設定します。詳しくは、 Edge apigee-setup ユーティリティをインストールします。 できます。
  2. Cassandra 認証を有効にするかどうかを決定します。
  3. Postgres にマスター / スタンバイ レプリケーションを設定するかどうかを決定します。
  4. 推奨トポロジのリストから Edge 構成を選択します。たとえば、 Edge は、テスト用には単一ノードに、本番環境用には 13 ノードにインストールできます。詳しくは、 インストール トポロジをご覧ください。
  5. 選択したトポロジの各ノードに、Edge apigee-setup ユーティリティをインストールします。 <ph type="x-smartling-placeholder">
      </ph>
    • Edge bootstrap_4.19.01.sh ファイルを次の場所にダウンロードします。 /tmp/bootstrap_4.19.01.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. インストールの完了後に、各ノードで Edge UI コンポーネントを再起動します。 次の例をご覧ください。 
    /opt/apigee/apigee-service/bin/apigee-service edge-ui restart

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

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

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

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

  • apigee-service ユーティリティ: <ph type="x-smartling-placeholder">
      </ph>
    • apigee-service コマンド: install, uninstall, update
    • apigee-all コマンド: install, uninstall, update
  • Edge コンポーネントをインストールする setup.sh スクリプト（ 「apigee-service install」必要な RPM をインストールします。root または完全な sudo 必要ない場合はアクセスできません）。
  • Edge コンポーネントを更新する update.sh スクリプト

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

上記以外のすべてのコマンドを実行するには、 「apigee」への sudo フルアクセス権できます。たとえば、次のようなコマンドです。

  • 次のような apigee-service ユーティリティ コマンド <ph type="x-smartling-placeholder">
      </ph>
    • 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」にします。または、管理者がユーザー名を変更した場合や、 「apigee」から Edge サービスを実行する実行しているユーザーにファイルを 使用できます。

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

Edge のインストール プロセス全体を実行するのは、root として実行するか、インストールを行ったユーザーが sudo フルアクセスが付与されるため、常に可能とは限りません。代わりに、ラベルを ロールを持つタスクと、権限のあるユーザーが実行するタスクに分けることができます。 「apigee」への sudo フルアクセス権できます。

  1. root が実行するタスク: <ph type="x-smartling-placeholder">
      </ph>
    1. bootstrap_4.19.01.sh ファイルをダウンロードして実行します。 
      curl https://software.apigee.com/bootstrap_4.19.01.sh -o /tmp/bootstrap_4.19.01.sh
sudo bash /tmp/bootstrap_4.19.01.sh apigeeuser=uName apigeepassword=pWord

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

    2. 「apigee」への sudo フルアクセスを持つようにユーザーを構成する詳しくは、 「apigee」への sudo フルアクセス権を持つユーザーの作成user です。
    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 をインストールすると、root 権限があるユーザーが 「apigee」構成プロセスを完了します。 <ph type="x-smartling-placeholder">
      </ph>
    1. setup.sh ユーティリティを使用して Edge の構成を完了します。 ノードに配置されます。コマンドの形式は、構成するコンポーネントによって異なります。 インストールされます。完全なリストについては、 Edge コンポーネントをノードにインストールする。

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

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

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

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

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

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

環境変数を含む apigee-setup ユーティリティに構成ファイルを渡す必要があります。 詳細情報を確認できます。サイレント インストールの唯一の要件は、 構成ファイルが「apigee」からアクセス可能または読み取り可能になっている必要があります。できます。たとえば、 （ノードの /usr/local/var または /usr/local/share ディレクトリ） 「apigee:apigee」に chown します。

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

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

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

Edge コンポーネントのインストール中にエラーが発生した場合は、 インストーラを再度実行します。インストーラは、 障害を検出した場合や、後でコンポーネントの変更または更新が必要になった場合に インストールできます。

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

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

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

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

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

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

    外部インターネット接続がないノードでも、ミラーリングされたバージョンの Apigee にアクセスできます 内部でセットアップしたリポジトリです。このリポジトリにはすべての Edge RPM が格納されていますが、 他の依存関係が内部リポジトリのリポジトリから利用可能であることを 接続します

    内部 Apigee リポジトリを作成するには、外部インターネットを持つノードが必要です アクセスする必要があります。新しい P-MAX キャンペーンを そのリポジトリを別のノードに移動したり、そのノードに Edge からアクセスできるようにしたりすることが可能です。 作成します。

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

ローカル（ミラーリング）リポジトリを使用する理由の一つは、ノードに Edge をインストールするためです。 外部インターネット接続なしで使用できます。

<ph type="x-smartling-placeholder">

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

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

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

一般的な 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 をデプロイします 説明します。

ログファイル

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

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

/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
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
クピッド /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」です。無効にするには、 確認します。