このページは Cloud Translation API によって翻訳されました。

Apigee サーバーの移動

Edge for Private Cloud v4.18.05

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

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

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

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

変更するシステムで /opt/apigee/customer/application/cassandra.properties を編集します。ファイルが存在しない場合は作成します。
次のパラメータを変更します。
- conf_cassandra_seeds パラメータと conf_cassandra_listen_address パラメータを設定して、システムの新しい IP アドレスを指定します。
- 新しい IP アドレスまたは 0.0.0.0 を使用するように conf_cassandra_rpc_address を変更します（これにより、Cassandra Thrift はすべてのインターフェースをリッスンできます）。
エディタで /opt/apigee/apigee-cassandra/conf/cassandra-topology.properties を開きます。古い IP アドレスとデフォルト設定が
```
192.168.56.101=dc-1:ra-1
default=dc-1:ra-1
```
の形式で表示されます。
その情報を保存します。
/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
```
IP アドレスの後に「\n」を挿入し、上記のステップ 3 と同じデフォルト設定を指定します。

Cassandra を再起動します。

/opt/apigee/apigee-service/bin/apigee-service apigee-cassandra restart

必要に応じて ZooKeeper も修復します（下記参照）。それ以外の場合は、Management Server 以降のすべての Apigee プラットフォームコンポーネントを再起動します。

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

変更するノードがシードノードの場合は、リング内の各システムの /opt/apigee/customer/application/cassandra.properties ファイルを編集し、conf_cassandra_seeds パラメータを変更して変更後のシステムの新しい IP を含めます。cassandra.properties ファイルが存在しない場合は作成します。
変更するシステムで /opt/apigee/customer/application/cassandra.properties を編集し、次のパラメータを変更します。
- 新しい IP アドレスを使用するように conf_cassandra_listen_address を設定します。
- 新しい IP アドレスまたは「0.0.0.0」を使用するように conf_cassandra_rpc_address を設定します（これにより、Cassandra Thrift がすべてのインターフェースでリッスンできます）。
エディタで /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
```
の形式で表示されます。
その情報を保存します。
/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
```
各 IP アドレスの後に「\n」を挿入し、上記の手順 3 で記録したものと同じデフォルト設定を使用してください。
変更したシステムで Cassandra を再起動します。変更したシステムがシードノードの場合は、変更したシードノードを使用していた各システムも再起動します。
```
/opt/apigee/apigee-service/bin/apigee-service apigee-cassandra restart
```
変更したノードで nodetool ring コマンドを実行して、リングが完了していることを確認します。このユーティリティは /opt/apigee/apigee-cassandra/bin にあります。
```
nodetool -h localhost ring
```
変更したノードで nodetool repair を実行します。この処理には時間がかかる場合があるため、API トラフィックのピーク時には行わないことを強くおすすめします。
```
nodetool -h localhost repair
```
必要に応じて ZooKeeper（下記参照）を修復し、Management Server 以降のすべての Apigee プラットフォームコンポーネントを再起動します。

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

次のコマンドを使用して、古い IP アドレスを指定してデータストア登録の UUID を確認します。「type」パラメータと「UUID」パラメータをメモしておきます。

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" です。

以下のいずれかのコマンドを使用して、新しい 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

IP アドレスが変更されたシステムの UUID の古い登録を削除します。各 UUID に対して、以下の処理を行います。
```
curl -u ADMINEMAIL:PW "http://MSIP:port/v1/servers/OLD_UUID" -X DELETE
```

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

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

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

エディタで /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
```
の形式で表示されます。
その情報を保存します。
各 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
```
各 IP アドレスの後に "\n" を挿入し、エントリがすべてのノードで同じ順序になっていることを確認してください。
次のコマンドを使用して、ZooKeeper アンサンブルのリーダーを見つけます（node は Zookeeper マシンの IP アドレスに置き換えます）。
```
echo srvr | nc node 2181
```
出力の Mode 行に「leader」と表示されます。
一方の ZooKeeper をリーダーから順に再起動し、IP アドレスを変更したノードで終了します。複数の Zookeeper ノードで IP アドレスが変更された場合は、すべてのノードを再起動する必要があります。
```
/opt/apigee/apigee-service/bin/apigee-service apigee-zookeeper restart
```
上記の echo コマンドを使用して、各 ZooKeeper ノードを確認します。

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

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

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

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

Management Server ノードで、/opt/apigee/customer/application/management-server.properties ファイルを編集します。ファイルが存在しない場合は作成します。
management-server.properties ファイルで、conf_security_ldap.server.host パラメータを新しい IP アドレスに設定します。

Management Server を再起動します。

/opt/apigee/apigee-service/bin/apigee-service edge-management-server restart

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

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

次の 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 がわからない場合は、次のコマンドを使用して表示できます。

ルーター:

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
```