将 Apigee Edge 4.51.00 或 4.52.00 更新到 4.52.01

Apigee 支持将适用于 Private Cloud 的 Edge 从 4.51.00 版或 4.52.00 版直接升级到 4.52.01 版。本页将介绍如何执行上述任一升级。

谁可以执行更新

运行更新的人员应与最初安装 Edge 的人员或以 root 身份运行的人员相同。

安装 Edge RPM 后，任何人都可以对其进行配置。

必须更新哪些组件

您必须更新所有 Edge 组件。Edge 不支持包含多个版本的组件的设置。

更新前提条件

在升级 Apigee Edge 之前，请确保满足以下前提条件：

• 备份所有节点
  出于安全考虑，在更新之前，我们建议您完整备份所有节点。按照您当前所用 Edge 版本的流程执行备份。

  这样，您可以制定备份计划，以防更新到新版本无法正常运行。如需详细了解备份，请参阅备份和恢复。

• 确保 Edge 正在运行
  使用以下命令在更新过程中确保 Edge 已启动并运行：

  /opt/apigee/apigee-service/bin/apigee-all status

• 确保 Cassandra 压缩策略为 LeveledCompactionStrategy
  确保将 Cassandra 兼容性策略设置为 LeveledCompactionStrategy，如更改 Cassandra 压缩策略中所述。

自动传播媒体资源设置

如果您通过修改 /opt/apigee/customer/application 中的 .properties 文件设置了任何属性，则更新会保留这些值。

必须升级到 Zookeeper 3.8.3

此版本的适用于私有云的 Edge 包含对 Zookeeper 3.8.3 的升级。在升级过程中，所有 Zookeeper 数据都将迁移到 Zookeeper 3.8.3。

在升级 Zookeeper 之前，请仔细阅读 Zookeeper 维护指南。大多数 Edge 生产系统都使用分布在多个数据中心的 Zookeeper 节点集群。其中一些节点配置为参与 Zookeeper 领导者选举的投票者，其余节点配置为观察者。如需了解详情，请参阅 关于领导者、关注者、投票者和观察者。选民节点会选出领导者，之后选民节点则自己成为关注者。

在更新过程中，当主要节点关闭时，可能会出现暂时性延迟或写入失败的情况。这可能会影响向 Zookeeper 写入数据的管理操作（例如代理的部署操作）和 Apigee 基础架构更改（例如添加或移除消息处理器等）。在升级 Zookeeper 期间，遵循以下流程应该不会对 Apigee 的运行时 API 产生任何影响（除非这些运行时 API 调用管理 API）。

概括来讲，升级过程涉及对每个节点进行备份。接下来升级所有观察者和关注者，最后升级主节点。

备份

备份 Zookeeper 的所有节点，以便在需要回滚时使用。请注意，回滚会将 Zookeeper 恢复到进行备份时的状态。注意：自备份获取（其信息存储在 Zookeeper 中）后，Apigee 中的任何部署或基础架构更改都将在恢复期间丢失。

  /opt/apigee/apigee-service/bin/apigee-service apigee-zookeeper backup

如果您使用的是虚拟机并且具有此功能，则还可以截取虚拟机快照或备份以进行恢复或回滚（如有必要）。

确定领导者、关注者和观察者

注意：以下示例命令使用 nc 实用程序将数据发送到 Zookeeper。您也可以使用其他实用程序将数据发送到 Zookeeper。

1. 如果 nc 未安装在 ZooKeeper 节点上，请安装 nc：

     sudo yum install nc

2. 在该节点上运行以下 nc 命令，其中 2181 表示 ZooKeeper 端口：

     echo stat | nc localhost 2181

   您应该会看到如下所示的输出：

     Zookeeper version: 3.8.3-5a02a05eddb59aee6ac762f7ea82e92a68eb9c0f, built on 2022-02-25 08:49 UTC
     Clients:
      /0:0:0:0:0:0:0:1:41246[0](queued=0,recved=1,sent=0)
     
     Latency min/avg/max: 0/0.2518/41
     Received: 647228
     Sent: 647339
     Connections: 4
     Outstanding: 0
     Zxid: 0x400018b15
     Mode: follower
     Node count: 100597

   在节点输出的 Mode 行中，您应该看到观察者、主要节点或跟随者（即投票者不是主要节点），具体取决于节点配置。注意：在具有单个 ZooKeeper 节点的独立安装 Edge 中，Mode 设置为独立安装。

