将 Apigee Edge 4.51.00、4.52.00 或 4.52.01 更新为 4.52.02

Apigee 支持将 Edge for Private Cloud 直接从 4.51.00、4.52.00 或 4.52.01 版本升级到 4.52.02 版本。本页介绍了如何执行此类升级。

谁可以执行更新

运行更新的用户应与最初安装 Edge 的用户相同，或者是运行以 root 身份运行的用户。

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

您必须更新哪些组件

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

更新前提条件

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

• 备份所有节点
  出于安全考虑，我们建议您在更新之前对所有节点执行完整备份。使用适用于您当前 Edge 版本的步骤进行备份。

  这样，您就可以在更新到新版本时出现问题时，采取备用方案。如需详细了解备份，请参阅备份和恢复。

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

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

• 确保 Cassandra 压缩策略为 LeveledCompactionStrategy
  根据您当前的版本，对 Cassandra 压缩策略进行必要的更改。请按以下步骤操作，然后返回到主要升级流程：
  • 如果您要从 4.51.00 版升级，请参阅 适用于 v4.51.00 的 Cassandra 压缩策略文档。
  • 如果您要从 4.52.00 版升级，请参阅 适用于 v4.52.00 的 Cassandra 压缩策略文档。
  • 如果您要从 4.52.01 版升级，请参阅 适用于 v4.52.01 的 Cassandra 压缩策略文档。

升级时应考虑哪些特殊步骤

如需升级到 Edge for Private Cloud 4.52.02，请考虑运行升级特定软件的具体步骤。具体步骤取决于您当前使用的版本。请参阅下表，了解需要执行补充步骤的各种软件，并按照每种软件的详细说明操作。完成必要的任务后，返回主升级流程以继续升级过程。

根据您的版本执行必要的步骤后，返回主升级流程以继续。

自动传播房源设置

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

必须升级到 Cassandra 3.11.16

Apigee Edge for Private Cloud 4.52.02 包括将 Cassandra 升级到 3.11.16 版。Cassandra 是 Apigee 的一项关键组件，此次升级还包括对用于查询 Cassandra 和向其写入数据的各种运行时和管理组件中的驱动程序软件的更新。

由于这是一项重大升级，因此必须对 Cassandra 中的 Apigee 数据模型进行一些更改，以确保新版本中的性能达到最佳。虽然这些变更微不足道，但升级过程会中断某些管理 API，从而影响 Apigee 界面和开发者门户。下文档详细说明了哪些 API 将无法正常运行，并简要介绍了升级期间中断开始和结束的时间点。重要的是，升级期间运行时流量不应中断。

概要回滚

一次升级一个 Cassandra 节点。更新节点后，某些架构更改会立即生效，并且无法直接回滚。请仔细阅读“回滚”部分，因为您可以根据集群升级的程度使用不同的方法。

如果您需要在升级整个 Cassandra 集群后回滚升级，唯一的选择是恢复备份。为此做好准备，并熟悉 Cassandra 备份恢复。如果您可以比 Apigee 备份更快地恢复虚拟机级快照，请使用虚拟机快照将 Cassandra 虚拟机恢复到较早的状态。

如需了解详情，请参阅回滚 Cassandra 3.11.16 更新部分。

在开发者门户中为 API 编写文档

Apigee Drupal 开发者门户提供了各种用于记录 API 的功能。虽然我们建议您停止使用基于 Drupal 7 的开发者门户，但如果您仍在使用该门户并利用其 SmartDocs 功能，则 使用 SmartDocs API 文档适用于您。如果您使用的是较新版本的开发者门户，则此次升级对您的 API 文档没有影响。

将 Apigee 升级到 4.52.02 版后，使用 Drupal 7 开发者门户的 SmartDocs 功能创建的任何 API 模型都不会自动迁移到新版本。您需要使用开发者门户手动导出每个模型，并在完成升级后重新导入。

以下部分中使用的术语

运行时：运行时涵盖运行时代理流量的处理。它包含路由器和消息处理器执行的所有操作，以便有效处理现有代理的运行时 API 请求。但不包括部署新的代理或代理的新修订版本。

管理：管理包括 Apigee Edge 系统的管理。这包括但不限于应用、产品、目标服务器、密钥库等的部署和修改。所有管理 API（及其客户端，例如 Apigee 界面和开发者门户）都包含在此范围内。

