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

Apigee 支持将适用于私有云的 Edge 直接从版本 4.51.00、4.52.00 或 4.52.01 升级到版本 4.52.02。本页介绍了如何执行此类升级。

谁可以执行更新

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

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

您必须更新哪些组件

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

更新前提条件

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

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

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

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

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

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

升级时需要考虑的特殊步骤

如需升级到适用于私有云 4.52.02 的 Edge，请考虑执行升级特定软件的具体步骤。必要的步骤取决于您的当前版本。请参阅下表，了解需要执行补充步骤的各种软件。本页后面的部分提供了各软件的详细讨论和具体步骤。

自动传播媒体资源设置

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

需要升级到 Cassandra 3.11.16

适用于私有云 4.52.02 的 Apigee Edge 包括将 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. 适用于 Private Cloud 4.52.02 组件的 Edge：
• 管理服务器通过旧版 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。
• 如果端口 9160 和 9042 尚不存在，请确保可从所有 Edge 对 Private Cloud 4.52.02 组件访问端口 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 步：升级 Private Cloud 4.52.02 组件的所有剩余 Edge

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

在此阶段，如果您要从适用于 Private Cloud 4.52.01 的 Edge 之前的版本进行升级，并且正在执行升级 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

虽然适用于私有云 4.52.02 的 Edge 不包含升级到 ZooKeeper，但如果您是从 4.52.01 之前的版本升级，则需要按照相应步骤升级 ZooKeeper。

• 如果您要从适用于 Private Cloud 的 Edge（4.51.00 或 4.52.00）升级，请参阅必须升级到 ZooKeeper 3.8.3 中的步骤以升级 ZooKeeper。
• 如果您要从适用于私有云的 Edge 版本 4.52.01 升级，那么您应该已经在使用 ZooKeeper 3.8.3 版本，不需要执行任何特殊步骤来升级 ZooKeeper。

必须升级到 Postgres 14

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

必须升级到 Qpid J-Broker

虽然适用于私有云 4.52.02 的 Edge 不包含升级到 QPID 的升级，但如果您要从 4.52.01 之前的版本升级，则需要按照相应步骤升级 QPID。

• 如果您要从适用于私有云的 Edge 4.51.00 或 4.52.00 升级到 4.52.02，则必须执行额外的 QPID 升级步骤。如果您要从 4.51.00 或 4.52.00 版本升级到 4.52.02，请参阅升级 Qpid 部分。
• 如果您要从适用于私有云的 Edge 4.52.01 升级到 4.52.02，您应该已经在使用最新版本的 Qpid Broker，无需再执行额外的 QPID 升级步骤。

新的 Edge 界面

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

安装 Edge 界面

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

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

如需了解详情，请参阅安装新的 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 组件。所有 Edge 配置都在同一节点上显示路由器和消息处理器。
4. 使路由器再次可连接。
5. 对其余的路由器重复步骤 2 到 4。
6. 继续更新安装中的所有剩余机器。

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

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

使用静默配置文件

您必须将静默配置文件传递给 update 命令。静默配置文件应与用于安装 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. 按照安装 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.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，系统会提示您输入。

      默认情况下，安装程序会检查您是否安装了 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 组件（边缘界面除外）：管理服务器、消息处理器、路由器、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 界面组件的节点上重启 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. 创建一个本地 4.52.02 代码库，如安装 Edge apigee-setup 实用程序中的“创建本地 Apigee 代码库”中所述。
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 组件（边缘界面除外）：管理服务器、消息处理器、路由器、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 节点。
• 对于具有多个边缘组件（管理服务器、消息处理器、路由器、QPID 服务器，但不包括 Postgres 服务器）的任何机器，请使用 -c edge 选项同时更新所有组件。
• 如果某个步骤指定应在多台机器上执行，请按指定的机器顺序执行该步骤。
• 更新创收功能没有单独的步骤。当您指定 -c edge 选项时，它会更新。

单节点独立升级

如需将单节点独立配置升级到 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

双节点独立升级

为双节点独立安装更新以下组件：

如需查看 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. 边缘，表示以下顺序所有节点上的“-c 边缘”配置文件：具有 Qpid 服务器、Edge Postgres 服务器、管理服务器、消息处理器和路由器的节点。
6. Qpidd
7. Edge 界面（传统版或新版）
8. apigee-adminapi
9. Apigee 单点登录

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