4.19.01.09 - Edge for Private Cloud 版本说明

您正在查看 Apigee Edge 文档。
前往 Apigee X 文档。 信息

2020 年 9 月 29 日，我们发布了新版 Apigee Edge for Private Cloud。

更新过程

更新此版本将更新以下 RPM 列表中的组件：

  • edge-gateway-4.19.01-0.0.20095.noarch.rpm
  • edge-management-server-4.19.01-0.0.20095.noarch.rpm
  • edge-message-processor-4.19.01-0.0.20095.noarch.rpm
  • edge-postgres-server-4.19.01-0.0.20095.noarch.rpm
  • edge-qpid-server-4.19.01-0.0.20095.noarch.rpm
  • edge-router-4.19.01-0.0.20095.noarch.rpm
  • apigee-cassandra-2.1.16-0.0.2507.noarch.rpm
  • edge-management-ui-static-4.19.01-0.0.20017.noarch.rpm
  • apigee-setup-4.19.01-0.0.1123.noarch.rpm
  • apigee-mtls-consul-4.19.01-0.0.20129.noarch.rpm
  • apigee-mtls-4.19.01-0.0.20190.noarch.rpm

您可以输入以下命令，查看当前安装的 RPM 版本是否需要更新：

apigee-all version

如需更新安装，请在 Edge 节点上执行以下步骤：

  1. 在所有边缘节点上：

    1. 清理 Yum 代码库： 
      sudo yum clean all
    2. 将最新的 Edge 4.19.01 bootstrap_4.19.01.sh 文件下载到 /tmp/bootstrap_4.19.01.sh： 
      curl https://software.apigee.com/bootstrap_4.19.01.sh -o /tmp/bootstrap_4.19.01.sh
    3. 安装 Edge 4.19.01 apigee-service 实用程序和依赖项： 
      sudo bash /tmp/bootstrap_4.19.01.sh apigeeuser=uName apigeepassword=pWord

      其中，uName:pWord 是您从 Apigee 收到的用户名和密码。 如果您省略 pWord，系统会提示您输入。

    4. 更新 apigee-setup 实用程序： 
      sudo /opt/apigee/apigee-service/bin/apigee-service apigee-setup update
    5. 使用 source 命令执行 apigee-service.sh 脚本： 
      source /etc/profile.d/apigee-service.sh

  2. 更新所有 Cassandra 节点：

    /opt/apigee/apigee-setup/bin/update.sh -c cs -f configFile

    其中，configFile 指定了您用于安装 Apigee Edge for Private Cloud 的配置文件。例如 /opt/silent.conf。

  3. 在所有边缘节点上，针对 edge 进程执行 update.sh 脚本。为此，请在每个节点上执行以下命令： 
    /opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile
  4. 如果您使用的是新版 Edge 体验，请执行以下命令： 
    /opt/apigee/apigee-setup/bin/update.sh -c ue -f configFile
  5. （仅限 Apigee mTLS）如需更新 Apigee mTLS，请按照升级 Apigee mTLS 中所述的步骤操作。

    如需了解详情，请参阅 Apigee mTLS 简介。

支持的软件

无任何更改。

弃用和停用

没有新的弃用或停用。

新功能

本部分列出了此版本中的新功能。

加密 JMX 密码

您现在可以加密 JMX 密码。如需了解详情，请参阅 启用 JMX 密码加密和 为 Cassandra 启用 JMX 身份验证。(150633039)

已修复 Bug

下表列出了此版本中修复的 bug：

问题 ID 说明
159360654

apigee-mtls 证书的有效期只有 30 天。

新证书的有效期现在为一年。 如需将旧的 30 天证书升级为新的有效期为一年的证书，请参阅 升级 Apigee MTLS。
160890634

当消息处理器重启时，部分代理未部署。
130416715

因“True-Client-IP”标头而可能存在的漏洞

此版本引入了一个新的访问权限控制政策元素 IgnoreTrueClientIPHeader，用于修复此问题。 请参阅 IgnoreTrueClientIPHeader 元素。
132654321

审核日志未显示角色已更新的用户。

在为现有用户执行角色变更或将现有用户添加到组织后，审核日志会显示“更新用户未定义”，导致您无法查看操作是针对哪个用户执行的。
160951701

由于 Consul 二进制版本过时，mTLS 安装失败。

Consul 二进制文件已从 v1.6.2 升级到最新的稳定版本 v1.8.0。
160916451

由于 Consul bindaddr 字段缺少条目，mTLS 安装失败。

apigee-mtls 现在可以正确处理具有多个网络接口和地址的服务器。
133145969

缺少有关在界面中停用协议的文档

如需查看新文档，请参阅 停用 TLS 协议。

已知问题

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

问题 ID 说明
149245401

Ldap 政策连接池问题

使用 LDAP 资源指定的 LDAP 连接池属性未生效。因此，每次使用时都会打开和关闭连接，从而每小时与 LDAP 服务器建立大量连接。

临时解决方法：

如需更改 LDAP 连接池属性，请执行以下步骤，以在所有 LDAP 政策中设置全局更改。

  1. 如果配置属性文件尚不存在，请创建一个： 
    /opt/apigee/customer/application/message-processor.properties
  2. 将以下内容添加到文件中（根据您的 LDAP 资源配置要求替换 Java 命名和目录接口 [JNDI] 属性的值）。 
    bin_setenv_ext_jvm_opts="-Dcom.sun.jndi.ldap.connect.pool.maxsize=20
-Dcom.sun.jndi.ldap.connect.pool.prefsize=2
-Dcom.sun.jndi.ldap.connect.pool.initsize=2
-Dcom.sun.jndi.ldap.connect.pool.timeout=120000
-Dcom.sun.jndi.ldap.connect.pool.protocol=ssl"
  3. 确保文件 /opt/apigee/customer/application/message-processor.properties 的所有者为 apigee:apigee。
  4. 重启每个消息处理器。

如需验证连接池 JNDI 属性是否生效，您可以执行 tcpdump 以观察 LDAP 连接池随时间变化的行为。