在以下每个步骤中，都会介绍您在升级流程的各个阶段中运行时和管理状态。请注意，升级期间不会对运行时流量产生影响。不过，一小部分管理 API 和开发者门户功能受到了影响。

第 0 步：开始状态

1. Apigee 中的 Cassandra 运行版本为 2.1.22。
2. Edge for Private Cloud 4.52.02 组件：
• 管理服务器通过较旧的 Thrift 协议与 Cassandra 通信。
• 运行时服务器（消息处理器和路由器）通过旧版 Thrift 协议与 Cassandra 通信。

此阶段的运行时状态	此阶段的管理状态
运行时完全正常运行	管理功能完全正常

第 1 步：准备升级

除了您通常创建的标准文件（例如用于启用组件升级的 Apigee 标准配置文件）之外，您还需要执行以下步骤。

1. 将 Cassandra 更改为使用 LeveledCompactionStrategy。
2. 使用 Apigee 备份 Cassandra。
3. 为 Cassandra 节点创建虚拟机快照（如果可行）。
4. 在每个 Cassandra 节点的 /opt/apigee/apigee-cassandra/cass_upgrade.conf 位置创建一个 Cassandra 升级配置文件，其中包含以下内容：

   # IP Address of node
   HOSTIP=10.0.0.1
   
   # Username for running Cassandra queries. Optional. Can be skipped if you have not enabled Cassandra authentication.
   CASS_USERNAME=<cassuser>
   
   # Password for running Cassandra queries. Optional. Can be skipped if you have not enabled Cassandra authentication.
   CASS_PASSWORD=<casspass>
   
   # Port for connecting to Cassandra via thrift. Optional. Defaults to 9160 if skipped.
   CASS_PORT=9160
   
   # Port for connecting to Cassandra via CQL. Optional. Defaults to 9042 if skipped.
   CASS_CQL_PORT=9042
   
   # Directory to be used by Cassandra upgrade scripts. Optional. Defaults to /tmp/cass_upgrade_scripts if skipped.
   # Note that if upgrade is successful, this directory is deleted via root user - so provide a directory accordingly.
   CASS_TMP_DIR=/tmp/cass_upgrade_scripts
       

   如果无法在 /opt/apigee/apigee-cassandra/cass_upgrade.conf 位置创建文件，请在每个 Cassandra 节点上创建内容相同的文件 /opt/silent.conf。

• 如果您使用 Apigee Drupal 7 开发者门户的 SmartDocs 功能，请从开发者门户界面以 JSON 格式下载每个模型，以导出这些模型。更新管理服务器后，需要将这些模型重新导入 Apigee。
• 确保所有 Edge for Private Cloud 4.52.02 组件都可以访问 Cassandra 节点的端口 9160 和 9042（如果尚不存在）。如需了解详情，请参阅端口要求。

第 2 步：升级所有 Cassandra 节点

1. 逐个升级所有区域中的所有 Cassandra 节点。在每个节点上运行以下命令：

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

2. 更新节点后，请在继续操作之前，先在节点上运行以下命令以运行一些验证：

   /opt/apigee/apigee-service/bin/apigee-service apigee-cassandra validate_upgrade -f configFile

3. 上述命令会输出如下内容：

   Cassandra version is verified - [cqlsh 5.0.1 | Cassandra 3.11.16 | CQL spec 3.4.4 | Native protocol v3] Metadata is verified

此阶段的运行时状态	此阶段的管理状态
运行时完全正常运行	升级 Cassandra 后，以下管理功能会降级： 使用 Management API 创建具有环境的 API 产品 使用 Management API 更新具有环境的 API 产品 用于删除组织的 Management API

第 3 步：升级所有管理节点

逐个升级所有区域中的所有管理节点：

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

运行时状态	管理状态
运行时完全正常运行	Management API 降级： Drupal 7 开发者门户的 SmartDocs 功能不显示任何数据

第 3a 步：[可选] 导入之前导出的 SmartDocs

升级所有管理服务器后，您可以导入在第 1 步中导出的 SmartDocs 模型。您也可以稍后再执行此操作。

运行时状态	管理状态
运行时完全正常运行	管理功能完全正常

