一般的な Edge インストール環境は、複数のノードに分散された Edge コンポーネントで構成されます。 Edge をノードにインストールした後、1 つ以上の Edge コンポーネントをノードにインストールして構成します。 作成されます。
インストール プロセス
ノードへの Edge のインストールは、複数のステップから成ります。
- ノードで SELinux を無効にするか、permissive モードに設定します。詳しくは、 Edge apigee-setup ユーティリティをインストールします。 できます。
- Cassandra 認証を有効にするかどうかを決定します。
- Postgres にマスター / スタンバイ レプリケーションを設定するかどうかを決定します。
- 推奨トポロジのリストから Edge 構成を選択します。たとえば、 Edge は、テスト用には単一ノードに、本番環境用には 13 ノードにインストールできます。詳しくは、 インストール トポロジをご覧ください。
- 選択したトポロジの各ノードに、Edge
apigee-setup
ユーティリティをインストールします。 <ph type="x-smartling-placeholder">- </ph>
- Edge
bootstrap_4.52.02.sh
ファイルを次の場所にダウンロードします。/tmp/bootstrap_4.52.02.sh
。 - Edge
apigee-service
ユーティリティと依存関係をインストールします。 - Edge
apigee-setup
ユーティリティと依存関係をインストールします。
- Edge
apigee-setup
ユーティリティを使用して、それぞれに 1 つ以上の Edge コンポーネントをインストールします。 ノードを選択します。ノードに Edge コンポーネントをインストールするをご覧ください。
- Management Server ノードで、
apigee-setup
ユーティリティを使用してインストールします。apigee-provision
: Edge の作成と管理に使用するユーティリティ 組織に提供します。詳細については、組織のオンボーディングをご覧ください。
- インストールの完了後に、各ノードで Classic UI コンポーネントを再起動します。
次の例をご覧ください。
/opt/apigee/apigee-service/bin/apigee-service edge-ui restart
(推奨)最初のインストールが完了すると、Apigee は 新しい Edge UI(コンポーネント名が
edge-management-ui
: 拡張されたユーザー インターフェースです。 Apigee Edge for Private Cloud のデベロッパーと管理者の責任です。詳細については、新しい 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
- apigee-service コマンド:
- 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-service コマンド(
「apigee」への sudo フルアクセス権を持つユーザーの作成ユーザー
「apigee」へのフル sudo アクセス権をユーザーが持つように構成します。「visudo」を使用します。コマンドを sudoers ファイルを編集して以下を追加します。
installUser ALL=(apigee) NOPASSWD: ALL
ここで、installUser は Edge を使用するユーザーのユーザー名です。
構成ファイルの権限を設定する
Edge コマンドで使用するファイルやリソースには、apigee からアクセスできる必要があります。できます。この Edge ライセンス ファイルとすべての構成ファイルが含まれています。
構成ファイルを作成するときに、ファイルのオーナーを「apigee:apigee」に変更できます。確実に保存し、 Edge コマンドでアクセスできます。
- エディタで、任意のユーザーとしてファイルを作成します。
chown
: ファイルのオーナーを「apigee:apigee」にします。または、管理者がユーザー名を変更した場合や、 「apigee」から Edge サービスを実行する実行しているユーザーにファイルを 使用できます。
root ユーザーと root 以外のユーザーの Edge インストール タスクの分離
Edge のインストール プロセス全体を実行するのは、root として実行するか、インストールを行ったユーザーが sudo フルアクセスが付与されるため、常に可能とは限りません。代わりに、ラベルを ロールを持つタスクと、権限のあるユーザーが実行するタスクに分けることができます。 「apigee」への sudo フルアクセス権できます。
- root が実行するタスク:
<ph type="x-smartling-placeholder">
- </ph>
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」を作成します。 できます。- 「apigee」への sudo フルアクセスを持つようにユーザーを構成する詳しくは、 「apigee」への sudo フルアクセス権を持つユーザーの作成user です。
apigee-setup
ユーティリティをインストールします。/opt/apigee/apigee-service/bin/apigee-service apigee-setup install
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
があります。
- root ユーザーがノードに Edge RPM をインストールすると、root 権限があるユーザーが
「apigee」構成プロセスを完了します。
<ph type="x-smartling-placeholder">
- </ph>
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 を使用して実装されています。その他のログについては、以下をご覧ください。
|
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 UI ではありません。この UI のコンポーネント名は
edge-management-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」です。無効にするには、 確認します。