Edge for Private Cloud バージョン 4.17.05
Edge apigee-setup ユーティリティをノードにインストールした後、apigee-setup ユーティリティを使用して 1 つ以上の Edge コンポーネントをノードにインストールします。
apigee-setup ユーティリティは、次の形式のコマンドを使用します。
> /opt/apigee/apigee-setup/bin/setup.sh -p component -f configFile
component はインストールする Edge コンポーネント、configFile はインストール情報を含むサイレント構成ファイルです。構成ファイルは「apigee」ユーザーからアクセス可能で、読み取り可能である必要があります。たとえば、ファイル用の新しいディレクトリを作成して、/usr/local ディレクトリ、/usr/local/share ディレクトリ、または「apigee」ユーザーがアクセスできるノード上の任意の場所に置くことができます。
たとえば、Edge Management Server をインストールするには、次のコマンドを実行します。
> /opt/apigee/apigee-setup/bin/setup.sh -p ms -f /usr/local/myConfig
インストールに関する考慮事項
構成ファイルを作成する際には、次のオプションを考慮してください。
Postgres のマスター / スタンバイ レプリケーションの設定
デフォルトでは、すべての Postgres ノードがマスターモードでインストールされます。ただし、複数の Postgres ノードがある本番環境システムでは、マスター / スタンバイ レプリケーションを使用するように構成し、マスターノードに障害が発生しても、スタンバイ ノードがトラフィックの処理を続行できるようにする必要があります。
インストール時にマスター / スタンバイ レプリケーションを有効にして構成するには、サイレント構成ファイルのプロパティを使用します。インストール後にマスター / スタンバイ レプリケーションを有効にすることもできます。詳細については、Postgres のマスター / スタンバイ レプリケーションを設定するをご覧ください。
Cassandra 認証の有効化
デフォルトでは、Cassandra は認証を有効にせずにインストールされます。つまり、誰でも Cassandra にアクセスできます。Edge のインストール後、またはインストール プロセスの一環として、認証を有効にできます。
詳細については、Cassandra 認証を有効にするをご覧ください。
仮想ホスト作成時の保護されたポートの使用
保護されたポート(例: 1,000 未満のポート番号)に Router をバインドする仮想ホストを作成する場合は、それらのポートへのアクセス権を持つユーザーとして実行されるように Router を構成する必要があります。デフォルトでは、Router は特権ポートへのアクセス権がないユーザー「apigee」として実行されます。
1,000 未満のポートにアクセスするように仮想ホストと Router を構成する方法については、仮想ホストの設定をご覧ください。
インストールするコンポーネントの指定
次の表に、ノードにインストールするコンポーネントを指定するために apigee-service ユーティリティの -p オプションに渡すオプションを示します。
コンポーネント |
Description |
---|---|
線 |
Cassandra のみをインストールします。 |
ZK | ZooKeeper のみをインストールします。 |
ds |
ZooKeeper と Cassandra をインストールします。 |
ld |
OpenLDAP のみをインストールします。 |
ms |
Edge Management Server をインストールします。これにより、Edge UI と OpenLDAP もインストールされます。 構成ファイルに USE_LDAP_REMOTE_HOST=y を設定すると、OpenLDAP のインストールがスキップされ、Management Server は別のノードにインストールされた OpenLDAP を使用します。 |
R |
Edge Router のみをインストールします。 |
mp |
Edge Message Processor のみをインストールします。 |
RAMP |
Edge Router と Message Processor をインストールします。 |
ui |
Edge UI をインストールします。 |
qs |
Qpid Server のみをインストールします。 |
ps |
Postgres Server のみをインストールします。 |
PDB | Postgres データベースのみをインストールします - Developer Services ポータルをインストールする場合にのみ使用します。デベロッパー サービス ポータルのインストールをご覧ください。 |
サックス |
分析コンポーネント、つまり Qpid と Postgres をインストールします。 このオプションは開発とテストにのみ使用し、本番環境では使用できません。 |
5 割 |
Monetization をインストールします。 |
sa |
Edge スタンドアロン(Cassandra、ZooKeeper、Management Server、OpenLDAP、Edge UI、Router、Message Processor)をインストールします。このオプションでは、Edge Analytics コンポーネント(Qpid と Postgres)が省略されます。 このオプションは開発とテストにのみ使用し、本番環境では使用できません。 |
Aio |
すべてのコンポーネントを単一のノードにインストールします。 このオプションは開発とテストにのみ使用し、本番環境では使用できません。 |
dp |
Developer Services ポータルをインストールします。 |
構成ファイルの作成
構成ファイルには、Edge のインストールに必要な情報がすべて含まれています。多くの場合、同じ構成ファイルを使用して Edge 環境のすべてのコンポーネントをインストールできます。
ただし、次の場合は、別の構成ファイルを使用するか、構成ファイルを変更する必要があります。
- 複数の OpenLDAP サーバーをインストールし、13 ノード構成でレプリケーションを構成する必要がある場合。ファイルごとに、LDAP_SID と LDAP_PEER に異なる値が必要です。
- 12 ノード構成で複数のデータセンターを作成しています。データセンターごとに、ZK_CLIENT_HOSTS や CASS_HOSTS などのプロパティに異なる設定が必要です。
以下で説明する各インストール トポロジでは、そのトポロジの構成ファイルの例を示しています。構成ファイルの詳細については、Edge 構成ファイル リファレンスをご覧ください。
インストール ログファイル
デフォルトでは、setup.sh ユーティリティはインストールに関するログ情報を次の場所に書き込みます。
/opt/apigee/var/log/apigee-setup/setup.log
setup.sh ユーティリティを実行しているユーザーがこのディレクトリにアクセスできない場合は、ログを setup_username.log という名前のファイルとして /tmp ディレクトリに書き込みます。
ユーザーに /tmp へのアクセス権がない場合、setup.sh ユーティリティは失敗します。
Edge コンポーネントをインストールする
このセクションでは、さまざまなトポロジ用の Edge コンポーネントをインストールする方法について説明します。コンポーネントのインストール順序は、必要なトポロジに基づきます。
以下に示すインストール例はすべて、以下をインストールしていることを前提としています。
- Cassandra 認証を無効にした場合(デフォルト)。詳細については、Cassandra 認証を有効にするをご覧ください。
- Postgres のマスター / スタンバイ レプリケーションが無効になっている(デフォルト)。詳細については、Postgres のマスター / スタンバイ レプリケーションを設定するをご覧ください。
- Message Processor と Router を同じノードに配置します。Message Processor と Router を別々のノードにインストールする場合は、まずすべての Message Processor をインストールし、次にすべての Router をインストールします。
オールインワン設置
- 次のコマンドを使用して、すべてのコンポーネントを単一ノードにインストールします。
> /opt/apigee/apigee-setup/bin/setup.sh -p aio -f configFile - インストールをテストするの説明に沿ってインストールをテストします。
- 組織のオンボーディングの説明に従って、組織をオンボーディングします。
次の図は、このトポロジのサイレント構成ファイルを示しています。構成ファイルの詳細については、Edge 構成ファイル リファレンスをご覧ください。
# With SMTP IP1=IPorDNSnameOfNode HOSTIP=$(hostname -i) ADMIN_EMAIL=opdk@google.com APIGEE_ADMINPW=Secret123 LICENSE_FILE=/tmp/license.txt MSIP=$IP1 LDAP_TYPE=1 APIGEE_LDAPPW=secret BIND_ON_ALL_INTERFACES=y MP_POD=gateway REGION=dc-1 ZK_HOSTS="$IP1" ZK_CLIENT_HOSTS="$IP1" # Must use IP addresses for CASS_HOSTS, not DNS names. CASS_HOSTS="$IP1" # Default is postgres PG_PWD=postgres SKIP_SMTP=n SMTPHOST=smtp.example.com SMTPUSER=smtp@example.com # omit for no username SMTPPASSWORD=smtppwd # omit for no password SMTPSSL=n SMTPPORT=25 SMTPMAILFROM="My Company <myco@company.com>"
2 ホストのスタンドアロン インストール
Edge トポロジとノード番号のリストについては、インストール トポロジをご覧ください。
- スタンドアロン ゲートウェイとノード 1 をインストールします
> /opt/apigee/apigee-setup/bin/setup.sh -p sa -f configFile - ノード 2 に Analytics をインストールします。
> /opt/apigee/apigee-setup/bin/setup.sh -p sax -f configFile - インストールをテストするの説明に沿ってインストールをテストします。
- 組織のオンボーディングの説明に従って、組織をオンボーディングします。
次の図は、このトポロジのサイレント構成ファイルを示しています。構成ファイルの詳細については、Edge 構成ファイル リファレンスをご覧ください。
# With SMTP IP1=IPorDNSnameOfNode1 HOSTIP=$(hostname -i) ADMIN_EMAIL=opdk@google.com APIGEE_ADMINPW=Secret123 LICENSE_FILE=/tmp/license.txt MSIP=$IP1 LDAP_TYPE=1 APIGEE_LDAPPW=secret BIND_ON_ALL_INTERFACES=y MP_POD=gateway REGION=dc-1 ZK_HOSTS="$IP1" ZK_CLIENT_HOSTS="$IP1" # Must use IP addresses for CASS_HOSTS, not DNS names. CASS_HOSTS="$IP1" # Default is postgres PG_PWD=postgres SKIP_SMTP=n SMTPHOST=smtp.example.com SMTPUSER=smtp@example.com # omit for no username SMTPPASSWORD=smtppwd # omit for no password SMTPSSL=n SMTPPORT=25 SMTPMAILFROM="My Company <myco@company.com>"
5 ホストクラスタ インストール
Edge トポロジとノード番号のリストについては、インストール トポロジをご覧ください。
- ノード 1、2、3 に Datastore クラスタをインストールします。
> /opt/apigee/apigee-setup/bin/setup.sh -p ds -f configFile - ノード 1 に Management Server をインストールします。
> /opt/apigee/apigee-setup/bin/setup.sh -p ms -f configFile - ノード 2 と 3 に Router と Message Processor をインストールします。
> /opt/apigee/apigee-setup/bin/setup.sh -p rmp -f configFile - ノード 4 と 5 に Analytics をインストールします。
> /opt/apigee/apigee-setup/bin/setup.sh -p sax -f configFile - インストールをテストするの説明に沿ってインストールをテストします。
- 組織のオンボーディングの説明に従って、組織をオンボーディングします。
次の図は、このトポロジのサイレント構成ファイルを示しています。構成ファイルの詳細については、Edge 構成ファイル リファレンスをご覧ください。
# With SMTP IP1=IPorDNSnameOfNode1 IP2=IPorDNSnameOfNode2 IP3=IPorDNSnameOfNode3 IP4=IPorDNSnameOfNode4 IP5=IPorDNSnameOfNode5 HOSTIP=$(hostname -i) ADMIN_EMAIL=opdk@google.com APIGEE_ADMINPW=Secret123 LICENSE_FILE=/tmp/license.txt MSIP=$IP1 USE_LDAP_REMOTE_HOST=n LDAP_TYPE=1 APIGEE_LDAPPW=secret BIND_ON_ALL_INTERFACES=y MP_POD=gateway REGION=dc-1 ZK_HOSTS="$IP1 $IP2 $IP3" ZK_CLIENT_HOSTS="$IP1 $IP2 $IP3" # Must use IP addresses for CASS_HOSTS, not DNS names. CASS_HOSTS="$IP1 $IP2 $IP3" # Default is postgres PG_PWD=postgres PG_MASTER=$IP4 PG_STANDBY=$IP5 SKIP_SMTP=n SMTPHOST=smtp.example.com SMTPUSER=smtp@example.com # omit for no username SMTPPASSWORD=smtppwd # omit for no password SMTPSSL=n SMTPPORT=25 SMTPMAILFROM="My Company <myco@company.com>"
9 ホストクラスタ構成のインストール
Edge トポロジとノード番号のリストについては、インストール トポロジをご覧ください。
- ノード 1、2、3 に Datastore クラスタノードをインストールします。
> /opt/apigee/apigee-setup/bin/setup.sh -p ds -f configFile - Apigee Management Server をノード 1 にインストールします。
> /opt/apigee/apigee-setup/bin/setup.sh -p ms -f configFile - ノード 4 と 5 に Router と Message Processor をインストールします。
> /opt/apigee/apigee-setup/bin/setup.sh -p rmp -f configFile - Apigee Analytics Qpid Server をノード 6 と 7 にインストールします。
> /opt/apigee/apigee-setup/bin/setup.sh -p qs -f configFile - ノード 8 と 9 に Apigee Analytics Postgres Server をインストールします。
> /opt/apigee/apigee-setup/bin/setup.sh -p ps -f configFile - インストールをテストするの説明に沿ってインストールをテストします。
- 組織のオンボーディングの説明に従って、組織をオンボーディングします。
次の図は、このトポロジのサイレント構成ファイルを示しています。構成ファイルの詳細については、Edge 構成ファイル リファレンスをご覧ください。
# With SMTP IP1=IPorDNSnameOfNode1 IP2=IPorDNSnameOfNode2 IP3=IPorDNSnameOfNode3 IP8=IPorDNSnameOfNode8 IP9=IPorDNSnameOfNode9 HOSTIP=$(hostname -i) ADMIN_EMAIL=opdk@google.com APIGEE_ADMINPW=Secret123 LICENSE_FILE=/tmp/license.txt MSIP=$IP1 USE_LDAP_REMOTE_HOST=n LDAP_TYPE=1 APIGEE_LDAPPW=secret BIND_ON_ALL_INTERFACES=y MP_POD=gateway REGION=dc-1 ZK_HOSTS="$IP1 $IP2 $IP3" ZK_CLIENT_HOSTS="$IP1 $IP2 $IP3" # Must use IP addresses for CASS_HOSTS, not DNS names. CASS_HOSTS="$IP1 $IP2 $IP3" # Default is postgres PG_PWD=postgres SKIP_SMTP=n PG_MASTER=$IP8 PG_STANDBY=$IP9 SMTPHOST=smtp.example.com SMTPUSER=smtp@example.com # omit for no username SMTPPASSWORD=smtppwd # omit for no password SMTPSSL=n SMTPPORT=25 SMTPMAILFROM="My Company <myco@company.com>"
13 ホストクラスタ インストール
Edge トポロジとノード番号のリストについては、インストール トポロジをご覧ください。
- ノード 1、2、3 に Datastore クラスタノードをインストールします。
> /opt/apigee/apigee-setup/bin/setup.sh -p ds -f configFile - ノード 4 と 5 に OpenLDAP をインストールします。
> /opt/apigee/apigee-setup/bin/setup.sh -p ld -f configFile - Apigee Management Server をノード 6 と 7 にインストールします。
> /opt/apigee/apigee-setup/bin/setup.sh -p ms -f configFile - ノード 8 と 9 に Apigee Analytics Postgres Server をインストールします。
> /opt/apigee/apigee-setup/bin/setup.sh -p ps -f configFile - ノード 10 と 11 に Router と Message Processor をインストールします。
> /opt/apigee/apigee-setup/bin/setup.sh -p rmp -f configFile - ノード 12 と 13 に Apigee Analytics Qpid Server をインストールします。
> /opt/apigee/apigee-setup/bin/setup.sh -p qs -f configFile - インストールをテストするの説明に沿ってインストールをテストします。
- 組織のオンボーディングの説明に従って、組織をオンボーディングします。
次の図は、このトポロジのサイレント構成ファイルを示しています。構成ファイルの詳細については、Edge 構成ファイル リファレンスをご覧ください。
# For all components except OpenLDAP IP1=IPorDNSnameOfNode1 IP2=IPorDNSnameOfNode2 IP3=IPorDNSnameOfNode3 IP4=IPorDNSnameOfNode4 IP5=IPorDNSnameOfNode5 IP6=IPorDNSnameOfNode6 IP7=IPorDNSnameOfNode7 IP8=IPorDNSnameOfNode8 IP9=IPorDNSnameOfNode9 HOSTIP=$(hostname -i) ADMIN_EMAIL=opdk@google.com APIGEE_ADMINPW=Secret123 LICENSE_FILE=/tmp/license.txt # First Management Server on IP6 MSIP=$IP6 USE_LDAP_REMOTE_HOST=y LDAP_HOST=$IP4 LDAP_PORT=10389 # Second Management Server on IP7 # MSIP=$IP7 # USE_LDAP_REMOTE_HOST=y # LDAP_HOST=$IP5 # LDAP_PORT=10389 # Same password for both OpenLDAPs. APIGEE_LDAPPW=secret BIND_ON_ALL_INTERFACES=y MP_POD=gateway REGION=dc-1 ZK_HOSTS="$IP1 $IP2 $IP3" ZK_CLIENT_HOSTS="$IP1 $IP2 $IP3" # Must use IP addresses for CASS_HOSTS, not DNS names. CASS_HOSTS="$IP1 $IP2 $IP3" # Default is postgres PG_PWD=postgres PG_MASTER=$IP8 PG_STANDBY=$IP9 SKIP_SMTP=n SMTPHOST=smtp.example.com SMTPUSER=smtp@example.com # omit for no username SMTPPASSWORD=smtppwd # omit for no password SMTPSSL=n SMTPPORT=25 SMTPMAILFROM="My Company <myco@company.com>" |
# For OpenLDAP on IP4 and IP5 IP1=IPorDNSnameOfNode1 IP2=IPorDNSnameOfNode2 IP3=IPorDNSnameOfNode3 IP4=IPorDNSnameOfNode4 IP5=IPorDNSnameOfNode5 IP6=IPorDNSnameOfNode6 IP7=IPorDNSnameOfNode7 IP8=IPorDNSnameOfNode8 IP9=IPorDNSnameOfNode9 HOSTIP=$(hostname -i) ADMIN_EMAIL=opdk@google.com APIGEE_ADMINPW=Secret123 # First OpenLDAP Server on IP4 MSIP=$IP6 USE_LDAP_REMOTE_HOST=n LDAP_TYPE=2 LDAP_SID=1 LDAP_PEER=$IP5 # Second OpenLDAP Server on IP5 # MSIP=$IP7 # USE_LDAP_REMOTE_HOST=n # LDAP_TYPE=2 # LDAP_SID=2 # LDAP_PEER=$IP4 # Set same password for both OpenLDAPs. APIGEE_LDAPPW=secret |
12 ホストクラスタ インストール
a12 ホスト クラスタ トポロジ(2 つのデータセンター)に Edge をインストールする前に、サイレント構成ファイルで ZooKeeper プロパティと Cassandra プロパティを設定する方法を理解する必要があります。
- ZooKeeper
両方のデータセンターの ZK_HOSTS プロパティには、両方のデータセンターのすべての ZooKeeper ノードの IP アドレスまたは DNS 名を同じ順序で指定し、任意のノードに「:observer」修飾子を付けます。「:observer」修飾子が付いていないノードは「ボーター」と呼ばれます。構成の「ボーター」の数は奇数である必要があります。
このトポロジでは、ホスト 9 の ZooKeeper ホストがオブザーバーです。
各データセンターの ZK_CLIENT_HOSTS プロパティに、データセンター内のすべての ZooKeeper ノードのみの IP アドレスまたは DNS 名を同じ順序で指定します。以下に示す構成ファイルの例では、ノード 9 に「:observer」修飾子が付いているため、5 つのボーター(ノード 1、2、3、7、8)があります。 - Cassandra
すべてのデータセンターで同じ数の Cassandra ノードが必要です。
各データセンターの CASS_HOSTS には、両方のデータセンターのすべての Cassandra の IP アドレス(DNS 名ではない)を指定します。データセンター 1 の場合は、そのデータセンター内の Cassandra ノードを最初にリストします。データセンター 2 では、まず、そのデータセンター内の Cassandra ノードをリストアップします。データセンター内のすべての Cassandra ノードを同じ順序でリストします。
すべての Cassandra ノードに「:<d>,<r>」という接尾辞を付ける必要があります。たとえば、「<ip>:1,1」はデータセンター 1 とラック/アベイラビリティ ゾーン 1、「<ip>:2,1」はデータセンター 2 とラック/アベイラビリティ ゾーン 1 を表します。
例: "192.168.124.201:1,1 192.168.124.202:1,1 192.168.124.203:1,1 192.168.124.204:2,1
このデプロイモデルで、Cassandra の設定は次のようになります。
Edge トポロジとノード番号のリストについては、インストール トポロジをご覧ください。
- ノード 1、2、3、7、8、9 に Datastore クラスタノードをインストールします。
> /opt/apigee/apigee-setup/bin/setup.sh -p ds -f configFile - OpenLDAP レプリケーションを備えた Apigee Management Server をノード 1 と 7 にインストールします。
> /opt/apigee/apigee-setup/bin/setup.sh -p ms -f configFile - ノード 2、3、8、9 に Router と Message Processor をインストールします。
> /opt/apigee/apigee-setup/bin/setup.sh -p rmp -f configFile - Apigee Analytics Qpid Server をノード 4、5、10、11 にインストールします。
> /opt/apigee/apigee-setup/bin/setup.sh -p qs -f configFile - ノード 6 と 12 に Apigee Analytics Postgres Server をインストールします。
> /opt/apigee/apigee-setup/bin/setup.sh -p ps -f configFile - インストールをテストするの説明に沿ってインストールをテストします。
- 組織のオンボーディングの説明に従って、組織をオンボーディングします。
次の図は、このトポロジのサイレント構成ファイルを示しています。この構成ファイルに注目してください。構成ファイルの詳細については、Edge 構成ファイル リファレンスをご覧ください。
- 2 つの OpenLDAP ノード間でのレプリケーションを行うように OpenLDAP を構成します。
- 1 つの ZooKeeper ノードに「:observer」修飾子を指定します。単一のデータセンター インストールでは、この修飾子は省略します。
# Datacenter 1 IP1=IPorDNSnameOfNode1 IP2=IPorDNSnameOfNode2 IP3=IPorDNSnameOfNode3 IP6=IPorDNSnameOfNode6 IP7=IPorDNSnameOfNode7 IP8=IPorDNSnameOfNode8 IP9=IPorDNSnameOfNode9 IP12=IPorDNSnameOfNode12 HOSTIP=$(hostname -i) MSIP=$IP1 ADMIN_EMAIL=opdk@google.com APIGEE_ADMINPW=Secret123 LICENSE_FILE=/tmp/license.txt USE_LDAP_REMOTE_HOST=n LDAP_TYPE=2 LDAP_SID=1 LDAP_PEER=$IP7 APIGEE_LDAPPW=secret BIND_ON_ALL_INTERFACES=y MP_POD=gateway-1 REGION=dc-1 ZK_HOSTS="$IP1 $IP2 $IP3 $IP7 $IP8 $IP9:observer" ZK_CLIENT_HOSTS="$IP1 $IP2 $IP3" # Must use IP addresses for CASS_HOSTS, not DNS names. CASS_HOSTS="$IP1:1,1 $IP2:1,1 $IP3:1,1 $IP7:2,1 $IP8:2,1 $IP9:2,1" # Default is postgres PG_PWD=postgres PG_MASTER=$IP6 PG_STANDBY=$IP12 SKIP_SMTP=n SMTPHOST=smtp.example.com SMTPUSER=smtp@example.com # omit for no username SMTPPASSWORD=smtppwd # omit for no password SMTPSSL=n SMTPPORT=25 SMTPMAILFROM="My Company <myco@company.com>" |
# Datacenter 2 IP1=IPorDNSnameOfNode1 IP2=IPorDNSnameOfNode2 IP3=IPorDNSnameOfNode3 IP6=IPorDNSnameOfNode6 IP7=IPorDNSnameOfNode7 IP8=IPorDNSnameOfNode8 IP9=IPorDNSnameOfNode9 IP12=IPorDNSnameOfNode12 HOSTIP=$(hostname -i) MSIP=$IP7 ADMIN_EMAIL=opdk@google.com APIGEE_ADMINPW=Secret123 LICENSE_FILE=/tmp/license.txt USE_LDAP_REMOTE_HOST=n LDAP_TYPE=2 LDAP_SID=2 LDAP_PEER=$IP1 APIGEE_LDAPPW=secret BIND_ON_ALL_INTERFACES=y MP_POD=gateway-2 REGION=dc-2 ZK_HOSTS="$IP1 $IP2 $IP3 $IP7 $IP8 $IP9:observer" ZK_CLIENT_HOSTS="$IP7 $IP8 $IP9" # Must use IP addresses for CASS_HOSTS, not DNS names. CASS_HOSTS="$IP7:2,1 $IP8:2,1 $IP9:2,1 $IP1:1,1 $IP2:1,1 $IP3:1,1" # Default is postgres PG_PWD=postgres PG_MASTER=$IP6 PG_STANDBY=$IP12 SKIP_SMTP=n SMTPHOST=smtp.example.com SMTPUSER=smtp@example.com # omit for no username SMTPPASSWORD=smtppwd # omit for no password SMTPSSL=n SMTPPORT=25 SMTPMAILFROM="My Company <myco@company.com>" |