3. 在每个 ZooKeeper 节点上重复第 1 步和第 2 步。

在观察者和关注者节点上升级 Zookeeper

在每个观察器和关注者节点上升级 Zookeeper，如下所示：

1. 下载并运行 Private Cloud 4.52 的 Edge 引导，如 在具有外部互联网连接的节点上更新到 4.52.01 中所述。根据节点是具有外部互联网连接还是您要执行离线安装，该过程可能会有所不同。
2. 升级 Zookeeper 组件：

     /opt/apigee/apigee-setup/bin/update.sh -c zk -f <silent-config-file>

   注意：如果这些节点安装了其他组件（例如 Cassandra），您也可以立即升级它们（例如使用 cs,zk 配置文件），也可以稍后升级其他组件。Apigee 建议您先升级 Zookeeper，并在升级其他组件之前确保您的集群正常工作。
3. 对每个 Zookeeper 观察器和跟随节点重复执行上述步骤。

关停领先变体

所有观察者节点和跟随节点完成升级后，关闭主副本。在被标识为主要节点的节点上，运行以下命令：

  /opt/apigee/apigee-service/bin/apigee-service apigee-zookeeper stop

请注意，在此事件期间，在选择新的主要副本之前，Zookeeper 中可能会发生暂时性延迟或写入失败。这可能会影响向 Zookeeper 写入数据的操作，例如代理的部署操作或 Apigee 基础架构更改（例如添加或移除消息处理器等）。

验证是否已选择新的领先变体

按照上面识别领先变体和观察者部分中的步骤，验证在现有主要副本停止后，是否已从关注者中选出了新的主要版本。请注意，可以在与当前主要副本不同的数据中心中选择主要副本。

升级领导者

按照上面 在观察者和关注者节点上升级 Zookeeper的步骤操作。

同时升级旧的主要节点后，验证集群运行状况并确保存在主要节点。

回滚

如果需要回滚：

1. 请先对观察者和关注者执行回滚步骤。
2. 下载并执行您要回滚到的版本（4.50 或 4.51）的引导加载程序。根据节点是具有外部互联网连接还是您进行离线安装，该过程可能会有所不同。
3. 如果 Zookeeper 正在以下节点上运行，请将其停止：

     /opt/apigee/apigee-service/bin/apigee-service apigee-zookeeper stop

4. 卸载现有的 zookeeper：

     /opt/apigee/apigee-service/bin/apigee-service apigee-zookeeper uninstall

5. 照常安装 Zookeeper：

     /opt/apigee/apigee-setup/bin/setup.sh -p zk -f <silent-config-file>

6. 所有关注者和观察者都回滚后，在主要节点上按照第 2 步到第 5 步回滚主要节点。
7. 所有节点回滚后，请验证集群运行状况并确保集群中有主节点。

恢复备份

请参阅使用备份进行恢复。 请注意，从适用于 Private Cloud 的早期版本（例如 4.50 和 4.51）中获取的 Zookeeper 备份应该与适用于 Private Cloud 4.52 的 Edge 中的 Zookeeper 版本兼容。

升级 Qpid

此 Private Cloud 边缘版本包含对 Qpid J-Broker 的升级。我们建议您选择以下方法之一来执行 Qpid 升级：

• 就地升级，无需停机
• 启用新的 Qpid 节点

就地升级，零停机

此方法可确保您的 Edge 运行时环境不会停机，并最大限度地减少为进行分析而获取的运行时数据（如果有）的损失。

如需针对 Qpid 执行就地、零停机升级，请执行以下操作：

1. 选择一个 Qpid 节点作为起始点。
2. 停止节点上的 Qpid 代理：

   apigee-service apigee-qpidd stop

3. 通过应用防火墙，阻止代理端口 5672 上来自所有消息处理器的传入流量。您可以在 Qpid 节点实例或其他一些外部防火墙/网络组件的级别应用此防火墙。

   我们建议您针对所有消息处理器 IP 地址执行相同的步骤。 例如，如需使用 IPTables 将来自消息处理器 IP 地址的 DROP 请求发送到端口 5672 上的 Qpid 节点，您可以使用如下命令：

   iptables -A INPUT -p tcp --dport 5672 -s MESSAGE_PROCESSOR_IP -j DROP

4. 再次启动 Qpid 代理以排空现有消息（如果有）：

   apigee-service apigee-qpidd start

