将 Apigee Edge 4.52.02 更新为 4.53.00

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

如需简要了解兼容的升级路径，请参阅Edge for Private Cloud 版本的升级兼容性矩阵。

谁可以执行更新

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

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

您必须更新哪些组件

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

更新前提条件

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

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

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

  • 确保 Edge 正在运行
    使用以下命令确保 Edge 在更新过程中正常运行： 
    /opt/apigee/apigee-service/bin/apigee-all status
  • 验证 Cassandra 的必备条件
    如果您之前从较低版本的 Edge for Private Cloud 升级到了 4.52.02 版，现在计划升级到 4.53.00 版，请确保您已完成 Cassandra 的必要升级后步骤。版本 4.52.02 升级文档中的升级后步骤部分概述了这些步骤。如果您不确定是否已在上次升级期间完成这些步骤，请先重新完成这些步骤，然后再继续升级到版本 4.53.00。
  • 在 Edge for Private Cloud 4.53.00 中配置 IDP 密钥和证书

    在 Edge for Private Cloud 4.53.00 中，apigee-sso 组件中使用的 IDP 密钥和证书现在通过密钥库进行配置。您需要将之前使用的密钥和证书导出到密钥库。在更新 SSO 组件之前，请先按照从旧版本更新 Apigee SSO 的步骤部分中的步骤操作。

  • Python 要求
    请确保所有节点（包括 Cassandra 节点）都已安装 Python 3，然后再尝试升级。

自动传播房源设置

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

必须升级到 Cassandra 4.0.13

Apigee Edge for Private Cloud 4.53.00 包括将 Cassandra 升级到 4.0.13 版。

升级和回滚

  • 从 Cassandra 3.11.X 升级到 Cassandra 4.0.X 是一个顺畅的过程。与 Edge for Private Cloud 4.53.00 一起发布的 Cassandra 4.0.X 与 Private Cloud 4.52.02 的运行时和管理组件兼容。
  • 无法直接就地从 Cassandra 4.0.X 回滚到 3.11.X。使用副本或备份进行回滚是一项复杂的操作，可能会导致服务中断和/或数据丢失。排查问题并升级到 Cassandra 4.0.X 比回滚更为妥当。
  • 请务必先熟悉回滚流程，然后再尝试升级。考虑升级期间回滚的细微之处至关重要，以确保有适当的回滚路径可用。

单数据中心

在单个数据中心内将 Cassandra 从 3.11.X 升级到 4.0.X 是无缝的，但回滚很复杂，可能会导致服务中断和数据丢失。对于生产工作负载，强烈建议您先添加新的数据中心（新数据中心中至少有 Cassandra 节点可用），然后再启动升级。这样，您就可以回滚 Cassandra，而不会导致数据丢失或 API 流量中断。升级完成或达到检查点 2 后，您可以停用此额外的数据中心。

如果无法添加新的数据中心，但仍需要回滚功能，则必须备份 Cassandra 3.11.X 才能进行恢复。不过，这种方法可能会导致停机和数据丢失。

多个数据中心

使用 Edge for Private Cloud 4.52.02 运营多个数据中心，可在升级到 Edge for Private Cloud 4.53.00 期间更灵活地进行回滚。

  • 回滚取决于是否至少有一个数据中心运行的是较低的 Cassandra 版本 (3.11.X)。
  • 如果整个 Cassandra 集群已升级到 4.0.X，则不得回滚到 Cassandra 3.11.X。您必须继续将较新版本的 Cassandra 与私有云 4.53.00 或 4.52.02 的其他组件搭配使用。
  1. 一次升级一个 Cassandra 数据中心：首先，在单个数据中心内单独升级 Cassandra 节点。请先完成一个数据中心中所有 Cassandra 节点的升级，然后再继续升级下一个数据中心。
  2. 暂停并验证：升级一个数据中心后，请暂停，以确保您的私有云集群（尤其是升级后的数据中心）正常运行。
  3. 注意：只有当您至少有一个数据中心仍在运行旧版本时，才能回滚到之前的 Cassandra 版本。
  4. 时效性：虽然您可以暂停一小段时间（建议暂停几个小时）来验证功能，但不能无限期地保持混合版本状态。这是因为非均匀 Cassandra 集群（使用不同版本的节点）存在操作限制。
  5. 全面测试：Apigee 强烈建议您在升级下一个数据中心之前，对性能和功能进行全面测试。所有数据中心升级后，将无法回滚到较低版本。
