将 Apigee Edge 4.19.06 或 4.50.00 更新为 4.51.00

本部分介绍如何从 Apigee Edge 4.19.06 或 4.50.00 升级到 4.51.00。

谁可以执行更新

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

安装 Edge RPM 后，任何人都可以配置它们。

必须更新哪些组件

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

媒体资源设置自动传播

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

必须升级到 Postgres 10.17

此版本的 Edge 包含对 Postgres 10.17 的升级。在升级过程中，所有 Postgres 数据都将迁移到 Postgres 10.17。

大多数 Edge 生产系统使用两个针对主备用复制功能配置的 Postgres 节点。在更新过程中，虽然 Postgres 节点关闭以进行更新，但分析数据仍会写入 Qpid 节点。在 Postgres 节点更新并恢复在线状态后，分析数据会被推送到 Postgres 节点。

执行 Postgres 更新的方式取决于您为 Postgres 节点配置数据存储的方式：

• 如果您为 Postgres 节点使用本地数据存储，则必须在升级期间安装新的 Postgres 备用节点。升级完成后，您可以停用新的 Postgres 备用节点。

  如果您出于任何原因必须回滚更新，则需要额外的 Postgres 备用节点。如果必须回滚更新，新的 Postgres 备用节点会在回滚后成为 Postgres 主节点。因此，当您安装新的 Postgres 备用节点时，它应该位于满足 Edge 安装要求中定义的 Postgres 服务器所有硬件要求的节点上。

  在 Edge 的单节点和双节点配置（用于原型设计和测试的拓扑）中，您只有一个 Postgres 节点。您可以直接更新这些 Postgres 节点，而无需创建新的 Postgres 节点。

• 如果您为 Postgres 节点使用网络存储空间（按照 Apigee 的建议），则无需安装新的 Postgres 节点。在下面的过程中，您可以跳过指定安装并在稍后停用新的 Postgres 备用节点的步骤。

  在开始更新流程之前，请为 Postgres 使用的数据存储区截取网络快照。然后，如果更新期间发生任何错误且您被迫执行回滚，您可以从该快照中恢复 Postgres 节点。

安装新的 Postgres 备用节点

此过程会在新节点上创建一个 Postgres 备用服务器。确保为现有 Edge 版本（4.19.06 或 4.50.00）而不是版本 4.51.00 安装新的 Postgres 备用服务器。

如需执行安装，请使用用于安装当前版本 Edge 的同一配置文件。

如需创建新的 Postgres 备用节点，请执行以下操作：

1. 在当前 Postgres 主实例上，修改 /opt/apigee/customer/application/postgresql.properties 文件以设置以下令牌。如果该文件不存在，请创建一个：

   conf_pg_hba_replication.connection=host replication apigee existing_standby_ip/32 trust\ \nhost replication apigee new_standby_ip/32 trust

   其中，existing_standby_ip 是当前 Postgres 备用服务器的 IP 地址，new_standby_ip 是新备用节点的 IP 地址。

2. 在 Postgres 主实例上重启 apigee-postgresql：

   /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql restart

3. 查看主实例上的 /opt/apigee/apigee-postgresql/conf/pg_hba.conf 文件，验证是否已添加新的备用节点。您应该会在该文件中看到以下几行内容：

   host replication apigee existing_standby_ip/32 trust
   host replication apigee new_standby_ip/32 trust

4. 安装新的 Postgres 备用服务器：
   1. 修改用于安装当前版本 Edge 的配置文件，以指定以下内容：

      # IP address of the current master:
      PG_MASTER=192.168.56.103
      # IP address of the new standby node
      PG_STANDBY=192.168.56.102

   2. 按照安装 Edge apigee-setup 实用程序中的说明停用 SELinux。
   3. 根据要从哪个版本的 Edge 升级，执行以下其中一项操作：
      • 如果您要从 Edge 4.19.06 升级，请将 Edge bootstrap_4.19.06.sh 文件下载到 /tmp/bootstrap_4.19.06.sh ：

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

        接下来，安装 Edge apigee-service 实用程序和依赖项：

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

      • 如果您要从 Edge 4.50.00 升级，请将 Edge bootstrap_4.50.00.sh 文件下载到 /tmp/bootstrap_4.50.00.sh ：

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

        接下来，安装 Edge apigee-service 实用程序和依赖项：

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

   4. 使用 apigee-service 安装 apigee-setup 实用程序：

      /opt/apigee/apigee-service/bin/apigee-service apigee-setup install

   5. 安装 Postgres：

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

   6. 在新备用节点上，运行以下命令：

      /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql postgres-check-standby

      验证设备是否为备用设备。

执行 Postgres 就地升级

如需执行就地升级到 Postgres 10.17 的操作，请按以下步骤操作：

1. 在主实例主机上升级 postgres

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

2. 在主实例主机上运行设置命令：

   apigee-service apigee-postgresql setup -f /opt/silent.conf

3. 在主实例主机上运行配置命令：

   apigee-service apigee-postgresql configure

4. 重启主实例主机：

   apigee-service apigee-postgresql restart

5. 将其配置为主实例：

   apigee-service apigee-postgresql setup-replication-on-master -f /opt/silent.conf

6. 确保主实例主机已启动：

   apigee-service apigee-postgresql wait_for_ready