5. 检查现有队列是否为空：

   qpid-stat -q

   如果消息卡在死信队列 (DLQ) (ax-q-axgroup-001-consumer-group-001-dl) 中，请按照解决分析数据卡在死信队列中的步骤排空队列。

6. 验证在旧节点上排空队列后，停止 apigee-qpidd：

   apigee-service apigee-qpidd stop

7. 在节点上升级 Qpid：

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

8. 重启 edge-qpid-server：

   apigee-service edge-qpid-server restart

9. 移除第 3 步中应用的防火墙规则。

   对所有应用了防火墙的邮件处理器 IP 地址执行相同的移除步骤。 移除防火墙后，系统将接受从消息处理器 IP 地址发送到端口 5672 上的 Qpid 节点的请求。如果您使用 iptables 添加防火墙，并移除防火墙并列出现有设置，则可以使用如下命令：

   iptables -F
     iptables -L

10. 使用网络监控来验证 Qpid 队列是否正在接收消息：

    http://QPID_NODE_IP:8090

11. 对每个 Qpid 节点重复第 1 步到第 9 步。

调试新的 Qpid 节点

此方法会在新节点上设置 apigee-qpidd 和 edge-qpid-server 并将其安装。

1. 添加新的 Qpid 节点。此步骤将设置具有 J-broker 的 Qpid 节点。如需了解详细步骤，请参阅添加 Qpid 服务器。
2. 选择现有的 Qpid 节点（从您要升级的版本中选择一个节点）。
3. 停止节点上的 Qpid 代理：

   apigee-service apigee-qpidd stop

4. 通过应用防火墙，阻止代理端口 5672 上来自所有消息处理器的传入流量。您可以在 Qpid 节点实例或其他一些外部防火墙/网络组件的级别应用此防火墙。

   我们建议您针对所有消息处理器 IP 地址执行相同的步骤。 例如，如需使用 IPTables 将来自消息处理器 IP 地址的 DROP 请求发送到端口 5672 上的 Qpid 节点，您可以使用如下命令：

   iptables -A INPUT -p tcp --dport 5672 -s MESSAGE_PROCESSOR_IP -j DROP

5. 再次启动 Qpid 代理以排空现有消息（如果有）：

   apigee-service apigee-qpidd start

6. 检查以确保现有队列为空：

   qpid-stat -q

   如果消息卡在死信队列 (DLQ) (ax-q-axgroup-001-consumer-group-001-dl) 中，请按照问题排查主题 Analytics 数据卡在 Qpidd 死信队列中中的步骤来排空队列。

7. 验证队列已在旧节点上排空后，停止 apigee-qpidd

   apigee-service apigee-qpidd stop

8. 按照移除 Qpid 服务器中的步骤取消注册旧的 Qpid 节点。
9. 继续添加新节点并移除旧节点（一次一个），直到所有 Qpid 节点均已升级。

回滚

如需回滚到先前的功能版本，请务必下载要回滚到的目标版本的 bootstrap.sh 文件。如需回滚到 4.52.00 版，请下载 bootstrap_4.52.00.sh。

如需回滚 Qpid，请在所有 Qpid 主机上执行以下步骤：

1. 停止现有的 Qpid 代理

   apigee-service apigee-qpidd stop

2. 通过应用防火墙，阻止代理端口 5672 上来自所有消息处理器的传入流量。您可以在 Qpid 节点实例或其他一些外部防火墙/网络组件的级别应用此防火墙。

   我们建议您针对所有消息处理器 IP 地址执行相同的步骤。 例如，如需使用 IPTables 将来自消息处理器 IP 地址的 DROP 请求发送到端口 5672 上的 Qpid 节点，您可以使用如下命令：

   iptables -A INPUT -p tcp --dport 5672 -s MESSAGE_PROCESSOR_IP -j DROP

3. 再次启动 qpid 代理以排空现有消息（如果有）：

   apigee-service apigee-qpidd start

4. 确保现有队列为空。如需检查此网址，请登录 Qpid 管理门户：

   http://QPID_NODE_IP:8090

   注意 ：如果 QPID 节点上的此端口 8090 无法访问，您可以使用 SSH 端口转发等备用机制来访问此网址。
5. 验证队列已排空后，停止并卸载 Qpid：

   apigee-service apigee-apidd uninstall

6. 删除 Qpid 数据目录：

   rm -r APIGEE_ROOT/data/apigee-qpidd

