将 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 的 1 节点和 2 节点配置（用于原型设计和测试的拓扑）中，您只有一个 Postgres 节点。您可以直接更新这些 Postgres 节点，而无需创建新的 Postgres 节点。

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

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

安装新的 Postgres 备用节点

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

如需执行安装，请使用您用于安装当前 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. 在主机上运行 setup 命令：

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

3. 在主机上运行 configure 命令：

   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. 在管理服务器节点上执行以下 Edge 管理 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 for Private Cloud 开发者和管理员的增强型界面。

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

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

更新 Edge 界面

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

• 从 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 了解详细说明。

日志记录更新信息

默认情况下，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.19.06 或 4.50.00 时使用的配置文件相同。

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

请按照以下步骤更新节点上的 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 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，系统会提示您输入 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：除 Edge 界面之外的所有 Edge 组件：管理服务器、消息处理器、路由器、QPID 服务器、Postgres 服务器
      • ldap：OpenLDAP
      • ps：postgresql
      • qpid：qpidd
      • sso：Apigee SSO（如果您已安装 SSO）
      • ue：新的 Edge 界面
      • ui：Edge 经典版界面
      • zk：Zookeeper
    • configFile 是您在安装 4.19.06 或 4.50.00 时用于定义 Edge 组件的配置文件。

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

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

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：除 Edge 界面之外的所有 Edge 组件：管理服务器、消息处理器、路由器、QPID 服务器、Postgres 服务器
     • ldap：OpenLDAP
     • ps：postgresql
     • qpid：qpidd
     • sso：Apigee SSO（如果您已安装 SSO）
     • ue 新版 Edge 界面
     • ui：Edge 经典版界面
     • zk：Zookeeper
   • configFile 是您在安装 4.19.06 或 4.50.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.51.00 中所述的步骤。

机器更新顺序

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

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

1 个节点的独立升级

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

2 个节点的独立升级

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

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

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

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

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

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

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

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

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

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

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