7. 停止待机模式：

   apigee-service apigee-postgresql stop

8. 升级备用实例。

   注意：如果此步骤出错/失败，则可以忽略。update.sh 会尝试使用错误配置启动备用服务器。如果 Postgres 安装已升级到 10.17，可以忽略该错误。

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

9. 确保已停止待机：

   apigee-service apigee-postgresql stop

10. 移除旧的备用配置：

    rm -rf /opt/apigee/data/apigee-postgresql/

11. 在备用服务器上设置复制功能：

    apigee-service apigee-postgresql setup-replication-on-standby -f /opt/silent.conf

完成此过程后，待机模式将成功启动。

停用 Postgres 节点

更新完成后，停用新的备用节点：

1. 确保 Postgres 正在运行：

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

   如果 Postgres 没有运行，请将其启动：

   /opt/apigee/apigee-service/bin/apigee-all start

2. 通过在新备用节点上运行以下 curl 命令来获取新备用节点的 UUID：

   curl -u sysAdminEmail:password http://node_IP:8084/v1/servers/self

   您应该会在输出末尾看到节点的 UUID，格式为：

   "type" : [ "postgres-server" ],
   "uUID" : "599e8ebf-5d69-4ae4-aa71-154970a8ec75"

3. 通过在新备用节点上运行以下命令来停止新备用节点：

   /opt/apigee/apigee-service/bin/apigee-all stop

4. 在 Postgres 主节点上，修改 /opt/apigee/customer/application/postgresql.properties 以从 conf_pg_hba_replication.connection 中移除新的备用节点：

   conf_pg_hba_replication.connection=host replication apigee existing_standby_ip/32 trust

5. 在 Postgres 主实例上重启 apigee-postgresql：

   /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql restart

6. 通过查看主节点上的 /opt/apigee/apigee-postgresql/conf/pg_hba.conf 文件，验证新的备用节点是否已移除。您应该只在该文件中看到以下行：

   host replication apigee existing_standby_ip/32 trust

7. 对 Management Server 节点进行以下 Edge Management API 调用，从 ZooKeeper 中删除备用节点的 UUID：

   curl -u sysAdminEmail:password -X DELETE http://ms_IP:8080/v1/servers/new_standby_uuid

更新前提条件

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

• 备份所有节点
  出于安全考虑，我们建议您完整备份所有节点，然后再进行更新。请按照当前版本 Edge 中的步骤执行备份。

  这样，您就可以制定一个备份方案，以备在新版本更新无法正常运行时使用。如需详细了解备份，请参阅备份和恢复。

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

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

全新 Edge 界面

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

安装 Edge 界面

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

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

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

更新 Edge 界面

如需更新 Edge 界面组件，请考虑要从私有云升级的 Edge 版本：

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

使用 Apigee mTLS 进行更新

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

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

回滚更新

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

如果失败操作需要您将更新回滚到先前版本，请参阅回滚 4.51.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.19.06 或 4.50.00 时所用的配置文件相同。

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

请按以下步骤更新节点上的 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 bootstrap_4.51.00.sh 文件下载到 /tmp/bootstrap_4.51.00.sh：

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

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

   sudo bash /tmp/bootstrap_4.51.00.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。
9. 使用 apigee-service 更新 apigee-setup 实用程序，如以下示例所示：

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

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

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

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

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

12. 通过执行以下命令，在您的节点上运行 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.19.06 或 4.50.00 安装期间用于定义 Edge 组件的配置文件。

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

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

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

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

14. 通过在管理服务器上运行 apigee-validate 实用程序来测试更新，如测试安装中所述。

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

从本地代码库更新到 4.51.00

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

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

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

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

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

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

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

      tar -xzf apigee-4.51.00.tar.gz

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

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

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

      请注意，此命令中包含 repos 目录的路径。

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

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

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

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

      sudo bash /tmp/bootstrap_4.51.00.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.19.06 或 4.50.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.51.00 中所述的过程进行操作。

机器更新顺序

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

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

单节点独立升级

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

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

双节点独立升级

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

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

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

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

2. 在机器 2 上更新 Qpid 和 Postgres：

   /opt/apigee/apigee-setup/bin/update.sh -c qpid,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. 更新机器 1 上的界面：

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

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

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

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

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

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

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

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

5 节点升级

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

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

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

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

2. 在机器 4 上更新 Qpid 和 Postgres：

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

3. 在机器 5 上更新 Qpid 和 Postgres：

   /opt/apigee/apigee-setup/bin/update.sh -c qpid, 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. 更新 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

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-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 节点集群安装更新以下组件：

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

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

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

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

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

3. 在机器 8 上更新 Postgres：

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

4. 在机器 9 上更新 Postgres：

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

5. 更新机器 1 上的 LDAP：

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

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

   /opt/apigee/apigee-setup/bin/update.sh -c edge -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 节点集群安装更新以下组件：

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

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

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

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

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

3. 在机器 8 上更新 Postgres：

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

4. 在机器 9 上更新 Postgres：

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

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

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

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

   /opt/apigee/apigee-setup/bin/update.sh -c edge -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 节点集群安装更新以下组件：

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

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. 更新 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

3. 更新 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

4. 更新 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

5. 更新 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

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

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