7. 重新安装 Qpid 代理：

   /opt/apigee/apigee-setup/bin/setup.sh -p qs -f configFile

8. 重新安装 Qpid 代理后，请使用以下命令移除防火墙设置并列出所有现有设置：

   iptables -F

   iptables -L

新的 Edge 界面

本部分列出了有关 Edge 界面的注意事项。如需了解详情，请参阅适用于私有云的全新 Edge 界面。

安装 Edge 界面

完成初始安装后，Apigee 建议您安装 Edge 界面，这是适用于私有云的 Apigee Edge 开发者和管理员的增强界面。

请注意，Edge 界面要求您停用基本身份验证，并使用 SAML 或 LDAP 等 IDP。

如需了解详情，请参阅安装新版 Edge 界面。

更新 Edge 界面

如需更新 Edge 界面组件，请考虑要升级的 Private Cloud 的 Edge 版本：

• 从 4.51.00 到 4.52.00（已安装新的 Edge 界面）：针对 edge-management-ui 组件按照本部分的升级说明。

使用 Apigee mTLS 进行更新

如需更新 Apigee mTLS，请执行以下步骤：

• 卸载 Apigee mTLS。
• 重新安装 Apigee mTLS。

回滚更新

如果更新失败，您可以尝试修正问题，然后再次执行 update.sh。您可以多次运行更新，并从上次中断的位置继续更新。

如果失败操作需要您将更新回滚到之前的版本，请参阅回滚 4.52.00 了解详细说明。

Logging 更新信息

默认情况下，update.sh 实用程序会将日志信息写入到：

/opt/apigee/var/log/apigee-setup/update.log

如果运行 update.sh 实用程序的人员无权访问该目录，它会将日志作为名为 update_username.log 的文件写入 /tmp 目录。

如果该人员无权访问 /tmp，则 update.sh 实用程序会运行失败。

零停机更新

零停机更新或滚动更新可让您更新 Edge 安装，而无需关闭 Edge。

零停机更新仅适用于 5 节点及更大的节点配置。

零停机升级的关键是从负载平衡器中移除每个路由器（一次一个）。然后，在路由器的同一台计算机上更新该路由器以及任何其他组件，再将该路由器添加回负载平衡器。

1. 按照机器更新的顺序中的说明，按照正确的安装顺序更新机器。
2. 在更新路由器时，选择任意一个路由器并使其无法访问，如启用/停用服务器（消息处理器/路由器）可达性中所述。
3. 更新该路由器所在机器上的所选路由器和所有其他 Edge 组件。 所有边缘配置都在同一节点上显示路由器和消息处理器。
4. 使该路由器可再次访问。
5. 对其余路由器重复步骤 2 到 4。
6. 继续更新安装中的所有剩余计算机。

更新前后请注意以下事项：

• 在合并的路由器和消息处理器节点上：
  • 更新之前，请执行以下操作：
    1. 使路由器无法访问。
    2. 使消息处理器无法访问。
  • 更新后，执行以下操作：
    1. 使消息处理器可访问。
    2. 使路由器可访问。
• 在单个路由器节点上：
  • 在更新之前，请使路由器无法访问。
  • 更新后，使路由器可到达。
• 在单个消息处理器节点上：
  • 更新前，请将消息设为无法访问消息处理器。
  • 更新后，使消息处理器可访问。

使用静默配置文件

您必须向 update 命令传递静默配置文件。静默配置文件应该与您安装 Edge 4.50.00 或 4.51.00 时所用的配置文件相同。

在具有外部互联网连接的节点上更新到 4.52.01

请按以下步骤更新节点上的 Edge 组件：

1. 停用任何配置为在 Cassandra 上执行修复操作的 cron 作业，直到更新完成为止。
2. 以根用户身份登录您的节点以安装 Edge RPM。
3. 安装 yum-utils 和 yum-plugin-priorities：

   sudo yum install yum-utils
   sudo yum install yum-plugin-priorities

4. 按照安装 Edge apigee-setup 实用程序的说明停用 SELinux。
5. 如果要在 Oracle 7.x 上进行安装，请执行以下命令：

   sudo yum-config-manager --enable ol7_optional_latest

6. 如果您要在 AWS 上安装，请执行以下 yum-configure-manager 命令：

   yum update rh-amazon-rhui-client.noarch
   sudo yum-config-manager --enable rhui-REGION-rhel-server-extras rhui-REGION-rhel-server-optional

