一般的な Edge インストールは、複数のノードに分散された Edge コンポーネントで構成されます。ノードに Edge をインストールしたら、1 つ以上の Edge コンポーネントをノードにインストールして構成します。
インストール プロセス
ノードへの Edge のインストールは、次のような複数の手順で構成されます。
- ノード上の SELinux を無効にするか、制限なしモードに設定します。詳細については、Edge apigee-setup ユーティリティのインストールをご覧ください。
- Cassandra 認証を有効にするかどうかを決定します。
- Postgres のマスター / スタンバイ レプリケーションを設定するかどうかを決めます。
- 推奨されるトポロジのリストから、Edge 構成を選択します。たとえば、テスト用の 1 つのノードに Edge をインストールしたり、本番環境用に 13 ノードに Edge をインストールしたりできます。詳細については、インストール トポロジをご覧ください。
- 選択したトポロジの各ノードに Edge
apigee-setup
ユーティリティをインストールします。- Edge
bootstrap_4.52.00.sh
ファイルを/tmp/bootstrap_4.52.00.sh
にダウンロードします。 - Edge
apigee-service
ユーティリティと依存関係をインストールします。 - Edge
apigee-setup
ユーティリティと依存関係をインストールします。詳細については、Edge apigee-setup ユーティリティのインストールをご覧ください。
- Edge
apigee-setup
ユーティリティを使用して、選択したトポロジに基づいて、各ノードに 1 つ以上の Edge コンポーネントをインストールします。Edge コンポーネントをノードにインストールするをご覧ください。
- Management Server ノード上で、
apigee-setup
ユーティリティを使用して、Edge 組織の作成と管理に使用するユーティリティであるapigee-provision
をインストールします。詳しくは、組織のオンボーディングを行うをご覧ください。
- 次の例に示すように、インストールの完了後に、Classic UI コンポーネントを各ノードで再起動します。
/opt/apigee/apigee-service/bin/apigee-service edge-ui restart
(推奨)初期インストールが完了した後、新しい Edge UI (コンポーネント名は
edge-management-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
- apigee-service コマンド:
- setup.sh スクリプトを実行して Edge コンポーネントをインストールします(ただし、すでに「
apigee-service install
」を使用して必要な RPM をインストールしている場合を除きます)。その後、root または sudo フルアクセスが必要ありません)。 - update.sh スクリプト: Edge コンポーネントを更新する
また、Edge インストーラはシステム上に「apigee」という名前の新しいユーザーを作成します。多くの Edge コマンドでは、「sudo」を呼び出して「apigee」ユーザーとして実行します。
上に表示されているコマンド以外のコマンドを実行するユーザーは、「apigee」ユーザーに対する sudo フルアクセス権限を持つユーザーである必要があります。以下のコマンドがあります。
-
apigee-service ユーティリティ コマンド。次のものが含まれます。
- 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 コマンドからアクセスできるようになります。
- このファイルを任意のユーザーとしてエディタで作成します。
- ファイルのオーナーを「apigee:apigee」に変更します。Edge サービスを実行しているユーザーを「apigee」ユーザーから変更した場合は、ファイルのオーナーを Edge サービスを実行しているユーザーに変更します。
chown
root ユーザーと非 root ユーザーの間で Edge インストール タスクを分離する
Edge のインストール プロセス全体を、root として、または完全な sudo アクセス権を持つユーザーによって行うのが最も簡単ですが、常に可能であるとは限りません。代わりに、プロセスを root が実行するタスクと、「apigee」ユーザーに対する sudo フルアクセス権限を持つユーザーが実行するタスクに分離できます。
- root で実行されるタスク:
bootstrap_4.52.00.sh
ファイルをダウンロードして実行します。curl https://software.apigee.com/bootstrap_4.52.00.sh -o /tmp/bootstrap_4.52.00.sh
sudo bash /tmp/bootstrap_4.52.00.sh apigeeuser=uName apigeepassword=pWord
このステップでは、
apigee-service
ユーティリティをインストールして「apigee」ユーザーを作成します。- 「apigee」ユーザーに対する sudo フルアクセス権限を持つユーザーの作成の説明に従って、「apigee」ユーザーに対する sudo フルアクセス権限を持つユーザーを構成します。
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 をインストールした後に、「apigee」ユーザーに対する sudo フルアクセス権限を持つユーザーが構成プロセスを完了させます。
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 のバージョンを維持する
ローカル リポジトリまたはミラーリングされたリポジトリを使用する理由の 1 つは、前のセクションで説明したように、外部インターネット接続がないノードに 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
次の表に、ログファイルの場所を示します。
コンポーネント | ロケーション |
---|---|
管理サーバー |
/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 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 で、このチェックは行われません。