移动 Apigee 服务器

如果您没有使组件配置文件中的 IP 地址保持同步，将组件从一台机器移到另一台机器可能会导致配置不匹配。

本部分介绍了如何诊断和修复配置不匹配问题。

IP 地址与主机名

在组件配置文件中，您应使用 IP 地址，而不是主机名。

虽然某些组件配置文件允许您使用主机名而不是 IP 地址，但使用主机名会使问题排查变得更加复杂。例如，主机名可能是 DNS 服务器连接、查找失败和同步相关问题的来源。

因此，Apigee 强烈建议所有组件配置都使用 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

   确保在 IP 地址后插入“\n”，并指定与上面第 3 步相同的默认设置。

5. 重启 Cassandra：

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

6. 如有必要，还可以修复 ZooKeeper（请参阅更改 ZooKeeper 节点的 IP 地址）。否则，从管理服务器开始，重启每个 Apigee 平台组件。

适用于具有多个 Cassandra 节点（环）的配置

1. 如果要更改的节点是种子节点，请修改环中每个系统上的 /opt/apigee/customer/application/cassandra.properties 文件，并更改 conf_cassandra_seeds 参数以包含修改后的系统的新 IP。如果 cassandra.properties 文件不存在，请创建该文件。
2. 在被修改的系统上修改 /opt/apigee/customer/application/cassandra.properties，并更改以下参数：
   • 将 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。您应该会看到采用以下格式的所有 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

   确保在每个 IP 地址后插入“\n”，并使用上面第 3 步中记录的相同默认设置。

5. 在修改后的系统上重启 Cassandra。

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

6. 对于所有其他节点，重复第 3 步和第 4 步所做的更改，以告知他们此节点在 Cassandra 环中的位置。此外，请按照第 1 步中的说明更改种子节点 IP。
7. 逐个重启剩余的每个 Cassandra 节点。

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

8. 在已修改的节点上运行 nodetool ring 命令，以确保环已完成。该实用程序可在 /opt/apigee/apigee-cassandra/bin 中找到。

   nodetool [-u username -pw password] -h localhost ring

9. 在已修改的节点上运行 nodetool repair。请注意，此过程可能需要一些时间，因此强烈建议不要在 API 流量高峰时段执行此操作。

   nodetool [-u username -pw password] -h localhost repair -pr

10. 如有必要，请修复 ZooKeeper（请参阅更改 ZooKeeper 节点的 IP 地址），然后从管理服务器开始重启每个 Apigee 平台组件。

更新数据存储区注册

1. 使用以下命令查找指定旧 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”。

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

   请确保在每个 IP 地址后插入“\n”，并确保条目在每个节点上都以相同的顺序排列。

3. 使用以下命令查找 ZooKeeper 集成学习的领导者（将 node 替换为 ZooKeeper 机器的 IP 地址）：

   echo srvr | nc node 2181

   输出中的 Mode 行应显示“leader”。

4. 依次重启一个 ZooKeeper，从主要节点开始，并以更改 IP 地址的节点结尾。如果多个 zookeeper 节点更改了 IP 地址，则可能需要重启所有节点。

   /opt/apigee/apigee-service/bin/apigee-service apigee-zookeeper restart

5. 使用上述 echo 命令验证每个 ZooKeeper 节点。

将更改后的配置告知 Apigee 节点

1. 在每个路由器节点上，修改文件 /opt/apigee/customer/application/router.properties，如下所示。如果该文件不存在，请创建该文件。
   • 更改 conf_zookeeper_connection.string 参数以包含新的 IP 地址
   • 更改 conf_zookeeper_zk1.host 参数以包含新的 IP 地址
2. 在每个消息处理器节点上，修改文件 /opt/apigee/customer/application/message-processor.properties，如下所示。如果该文件不存在，请创建该文件。
   • 更改 conf_zookeeper_connection.string 参数以包含新的 IP 地址
   • 更改 conf_zookeeper_zk1.host 参数以包含新的 IP 地址
3. 在管理服务器节点上，修改文件 /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. 在管理服务器节点上，修改 /opt/apigee/customer/application/management-server.properties 文件。如果该文件不存在，请创建该文件。
2. 在 management-server.properties 文件中，将 conf_security_ldap.server.host 参数设置为新的 IP 地址。
3. 重启管理服务器：

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

更改其他 Apigee 节点类型的 IP 地址

如需更改任意节点类型（路由器、消息处理器、Postgres 服务器（非 postgresql）和 Qpid 服务器（非 qpidd）的 IP 地址，请执行以下操作：

1. 使用以下 curl 命令注册新的内部和外部 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。