移动 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（见下文），否则请重启每个 Apigee 平台组件（从 Management Server 开始）。

对于具有多个 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. 在修改后的节点上运行 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”参数：
   • 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 服务器 (OpenLDAP) 的 IP 地址

如需更改 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。