このドキュメントでは、既存の Edge for Private Cloud インストール環境に 3 つの新しい ZooKeeper ノードを追加する方法について説明します。
既存の Edge インストールには 1 つまたは 2 つの ZooKeeper ノードを追加できますが、ただし、以下で説明するように、ZooKeeper ボーターノードは常に奇数にする必要があります。
既存の Edge の構成
本番環境システムでサポートされるすべての Edge トポロジでは、3 つの ZooKeeper ノードを使用するように指定します。以下のように、構成ファイルの ZK_HOSTS
プロパティと ZK_CLIENT_HOSTS
プロパティに 3 つのノードを指定します。
IP1=10.10.0.1 IP2=10.10.0.2 IP3=10.10.0.3 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 MP_POD=gateway REGION=dc-1 ZK_HOSTS="$IP1 $IP2 $IP3" ZK_CLIENT_HOSTS="$IP1 $IP2 $IP3" CASS_HOSTS="$IP1:1,1 $IP2:1,1 $IP3:1,1" SKIP_SMTP=n SMTPHOST=smtp.example.com SMTPUSER=smtp@example.com SMTPPASSWORD=smtppwd
ここで
ZK_HOSTS
には、ZooKeeper ノードの IP アドレスまたは DNS 名を指定します。すべての ZooKeeper ノードで同じ順序で IP アドレスまたは DNS 名をリストする必要があります。マルチデータセンター環境では、両方のデータセンターのすべての ZooKeeper ノードをリストします。ZK_CLIENT_HOSTS
には、このデータセンターで使用される ZooKeeper ノードの IP アドレスまたは DNS 名を指定します。すべての ZooKeeper ノードで同じ順序で IP アドレスまたは DNS 名をリストする必要があります。単一のデータセンター インストールでは、これらは
ZK_HOSTS
で指定されたノードと同じです。マルチデータセンター環境では、このデータセンター内の ZooKeeper ノードのみを列挙します。
構成ファイルを変更して 3 つの新しい ZooKeeper ノードを追加する
この例では、3 つの新しい ZooKeeper ノードは次の IP アドレスにあります。
- 10.10.0.14
- 10.10.0.15
- 10.10.0.16
まず、Edge 構成ファイルを更新して、新しいノードを追加する必要があります。
IP1=10.10.0.1 IP2=10.10.0.2 IP3=10.10.0.3 # Add the new node IP addresses. IP14=10.10.0.14 IP15=10.10.0.15 IP16=10.10.0.16 HOSTIP=$(hostname -i) ADMIN_EMAIL=opdk@google.com ... # Update ZK_HOSTS to add each new node after an existing nodes. ZK_HOSTS="$IP1 $IP2 $IP3 $IP14 $IP15 $IP16:observer" # Update ZK_Client_HOSTS to add each new node after an existing nodes. ZK_CLIENT_HOSTS="$IP1 $IP2 $IP3 $IP14 $IP15 $IP16"
ZK_HOSTS
の最後のノードを :observer
修飾子でマークします。:observer
修飾子が付かないノードは「ボーター」と呼ばれます。構成の「ボーター」の数は奇数である必要があります。したがって、この構成では、5 つの ZooKeeper ボーターと 1 つのオブザーバーがあります。
ZK_HOSTS
と ZK_CLIENT_HOSTS
の両方に同じ順序でノードを追加するようにしてください。ただし、ZK_CLIENT_HOSTS
を設定するときは、:observer
修飾子は省略してください。
Edge の構成
構成ファイルを編集したら、次のタスクをすべて行う必要があります。
新しいノードに ZooKeeper をインストールする
- Edge apigee-setup ユーティリティのインストールの説明に従って、最初のノードに
apigee-setup
をインストールします。 - 次のコマンドを使用して、最初のノードに ZooKeeper をインストールします。
/opt/apigee/apigee-service/bin/apigee-service apigee-zookeeper install
/opt/apigee/apigee-service/bin/apigee-service apigee-zookeeper setup -f updatedConfigFile
- 残りの新しい ZooKeeper ノードに手順 1 と 2 を繰り返します。
既存の ZooKeeper ノードを再構成する
既存の ZooKeeper ノード:
- 新しい構成ファイルで setup コマンドを再実行します。
/opt/apigee/apigee-service/bin/apigee-service apigee-zookeeper setup -f updatedConfigFile
すべての Zookeeper ノードを再起動します。
すべての ZooKeeper ノード:
- ノードを再起動します。
/opt/apigee/apigee-service/bin/apigee-service apigee-zookeeper restart
すべての ZooKeeper ノードを再起動する必要がありますが、再起動の順序は重要ではありません。
Management Server ノードを再構成する
Management Server ノードで、次の操作を行います。
- 設定コマンドを実行します。
/opt/apigee/apigee-service/bin/apigee-service edge-management-server setup -f updatedConfigFile
- Management Server を再起動します。
/opt/apigee/apigee-service/bin/apigee-service edge-management-server restart
すべての Router を再構成する
すべての Router ノードで、次のコマンドを実行します。
- 設定コマンドを実行します。
/opt/apigee/apigee-service/bin/apigee-service edge-router setup -f updatedConfigFile
- Router を再起動します。
/opt/apigee/apigee-service/bin/apigee-service edge-router restart
すべての Message Processor を再構成する
すべての Message Processor ノード:
- 設定コマンドを実行します。
/opt/apigee/apigee-service/bin/apigee-service edge-message-processor setup -f updatedConfigFile
- Message Processor を再起動します。
/opt/apigee/apigee-service/bin/apigee-service edge-message-processor restart
すべての Qpid ノードを再構成する
すべての Qpid ノードで、次の操作を行います。
- 設定コマンドを実行します。
/opt/apigee/apigee-service/bin/apigee-service edge-qpid-server setup -f updatedConfigFile
- Qpid を再起動します。
/opt/apigee/apigee-service/bin/apigee-service edge-qpid-server restart
すべての Postgres ノードを再構成する
すべての Postgres ノードの場合:
- 設定コマンドを実行します。
/opt/apigee/apigee-service/bin/apigee-service edge-postgres-server setup -f updatedConfigFile
- Postgres を再起動します。
/opt/apigee/apigee-service/bin/apigee-service edge-postgres-server restart
インストールを検証する
新しい ZooKeeper ノードのインストールを検証するには、netcat(nc)または telnet を使用してポート 2181 にコマンドを送信します。ZooKeeper コマンドの詳細については、http://zookeeper.apache.org/doc/r3.1.2/zookeeperAdmin.html#sc_zkCommands をご覧ください。
検証方法は次のとおりです。
- ZooKeeper ノードにインストールされていない場合は、nc をインストールします。
sudo yum install nc
- nc コマンドを実行します。
echo stat | nc localhost 2181
- 各 ZooKeeper ノードで手順 1 と 2 を繰り返します。各ノードの出力の
Mode
行で、1 つのノードがオブザーバー、1 つのノードがリーダー、残りのノードがフォロワーとして指定されます。