7. 如果您目前使用的是 Edge 4.51.00：

   1. 将 Edge bootstrap_4.52.01.sh 文件下载到 /tmp/bootstrap_4.52.01.sh：

      curl https://software.apigee.com/bootstrap_4.52.01.sh -o /tmp/bootstrap_4.52.01.sh

   2. 执行以下命令，安装 Edge 4.52.01 apigee-service 实用程序和依赖项：

      sudo bash /tmp/bootstrap_4.52.01.sh apigeeuser=uName apigeepassword=pWord

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

      默认情况下，安装程序会检查您是否安装了 Java 1.8。如果您没有安装此应用，安装程序会为您安装。

      使用 JAVA_FIX 选项指定如何处理 Java 安装。JAVA_FIX 采用以下值：

      • I：安装 OpenJDK 1.8（默认）。
      • C：在不安装 Java 的情况下继续。
      • Q：退出。对于此选项，您必须自行安装 Java。
   3. 使用 apigee-service 更新 apigee-setup 实用程序，如以下示例所示：

      /opt/apigee/apigee-service/bin/apigee-service apigee-setup update

   4. 更新管理服务器上的 apigee-validate 实用程序，如以下示例所示：

      /opt/apigee/apigee-service/bin/apigee-service apigee-validate update

   5. 更新管理服务器上的 apigee-provision 实用程序，如以下示例所示：

      /opt/apigee/apigee-service/bin/apigee-service apigee-provision update

   6. 执行以下命令，在您的节点上运行 update 实用程序：

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

      请按照机器更新的顺序中描述的顺序执行此操作。

      其中：

      • component 是要更新的 Edge 组件。可能的值包括：
        • cs：Cassandra
        • edge：所有边缘组件（边缘界面除外）：管理服务器、消息处理器、路由器、QPID 服务器、Postgres Server
        • ldap：OpenLDAP
        • ps：postgresql
        • qpid：qpidd
        • sso：Apigee SSO（如果您安装了 SSO）
        • ue：新的 Edge 界面
        • ui：传统版 Edge 界面
        • zk：Zookeeper
      • configFile 是在 4.50.00 或 4.51.00 安装期间用于定义 Edge 组件的配置文件。

      您可以对所有组件运行 update.sh，只需将 component 设置为“all”，但前提是您拥有 Edge 一体式 (AIO) 安装配置文件。例如：

      /opt/apigee/apigee-setup/bin/update.sh -c all -f ./sa_silent_config

   7. 在运行 Edge 界面组件的所有节点上重启该组件（如果您尚未执行此操作）：

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

   8. 按照测试安装中的说明，通过在管理服务器上运行 apigee-validate 实用程序来测试更新。

如果您以后决定回滚更新，请按照回滚 4.52.01 中所述的过程进行操作。

从本地代码库更新到 4.52.01

如果您的 Edge 节点设有防火墙，或者以其他方式被禁止通过互联网访问 Apigee 代码库，则您可以通过 Apigee 代码库的本地代码库或镜像执行更新。

创建本地 Edge 代码库后，您可以通过以下两种方式从本地代码库更新 Edge：

• 创建代码库的 .tar 文件，将 .tar 文件复制到节点，然后从 .tar 文件更新 Edge。
• 在具有本地代码库的节点上安装 Web 服务器，以便其他节点可以访问该服务器。Apigee 提供 Nginx Web 服务器供您使用，您也可以使用自己的 Web 服务器。

如需从本地 4.52.01 代码库进行更新，请执行以下操作：

1. 按照安装 Edge apigee-setup 实用程序中的“创建本地 Apigee 代码库”中的说明创建本地 4.52.01 代码库。
2. 通过 .tar 文件安装 apigee-service：
   1. 在包含本地代码库的节点上，使用以下命令将本地代码库打包到名为 /opt/apigee/data/apigee-mirror/apigee-4.52.01.tar.gz 的单个 .tar 文件中：

      /opt/apigee/apigee-service/bin/apigee-service apigee-mirror package

   2. 将 .tar 文件复制到您要在其中更新 Edge 的节点。例如，将其复制到新节点上的 /tmp 目录。
   3. 在新节点上，将文件解压缩到 /tmp 目录：

      tar -xzf apigee-4.52.01.tar.gz

      此命令会在包含 .tar 文件的目录中创建一个名为 repos 的新目录。例如 /tmp/repos。

   4. 从 /tmp/repos 安装 Edge apigee-service 实用程序和依赖项：

      sudo bash /tmp/repos/bootstrap_4.52.01.sh apigeeprotocol="file://" apigeerepobasepath=/tmp/repos

      请注意，您在此命令中添加了 repos 目录的路径。

