移动 Apigee 服务器

Edge for Private Cloud v4.18.05

Apigee 组件使用 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（见下文），否则从 Management Server 开始重启每个 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. 在修改后的节点上运行 nodetool ring 命令，以确保环已完成。您可以在以下位置找到该实用程序：/opt/apigee/apigee-cassandra/bin。

   nodetool -h localhost ring

7. 在修改后的节点上运行 nodetool repair。请注意，此过程可能需要一些时间，因此强烈建议不要在 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&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 Server（非 postgresql）和 Qpid Server（非 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，可以使用以下命令显示它：

• 路由器：

  curl http://router_IP:8081/v1/servers/self

• 消息处理器：

  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