Edge のインストールの概要

Edge for Private Cloud v4.18.05

一般的な 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.18.05.sh ファイルを次の場所にダウンロードします。 /tmp/bootstrap_4.18.05.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 コンポーネントを再起動します。

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

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.18.05.sh ファイルをダウンロードして実行します。

      curl https://software.apigee.com/bootstrap_4.18.05.sh -o /tmp/bootstrap_4.18.05.sh
      sudo bash /tmp/bootstrap_4.18.05.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 をインストールするためです。 外部インターネット接続なしで使用できます。

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

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

データ

インストール後のタスク

インストールが完了したら、Edge コンポーネントに対して追加の操作を実行できます。

Edge UI を再起動する コンポーネント

インストールが完了したら、各ノードで Edge UI コンポーネントを再起動する必要があります。

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

Edge の構成 インストール後のコンポーネント

インストール後に Edge を構成するには、.properties ファイルを組み合わせて使用します。 ユーティリティです。たとえば、Edge UI で TLS/SSL を構成するには、 .properties ファイルを使用して、必要なプロパティを設定します。.properties の変更 該当する Edge コンポーネントを再起動する必要があります。

.properties ファイルは次の場所にあります。 /opt/apigee/customer/application ディレクトリにあります。 このディレクトリには、コンポーネントごとに独自の .properties ファイルがあります。 たとえば、router.properties や management-server.properties です。

コンポーネントのプロパティを設定するには、対応する .properties ファイルを編集します。 コンポーネントを再起動します。

/opt/apigee/apigee-service/bin/apigee-service component restart

例:

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

Edge を更新すると、.properties /opt/apigee/customer/application ディレクトリが読み取られます。つまり、このアップデートは すべてのプロパティに適用されます。

詳細については、Edge の構成方法をご覧ください。 エッジ構成。

Edge コンポーネントでのコマンドの呼び出し

Edge では、管理ユーティリティが /opt/apigee/apigee-service/bin の下にインストールされ、 管理するために使用します。たとえば、apigee-all ユーティリティを使用すると、 ノード上のすべての Edge コンポーネントの起動、停止、再起動、ステータスの確認を行います。

/opt/apigee/apigee-service/bin/apigee-all stop|start|restart|status|version

apigee-service ユーティリティを使用する 個別のコンポーネントを制御および構成できます。apigee-service ユーティリティの形式は次のとおりです。

/opt/apigee/apigee-service/bin/apigee-service component_name action

ここで、component_name はコンポーネントを表します。コンポーネントは、Compute Engine の apigee-service を実行します。構成によっては、 component_name に含めることができる要素:

• apigee-cassandra（Cassandra）
• apigee-openldap（OpenLDAP）
• apigee-postgresql（PostgreSQL データベース）
• apigee-qpidd（Qpidd）
• apigee-sso（Edge SSO）
• apigee-zookeeper（ZooKeeper）
• edge-management-server（Management Server）
• edge-management-ui（新しい Edge UI）
• edge-message-processor（Message Processor）
• edge-postgres-server（Postgres Server）
• edge-qpid-server（Qpid Server）
• edge-router（Edge Router）
• edge-ui（Classic UI）

これらのコンポーネントに加えて、apigee-service を 環境に応じて、apigee-provision コンポーネントと apigee-validate コンポーネント できます。

たとえば、Edge Router を再起動するには、次のコマンドを実行します。

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

ノードにインストールされているコンポーネントのリストは、 /opt/apigee ディレクトリ。このディレクトリには、すべての Edge 用のサブディレクトリが コンポーネントをインストールします。各サブディレクトリには、次の接頭辞が付けられます。

• apigee: Edge で使用されるサードパーティ コンポーネント。例: apigee-cassandra
• edge: Apigee の Edge コンポーネント。例: edge-management-server
• edge-mint: 収益化コンポーネント。たとえば edge-mint-management-server。

コンポーネントに対するアクションの完全なリストはコンポーネント自体によって異なりますが、 次のアクションをサポートしています。

• start, stop, restart
• status, version
• backup, restore
• install, uninstall

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

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

ENABLE_SYSTEM_CHECK=y

このプロパティを「y」に設定すると、システムが CPU の要件を満たしており、 メモリ要件を指定します。デフォルト値は「n」です。無効にするには、 確認します。