4.19.01 Edge for Private Cloud 版本说明

用于安装 apigee-sso 的元数据文件格式

安装 apigee-sso 并使用 metadata.xml 文件（而非网址）时，如果 metadata.xml 文件末尾不包含换行符 (CRLF)，则系统不会完整读取该文件。

临时解决方法：

如需解决此问题，您可以执行以下任一操作：

• 在 metadata.xml 文件末尾添加 CRLF

  或

• 使用基于网址的元数据位置

apigee-monit 在 Amazon Linux 1 上不受支持

临时解决方法：

消息处理器备份未备份正确的文件集

临时解决方法：

再次运行备份，系统应该会备份正确的文件集。

会话令牌未失效

当用户点击 Apigee Edge 的“退出”按钮时，会话令牌不会在服务器上失效。

临时解决方法：

启用 JMX 身份验证后，Cassandra 操作无法正常运行

临时解决方法：

向 Node.js 目标发出的 HEAD 请求挂起

向 Node.js 目标发出的 HEAD 请求可能会挂起，导致连接处于待处理状态。

临时解决方法：

如需解决此问题，请为 HEAD 请求定义一个处理程序，以明确返回空响应。

主机名无法解析

安装或升级 Edge for Private Cloud 后，主机名可能无法解析为其地址。

临时解决方法：

如需解决此问题，请重启 Edge 界面组件：

/opt/apigee/apigee-service/bin/apigee-service edge-ui restart

在多数据中心配置中出现 DataAccessException

在多数据中心配置中，如果某个数据存储区变得不可用，您可能会看到以下错误：

DataAccessException: Error while accessing datastore;
Please retry later

结果是，管理服务器可能无法启动，因为它尝试连接到 dc-1 和 dc-2 中的 Cassandra 节点。如果 Cassandra 节点出现故障，则会发生 DataAccessExceptions。这还可能会导致 API 流量中断，其中消息处理器在尝试检索 KVM 时报告 DataAccessExceptions。

请注意，预期状态是管理服务器不连接到跨区域的数据存储区组件。

临时解决方法

解决方法是，在不可用的数据中心内取消注册以下 Cassandra 节点类型，然后在 Cassandra 节点再次可用后重新注册这些节点类型：

• kms-datastore
• dc-datastore
• keyvaluemap-datastore

如需取消注册并重新注册这些 Cassandra 节点类型，请执行以下操作：

1. 使用以下 curl 命令获取 Cassandra 节点的 UUID：

   curl -u ADMIN_EMAIL:ADMIN_PW \
     "http://MS_IP:MS_PORT/v1/servers?region=REGION&pod=GATEWAY_POD \
     &type=CASSANDRA_NODE_TYPE"

   其中：

   • ADMIN_EMAIL 和 ADMIN_PW 是您的 Apigee 账号的凭据。
   • MS_IP 和 MS_PORT 是管理服务器的 IP 地址和端口号。
   • REGION 是管理服务器所在的数据中心的名称。
   • GATEWAY_POD 是 pod 名称，默认情况下为“gateway”。不过，您可能已将其重命名为其他名称，因此请检查您的实现。
   • CASSANDRA_NODE_TYPE 是 kms-datastore、dc-datastore 和 keyvaluemap-datastore 中的一个。

   例如：

   curl -u nickdanger@google.com:myP@$$w0rD
     "http://192.168.0.1:8080/v1/servers?region=dc-1&pod=gateway&type=dc-datastore"

   回答采用以下格式：

   {
     "internalIP" : "POD_IP_ADDRESS",
     "isUp" : [true|false],
     "pod" : "GATEWAY_POD",
     "reachable" : [true|false],
     "region" : "dc-1",
     "tags" : {
       "property" : [ ]
     },
     "type" : [ "kms-datastore", "dc-datastore", "keyvaluemap-datastore" ],
       "uUID" : "POD_UUID"
   }

   例如：

   {
     "internalIP" : "192.168.1.11",
     "isUp" : false,
     "pod" : "gateway",
     "reachable" : false,
     "region" : "dc-1",
     "tags" : {
       "property" : [ ]
     },
     "type" : "dc-datastore",
     "uUID" : "13cee956-d3a7-4577-8f0f-1694564179e4"
   }

   请记下响应中 uUID 字段的值。您将使用这些命令来取消注册节点。

2. 针对每种 Cassandra 节点类型（kms-datastore、dc-datastore 和 keyvaluemap-datastore）重复执行第 1 步。请务必记下返回的 UUID。
3. 使用以下命令取消注册节点：

   curl -u ADMIN_EMAIL:ADMIN_PW "http://MS_IP:MS_PORT/v1/servers/UUID" -X DELETE

   其中，UUID 是上一条命令的响应中返回的 UUID。

4. 针对您在第 1 步和第 2 步中收集的每个 UUID 重复第 3 步。
5. 使用以下命令重新注册节点：

   curl -u ADMIN_EMAIL:ADMIN_PW "http://MS_IP:MS_PORT/v1/servers -d \
     "Type=kms-datastore&Type=dc-datastore&Type=keyvaluemap-datastore& \
     Type=counter-datastore&Type=cache-datastore&InternalIP=POD_IP_ADDRESS& \
     region=REGION&pod=GATEWAY_POD" -H \
     'content-type: application/x-www-form-urlencoded' -X POST

请注意，这些操作会向 Zookeeper 注册节点并从 Zookeeper 中注销节点，但不会对 Cassandra 集群产生任何影响。如需详细了解这些命令，请参阅更新数据存储区注册信息。

MessageLogging 政策，可在日志消息中包含额外信息

MessageLogging 政策的 FormatMessage 元素用于控制记录的消息的格式。如果值为 FormatMessage=false，则记录的消息不应包含任何 Apigee 生成的信息。不过，即使您设置了 FormatMessage=false，日志消息仍会包含以下信息：

• 优先级得分
• 时间戳

临时解决方法：

重置系统管理员密码失败

重置包含特殊字符的管理服务器的系统管理员密码会失败。

临时解决方法：

在数据文件中定义密码，然后将该文件传递给 Management API 中的 /users 端点。如需了解详情，请参阅重置系统管理员密码。