4.19.06 Edge for Private Cloud 版本说明

您正在查看的是 Apigee Edge 文档。
转到 Apigee X 文档
信息

本部分介绍了 4.19.06 版 Edge for Private Cloud 功能。

版本摘要

下表总结了此版本中的变化:

新功能

此版本包含以下新功能:

○ 为单点登录提供 LDAP 支持
○ 支持 HTTP 部署
○ 可插拔分析
○ Cassandra 机架支持
○ IPv6 支持
○ 简化版全新边缘体验安装
○ 排除 INVALID_TSC 交易(创收)

如需详细了解各项新功能,请参阅新功能

向后兼容性

此版本的适用于私有云的 Apigee Edge 中引入了以下问题,影响向后兼容性:

     
  • 由于修复了问题 132443137(如 19.03.01 公有云版本说明中所述),消息处理器现在会忽略以 X-Apigee-* 开头的标头。因此,您必须重构使用 X-Apigee-* 头文件的所有代码,并将这些头文件替换为受支持的头文件。

  • Cassandra 日志文件的名称已更改。现在是:

    /opt/apigee/var/log/apigee-cassandra/system.log
包含的版本

自上一个 Private Cloud 功能版本 Edge 以来,此版本已推出并包含以下版本:

○ Edge:
   19.07.23(界面)
   19.03.01
   19.02.19
   19.02.04
   19.01.23
{1.2.04}
{1.01.23
{1.3.01}
{1.03.01}
{1.01.23。{/1.03.01}
19.01.1418.12.0418.08.3118.07.31
○ 门户:
   19.07.08
   19.05.23
   19.05.08
   19.04.18
   19.03.20
   19.02}
19.02}
19.02.2719.02.2119.02.0419.01.16
退休
弃用

4.19.06 版本发布后,弃用了以下几项:

  • 4.18.01::适用于私有云的 Apigee Edge 4.18.01 版现已弃用。

如需了解详情,请参阅 Apigee 弃用、弃用和 CPS 变更

bug 修复

此版本修复了以下问题:

○ UseStringDeduplication is failed to set (140270474) ○26 140270474 o2










HEAD

如需详细了解各个修复程序,请参阅问题修复

已知问题

此版本包含以下已知问题:

○ Mint 未对事务进行初始评分 (○141628497) 2 7 2 7 2
确认消息 服务器内存泄露 (137865184)
○ apigee-sso 安装 (135616498) 的元数据文件格式
○ Amazon Linux 1 (12237) 不支持 apigee-monit 1



如需详细了解每个已知问题(包括解决方法),请参阅已知问题

升级路径

下表显示了此版本的升级路径:

From 4.19.01 直接从 4.19.01 升级到 4.19.06
从 5 月 4 日 18 日 直接从 4.18.05 → 4.19.06 升级
2001 年 4 月 18 日起 直接从 4.18.01 → 4.19.06 升级

新功能

本部分列出了此版本中的新功能。此外,此版本还包含包含的版本中列出的 Edge 界面、边缘管理和门户版本中的所有功能。

除了以下增强功能之外,此版本还在易用性、性能、安全性和稳定性方面进行了多项改进。

HTTP 部署支持

默认情况下,Edge 使用 RPC 部署 API 代理。虽然此模式非常适合大多数安装,但如果通过 RPC 进行大量并发调用,具有许多 MP 的较大拓扑可能会出现超时。

因此,Apigee 建议大型部署使用 HTTP 而不是 RPC 进行部署。现在支持启用 HTTP 部署。

如需了解详情,请参阅启用 HTTP 部署

Cassandra 机架支持

现在,Apigee 通过让 Cassandra on Apigee Edge for Private Cloud 机架感知型功能为 Cassandra 的运维提供一般指导。

如需了解详情,请参阅 Cassandra 机架支持

可插入式分析

默认情况下,消息处理器收集的分析数据会上传到 Qpid 和 Postgres 进行处理。然后,您可以在 Edge 界面中查看分析数据。

通过此功能版本,您可以配置消息处理器以将分析数据写入磁盘,也可以选择同时使用这两个选项。

如需了解详情,请参阅将分析数据写入文件

简化版新边缘体验安装

通过新脚本简化了新版 Edge 体验的安装。

如需了解详情,请参阅安装新版边缘体验

LDAP IDP 支持

现在,除了 SAML 之外,通过 Edge 界面和 Edge Management API 调用对用户进行身份验证还支持 LDAP。LDAP 支持包括直接绑定和间接绑定方法。

如需了解详情,请参阅外部 IDP 身份验证概览

IPv6 支持

默认情况下,对适用于私有云的 Apigee Edge 的所有运行时 API 调用均使用 IPv4。您可以使用新属性向路由器添加 IPv6 支持。

如需了解详情,请参阅在路由器上使用 IPv6

排除 INVALID_TSC 笔交易(变现)

您现在可以在使用 Monetization 时排除 INVALID_TSC 事务,使其不添加到 Postgres 数据库。

如需了解详情,请参阅创收服务器属性

支持的软件

此版本对支持的软件进行了以下更改:

