将 Apigee Edge 4.18.01 或 4.18.05 更新为 4.19.01

适用于私有云的 Edge v4.19.01

本部分介绍如何执行以下升级：

  • 1 月 4 日至 1 月 4 日
  • 5 月 4 日至 1 月 4 日
。

谁可以执行更新

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

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

您必须更新哪些组件

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

自动传播媒体资源设置

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

更新前提条件

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

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

    这样，您就可以有备用计划，以防无法更新到新版本 功能。有关备份的详细信息，请参阅备份 和恢复。

  • 确保 Edge 正在运行
    使用以下命令确保 Edge 在更新过程中已启动并运行： 
    /opt/apigee/apigee-service/bin/apigee-all status

更新全新 Edge 体验

如果您是在 4.18.0x 中安装 Beta 版 New Edge 体验的，则必须卸载它，然后 重新安装 4.19.01 版 New Edge。如需了解详情，请参阅 私有云的全新 Edge 体验。

请注意，从 Edge 4.18.01（而不是 4.18.05）开始，安装配置有所更改。 Edge 4.19.01 新版 Edge 体验中的配置从 Edge 4.18.01 版本。有关新属性的说明，请参见 安装 Edge 4.18.01 中的配置变更。

处理失败的更新

如果更新失败，您可以尝试纠正问题，然后运行 update.sh 。您可以多次运行更新，系统会从上次更新的位置继续更新 关闭。

如果失败要求您将更新回滚到先前版本，请参阅 如需更多信息，请回滚 4.19.01。

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.18.0x 的相同。

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

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

  1. 停用任何配置为在 Cassandra 上执行修复操作的 CRON 作业（如果存在） 直到更新完成为止。
  2. 以 root 身份登录您的节点以安装 Edge RPM。
  3. 安装 yum-utils 和 yum-plugin-priorities： 
    sudo yum install yum-utils
sudo yum install yum-plugin-priorities
  4. 按照安装 Edge apigee-setup 实用程序，
  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.19.01 bootstrap_4.19.01.sh 文件下载到 /tmp/bootstrap_4.19.01.sh： 
    curl https://software.apigee.com/bootstrap_4.19.01.sh -o /tmp/bootstrap_4.19.01.sh
  8. 安装 Edge 4.19.01 apigee-service 实用程序和依赖项： 
    sudo bash /tmp/bootstrap_4.19.01.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”：除 Edge 界面之外的所有 Edge 组件：管理服务器、消息处理器、路由器、 QPID 服务器、Postgres 服务器
    • “ldap”：OpenLDAP
    • “ps”：postgresql
    • “qpid”：qpidd
    • “sso”：Edge SSO（如果您安装了 SSO）
    • “ui”：Edge UI
    • “zk”：Zookeeper

    configFile 就是您之前 定义 Edge 组件 4.18.0x 安装期间会发生此错误。

    您可以通过将 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. 通过在 Management API 上运行 apigee-validate 实用程序来测试更新 服务器，如测试安装中所述。

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

从本地代码库更新为 4.19.01

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

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

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

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

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

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

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

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

  3. 如需使用 Nginx Web 服务器安装 apigee-service，请执行以下操作： <ph type="x-smartling-placeholder">
      </ph>
    1. 按照“使用 Nginx 从代码库安装”中的说明配置 Nginx Web 服务器 webserver&quot;Install the Edge apigee-setup 实用程序，
    2. 在远程节点上，将 Edge bootstrap_4.19.01.sh 文件下载到 /tmp/bootstrap_4.19.01.sh： 
      /usr/bin/curl http://uName:pWord@remoteRepo:3939/bootstrap_4.19.01.sh -o /tmp/bootstrap_4.19.01.sh

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

    3. 在远程节点上，安装 Edge apigee-setup 实用程序和依赖项： 
      sudo bash /tmp/bootstrap_4.19.01.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 界面以外的所有 Edge 组件。“边缘”组件包括管理 服务器、消息处理器、路由器、QPID 服务器和 Edge Postgres 服务器。
      • “ldap”：OpenLDAP
      • “ps”：postgresql
      • “qpid”：qpidd
      • “sso”：Edge SSO（如果您安装了 SSO）
      • “ui”：Edge UI
      • “zk”：Zookeeper
    • configFile 就是 定义 Edge 组件 4.18.0x 安装期间会发生此错误。

    您可以通过设置 component 针对所有组件运行 update.sh 设置为“all”，但前提是您使用的是 Edge 一体化 (AIO) 安装配置文件。例如：

    /opt/apigee/apigee-setup/bin/update.sh -c all -f /tmp/sa_silent_config
  8. 如果您尚未在运行 Edge 界面组件的所有节点上重启该组件，请执行此操作： 
    /opt/apigee/apigee-service/bin/apigee-service edge-ui restart
  9. 通过在 Management API 上运行 apigee-validate 实用程序来测试更新 服务器，如测试安装中所述。

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