回滚作为两点检查过程
  1. 检查点 1：初始状态，所有组件的版本均为 4.52.02。只要至少有一个 Cassandra 数据中心仍使用旧版本，就可以完全回滚。
  2. 检查点 2：更新所有数据中心中的所有 Cassandra 节点后。您可以回滚到此状态，但无法还原到检查点 1。
示例

假设有一个双数据中心 (DC) 集群：

  1. 开始状态：两个数据中心中的 Cassandra 节点均为版本 3.11.X。所有其他节点均搭载 Edge for Private Cloud 4.52.02 版。假设每个数据中心有三个 Cassandra 节点。
  2. 升级 DC-1：依次升级 DC-1 中的三个 Cassandra 节点。
  3. 暂停并验证：暂停以确保集群（尤其是 DC-1）正常运行（检查性能和功能）。您可以使用 DC-2 中的 Cassandra 节点回滚到初始状态。请注意，由于混合版本 Cassandra 集群的限制，此暂停必须是暂时的。
  4. 升级 DC-2：升级 DC-2 中的其余三个 Cassandra 节点。这将成为新的回滚检查点。
  5. 升级其他组件：按照常规方式升级所有数据中心中的管理节点、运行时节点和分析节点，每次升级一个节点和一个数据中心。如果出现问题，您可以回滚到第 4 步的状态。

Cassandra 升级的先决条件

您应运行 Cassandra 3.11.16 和 Edge for Private Cloud 4.52.02，并确保满足以下条件：
  • 整个集群都已正常运行，并使用 Cassandra 3.11.16 正常运行。
  • 压缩策略设置为 LeveledCompactionStrategy（升级到版本 4.52.02 的前提条件）。
  • 在 4.52.02 升级过程中，从最初升级到 Cassandra 3.11.16 的所有升级后步骤均已完成。如果没有，请重新运行这些步骤。只有当您从较低版本升级到私有云版 4.52.02 时，此问题才会出现。

第 1 步：准备升级

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

  1. 使用 Apigee 备份 Cassandra。
  2. 为 Cassandra 节点创建虚拟机快照（如果可行）。
  3. 确保所有 Edge for Private Cloud 组件（包括管理服务器、消息处理器、路由器、Qpid 和 Postgres）都可以访问端口 9042，以便访问 Cassandra 节点（如果尚未配置）。如需了解详情，请参阅充电桩要求。

第 2 步：升级所有 Cassandra 节点

应在每个数据中心内逐个更新所有 Cassandra 节点，一次一个数据中心。在升级数据中心内节点之间，请等待几分钟，以确保已升级的节点已完全启动并加入集群，然后再继续升级同一数据中心中的其他节点。

升级数据中心内的所有 Cassandra 节点后，请等待一段时间（30 分钟到几小时），然后再升级下一个数据中心中的节点。在此期间，请仔细检查已更新的数据中心，确保 Apigee 集群的功能和性能指标保持不变。此步骤对于确保数据中心的稳定性至关重要，因为 Cassandra 已升级到 4.0.X 版，而其余 Apigee 组件仍保持在 4.52.02 版。

  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 6.0.0 | Cassandra 4.0.13 | CQL spec 3.4.5 | Native protocol v5] 
