Apigee サーバーの移動

あるマシンから別のマシンにコンポーネントを移動する場合、コンポーネント構成ファイル内の IP アドレスを同期させないと、構成の不一致につながる可能性があります。

このセクションでは、構成の不一致を診断して修正する方法について説明します。

IP アドレスとホスト名

コンポーネント構成ファイルでは、ホスト名ではなく IP アドレスを使用してください。

一部のコンポーネント構成ファイルでは、構成ファイルの代わりに ホスト名を使用すると、トラブルシューティングが複雑になる場合があります。たとえば、ホスト名が原因で DNS サーバーの接続の問題、検索（ルックアップ）の失敗、同期に関連する問題が発生することがあります。

そのため、すべてのコンポーネントに IP アドレスを使用することを強くおすすめします。 できます。Cassandra など一部のケースでは、IP アドレスの使用が必須で、 できます。このドキュメントのほとんどの例では、コンポーネント構成に IP アドレスを使用しています。

ホスト名と IP アドレスについては、次のシナリオの影響を考慮してください。 Apigee サーバーを移動する場合:

シナリオ 移動サーバーへの影響
IP アドレスを変更する 元の IP アドレスを参照するすべての関連ファイルを更新する
ホスト名を変更し、IP アドレスは変更しない 影響なし
ホスト名と IP アドレスの両方を変更する IP アドレスを変更する場合と同じ

Cassandra ノードの IP アドレスの変更

Cassandra ノードの IP アドレスを変更するには、次の操作を行います。

対象 単一の Cassandra ノードを持つ構成

  1. /opt/apigee/customer/application/cassandra.propertiesを編集 記録します。ファイルが存在しない場合は作成します。
  2. 次のパラメータを変更します。
    • conf_cassandra_seeds と conf_cassandra_listen_address を設定する パラメータを使用して、システムの新しい IP アドレスを指定します。
    • 次のように conf_cassandra_rpc_address を変更する 新しい IP アドレスまたは 0.0.0.0（Cassandra Thrift がすべての インターフェースなど）が含まれます。
  3. /opt/apigee/apigee-cassandra/conf/cassandra-topology.properties をエディタで開きます。古い IP アドレスとデフォルト設定がフォームに表示されます。 
    192.168.56.101=dc-1:ra-1
default=dc-1:ra-1

    その情報を保存します。

  4. /opt/apigee/customer/application/cassandra.propertiesを編集 指定した古い IP アドレスを新しい IP アドレスに変更するには: 
    conf_cassandra-topology_topology=192.168.56.103=dc-1:ra-1\ndefault=dc-1:ra-1\n

    必ず「\n」を挿入してくださいの後に IP アドレスを追加し、先ほどと同じデフォルト設定を指定します。 確認します

  5. Cassandra を再起動します。 
    /opt/apigee/apigee-service/bin/apigee-service apigee-cassandra restart
  6. 必要に応じて ZooKeeper（以下を参照）も修復し、必要に応じてすべての Apigee プラットフォームを再起動します。 説明します。

複数の Cassandra ノード（リング）を使用する構成の場合

  1. 変更するノードがシードノードの場合は、/opt/apigee/customer/application/cassandra.properties を編集します。 リングの各システムでファイルを作成し、conf_cassandra_seeds パラメータを 変更したシステムの新しい IP アドレスが 送信されますcassandra.properties ファイルが存在しない場合は、 できます。
  2. /opt/apigee/customer/application/cassandra.propertiesを編集 次のパラメータを変更します: <ph type="x-smartling-placeholder">
      </ph>
    • 新しい IP アドレスを使用するように conf_cassandra_listen_address を設定します。
    • 新しい IP アドレスまたは「0.0.0.0」を使用するように conf_cassandra_rpc_address を設定します。 （これにより、Cassandra Thrift はすべてのインターフェースでリッスンできます）。
  3. /opt/apigee/apigee-cassandra/conf/cassandra-topology.properties をエディタで開きます。すべての Cassandra IP アドレスとデフォルト設定が フォーム: 
    192.168.56.101=dc-1:ra-1