机器更新顺序

在 Edge 安装中，更新机器的顺序很重要：

  • 在更新任何 Cassandra 和 ZooKeeper 节点之前，您必须更新 其他节点
  • 对于具有多个边缘组件（管理服务器、消息处理器、 路由器、QPID 服务器，但不包括 Postgres 服务器），请使用 -c edge 选项进行更新 所有操作
  • 如果某个步骤指定在多台机器上执行，请在 指定机器顺序
  • 更新创收功能没有单独的步骤。当您指定 -c edge 选项。
。

单节点独立升级

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

  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 上更新 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. （如果您已安装 Edge SSO）在机器 1 上更新 Edge 单点登录： 
    /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. 更新机器 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. （如果您已安装 Edge SSO）在机器 1 上更新 Edge 单点登录： 
    /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

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 上的界面： 
    /opt/apigee/apigee-setup/bin/update.sh -c ui -f configFile
  8. （如果您安装了 apigee-adminapi）更新了机器 1 上的 apigee-adminapi 实用程序： 
    /opt/apigee/apigee-service/bin/apigee-service apigee-adminapi update
  9. （如果您已安装 Edge SSO）在机器 1 上更新 Edge 单点登录： 
    /opt/apigee/apigee-setup/bin/update.sh -c sso -f sso_config_file

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

  10. 在机器 1 上重启 Edge 界面组件： 
    /opt/apigee/apigee-service/bin/apigee-service edge-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 上的界面： 
    /opt/apigee/apigee-setup/bin/update.sh -c ui -f configFile
  8. （如果您安装了 apigee-adminapi）更新了机器 6 和 7 上的 apigee-adminapi 实用程序： 
    /opt/apigee/apigee-service/bin/apigee-service apigee-adminapi update
  9. （如果您安装了 Edge SSO）在机器 6 和 7 上更新 Edge SSO： 
    /opt/apigee/apigee-setup/bin/update.sh -c sso -f sso_config_file

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

  10. 在机器 6 和 7 上重启 Edge 界面组件： 
    /opt/apigee/apigee-service/bin/apigee-service edge-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. 更新 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
  3. 更新 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
  4. 更新 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
  5. 更新 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
  6. 更新界面： <ph type="x-smartling-placeholder">
      </ph>
    1. 数据中心 1 的机器 1： 
      /opt/apigee/apigee-setup/bin/update.sh -c ui -f configFile
    2. 数据中心 2 中的机器 7： 
      /opt/apigee/apigee-setup/bin/update.sh -c ui -f configFile
    3. 在机器 1 和 7 上重启 Edge 界面组件： 
      /opt/apigee/apigee-service/bin/apigee-service edge-ui restart
  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. （如果您已安装 Edge SSO）更新 Edge SSO： <ph type="x-smartling-placeholder">
      </ph>
    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。

对于非标准配置

如果您有非标准配置，请在以下文件中更新 Edge 组件 订单：

  1. ZooKeeper
  2. Cassandra
  3. qpidd、ps
  4. LDAP
  5. 边缘，表示“-c 边缘”依次为：配备 Qpid 服务器的节点、 Edge Postgres 服务器、管理服务器、消息处理器和路由器。
  6. Edge 界面
  7. apigee-adminapi
  8. 边缘单点登录

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