Metadata is verified
  4. 在 Cassandra 节点上运行以下 post_upgrade 命令： 
    /opt/apigee/apigee-service/bin/apigee-service apigee-cassandra post_upgrade
  5. 运行以下 nodetool 命令，在 Cassandra 节点上重新构建索引： 
    /opt/apigee/apigee-cassandra/bin/nodetool rebuild_index kms api_products api_products_organization_name_idx
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index kms app_credentials app_credentials_api_products_idx
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index kms app_credentials app_credentials_organization_app_id_idx
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index kms app_credentials app_credentials_organization_name_idx
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index kms app_end_user app_end_user_app_id_idx
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index kms apps apps_app_family_idx
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index kms apps apps_app_id_idx
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index kms apps apps_app_type_idx
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index kms apps apps_name_idx
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index kms apps apps_organization_name_idx
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index kms apps apps_parent_id_idx
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index kms apps apps_parent_status_idx
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index kms apps apps_status_idx
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index kms maps maps_organization_name_idx
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index kms oauth_10_access_tokens oauth_10_access_tokens_app_id_idx
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index kms oauth_10_access_tokens oauth_10_access_tokens_consumer_key_idx
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index kms oauth_10_access_tokens oauth_10_access_tokens_organization_name_idx
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index kms oauth_10_access_tokens oauth_10_access_tokens_status_idx
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index kms oauth_10_request_tokens oauth_10_request_tokens_consumer_key_idx
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index kms oauth_10_request_tokens oauth_10_request_tokens_organization_name_idx
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index kms oauth_10_verifiers oauth_10_verifiers_organization_name_idx
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index kms oauth_10_verifiers oauth_10_verifiers_request_token_idx
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index kms oauth_20_access_tokens oauth_20_access_tokens_app_id_idx
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index kms oauth_20_access_tokens oauth_20_access_tokens_client_id_idx
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index kms oauth_20_access_tokens oauth_20_access_tokens_refresh_token_idx
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index kms oauth_20_authorization_codes oauth_20_authorization_codes_client_id_idx
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index kms oauth_20_authorization_codes oauth_20_authorization_codes_organization_name_idx
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index devconnect companies companies_name_idx
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index devconnect companies companies_organization_name_idx
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index devconnect companies companies_status_idx
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index devconnect company_developers company_developers_company_name_idx
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index devconnect company_developers company_developers_developer_email_idx
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index devconnect company_developers company_developers_organization_name_idx
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index devconnect developers developers_email_idx
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index devconnect developers developers_organization_name_idx
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index devconnect developers developers_status_idx
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index cache cache_entries cache_entries_cache_name_idx
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index audit audits audits_operation_idx
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index audit audits audits_requesturi_idx
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index audit audits audits_responsecode_idx
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index audit audits audits_timestamp_idx
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index audit audits audits_user_idx
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index apimodel_v2 apis a_name
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index apimodel_v2 apis a_org_name
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index apimodel_v2 apis_revision ar_a_active_rev
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index apimodel_v2 apis_revision ar_a_def_index_template
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index apimodel_v2 apis_revision ar_a_def_method_template
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index apimodel_v2 apis_revision ar_a_latest_rev
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index apimodel_v2 apis_revision ar_a_name
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index apimodel_v2 apis_revision ar_a_uuid
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index apimodel_v2 apis_revision ar_base_url
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index apimodel_v2 apis_revision ar_is_active
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index apimodel_v2 apis_revision ar_is_latest
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index apimodel_v2 apis_revision ar_name
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index apimodel_v2 apis_revision ar_org_name
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index apimodel_v2 apis_revision ar_rel_ver
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index apimodel_v2 apis_revision ar_rev_num
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index apimodel_v2 method m_a_name
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index apimodel_v2 method m_api_uuid
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index apimodel_v2 method m_ar_uuid
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index apimodel_v2 method m_base_url
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index apimodel_v2 method m_name
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index apimodel_v2 method m_org_name
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index apimodel_v2 method m_r_name
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index apimodel_v2 method m_r_uuid
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index apimodel_v2 method m_res_path
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index apimodel_v2 method m_rev_num
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index apimodel_v2 resource r_a_name
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index apimodel_v2 resource r_api_uuid
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index apimodel_v2 resource r_ar_uuid
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index apimodel_v2 resource r_base_url
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index apimodel_v2 resource r_name
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index apimodel_v2 resource r_org_name
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index apimodel_v2 resource r_res_path
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index apimodel_v2 resource r_rev_num
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index apimodel_v2 schemas s_api_uuid
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index apimodel_v2 schemas s_ar_uuid
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index apimodel_v2 security sa_api_uuid
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index apimodel_v2 security sa_ar_uuid
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index apimodel_v2 template t_a_name
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index apimodel_v2 template t_a_uuid
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index apimodel_v2 template t_entity
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index apimodel_v2 template t_name
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index apimodel_v2 template t_org_name
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index apimodel_v2 template_auth au_api_uuid
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index dek keys usecase_index
     如果您使用的是创收功能，还应运行与创收键空间相关的以下重新构建索引命令： 
    /opt/apigee/apigee-cassandra/bin/nodetool rebuild_index mint limits limits_created_date_idx
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index mint limits limits_id_idx
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index mint limits limits_org_id_idx
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index mint limits limits_updated_date_idx
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index mint suspended_developer_products suspended_developer_products_created_date_idx
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index mint suspended_developer_products suspended_developer_products_currency_idx
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index mint suspended_developer_products suspended_developer_products_dev_id_idx
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index mint suspended_developer_products suspended_developer_products_id_idx
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index mint suspended_developer_products suspended_developer_products_limit_id_idx
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index mint suspended_developer_products suspended_developer_products_org_id_idx
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index mint suspended_developer_products suspended_developer_products_prod_id_idx
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index mint suspended_developer_products suspended_developer_products_reason_code_idx
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index mint suspended_developer_products suspended_developer_products_sub_org_id_idx
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index mint invitations invitations_company_id_idx
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index mint invitations invitations_created_at_idx
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index mint invitations invitations_developer_id_idx
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index mint invitations invitations_lastmodified_at_idx
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index mint invitations invitations_org_id_idx
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index taurus triggers triggers_env_idx
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index taurus triggers triggers_job_id_idx
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index taurus triggers triggers_org_id_idx
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index taurus job_details job_details_job_class_name_idx
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index taurus job_details job_details_job_group_idx
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index taurus job_details job_details_job_name_idx
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index taurus org_triggers org_triggers_org_id_idx
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index taurus triggers_suite triggers_suite_group_idx
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index taurus triggers_suite triggers_suite_name_idx
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index taurus triggers_suite triggers_suite_suite_id_idx
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index notification notification_service_item notification_service_item_org_id_idx
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index notification notification_service_item notification_service_item_status_idx
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index notification notification_service_black_list_item notification_service_black_list_item_org_id_idx
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index notification notification_service_black_list_item notification_service_black_list_item_to_email_idx
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index notification notification_email_template_item notification_email_template_item_name_idx
/opt/apigee/apigee-cassandra/bin/nodetool rebuild_index notification notification_email_template_item notification_email_template_item_org_id_idx

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

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

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

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

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

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

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

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