第 4 步：升级所有运行时节点

逐个升级所有区域中的所有路由器和消息处理器节点：

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

运行时状态	管理状态
运行时完全正常运行	管理功能完全正常

第 5 步：升级所有剩余的 Edge for Private Cloud 4.52.02 组件

逐个升级所有区域中所有剩余的 edge-qpid-server 和 edge-postgres-server 节点。

在此阶段，如果您要从 Edge for Private Cloud 4.52.01 之前的版本升级，并且要按照额外的步骤升级 Qpid 或 Postgres，请按照相应步骤进行升级。

运行时状态	管理状态
运行时完全正常运行	管理功能完全正常

第 6 步：升级后步骤

升级完成后，请依次在每个 Cassandra 节点上运行以下命令：

/opt/apigee/apigee-service/bin/apigee-service apigee-cassandra post_upgrade

运行以下命令可从 Cassandra 集群中删除旧的未使用的表。在运行此脚本之前，您无法使用 Cassandra 的某些功能（例如设置新的身份验证机制 - 旧的身份验证机制将继续有效）。此命令只能在集群中的 1 个节点上执行：

/opt/apigee/apigee-service/bin/apigee-service apigee-cassandra drop_old_tables -f configFile

如果您尚未完成第 3a 步，请先完成该步骤。

运行时状态	管理状态
运行时完全正常运行	管理功能完全正常

必须升级到 Zookeeper 3.8.3

虽然 Edge for Private Cloud 4.52.02 不包含对 Zookeeper 的升级，但如果您要从低于 4.52.01 的版本升级，则需要按照相应步骤升级 Zookeeper。

• 如果您要从 Edge for Private Cloud 版本 4.51.00 或 4.52.00 升级，请参阅必须升级到 Zookeeper 3.8.3 中的步骤升级 Zookeeper。
• 如果您要从 Edge for Private Cloud 4.52.01 版升级，则应该已经在使用 Zookeeper 3.8.3 版，并且无需按照任何特殊步骤升级 Zookeeper。

必须升级到 Postgres 14

• 如果您要从 Edge for Private Cloud 4.51.00 升级到 4.52.02，则必须按照相应步骤升级 Postgres，即使 Edge for Private Cloud 4.52.02 不包含 Postgres 升级也是如此。从 Edge Private Cloud 4.51.00 升级到 4.52.02 需要额外的 Postgres 升级步骤。请参阅必须升级到 Postgres 14部分。
• 如果您要从 Edge for Private Cloud 4.52.00 或 4.52.01 升级到 4.52.02，则无需执行额外的 Postgres 升级步骤。

必须升级到 Qpid J-Broker

虽然 Edge for Private Cloud 4.52.02 不包含升级到 QPID 的步骤，但如果您要从低于 4.52.01 的版本升级，则需要按照相应步骤升级 QPID。

• 如果您要从 Edge for Private Cloud 4.51.00 或 4.52.00 升级到 4.52.02，则必须按照额外的 QPID 升级步骤操作。如果您要从版本 4.51.00 或 4.52.00 升级到 4.52.02，请参阅升级 Qpid 部分。
• 如果您要从 Edge for Private Cloud 4.52.01 升级到 4.52.02，则应该已经在使用最新版本的 Qpid Broker，无需执行其他 QPID 升级步骤。

新版 Edge 界面

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

安装 Edge 界面

完成初始安装后，Apigee 建议您安装 Edge 界面，这是面向 Apigee Edge for Private Cloud 开发者和管理员的增强型界面。

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

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

更新 Edge 界面

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

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

更新为 Apigee mTLS

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

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

回滚更新

如果更新失败，您可以尝试解决问题，然后再次执行 update.sh。您可以多次运行此更新，系统会从上次中断的位置继续更新。

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

日志记录更新信息

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

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

如果运行 update.sh 实用程序的用户无权访问该目录，则该实用程序会将日志写入 /tmp 目录，并将其命名为 update_username.log。

如果用户无权访问 /tmp，update.sh 实用程序将失败。

零停机时间更新

零停机更新（也称为滚动更新）可让您在不停用 Edge 的情况下更新 Edge 安装。

只有配置为 5 个节点或更多节点时，才能实现零停机更新。