新增支持 不再受支持

此版本新增了对以下平台的支持:

  • Red Hat Enterprise Linux (RHEL) 6.10
  • CentOS 6.10
  • Oracle Linux 6.9

此版本不再支持以下平台:

  • Red Hat Enterprise Linux (RHEL) 6.9
  • CentOS 6.9
  • Oracle 6.8

如需查看受支持平台的完整列表,请参阅支持的软件和支持的版本

bug 修复

本部分列出了此版本中修复的 Private Cloud bug。此外,此版本还包含包含的版本中所示的 Edge 界面、边缘管理和门户版本中的所有 bug 修复。

问题 ID 说明
140270474

未设置 UseStringDeduplication

未在生产环境中为 edge-message-processor 组件设置 UseStringDeduplication
111445518

MP 错误

消息处理器每 5 分钟持续记录一次以下错误消息:
2019-06-29 00:02:05,775 Apigee-Timer-6 ERROR CMgmt -
  ConnectorServiceImpl.refreshToken() : Connector Management API auth token
  generation failed: 0 null
113342838

JMX 的 Cassandra 失败

启用 JMX 身份验证后,Cassandra 操作不起作用
138931337

13 节点升级

13 个节点安装从 17.09、18.01 和 18.05 升级失败。
119802562

同名代理

如果同一组织中的两个用户创建了同名的代理,则创建的第二个用户会覆盖第一个用户。只有在不同用户无法看到其他代理时,才会发生这种情况。
118851790

密钥库无法加载

当组织/环境的密钥库超过 100 个时,Edge 界面中的密钥库和参考部分将不会加载。相反,界面会显示 Internal Error (Error Fetching Keystores) 错误。
110988191

分析失败

在从微网关提供设置为将来日期的数据时,对环境的分析失败。
110785400

备份失败

ZooKeeper、Cassandra 和 OpenLDAP 间歇性地无法正确备份其数据,并显示以下错误:File changed as we read it.
79993247

向 Node.js 发出的 HEAD 请求

对 Node.js 目标的 HEAD 请求可能会挂起,从而导致连接保持待处理。
70291825

apigee-postgres 备份/恢复

执行 apigee-postgres 备份/恢复现在会备份所有组件的数据。
65737520

重置系统管理员密码

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

已知问题

下表列出了此版本中的已知问题:

问题 ID 说明
141628497

铸造最初不对交易进行评分

当您首次为组织启用创收功能时,Private Cloud 边缘不会在一开始对交易进行评分。无论是新组织还是现有组织,都需遵循此要求。

变现启用 API 会返回作业 ID,完成后,作业的状态将指示成功。不过,最初进行的所有用于创收的 API 调用都不会通过创收功能进行处理,也不会进行分级。这些交易只会在常规分析中显示。

临时解决方法:

重启所有消息处理器 (MP),可通过以下代码重启:
apigee-service edge-message-processor restart

启用创收功能后,重启 MP 会导致 Edge 在启动时加载 ZooKeeper 配置。每次重启时都会出现这种情况,这意味着此问题只会在一开始出现。

137865184

Mint 评分服务器内存泄漏

在 mxgroup 中注册新的 Qpid 实例时,队列会在没有使用方的情况下构建,这将导致队列深度增大,直到它使用完所有可用资源为止。

临时解决方法:

无。
135616498

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

安装 apigee-sso 并使用 metadata.xml 文件(而非网址)时,如果 metadata.xml 文件的末尾未包含新行 (CRLF),则不会完全读取 metadata.xml 文件。

临时解决方法:

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

  • 将 CRLF 添加到 metadata.xml 文件的末尾

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

Amazon Linux 1 不支持 apigee-monit

临时解决方法:

无。
121095148

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

临时解决方法:

再次运行备份,系统应该会备份一组正确的文件。

76087166

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

在多个数据中心配置中,如果一个数据存储区不可用,您可能会看到以下错误:

DataAccessException: Error while accessing datastore;
Please retry later

结果是,Management Server 可能无法启动,因为它正尝试连接到 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_EMAILADMIN_PW 是您的 Apigee 帐号的凭据。
    • MS_IPMS_PORT 是管理服务器的 IP 地址和端口号。
    • REGION 是管理服务器所在数据中心的名称。
    • GATEWAY_POD 是 Pod 名称,默认为“网关”。不过,您可能已经将其重命名为其他名称,因此请检查您的实现。
    • CASSANDRA_NODE_TYPEkms-datastoredc-datastorekeyvaluemap-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 节点类型重复执行第 1 步:kms-datastoredc-datastorekeyvaluemap-datastore。请务必记下返回的 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 注册和取消注册节点,对 Cassandra 集群没有任何影响。如需详细了解这些命令,请参阅更新数据存储区注册

68722102

MessageLogging 政策,包括日志消息中包含额外信息

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

  • 优先级
  • 时间戳

临时解决方法:

无。

后续步骤

如需开始使用 Edge for Private Cloud 4.19.06,请访问以下链接:

新安装:
新安装概览
现有安装次数:
升级路径