3. 如需使用 Nginx Web 服务器安装 apigee-service，请执行以下操作：
   1. 按照安装 Edge apigee-setup 实用程序中的“使用 Nginx Web 服务器从代码库安装”中的说明配置 Nginx Web 服务器。
   2. 在远程节点上，将 Edge bootstrap_4.52.01.sh 文件下载到 /tmp/bootstrap_4.52.01.sh：

      /usr/bin/curl http://uName:pWord@remoteRepo:3939/bootstrap_4.52.01.sh -o /tmp/bootstrap_4.52.01.sh

      其中，uName:pWord 是您之前为代码库设置的用户名和密码，remoteRepo 是代码库节点的 IP 地址或 DNS 名称。

   3. 在远程节点上，安装 Edge apigee-setup 实用程序和依赖项：

      sudo bash /tmp/bootstrap_4.52.01.sh apigeerepohost=remoteRepo:3939 apigeeuser=uName apigeepassword=pWord apigeeprotocol=http://

      其中，uName:pWord 是代码库用户名和密码。

4. 使用 apigee-service 更新 apigee-setup 实用程序，如以下示例所示：

   /opt/apigee/apigee-service/bin/apigee-service apigee-setup update 

5. 更新管理服务器上的 apigee-validate 实用程序，如以下示例所示：

   /opt/apigee/apigee-service/bin/apigee-service apigee-validate update

6. 更新管理服务器上的 apigee-provision 实用程序，如以下示例所示：

   /opt/apigee/apigee-service/bin/apigee-service apigee-provision update

7. 按照机器更新的顺序中所述的顺序在您的节点上运行 update 实用程序：

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

   其中：

   • component 是要更新的 Edge 组件。您通常需要更新以下组件：
     • cs：Cassandra
     • edge：所有边缘组件（边缘界面除外）：管理服务器、消息处理器、路由器、QPID 服务器、Postgres Server
     • ldap：OpenLDAP
     • ps：postgresql
     • qpid：qpidd
     • sso：Apigee SSO（如果您安装了 SSO）
     • ue 新的 Edge 界面
     • ui：传统版 Edge 界面
     • zk：Zookeeper
   • configFile 与您在 4.50.00 或 4.51.00 安装期间定义 Edge 组件时所用的配置文件相同。

   您可以对所有组件运行 update.sh，只需将 component 设置为“all”，但前提是您拥有 Edge 一体式 (AIO) 安装配置文件。例如：

   /opt/apigee/apigee-setup/bin/update.sh -c all -f /tmp/sa_silent_config

8. 在运行界面组件的所有节点上重启界面组件（如果您尚未执行此操作）：

   /opt/apigee/apigee-service/bin/apigee-service [edge-management-ui|edge-ui] restart

9. 按照测试安装中的说明，通过在管理服务器上运行 apigee-validate 实用程序来测试更新。

如果您以后决定回滚更新，请按照回滚 4.52.01 中所述的过程进行操作。

机器更新顺序

在安装 Edge 时更新机器的顺序非常重要：

• 您必须先更新所有 Cassandra 和 ZooKeeper 节点，然后才能更新任何其他节点。
• 对于具有多个边缘组件（管理服务器、消息处理器、路由器、QPID 服务器，但不是 Postgres Server）的任何机器，请使用 -c edge 选项同时更新所有组件。
• 如果某个步骤指定应在多台机器上执行，则按指定的机器顺序执行。
• 若要更新创收功能，没有单独的步骤。当您指定 -c edge 选项时，它会更新。

单节点独立升级

如需将单节点独立配置升级到 4.52.01，请执行以下操作：

1. 更新所有组件：

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

2. （如果您安装了 apigee-adminapi）更新了 apigee-adminapi 实用程序：

   /opt/apigee/apigee-service/bin/apigee-service apigee-adminapi update

双节点独立升级

针对双节点独立安装，更新以下组件：

如需查看 Edge 拓扑和节点数列表，请参阅安装拓扑。

1. 在机器 1 上更新 Cassandra 和 ZooKeeper：

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

