Apigee サーバーの移動

Edge for Private Cloud バージョン 4.16.05

Apigee コンポーネントは IP アドレスを使用して相互に通信します。マシン間でコンポーネントを移動すると、構成の不一致が発生する可能性があります。構成の不一致を修正するには、以下の関連する手順に従ってください。

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

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

Cassandra ノードが 1 つの構成の場合

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


    情報を保存します。
  4. /<inst_root>/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

    上記の IP アドレスと同じ値を指定します。\n
  5. Cassandra を再起動します。
    > /<inst_root>/apigee/apigee-service/bin/apigee-service apigee-cassandra restart
  6. 必要に応じて ZooKeeper も修復します(下記参照)。それ以外の場合は、Management Server 以降のすべての Apigee プラットフォーム コンポーネントを再起動します。

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

  1. 変更するノードがシードノードの場合は、リング内の各システムの /<inst_root>/apigee/customer/application/cassandra.properties ファイルを編集し、変更したシステムの新しい IP が含まれるように conf_cassandra_seeds パラメータを変更します。cassandra.properties ファイルが存在しない場合は作成します。
  2. 変更するシステムで /<inst_root>/apigee/customer/application/cassandra.properties を編集し、次のパラメータを変更します。
    • 新しい IP アドレスを使用するように conf_cassandra_listen_address を設定します。
    • 新しい IP アドレスまたは 0.0.0.0 を使用するように conf_cassandra_rpc_address を設定します(これにより、Cassandra Thrift がすべてのインターフェースでリッスンできます)。
  3. エディタで /<inst_root>/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
    that or-1dc-1
    default=1dc-1

  4. /<inst_root>/apigee/customer/application/cassandra.properties を編集して、古い IP アドレスを新しい IP アドレスに変更します。
    /<inst_root>/apigee/customer/application/cassandra.properties

    n192.168.56.104
  5. 変更したシステムで Cassandra を再起動します。変更したシステムがシードノードの場合は、変更したシードノードを使用していた各システムも再起動します。
    > /<inst_root>/apigee/apigee-service/bin/apigee-service apigee-cassandra restart
  6. 変更したノードで nodetool ring コマンドを実行して、リングが完了していることを確認します。このユーティリティは <inst_root>/apigee/apigee-cassandra/bin にあります。
    > nodetool -h localhost ring
  7. 変更したノードで nodetool 検索広告 を実行します。この処理には時間がかかる場合があるため、API トラフィックのピーク時には行わないことを強くおすすめします。
    > nodetool -h localhost Repair
  8. 必要に応じて ZooKeeper を修復し(以下を参照)、Management Server 以降のすべての Apigee プラットフォーム コンポーネントを再起動します。

データストアの登録の更新

  1. 次のコマンドを使用して、古い IP アドレスを指定してデータストア登録の UUID を確認します。「type」パラメータと「UUID」パラメータをメモしておきます。
    • curl -u $ADMINEMAIL:$PW "http://$MSIP:$port/v1/servers?pod=central" | egrep -i '(type|internalip|uuid|region)'
    • curl -u $ADMINEMAIL:$PW "http://$MSIP:$port/v1/servers?pod=gateway" | egrep -i '(type|internalip|uuid|region)'
    • curl -u $ADMINEMAIL:$PW "http://$MSIP:$port/v1/servers?pod=analytics" | egrep -i '(type|internalip|uuid|region)'
  2. 以下のいずれかのコマンドを使用して、新しい IP アドレスを登録します。必要なコマンドは、変更したノードのタイプによって異なります。

    : 以下の REGION パラメータは、クラスタが存在するデータセンターを指します。たとえば、高可用性を実現するには、通常 dc-1(Dater Center 1)と dc-2(データセンター 2)のクラスタを使用します。このパラメータはインストール時に定義されます。デフォルト値は dc-1 です。
    • 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 X-url
    • 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 POST_NAME}&
    • 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 X-url
  3. IP アドレスが変更されたシステムの UUID の古い登録を削除します。次の UUID ごとに次のコマンドを実行します。
    curl -u $ADMINEMAIL:$PW "http://$MSIP:$port/v1/servers/${OLD_UUID}" -X DELETE

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

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

IP アドレスを変更して ZooKeeper アンサンブルを再起動します(マルチノード アンサンブル構成の場合のみ)。

  1. エディタで /<inst_root>/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 という情報を保存します。

    その情報を保存します。
  2. 各 ZooKeeper ノードで /<inst_root>/apigee/customer/application/zookeeper.properties ファイルを編集して、conf_zoo_quorum プロパティに正しい IP アドレスを設定します。ファイルが存在しない場合は作成します。
    conf_zoo_quorum=server.1=192.168.56.101:2888:3888nserver.2=192.168.56.102:2888:3888nserver.3=192.168.56.104:2888:3888n


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

    出力の Mode 行は「leader」になります。
  4. 一方の ZooKeeper をリーダーから順に再起動し、IP アドレスを変更したノードで終了します。複数の Zookeeper ノードで IP アドレスが変更された場合は、すべてのノードを再起動する必要があります。
    > /<inst_root>/apigee/apigee-service/bin/apigee-service apigee-zookeeper restart
  5. 上記の echo コマンドを使用して、各 ZooKeeper ノードを確認します。

構成を変更したことを Apigee ノードに通知します。

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

LDAP サーバー(OpenLDAP)の IP アドレスの変更

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

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

他の Apigee ノードタイプの IP アドレスの変更

次のノードタイプ(Router、Message Processor、Postgres Server(postgresql 以外)、Qpid Server(qpidd 以外))の IP アドレスを変更するには:

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

ノードの UUID がわからない場合は、次のコマンドを使用して表示できます。

  • ルーター: curl http://<router_IP>:8081/v1/servers/self
  • Message Processor: curl http://<mp_IP>:8082/v1/servers/self
  • Qpid: curl http://<qp_IP>:8083/v1/servers/self
  • Postgres: curl http://<pg_IP>:8084/v1/servers/self