Edge for Private Cloud バージョン 4.16.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」ユーザーからアクセス可能で、読み取り可能である必要があります。たとえば、このファイルをノード上の /tmp ディレクトリに格納します。
たとえば、Edge Management Server をインストールするには、次のコマンドを実行します。
> /opt/apigee/apigee-setup/bin/setup.sh -p ms -f /tmp/myConfig
インストールに関する考慮事項
構成ファイルを作成する際には、次のオプションを考慮してください。
Postgres のマスター / スタンバイ レプリケーションの設定
デフォルトでは、すべての Postgres ノードがマスターモードでインストールされます。ただし、複数の Postgres ノードがある本番環境システムでは、マスター / スタンバイ レプリケーションを使用するように構成し、マスターノードに障害が発生しても、スタンバイ ノードがトラフィックの処理を続行できるようにする必要があります。
インストール時にマスター / スタンバイ レプリケーションを有効にして構成するには、サイレント構成ファイルのプロパティを使用します。インストール後にマスター / スタンバイ レプリケーションを有効にすることもできます。詳細については、Postgres のマスター / スタンバイ レプリケーションを設定するをご覧ください。
Cassandra 認証の有効化
デフォルトでは、Cassandra は認証を有効にせずにインストールされます。つまり、誰でも Cassandra にアクセスできます。Edge のインストール後、またはインストール プロセスの一環として、認証を有効にできます。
インストール時に Cassandra 認証を有効にするには、サイレント構成ファイルのプロパティを使用します。インストール後に有効にすることもできます。
詳細については、Cassandra 認証を有効にするをご覧ください。
保護されたポートに Router をバインドする
保護されたポート(例: 1024 未満のポート番号)に Router をバインドする場合は、それらのポートへのアクセス権を持つユーザーとして動作するように Router を構成する必要があります。デフォルトでは、Router は特権ポートへのアクセス権がないユーザー「apigee」として実行されます。
Router を別のユーザーとして実行するには:
- root として、ファイル /opt/apigee/etc/edge-router.d/RUN_USER.sh を作成します。
- 次のエントリをファイルに追加します。
RUN_USER=root
Router を root として実行しない場合は、ポートにアクセスできるユーザーを指定します。 - ファイルを保存します。
- root 以外のユーザーを指定した場合は、ファイルのオーナーをそのユーザーに変更します。
> chown USER:USER /opt/apigee/etc/edge-router.d/RUN_USER.sh - ルーターを再起動します。
> /opt/apigee/apigee-service/bin/apigee-service edge-router restart
インストールするコンポーネントの指定
次の表に、ノードにインストールするコンポーネントを指定するために 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 のみをインストールします。 |
サックス |
分析コンポーネント、つまり Qpid と Postgres をインストールします。 このオプションは開発とテストにのみ使用し、本番環境では使用できません。 |
5 割 |
Monetization をインストールします。 |
sa |
Edge スタンドアロン(Cassandra、ZooKeeper、Management Server、OpenLDAP、Edge UI、Router、Message Processor)をインストールします。このオプションでは、Edge Analytics コンポーネント(Qpid と Postgres)が省略されます。 このオプションは開発とテストにのみ使用し、本番環境では使用できません。 |
Aio |
すべてのコンポーネントを単一のノードにインストールします。 このオプションは開発とテストにのみ使用し、本番環境では使用できません。 |
構成ファイルの作成
構成ファイルには、Edge のインストールに必要な情報がすべて含まれています。多くの場合、同じ構成ファイルを使用して Edge 環境のすべてのコンポーネントをインストールできます。
ただし、次の場合は、別の構成ファイルを使用するか、構成ファイルを変更する必要があります。
- 複数の OpenLDAP サーバーをインストールし、13 ノード構成でレプリケーションを構成する必要がある場合。ファイルごとに、LDAP_SID と LDAP_PEER に異なる値が必要です。
- 12 ノード構成で複数のデータセンターを作成しています。データセンターごとに、ZK_CLIENT_HOSTS や CASS_HOSTS などのプロパティに異なる設定が必要です。
例: 構成ファイル
以下に、9 ノードの Edge インストールにおける完全なサイレント構成ファイルの例を示します。このファイルを必要に応じて編集してください。このファイルをインクルードするには、setup.sh の -f オプションを使用します。また、各 Edge トポロジの構成ファイルの例を以下に示します。
# IP address or DNS name of nodes. IP1=192.168.1.1 # Management Server, OpenLDAP, UI, ZooKeeper, Cassandra IP2=192.168.1.2 # ZooKeeper, Cassandra IP3=192.168.1.3 # ZooKeeper, Cassandra IP4=192.168.1.4 # Router, Message Processor IP5=192.168.1.5 # Router, Message Processor IP6=192.168.1.6 # Qpid IP7=192.168.1.7 # Qpid IP8=192.168.1.8 # Postgres IP9=192.168.1.9 # Postgres # Must resolve to IP address or DNS name of host - not to 127.0.0.1 or localhost. HOSTIP=$(hostname -i) # Set Edge sys admin credentials. ADMIN_EMAIL=your@email.com APIGEE_ADMINPW=yourPassword # If omitted, you are prompted for it. # Location of Edge license file. LICENSE_FILE=/tmp/license.txt # Management Server information. MSIP=$IP1 # IP or DNS name of Management Server node. # Specify the port the Management Server listens on for API calls. # APIGEE_PORT_HTTP_MS=8080 # Default is 8080. # # OpenLDAP information. # # Set to y if you are connecting to a remote LDAP server. # If n, Edge installs OpenLDAP when it installs the Management Server. USE_LDAP_REMOTE_HOST=n # If connecting to remote OpenLDAP server, specify the IP/DNS name and port. # LDAP_HOST=$IP1 # IP or DNS name of OpenLDAP node. # LDAP_PORT=10389 # Default is 10389. APIGEE_LDAPPW=yourLdapPassword # Specify OpenLDAP without replication, 1, or with replication, 2. LDAP_TYPE=1 # Set only if using replication. # LDAP_SID=1 # Unique ID for this LDAP server. # LDAP_PEER= # IP or DNS name of LDAP peer. BIND_ON_ALL_INTERFACES=y # The Message Processor and Router pod. MP_POD=gateway # The name of the region, corresponding to the data center name. REGION=dc-1 # Use dc-1 unless installing in a # multi-data center environment. # ZooKeeper information. # See table below if installing in a multi-data center environment. ZK_HOSTS="$IP1 $IP2 $IP3" # IP/DNS names of all ZooKeeper nodes. ZK_CLIENT_HOSTS="$IP1 $IP2 $IP3" # IP/DNS names of all ZooKeeper nodes. # Cassandra information. CASS_CLUSTERNAME=Apigee # Default name is Apigee. # IP addresses of the Cassandra hosts separated by spaces. CASS_HOSTS="$IP1:1,1 $IP2:1,1 $IP3:1,1" # Set to enable Cassandra authentication. # CASS_AUTH=y # The default value is n. # Cassandra uname/pword required if you enabled Cassandra authentication. # CASS_USERNAME= # CASS_PASSWORD= # Use to enable Postgres master-standby replication # when you have multiple Postgres nodes. # PG_MASTER=IPorDNSofNewMaster # PG_STANDBY=IPorDNSofOldMaster # SMTP information. SKIP_SMTP=n # Skip now and configure later by specifying "y". SMTPHOST=smtp.gmail.com SMTPUSER=your@email.com SMTPPASSWORD=yourEmailPassword SMTPSSL=y SMTPPORT=465 # If no SSL, use a different port, such as 25.
次の表に、これらのプロパティに関する追加情報を示します。
プロパティ |
注 |
---|---|
IP/DNS 名 |
ノードの IP アドレスを指定するときは、127.0.0.1 にマッピングされたホスト名または 127.0.0.1 の IP アドレスを使用しないでください。 |
ADMIN_EMAIL |
システム管理者のパスワードは 8 文字以上で、大文字、小文字、数字、特殊文字を 1 文字含める必要があります。パスワードを省略すると、パスワードの入力を求められます。 |
LICENSE_FILE |
ライセンス ファイルの場所。「apigee」ユーザーがアクセスできる必要があります。 たとえば、/tmp ディレクトリに保存し、そのファイルに chmod 777 を指定します。このファイルは Edge インストール ディレクトリにコピーされます。 |
USE_LDAP_REMOTE_HOST |
USE_LDAP_REMOTE_HOST が n の場合、Edge は Management Server のインストール時に OpenLDAP を自動的にインストールします。 リモート LDAP サーバーに接続する場合は、USE_LDAP_REMOTE_HOST を y に設定します。OpenLDAP は Management Server とともにインストールされていません。 リモートの OpenLDAP サーバーに接続する場合は、LDAP_HOST |
LDAP_TYPE |
レプリケーションのない OpenLDAP の場合は、LDAP_TYPE=1 を設定します。LDAP_TYPE=2 は、レプリケーションありの OpenLDAP に対応します。 Edge トポロジで単一の OpenLDAP サーバーを使用する場合は、1 を指定します。13 ノードの本番環境のように、Edge で複数の OpenLDAP ノードを使用する場合は 2 を指定します。 レプリケーションを有効にする場合は、次のプロパティを設定します。
|
BIND_ON_ALL_INTERFACES |
「y」に設定すると、Router/Message Processor はすべてのインターフェース(IP)でバインド(リッスン)されます。「n」に設定すると、Router/Message Processor は、「hostname -i」コマンドで返される IP を特定のインターフェース上でバインド(リッスン)します。 |
MP_POD |
Message Processor と Router のポッドの名前を指定します。デフォルトの名前は gateway です。 |
地域 |
リージョン名。慣例として、名前は通常 dc-# の形式にします。# は整数値に対応します。たとえば、dc-1、dc-2 などです。マルチデータセンター環境にインストールしない限り、dc-1 を使用できます。 複数のデータセンターが設置されている場合、設置するデータセンターに応じて値は dc-1 や dc-2 などになります。ただし、dc-# の形式の名前のみを使用できます。リージョンには任意の名前を使用できます。 |
ZK_HOSTS |
ZooKeeper ノードの IP アドレスまたは DNS 名。すべての ZooKeeper ノードで同じ順序で IP アドレスまたは DNS 名をリストする必要があります。 マルチデータセンター環境では、両方のデータセンターのすべての ZooKeeper ノードを一覧表示します。 12 ホスト構成で説明されているように、複数のデータセンターを作成する場合にのみ、ZooKeeper ノードに「:observer」修飾子を指定します。単一のデータセンター インストールでは、この修飾子は省略します。詳細については、12 ホスト クラスタ インストールをご覧ください。 |
ZK_CLIENT_HOSTS |
このデータセンターで使用される ZooKeeper ノードの IP アドレスまたは DNS 名。すべての ZooKeeper ノードで同じ順序で IP アドレスまたは DNS 名をリストする必要があります。 単一のデータセンター インストールでは、これらは ZK_HOSTS で指定されたノードと同じノードになります。 マルチデータセンター環境では、このデータセンター内の ZooKeeper ノードのみを列挙します。詳細については、12 ホスト クラスタ インストールをご覧ください。 |
CASS_HOSTS |
Cassandra ノードの IP アドレス(DNS 名ではありません)。最初の 2 つのノードがシードサーバーとして使用されます。すべての Cassandra ノードで、IP アドレスを同じ順序で指定する必要があります。 Cassandra ノードには、オプションで Cassandra ノードのデータセンターとラックを指定する「:dc,ra」という接尾辞を付けることができます。この修飾子は、12 ホスト構成で説明しているように、複数のデータセンターを作成する場合にのみ指定します。単一のデータセンター インストールでは、この修飾子は省略します。 たとえば、192.168.124.201:1,1 はデータセンター 1 とラック/アベイラビリティ ゾーン 1、'192.168.124.204:2,1 はデータセンター 2 とラック/アベイラビリティ ゾーン 1 です。 マルチデータセンター環境でファイアウォールの問題を解決するためには、上記の例のように、現在のデータセンターのノードが先頭に配置されるような CASS_HOSTS を順番に並べる必要があります。詳細については、12 ホスト クラスタ インストールをご覧ください。 |
CASS_AUTH CASS_PASSWORD |
Cassandra 認証(CASS_AUTH=y)を有効にする場合、これらのプロパティを使用して、Cassandra のユーザー名とパスワードを渡すことができます。 |
PG_MASTER PG_STANDBY |
次の形式で Postgres のマスター / スタンバイ レプリケーションを有効にするように設定します。 PG_MASTER=IPorDNSofNewMasterIPorDNSofNewMaster PG_STANDBY=IPorDNSofOldMasterIPorDNSofOldMaster |
SKIP_SMTP |
SMTP を構成して、紛失したパスワードやその他の通知に関するメールを Edge が送信できるようにします。 SMTP ユーザー認証情報が不要な場合は、SMTPUSER と SMTPPASSWORD を省略します。 |
コンポーネントのインストール順序
コンポーネントのインストール順序は、必要なトポロジに基づきます。
以下に示すインストール例はすべて、以下をインストールしていることを前提としています。
- Cassandra 認証を無効にした場合(デフォルト)。詳細については、Cassandra 認証を有効にするをご覧ください。
- Postgres のマスター / スタンバイ レプリケーションが無効になっている(デフォルト)。詳細については、Postgres のマスター / スタンバイ レプリケーションを設定するをご覧ください。
- Message Processor と Router を同じノードに配置します。Message Processor と Router を別々のノードにインストールする場合は、まずすべての Message Processor をインストールし、次にすべての Router をインストールします。
インストール ログファイル
デフォルトでは、setup.sh ユーティリティはインストールに関するログ情報を次の場所に書き込みます。
/opt/apigee/var/log/apigee-setup/setup.log
setup.sh ユーティリティを実行しているユーザーがこのディレクトリにアクセスできない場合は、ログを setup_username.log という名前のファイルとして /tmp ディレクトリに書き込みます。
ユーザーに /tmp へのアクセス権がない場合、setup.sh ユーティリティは失敗します。
オールインワン設置
- 次のコマンドを使用して、すべてのコンポーネントを単一ノードにインストールします。
> /opt/apigee/apigee-setup/bin/setup.sh -p aio -f configFile - /opt/nginx/conf.d 内のファイルをすべて削除します。
> rm -f /opt/nginx/conf.d/* - Edge Router を再起動します。
> /<inst_root>/apigee/apigee-service/bin/apigee-service edge-router restart - インストールをテストするの説明に沿ってインストールをテストします。
- 組織のオンボーディングの説明に従って、組織をオンボーディングします。
次の図は、このトポロジのサイレント構成ファイルを示しています。
# With SMTP IP1=IPorDNSnameOfNode HOSTIP=$(hostname -i) ADMIN_EMAIL=opdk@apigee.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" 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
2 ホストのスタンドアロン インストール
Edge トポロジとノード番号のリストについては、インストール トポロジをご覧ください。
- スタンドアロン ゲートウェイとノード 1 をインストールします
> /opt/apigee/apigee-setup/bin/setup.sh -p sa -f configFile - ノード 1 で次の操作を行います。
- /opt/nginx/conf.d 内のファイルをすべて削除します。
> rm -f /opt/nginx/conf.d/* - Edge Router を再起動します。
> /<inst_root>/apigee/apigee-service/bin/apigee-service edge-router restart
- /opt/nginx/conf.d 内のファイルをすべて削除します。
- ノード 2 に Analytics をインストールします。
> /opt/apigee/apigee-setup/bin/setup.sh -p sax -f configFile - インストールをテストするの説明に沿ってインストールをテストします。
- 組織のオンボーディングの説明に従って、組織をオンボーディングします。
次の図は、このトポロジのサイレント構成ファイルを示しています。
# With SMTP IP1=IPorDNSnameOfNode1 HOSTIP=$(hostname -i) ADMIN_EMAIL=opdk@apigee.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" 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
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 - /opt/nginx/conf.d 内のファイルをすべて削除します。
> rm -f /opt/nginx/conf.d/* - Edge Router を再起動します。
> /<inst_root>/apigee/apigee-service/bin/apigee-service edge-router restart
- Router と Message Processor をインストールします。
- ノード 4 と 5 に Analytics をインストールします。
> /opt/apigee/apigee-setup/bin/setup.sh -p sax -f configFile - インストールをテストするの説明に沿ってインストールをテストします。
- 組織のオンボーディングの説明に従って、組織をオンボーディングします。
次の図は、このトポロジのサイレント構成ファイルを示しています。
# With SMTP IP1=IPorDNSnameOfNode1 IP2=IPorDNSnameOfNode2 IP3=IPorDNSnameOfNode3 IP4=IPorDNSnameOfNode4 IP5=IPorDNSnameOfNode5 HOSTIP=$(hostname -i) ADMIN_EMAIL=opdk@apigee.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" 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
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 - /opt/nginx/conf.d 内のファイルをすべて削除します。
> rm -f /opt/nginx/conf.d/* - Edge Router を再起動します。
> /<inst_root>/apigee/apigee-service/bin/apigee-service edge-router restart
- Router と Message Processor をインストールします。
- 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 - インストールをテストするの説明に沿ってインストールをテストします。
- 組織のオンボーディングの説明に従って、組織をオンボーディングします。
次の図は、このトポロジのサイレント構成ファイルを示しています。
# With SMTP IP1=IPorDNSnameOfNode1 IP2=IPorDNSnameOfNode2 IP3=IPorDNSnameOfNode3 IP8=IPorDNSnameOfNode8 IP9=IPorDNSnameOfNode9 HOSTIP=$(hostname -i) ADMIN_EMAIL=opdk@apigee.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" 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
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 - /opt/nginx/conf.d 内のファイルをすべて削除します。
> rm -f /opt/nginx/conf.d/* - Edge Router を再起動します。
> /<inst_root>/apigee/apigee-service/bin/apigee-service edge-router restart
- Router と Message Processor をインストールします。
- ノード 12 と 13 に Apigee Analytics Qpid Server をインストールします。
> /opt/apigee/apigee-setup/bin/setup.sh -p qs -f configFile - インストールをテストするの説明に沿ってインストールをテストします。
- 組織のオンボーディングの説明に従って、組織をオンボーディングします。
次の図は、このトポロジのサイレント構成ファイルを示しています。
# 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@apigee.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" 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 |
# 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@apigee.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 use data.center.2, 192.168.12」
このデプロイモデルで、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 - /opt/nginx/conf.d 内のファイルをすべて削除します。
> rm -f /opt/nginx/conf.d/* - Edge Router を再起動します。
> /<inst_root>/apigee/apigee-service/bin/apigee-service edge-router restart
- Router と Message Processor をインストールします。
- 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 - インストールをテストするの説明に沿ってインストールをテストします。
- 組織のオンボーディングの説明に従って、組織をオンボーディングします。
次の図は、このトポロジのサイレント構成ファイルを示しています。この構成ファイルに留意してください。
- 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@apigee.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" 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 |
# 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@apigee.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" 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 |