2. 在机器 2 上更新 Postgres：

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

3. 更新机器 1 上的 LDAP：

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

4. 更新机器 2 和 1 上的 Edge 组件：

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

5. 在机器 2 上更新 Qpid：

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

6. 更新机器 1 上的界面：

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

7. （如果您安装了 apigee-adminapi）更新了机器 1 上的 apigee-adminapi 实用程序：

   /opt/apigee/apigee-service/bin/apigee-service apigee-adminapi update

8. （如果您安装了 Apigee SSO）在机器 1 上更新 Apigee SSO：

   /opt/apigee/apigee-setup/bin/update.sh -c sso -f sso_config_file

   其中，sso_config_file 是您在安装 SSO 时创建的配置文件。

9. 在机器 1 上重启 Edge 界面组件：

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

5 节点升级

针对 5 节点安装更新以下组件：

如需查看 Edge 拓扑和节点数列表，请参阅安装拓扑。

1. 在机器 1、2 和 3 上更新 Cassandra 和 ZooKeeper：

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

2. 在机器 4 上更新 Postgres：

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

3. 在机器 5 上更新 Postgres：

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

4. 更新机器 1 上的 LDAP：

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

5. 更新机器 4、5、1、2、3 上的 Edge 组件：

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

6. 在机器 4 上更新 Qpid：

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

7. 在机器 5 上更新 Qpid：

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

8. 更新 Edge 界面：
   • 传统版界面：如果您使用的是传统版界面，请更新机器 1 上的 ui 组件，如以下示例所示：

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

   • 新的 Edge 界面：如果您安装了新的 Edge 界面，请在相应的机器（可能不是机器 1）上更新 ue 组件：

     /opt/apigee/apigee-setup/bin/update.sh -c ue -f /opt/silent.conf

9. （如果您安装了 apigee-adminapi）更新了机器 1 上的 apigee-adminapi 实用程序：

   /opt/apigee/apigee-service/bin/apigee-service apigee-adminapi update

10. （如果您安装了 Apigee SSO）在机器 1 上更新 Apigee SSO：

    /opt/apigee/apigee-setup/bin/update.sh -c sso -f sso_config_file

    其中，sso_config_file 是您在安装 SSO 时创建的配置文件。

11. 重启界面组件：
    • 传统版界面：如果您使用的是传统版界面，请在机器 1 上重启 edge-ui 组件，如以下示例所示：

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

    • 新的 Edge 界面：如果您安装了新的 Edge 界面，请在相应的机器（可能不是机器 1）上重启 edge-management-ui 组件：

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

9 节点集群升级

针对 9 节点集群安装更新以下组件：

如需查看 Edge 拓扑和节点数列表，请参阅安装拓扑。

1. 在机器 1、2 和 3 上更新 Cassandra 和 ZooKeeper：

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

2. 在机器 8 上更新 Postgres：

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

3. 在机器 9 上更新 Postgres：

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

4. 更新机器 1 上的 LDAP：

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

5. 按以下顺序更新机器 6、7、8、9、1、4 和 5 上的 Edge 组件：

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

6. 在机器 6 和 7 上更新 Qpid：

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

7. 更新机器 1 上的新界面 (ue) 或传统版界面 (ui)：

   /opt/apigee/apigee-setup/bin/update.sh -c [ui|ue] -f configFile

8. （如果您安装了 apigee-adminapi）更新机器 1 上的 apigee-adminapi 实用程序：

   /opt/apigee/apigee-service/bin/apigee-service apigee-adminapi update

9. （如果您安装了 Apigee SSO）在机器 1 上更新 Apigee SSO：

   /opt/apigee/apigee-setup/bin/update.sh -c sso -f sso_config_file

   其中，sso_config_file 是您在安装 SSO 时创建的配置文件。

10. 重启界面组件：
    • 传统版界面：如果您使用的是传统版界面，请在机器 1 上重启 edge-ui 组件，如以下示例所示：

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

    • 新的 Edge 界面：如果您安装了新的 Edge 界面，请在相应的机器（可能不是机器 1）上重启 edge-management-ui 组件：

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

13 节点集群升级

针对 13 节点集群安装更新以下组件：

如需查看 Edge 拓扑和节点数列表，请参阅安装拓扑。

1. 在机器 1、2 和 3 上更新 Cassandra 和 ZooKeeper：

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

2. 在机器 8 上更新 Postgres：

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