从旧版本更新 Apigee SSO 的步骤

在 Edge for Private Cloud 4.53.00 中，apigee-sso 组件中使用的 IDP 密钥和证书现在通过密钥库进行配置。您需要将之前使用的密钥和证书导出到密钥库，对其进行配置，然后照常继续进行 SSO 更新。

  1. 确定用于配置 IDP 的现有密钥和证书：

    1. 通过在 SSO 安装配置文件中查找 SSO_SAML_SERVICE_PROVIDER_CERTIFICATE 的值或通过查询 apigee-sso 组件中的 conf_login_service_provider_certificate 来检索证书。

      在 SSO 节点上，使用以下命令查询 apigee-sso 以获取 IDP 证书路径。在输出中，查找最后一行的值。 

      apigee-service apigee-sso configure -search conf_login_service_provider_certificate

    2. 通过在 SSO 安装配置文件中查找 SSO_SAML_SERVICE_PROVIDER_KEY 的值或通过查询 apigee-sso 组件中的 conf_login_service_provider_key 来检索该密钥。

      在 SSO 节点上使用以下命令查询 apigee-sso 以获取 IDP 密钥路径。在输出中，查找最后一行的值。

      apigee-service apigee-sso configure -search conf_login_service_provider_key
  2. 将密钥和证书导出到密钥库：
    1. 将密钥和证书导出到 PKCS12 密钥库： 
      sudo openssl pkcs12 -export -clcerts -in <certificate_path> -inkey <key_path> -out <keystore_path> -name <alias>

      参数：

      • certificate_path：在第 1.a 步中检索到的证书文件的路径。
      • key_path：在第 1.b 步中检索到的私钥文件的路径。
      • keystore_path：包含证书和私钥的新创建密钥库的路径。
      • alias：用于密钥库中的密钥和证书对的别名。

      如需了解详情，请参阅 OpenSSL 文档。

    2. （可选）将密钥和证书从 PKCS12 导出到 JKS 密钥库： 
      sudo keytool -importkeystore -srckeystore <PKCS12_keystore_path> -srcstoretype PKCS12 -destkeystore <destination_keystore_path> -deststoretype JKS -alias <alias>

      参数：

      • PKCS12_keystore_path：指向第 2.a 步中创建的 PKCS12 密钥库的路径，其中包含证书和密钥。
      • destination_keystore_path：要将证书和密钥导出到的新的 JKS 密钥库的路径。
      • alias：用于 JKS 密钥库中的密钥和证书对的别名。

      3. 如需了解详情，请参阅 keytool 文档。

  3. 将输出密钥库文件的所有者更改为“apigee”用户： 
    sudo chown apigee:apigee <keystore_file>
  4. 在 Apigee SSO 配置文件 中添加以下属性，并使用密钥库文件路径、密码、密钥库类型和别名对其进行更新： 
    # Path to the keystore file
