このドキュメントでは、既存の Edge for Private Cloud インストールに 3 つの新しい ZooKeeper ノードを追加する方法について説明します。
既存の Edge インストールに 1 つまたは 2 つの ZooKeeper ノードを追加できます。ただし、以下で説明するように、ZooKeeper ボーターノードの数は常に奇数にする必要があります。
既存の Edge 構成
本番環境システムでサポートされているすべての Edge トポロジでは、3 つの ZooKeeper ノードを使用するように指定されています。以下に示すように、3 つのノードが構成ファイルの ZK_HOSTS プロパティと ZK_CLIENT_HOSTS プロパティに指定されています。
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 名を指定します。IP アドレスまたは DNS 名は、すべての ZooKeeper ノードで同じ順序でリストする必要があります。マルチデータセンター環境では、両方のデータセンターのすべての ZooKeeper ノードを一覧表示します。ZK_CLIENT_HOSTSには、このデータセンターで使用される ZooKeeper ノードの IP アドレスまたは DNS 名を指定します。IP アドレスまたは DNS 名は、すべての ZooKeeper ノードで同じ順序でリストする必要があります。単一のデータセンターのインストールでは、これらは
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 ノードで、次の操作を行います。
- 新しい構成ファイルを使用して、設定コマンドを再実行します。
/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 つのノードがリーダー、残りのノードがフォロワーとして指定されている必要があります。