3. 在机器 9 上更新 Postgres：

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

4. 更新机器 4 和 5 上的 LDAP：

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

5. 按以下顺序更新机器 12、13、8、9、6、7、10 和 11 上的 Edge 组件：

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

6. 在机器 12 和 13 上更新 Qpid：

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

7. 更新计算机 6 和 7 上的新界面 (ue) 或传统版界面 (ui)：

   /opt/apigee/apigee-setup/bin/update.sh -c [ui|ue] -f configFile

8. （如果您安装了 apigee-adminapi）更新了机器 6 和 7 上的 apigee-adminapi 实用程序：

   /opt/apigee/apigee-service/bin/apigee-service apigee-adminapi update

9. （如果您在机器 6 和 7 上安装了 Apigee SSO）更新 Apigee SSO：

   /opt/apigee/apigee-setup/bin/update.sh -c sso -f sso_config_file

   其中，sso_config_file 是您在安装 SSO 时创建的配置文件。

10. 重启界面组件：
    • 传统版界面：如果您使用的是传统版界面，请在机器 6 和机器 7 上重启 edge-ui 组件，如以下示例所示：

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

    • 新版 Edge 界面：如果您安装了新版 Edge 界面，请在机器 6 和机器 7 上重启 edge-management-ui 组件：

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

12 节点集群升级

针对 12 节点集群安装更新以下组件：

如需查看 Edge 拓扑和节点数列表，请参阅安装拓扑。

1. 更新 Cassandra 和 ZooKeeper：
   1. 在数据中心 1 的机器 1、2 和 3 上：

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

   2. 在数据中心 2 的机器 7、8 和 9 上

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

2. 更新 Postgres：
   1. 数据中心 1 中的机器 6

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

   2. 数据中心 2 中的机器 12

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

3. 更新 LDAP：
   1. 数据中心 1 中的机器 1

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

   2. 数据中心 2 中的机器 7

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

4. 更新 Edge 组件：
   1. 数据中心 1 中的机器 4、5、6、1、2、3

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

   2. 数据中心 2 中的机器 10、11、12、7、8、9

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

5. 更新 qpidd：
   1. 数据中心 1 中的机器 4、5
      1. 在机器 4 上更新 qpidd：

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

      2. 更新机器 5 上的 qpidd：

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

   2. 数据中心 2 中的机器 10、11
      1. 在机器 10 上更新 qpidd ：

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

      2. 在机器 11 上更新 qpidd ：

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

6. 更新新界面 (ue) 或传统版界面 (ui)：
   1. 数据中心 1 中的机器 1：

      /opt/apigee/apigee-setup/bin/update.sh -c [ui|ue] -f configFile

   2. 数据中心 2 中的机器 7：

      /opt/apigee/apigee-setup/bin/update.sh -c [ui|ue] -f configFile

7. （如果您安装了 apigee-adminapi）更新了 apigee-adminapi 实用程序：
   1. 数据中心 1 中的机器 1：

      /opt/apigee/apigee-service/bin/apigee-service apigee-adminapi update

   2. 数据中心 2 中的机器 7：

      /opt/apigee/apigee-service/bin/apigee-service apigee-adminapi update

8. （如果您安装了 Apigee SSO）更新 Apigee SSO：
   1. 数据中心 1 中的机器 1：

      /opt/apigee/apigee-setup/bin/update.sh -c sso -f sso_config_file

   2. 数据中心 2 中的机器 7：

      /opt/apigee/apigee-setup/bin/update.sh -c sso -f sso_config_file

   其中，sso_config_file 是您在安装 SSO 时创建的配置文件。

9. 在机器 1 和 7 上重启新的 Edge 界面 (edge-management-ui) 或传统版 Edge 界面 (edge-ui) 组件：

   /opt/apigee/apigee-service/bin/apigee-service [edge-ui|edge-management-ui] restart

对于非标准配置

如果您有非标准配置，请按以下顺序更新 Edge 组件：

1. ZooKeeper
2. Cassandra
3. ps
4. LDAP
5. 边缘，表示所有节点上按顺序排列的“-c 边缘”配置文件：具有 Qpid 服务器的节点、Edge Postgres 服务器、管理服务器、消息处理器和路由器。
6. Qpidd
7. Edge 界面（传统版或新版）
8. apigee-adminapi
9. Apigee 单点登录

完成更新后，请务必在所有运行 Edge 界面组件的计算机上重启该组件。