192.168.56.102=dc-1:ra-1
192.168.56.103=dc-1:ra-1
default=dc-1:ra-1

    その情報を保存します。

  4. /opt/apigee/customer/application/cassandra.propertiesを編集 指定した古い IP アドレスを新しい IP アドレスに変更するには: 
    conf_cassandra-topology_topology=192.168.56.101=dc-1:ra-1\n192.168.56.102=dc-1:ra-1\n192.168.56.104=dc-1:ra-1\ndefault=dc-1:ra-1\n

    必ず「\n」を挿入してくださいデフォルトの設定を使用します。 ステップ 3 で記録した URL を入力します。

  5. 変更したシステムで Cassandra を再起動します。変更されたシステムがシードノードの場合、 変更されたシードノードを使用した各システムを再起動します。 
    /opt/apigee/apigee-service/bin/apigee-service apigee-cassandra restart
  6. 変更したノードで nodetool ring コマンドを実行して、リングが できます。このユーティリティは /opt/apigee/apigee-cassandra/bin。 
    nodetool [-u username -pw password] -h localhost ring

    ユーザー名とパスワードを渡す必要があるのは、Cassandra で JMX 認証を有効にした場合のみです。

  7. nodetool repair を次のインスタンスに対して実行します。 表示されます。この処理には時間がかかることがあるため、 API トラフィックのピーク時には対応しないことをおすすめします。 
    nodetool [-u username -pw password] -h localhost repair -pr
  8. 必要に応じて ZooKeeper を修復し（以下を参照）、すべての Apigee プラットフォーム コンポーネントを再起動します。 Management Server から始まります。

データストアの更新 登録

  1. 次を使用して、古い IP アドレスを指定するデータストア登録の UUID を検索します。 下で説明します。[Type]に注目してください「UUID」parameters: 
    • curl -u ADMINEMAIL:PW "http://$MSIP:$port/v1/servers?pod=central&region=DC" | egrep -i '[type|internalip|uuid|region]'
    • curl -u ADMINEMAIL:PW "http://$MSIP:$port/v1/servers?pod=gateway&region=DC" | egrep -i '[type|internalip|uuid|region]'
    • curl -u ADMINEMAIL:PW "http://$MSIP:$port/v1/servers?pod=analytics&region=DC" | egrep -i '[type|internalip|uuid|region]'

      ここで、DC はデータセンター名です。単一データセンター環境では、 通常は「dc-1」です。

  2. 次のいずれかのコマンドを使用して、新しい IP アドレスを登録します。必要なコマンドは、 変更されたノードのタイプに依存します。
    • type="application-datastore" の場合: 
      curl -u ADMINEMAIL:PW "http://MSIP:port/v1/servers -d \
  "Type=application-datastore&Type=audit-datastore&InternalIP=NEWIP&region=REGION&pod=central" \
  -H 'content-type: application/x-www-form-urlencoded' -X POST
    • type="kms-datastore" の場合: 
      curl -u ADMINEMAIL:PW "http://MSIP:port/v1/servers -d \
  "Type=kms-datastore&Type=dc-datastore&Type=keyvaluemap-datastore&Type=counter-datastore&Type=cache-datastore \
  &InternalIP=NEWIP&region=REGION&pod=GATEWAY_POD" -H 'content-type: \
  application/x-www-form-urlencoded' -X POST
    • type="reportcrud-datastore" の場合: 
      curl -u ADMINEMAIL:PW "http://MSIP:port/v1/servers" -d \
  "Type=reportcrud-datastore&InternalIP=NEW_IP&region=REGION&pod=analytics" \
  -H 'content-type: application/x-www-form-urlencoded' -X POST
  3. IP アドレスがあったシステムの UUID の古い登録を削除する 変更されました。それぞれの UUID について、次の処理を行います。 
    curl -u ADMINEMAIL:PW "http://MSIP:port/v1/servers/OLD_UUID" -X DELETE

ZooKeeper ノードの IP アドレスの変更

ZooKeeper ノードの IP アドレスを変更する手順は次のとおりです。