实现零停机升级的关键是从负载平衡器中逐个移除每个路由器。然后，更新与路由器位于同一计算机上的路由器和任何其他组件，然后将路由器重新添加到负载平衡器。

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

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

• 在路由器和消息处理器组合节点上：
  • 更新前 - 执行以下操作：
    1. 使路由器不可访问。
    2. 使消息处理器不可访问。
  • 更新后 - 执行以下操作：
    1. 使消息处理器可访问。
    2. 使路由器可访问。
• 在单个路由器节点上：
  • 在更新之前，使路由器不可访问。
  • 更新后，使路由器可访问。
• 在单个消息处理器节点上：
  • 在更新之前，使消息处理器不可访问。
  • 更新后，使消息处理器可访问。

使用静默配置文件

您必须将静默配置文件传递给更新命令。静默配置文件应与您安装 Edge 4.50.00 或 4.51.00 时使用的配置文件相同。

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

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

1. 在更新完成之前，停用配置为对 Cassandra 执行修复操作的所有 cron 作业（如果有）。
2. 以 root 用户身份登录节点以安装 Edge RPM。
3. 安装 yum-utils 和 yum-plugin-priorities：

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

4. 停用 SELinux，如安装 Edge apigee-setup 实用程序中所述。
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.02.sh 文件下载到 /tmp/bootstrap_4.52.02.sh：

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

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

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

      其中，uName:pWord 是您从 Apigee 收到的用户名和密码。如果您省略 pWord，系统会提示您输入 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：除 Edge 界面之外的所有 Edge 组件：管理服务器、消息处理器、路由器、QPID 服务器、Postgres 服务器
        • ldap：OpenLDAP
        • ps：postgresql
        • qpid：qpidd
        • sso：Apigee SSO（如果您已安装 SSO）
        • ue：新的 Edge 界面
        • ui：Edge 经典版界面
        • zk：Zookeeper
      • configFile 是您在安装 4.50.00 或 4.51.00 时用于定义 Edge 组件的配置文件。

      您可以通过将 component 设置为“all”来针对所有组件运行 update.sh，但前提是您拥有 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.02 中所述的步骤。

从本地代码库更新到 4.52.02

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

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

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

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

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

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

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

      tar -xzf apigee-4.52.02.tar.gz

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

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

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

      请注意，您需要在此命令中添加代码库目录的路径。

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

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

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

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

      sudo bash /tmp/bootstrap_4.52.02.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：除 Edge 界面之外的所有 Edge 组件：管理服务器、消息处理器、路由器、QPID 服务器、Postgres 服务器
     • ldap：OpenLDAP
     • ps：postgresql
     • qpid：qpidd
     • sso：Apigee SSO（如果您已安装 SSO）
     • ue 新版 Edge 界面
     • ui：Edge 经典版界面
     • zk：Zookeeper
   • configFile 是您在安装 4.50.00 或 4.51.00 期间用于定义 Edge 组件的配置文件。

   您可以通过将 component 设置为“all”来针对所有组件运行 update.sh，但前提是您拥有 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.02 中所述的步骤。

机器更新顺序

更新 Edge 安装中的计算机的顺序非常重要：

• 您必须先更新 所有 Cassandra 和 ZooKeeper 节点，然后才能更新任何其他节点。
• 对于具有多个 Edge 组件（管理服务器、消息处理器、路由器、QPID 服务器，但不包括 Postgres 服务器）的任何机器，请使用 -c edge 选项同时更新它们。
• 如果某个步骤指定应在多台机器上执行，请按指定的机器顺序执行该步骤。
• 无需单独执行任何步骤即可更新创收设置。当您指定 -c edge 选项时，该值会更新。

1 个节点的独立升级

如需将 1 个节点的独立配置升级到 4.52.02，请执行以下操作：

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

2 个节点的独立升级

对于 2 节点的独立安装，请更新以下组件：

如需查看 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. （如果您安装了 Apigee SSO）在计算机 6 和 7 上更新 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. Edge，表示所有节点上的“-c edge”配置文件，按以下顺序：具有 Qpid 服务器的节点、Edge Postgres 服务器、管理服务器、消息处理器和路由器。
6. qpidd
7. Edge 界面（旧版或新版）
8. apigee-adminapi
9. Apigee SSO

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