SSO_SAML_SERVICE_PROVIDER_KEYSTORE_PATH=${APIGEE_ROOT}/apigee-sso/source/conf/keystore.jks

# Keystore password
SSO_SAML_SERVICE_PROVIDER_KEYSTORE_PASSWORD=Secret123  # Password for accessing the keystore

# Keystore type
SSO_SAML_SERVICE_PROVIDER_KEYSTORE_TYPE=JKS  # Type of keystore, e.g., JKS, PKCS12

# Alias within keystore that stores the key and certificate
SSO_SAML_SERVICE_PROVIDER_KEYSTORE_ALIAS=service-provider-cert
  5. 使用以下命令照常在 SSO 节点上更新 Apigee SSO 软件： 
    /opt/apigee/apigee-setup/bin/update.sh -c sso -f /opt/silent.conf

新版 Edge 界面

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

安装 Edge 界面

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

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

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

更新为 Apigee mTLS

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

回滚更新

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

如果失败导致您需要将更新回滚到之前的版本，请参阅回滚 4.53.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. 继续为安装中的所有剩余计算机更新。

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

使用静默配置文件

您必须将静默配置文件传递给更新命令。静默配置文件应与您用于安装 Edge for Private Cloud 4.52.02 的配置文件相同。

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

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

  1. 在更新完成之前，停用配置为对 Cassandra 执行修复操作的所有 cron 作业（如果有）。
  2. 以 root 用户身份登录节点以安装 Edge RPM。
  3. 停用 SELinux，如安装 Edge apigee-setup 实用程序中所述。
  4. 如果您是在 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

  5. 如果您目前使用的是 Edge 4.52.02：

    1. 将 Edge bootstrap_4.53.00.sh 文件下载到 /tmp/bootstrap_4.53.00.sh： 
      curl https://software.apigee.com/bootstrap_4.53.00.sh -o /tmp/bootstrap_4.53.00.sh
    2. 运行以下命令，安装 Edge 4.53.00 apigee-service 实用程序和依赖项： 
      sudo bash /tmp/bootstrap_4.53.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。
    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.52.02 安装过程中用于定义 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-management-ui|edge-ui] restart
    8. 在管理服务器上运行 apigee-validate 实用程序，以测试更新（如测试安装中所述）。

如果您日后决定回滚更新，请使用回滚 4.53.00 中所述的步骤。

从本地代码库更新到 4.53.00

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

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

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

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

  1. 按照安装 Edge apigee-setup 实用程序中的“创建本地 Apigee 代码库”部分中的说明创建本地 4.53.00 代码库。
  2. 如需从 .tar 文件安装 apigee-service，请执行以下操作：
    1. 在包含本地代码库的节点上，使用以下命令将本地代码库打包到名为 /opt/apigee/data/apigee-mirror/apigee-4.53.00.tar.gz 的单个 .tar 文件中： 
      /opt/apigee/apigee-service/bin/apigee-service apigee-mirror package
    2. 将 .tar 文件复制到您要更新 Edge 的节点。例如，将其复制到新节点上的 /tmp 目录。
    3. 在新节点上，将文件解压缩到 /tmp 目录： 
      tar -xzf apigee-4.53.00.tar.gz

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

    4. 从 /tmp/repos 安装 Edge apigee-service 实用程序和依赖项： 
      sudo bash /tmp/repos/bootstrap_4.53.00.sh apigeeprotocol="file://" apigeerepobasepath=/tmp/repos

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

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

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

    3. 在远程节点上，安装 Edge apigee-setup 实用程序和依赖项： 
      sudo bash /tmp/bootstrap_4.53.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.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.53.00 中所述的步骤。

机器更新顺序

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

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

1 个节点的独立升级

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

      3. 其中 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 界面组件。