IP アドレスを変更し、ZooKeeper アンサンブルを再起動する（複数ノードのアンサンブル構成の場合のみ）

  1. エディタで /opt/apigee/apigee-zookeeper/conf/zoo.cfg を開きます。次のように表示されます。 すべての ZooKeeper IP アドレスとデフォルト設定を次の形式で指定します。 
    server.1=192.168.56.101:2888:3888
server.2=192.168.56.102:2888:3888
server.3=192.168.56.103:2888:3888

    その情報を保存します。

  2. 各 ZooKeeper ノードで、/opt/apigee/customer/application/zookeeper.properties ファイルを編集します。 conf_zoo_quorum プロパティを正しい IP アドレスに設定します。ファイルが 作成します。 
    conf_zoo_quorum=server.1=192.168.56.101:2888:3888\nserver.2=192.168.56.102:2888:3888\nserver.3=192.168.56.104:2888:3888\n

    必ず「\n」を挿入してください各 IP アドレスの後に 1 つのエントリが 必要があります。

  3. 次のコマンドを使用して、ZooKeeper アンサンブルのリーダーを見つけます（ node は Zookeeper マシンの IP アドレスに置き換えます）。 
    echo srvr | nc node 2181

    出力の Mode 行に「leader」と表示されます。

  4. まずリーダーの ZooKeeper を再起動します。その後、IP アドレスが変更されたノードの ZooKeeper を再起動します。複数の Zookeeper ノードが IP アドレスを変更した場合は、 すべてのノードを再起動する必要があります。 
    /opt/apigee/apigee-service/bin/apigee-service apigee-zookeeper restart
  5. 上記の echo コマンドを使用して、各 ZooKeeper ノードを確認します。

構成の変更を Apigee ノードに通知する

  1. 各 Router ノードで、/opt/apigee/customer/application/router.properties ファイルを編集します。 使用します。ファイルが存在しない場合は作成します。
    • conf_zookeeper_connection.string パラメータを変更して新しい IP を含める 住所
    • 新しい IP アドレスを含めるように conf_zookeeper_zk1.host パラメータを変更します。
  2. すべての Message Processor ノードで、/opt/apigee/customer/application/message-processor.properties ファイルを編集します。 使用します。ファイルが存在しない場合は作成します。
    • conf_zookeeper_connection.string パラメータを変更して、 IP アドレス
    • conf_zookeeper_zk1.host パラメータを変更して新しい IP を含める 住所
  3. Management Server ノードで、次のように /opt/apigee/customer/application/management-server.properties ファイルを編集します。ファイルが存在しない場合は作成します。
    • conf_zookeeper_connection.string パラメータを変更して、 IP アドレス
    • conf_zookeeper_zk1.host パラメータを変更して新しい IP を含める 住所
  4. 各ノードで次のコマンドを実行して、すべての Apigee プラットフォーム コンポーネントを再起動します。 
    /opt/apigee/apigee-service/bin/apigee-all restart

LDAP サーバーの IP アドレスの変更 （OpenLDAP）

OpenLDAP ノードの IP アドレスを変更するには、次の手順を行います。

  1. Management Server ノードで、/opt/apigee/customer/application/management-server.properties ファイルを編集します。 表示されます。ファイルが存在しない場合は作成します。
  2. management-server.properties ファイルで、 conf_security_ldap.server.host パラメータを新しい IP アドレスに追加します。
  3. Management Server を再起動します。 
    /opt/apigee/apigee-service/bin/apigee-service edge-management-server restart

他の Apigee ノードの IP アドレスの変更 種類

これらのノードタイプ（Router、Message Processor、Postgres）の IP アドレスを変更する サーバー（postgresql 以外）と Qpid Server（qpidd ではない）:

  1. 次の curl コマンドを使用して、新しい内部 IP アドレスと外部 IP アドレスを登録します。 
    curl -u ADMINEMAIL:PW -X PUT \
  http://MSIP:8080/v1/servers/uuid -d ExternalIP=ip
curl -u ADMINEMAIL:PW -X PUT \
  http://$MSIP:8080/v1/servers/uuid -d InternalIP=ip

    ここで、uuid はノードの UUID です。

コンポーネントの UUID を取得する方法については、UUID の取得をご覧ください。