将 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。本页介绍了如何执行此类升级。

<ph type="x-smartling-placeholder">。 。 。

谁可以执行更新

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

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

您必须更新哪些组件

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

<ph type="x-smartling-placeholder">

更新前提条件

在升级 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，并概述了升级过程中中断开始和结束时的步骤。重要的是，升级期间应该不会中断运行时流量。

<ph type="x-smartling-placeholder">。

高级别回滚

应用 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 文件。 <ph type="x-smartling-placeholder">

• 如果您使用 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 升级后，以下管理功能会降级： <ph type="x-smartling-placeholder"> </ph> 使用 Management API 创建具有环境的 API 产品 Management API，用于通过环境更新 API 产品 用于删除组织的 Management API

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

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

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

运行时状态	管理状态
运行时完全正常运行	Management API 已降级： <ph type="x-smartling-placeholder"> </ph> 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。

• 如果您要从适用于 Private Cloud 4.51.00 或 4.52.00 的 Edge 升级到 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 界面组件，请考虑您 升级前：

• 从 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 实用程序的人员无权访问 该目录下，它会将日志以名为/tmp update_username.log。

如果此人无权访问 /tmp，则使用 update.sh 实用程序 失败。

零停机更新

零停机更新或滚动更新，可让您在不停机更新的情况下 弃用了 Edge。

只有采用 5 节点及更大节点的配置才能实现零停机更新。

零停机升级的关键是从负载中移除每个路由器（一次一个） 进行负载均衡。然后，在与它相同的机器上更新路由器和任何其他组件， 然后将路由器添加回负载平衡器

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

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

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

使用静默配置文件

您必须将静默配置文件传递给 update 命令。静默配置文件 应与用于安装 Edge 4.50.00 或 4.51.00 的版本相同。

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

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

1. 如果有 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 实用程序，
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

      请按照设备 update。

      其中：

      • component 是要更新的 Edge 组件。可能的值包括： <ph type="x-smartling-placeholder">
        </ph>
        • cs：Cassandra
        • edge：除 Edge 界面之外的所有 Edge 组件：管理服务器、消息 处理器、路由器、QPID 服务器、Postgres 服务器
        • ldap：OpenLDAP
        • ps：postgresql
        • qpid：qpidd
        • sso：Apigee SSO（如果您安装了 SSO）
        • ue：新的 Edge 界面
        • ui：经典 Edge 界面
        • zk：Zookeeper
      • configFile 就是 定义您的优势 组件。

      您可以通过设置 component 针对所有组件运行 update.sh 设置为“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. 通过在 Management API 上运行 apigee-validate 实用程序来测试更新 服务器，如测试安装中所述。

如果以后决定回滚更新，请按照 回滚 4.52.02。

从本地代码库更新为 4.52.02

如果您的 Edge 节点受防火墙保护，或以其他方式被禁止访问 Apigee 代码库，然后便可从本地代码库执行更新， 也就是 Apigee 代码库的镜像

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

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

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

1. 按照“创建本地 Apigee 代码库”中的说明创建本地 4.52.02 代码库在 安装 Edge apigee-setup 实用程序。
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

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

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

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

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

3. 如需使用 Nginx Web 服务器安装 apigee-service，请执行以下操作：
   1. 按照“使用 Nginx 从代码库安装”中的说明配置 Nginx Web 服务器 网络服务器”Install the Edge apigee-setup 实用程序，
   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 组件。您通常需要更新 以下组件： <ph type="x-smartling-placeholder">
     </ph>
     • cs：Cassandra
     • edge：所有 Edge 组件（边缘界面除外）：管理服务器、消息处理器、路由器 QPID 服务器、Postgres 服务器
     • ldap：OpenLDAP
     • ps：postgresql
     • qpid：qpidd
     • sso：Apigee SSO（如果您安装了 SSO）
     • ue 新的 Edge 界面
     • ui：经典 Edge 界面
     • zk：Zookeeper
   • configFile 就是 定义 Edge 组件 4.50.00 或 4.51.00 安装期间。

   您可以通过设置 component 针对所有组件运行 update.sh 设置为“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. 通过在 Management API 上运行 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 界面： <ph type="x-smartling-placeholder">
   </ph>
   • 传统版界面：如果您使用的是传统版界面，请更新 ui 组件，如以下示例所示：

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

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

     /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. 重启界面组件： <ph type="x-smartling-placeholder">
    </ph>
    • 传统版界面：如果您使用的是传统版界面，请重启 edge-ui 组件，如以下示例所示：

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

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

      /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. 重启界面组件： <ph type="x-smartling-placeholder">
    </ph>
    • 传统版界面：如果您使用的是传统版界面，请重启 edge-ui 组件，如以下示例所示：

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

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

      /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 及以下版本上，更新新界面 (ue) 或传统版界面 (ui) 7：

   /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. 重启界面组件： <ph type="x-smartling-placeholder">
    </ph>
    • 传统版界面：如果您使用的是传统版界面，请重启 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： <ph type="x-smartling-placeholder">
   </ph>
   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： <ph type="x-smartling-placeholder">
   </ph>
   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： <ph type="x-smartling-placeholder">
   </ph>
   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 组件： <ph type="x-smartling-placeholder">
   </ph>
   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： <ph type="x-smartling-placeholder">
   </ph>
   1. 数据中心 1 中的机器 4、5 <ph type="x-smartling-placeholder">
      </ph>
      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 <ph type="x-smartling-placeholder">
      </ph>
      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. 重启新版 Edge 界面 (edge-management-ui) 或传统版 Edge 界面 (edge-ui) 组件（在机器 1 和 7 上）：

   /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 界面组件 。