このドキュメントでは、既存の Edge for Private Cloud 環境に 3 つの新しい Cassandra ノードを追加する方法について説明します。
既存の Edge 環境には 1 つまたは 2 つの Cassandra ノードを追加できますが、Apigee では一度に 3 つのノードを追加することをおすすめします。
Cassandra ノードのシステム要件については、インストール要件をご覧ください。
既存の Edge の構成
本番環境システムでサポートされているすべての Edge トポロジでは、3 つの Cassandra ノードを使用するように指定されています。以下に示すように、3 つのノードが構成ファイルの CASS_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" # Must use IP addresses for CASS_HOSTS, not DNS names. CASS_HOSTS="$IP1:1,1 $IP2:1,1 $IP3:1,1" SKIP_SMTP=n SMTPHOST=smtp.example.com SMTPUSER=smtp@example.com SMTPPASSWORD=smtppwd
REGION
プロパティでリージョン名を "dc-1" として指定しています。この情報は、新しい Cassandra ノードを追加する際に必要になります。
構成ファイルを変更して、3 つの新しい Cassandra ノードを追加する
この例では、3 つの新しい Cassandra ノードは次の 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 CASS_HOSTS to add each new node after an existing nodes. # Must use IP addresses for CASS_HOSTS, not DNS names. CASS_HOSTS="$IP1:1,1 $IP14:1,1 $IP2:1,1 $IP15:1,1 $IP3:1,1 $IP16:1,1"
これにより、既存のノードでは初期トークン設定が維持され、新しいノードの初期トークンは既存のノードのトークン値の間になります。
Edge の構成
構成ファイルを編集したら、以下を行う必要があります。
- 既存の Cassandra ノードを再構成する
- 新しいノードに Cassandra をインストールする
- Management Server を再構成する
既存の Cassandra ノードを再構成する
既存の Cassandra ノードで次の操作を行います。
- 「-p c」プロファイルと新しい構成ファイルを指定して setup.sh を再実行します。
/opt/apigee/apigee-setup/bin/setup.sh -p c -f updatedConfigFile
新しいノードに Cassandra をインストールする
新しいノードに Cassandra をインストールする手順は次のとおりです。
新しい Cassandra ノードごとに、次の操作を行います。
- 3 つのノードに Cassandra をインストールします。
- Edge apigee-setup ユーティリティのインストールの説明に従って、最初のノードに
apigee-setup
をインストールします。 - 更新された構成ファイルを使用して、最初のノードに Cassandra をインストールします。
/opt/apigee/apigee-setup/bin/setup.sh -p c -f updatedConfigFile
- 残りの新しい Cassandra ノードに、この 2 つの手順を繰り返します。
- Edge apigee-setup ユーティリティのインストールの説明に従って、最初のノードに
- 3 つの新しい Cassandra ノードを再ビルドします。その際、ノードを追加するデータセンターのリージョン名を指定します(
dc-1
、dc-2
など)。この例ではdc-1
です。- 最初のノードで、
/opt/apigee/apigee-cassandra/bin/nodetool [-u username -pw password] -h nodeIP rebuild dc-1
を実行します。ここで、nodeIP は Cassandra ノードの IP アドレスです。
ユーザー名とパスワードを渡す必要があるのは、Cassandra に対して JMX 認証を有効にした場合のみです。
- 残りの新しい Cassandra ノードでこの手順を繰り返します。
- 最初のノードで、
Management Server を再構成する
Management-Server ノードの場合
- setup.sh を再実行し、新しく追加した Cassandra ノード用に Management Server を更新します。
/opt/apigee/apigee-setup/bin/setup.sh -p ms -f updatedConfigFile
すべての Router と Message Processor を再起動します。
- すべてのルーター:
/opt/apigee/apigee-service/bin/apigee-service edge-router restart
- すべての Message Processor で次のコマンドを実行します。
/opt/apigee/apigee-service/bin/apigee-service edge-message-processor restart
既存の Cassandra ノードのディスク スペースを解放する
新しいノードを追加した後、既存のノードで nodetool cleanup
コマンドを使用してディスク スペースを解放できます。このコマンドは、既存の Cassandra ノードによって所有されなくなった構成トークンをクリアします。
新しいノードを追加した後に既存の Cassandra ノードのディスク スペースを解放するには、次のコマンドを実行します。
/opt/apigee/apigee-cassandra/bin/nodetool [-u username -pw password] -h cassandraIP cleanup
ユーザー名とパスワードを渡す必要があるのは、Cassandra に対して JMX 認証を有効にした場合のみです。
再ビルドを検証する
次のコマンドを使用して、再ビルドが成功したことを確認します。
nodetool [-u username -pw password] -h nodeIP netstats
ノードが稼働してインデックスがビルドされたら、このコマンドは MODE: Normal
を示します。
nodetool [-u username -pw password] -h nodeIP statusthrift
Thrift サーバーが実行中であることを示す必要があります。これにより、Cassandra は新しいクライアント リクエストを受け入れることができます。
nodetool [-u username -pw password] -h nodeIP statusbinary
ネイティブ トランスポート(またはバイナリ プロトコル)が実行中であることを示す。
nodetool [-u username -pw password] -h nodeIP describecluster
新しいノードが古いノードと同じスキーマ バージョンを使用していることを示します。
nodetool
の使用方法については、nodetool の使用に関するドキュメントをご覧ください。