回滚 Apigee Edge 4.51.00

如果您在更新到 Edge 4.51.00 期间遇到错误，可以回滚导致错误的组件，然后再次尝试更新。

您可以将 Edge 4.51.00 回滚到以下功能版本：

• 版本 4.50.00
• 版本 4.19.06

在以下两种情况下，您可能需要执行回滚：

1. 回滚到之前的功能版本。例如，从 4.51.00 改为 4.50.00。
2. 回滚到同一版本中的先前更新版本。例如，从 4.50.00.02 改为 4.50.00.01。

如需了解详情，请参阅 Apigee Edge 发布流程。

哪些人可以执行回滚

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

默认情况下，Edge 组件以用户“apigee”的身份运行。在某些情况下，您可能需要以不同的用户身份运行 Edge 组件。例如，如果路由器必须访问特权端口（例如 1000 以下的端口），则您必须以 root 用户身份或具有对这些端口访问权限的用户身份运行路由器。或者，您可以以一个用户身份运行一个组件，以另一个用户身份运行另一个组件。

包含通用代码的组件

以下 Edge 组件共享通用代码。因此，如需回滚节点上的任何这些组件，您必须回滚该节点上的所有这些组件。

• edge-management-server（管理服务器）
• edge-message-processor（消息处理器）
• edge-router（路由器）
• edge-postgres-server（Postgres 服务器）
• edge-qpid-server（Qpid 服务器）

例如，如果您在节点上安装了管理服务器、路由器和消息处理器，则若要回滚其中任何一个，您必须回滚所有三个。

回滚到之前的功能版本

如需回滚到之前的功能版本，请在托管该组件的每个节点上执行以下操作：

1. 下载要回滚到的版本的 bootstrap.sh 文件：

   • 如需回滚到 4.50.00，请下载 bootstrap_4.50.00.sh：

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

   • 如需回滚到 4.19.06，请下载 bootstrap_4.19.06.sh：

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

2. 停止组件以进行回滚：
   1. 如需回滚节点上的任何包含通用代码的组件，您必须停止所有这些组件，如以下示例所示：

      /opt/apigee/apigee-service/bin/apigee-service edge-management-server stop
      /opt/apigee/apigee-service/bin/apigee-service edge-router stop
      /opt/apigee/apigee-service/bin/apigee-service edge-message-processor stop
      /opt/apigee/apigee-service/bin/apigee-service edge-qpid-server stop
      /opt/apigee/apigee-service/bin/apigee-service edge-postgres-server stop

   2. 如需回滚节点上的任何其他组件，只需停止相应组件即可：

      • /opt/apigee/apigee-service/bin/apigee-service component stop

3. 如果您要回滚创收功能，请从所有管理服务器和消息处理器节点中卸载该功能：

   /opt/apigee/apigee-service/bin/apigee-service edge-mint-gateway uninstall

4. 卸载要回滚的节点上的组件：
   1. 如需回滚节点上的任何包含通用代码的组件，您必须通过卸载 edge-gateway 组件组来将其全部卸载，如以下示例所示：

      /opt/apigee/apigee-service/bin/apigee-service edge-gateway uninstall

   2. 如需回滚节点上的任何其他组件，请仅卸载该组件，如以下示例所示：

      /opt/apigee/apigee-service/bin/apigee-service component uninstall

      其中 component 是组件名称。

   3. 如需回滚边缘路由器，除了卸载 edge-gateway 组件组之外，您还必须删除 /opt/nginx/conf.d 文件的内容：

      cd /opt/nginx/conf.d
      rm -rf *

5. 卸载 4.51.00 版 apigee-setup：

   /opt/apigee/apigee-service/bin/apigee-service apigee-setup uninstall

6. 安装 4.19.06 或 4.50.00 版的 apigee-service 实用程序及其依赖项。以下示例会安装 4.50.00 版的 apigee-service：

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

   其中，uName 和 pWord 是您从 Apigee 收到的用户名和密码。如果您省略 pWord，系统会提示您输入该值。

   如果您收到错误消息，请确保您已在第 1 步中下载 bootstrap.sh 文件。

7. 安装 apigee-setup：

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

8. 安装旧版组件：

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

   其中，component 是要安装的组件，configFile 是旧版的配置文件。

9. 如果您要回滚 Qpid，请清空 iptables：

   sudo iptables -F

10. 对托管要回滚的组件的每个节点重复此过程。

回滚到之前的更新版本

如需将组件回滚到特定版本的发布版本，请在托管该组件的每个节点上执行以下操作：

1. 下载特定组件版本：

   /opt/apigee/apigee-service/bin/apigee-service component_version install

   其中 component_version 是要安装的组件和更新版本。例如：

   /opt/apigee/apigee-service/bin/apigee-service edge-ui-4.18.05-0.0.3749 install

   如果您使用的是 Apigee 在线代码库，则可以使用以下命令确定可用的组件版本：

   yum --showduplicates list comp

   例如：

   yum --showduplicates list edge-ui

2. 使用 apigee-setup 安装该组件：

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

   例如：

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

   请注意，在安装组件时，您只需指定组件名称，而无需指定版本。

3. 对托管要回滚的组件的每个节点重复此过程。

回滚 Postgres 10.17 更新

如果您从 4.19.06 或 4.50.00 版本升级到 4.51.00，则除了 Edge 组件之外，您还必须回滚 Postgres 更新。

如需在主-备用配置中更新 Postgres 时回滚 Postgres 更新，请执行以下操作：

• 将新的备用节点提升为 Postgres 主节点。新的 Postgres 主服务器的版本将与您之前的 Edge 安装版本相同。
• 将旧备用节点配置为新主节点的备用节点。旧备用节点的版本将与您之前安装的 Edge 版本相同。
• 将新的主节点和备用节点注册到分析组和使用方组。

回滚完成后，旧主节点将不再需要。然后，您可以停用旧的主节点。

1. 确保新的待机 Postgres 节点正在运行：

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

   如果 Postgres 未运行，请启动它：

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

2. 确保在旧主节点和旧备用节点上停止了 Postgres：

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

   如果 Postgres 正在运行，请将其停止：

   /opt/apigee/apigee-service/bin/apigee-service edge-postgres-server stop > /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql stop

3. 如果已安装，请在旧备用节点上启动 Qpid：

   /opt/apigee/apigee-service/bin/apigee-service edge-qpid-server start

4. 将新的备用节点提升为 Postgres 主节点：
   1. 将新的备用节点提升为新的主节点：

      apigee-service apigee-postgresql promote-standby-to-master new_standby_IP

      如果系统提示，请输入“apigee”用户的 Postgres 密码，默认为“postgres”。

   2. 修改您用于安装当前版本 Edge 的配置文件，以指定以下内容：

      # IP address of the new master:
      PG_MASTER=new_standby_IP
      # IP address of the old standby node
      PG_STANDBY=old_standby_IP

   3. 配置新主服务器：
      

      /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql setup-replication-on-master -f configFile

5. 如果您已将旧备用节点升级到较新版本，则必须先在旧备用节点上降级 Apigee 软件。如果旧备用节点上仍有旧版本，您可以跳过此步骤，继续执行第 6 步。
   1. 在旧备用节点上停止 Postgres：

      apigee-service apigee-postgresql stop
      apigee-service edge-postgres-server stop

   2. 从旧备用节点卸载 Postgres：

      apigee-service apigee-postgresql uninstall
      apigee-service edge-postgres-server uninstall

   3. 从旧备用节点中删除 Postgres 数据目录：

      cd /opt/apigee/data/apigee-postgresql/pgdata > rm -rf *

   4. 在旧备用节点上下载并运行旧版引导加载程序（适用于您要回滚到的 Apigee 版本）。具体步骤可能会因您是使用在线安装还是离线安装而异。运行旧版 Apigee 引导加载程序将使用旧版 Apigee 数据设置 yum 仓库。
   5. 在旧备用节点上设置 Postgres 组件：

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

   6. 检查并验证旧备用节点上的 Postgres 组件是否已回滚到旧版本：

      apigee-service apigee-postgresql version
      apigee-service edge-postgres-server version

6. 重新构建旧备用节点：
   1. 修改您用于安装当前版本 Edge 的配置文件，以指定以下内容：

      # IP address of the new master:
      PG_MASTER=new_standby_IP
      # IP address of the old standby node
      PG_STANDBY=old_standby_IP

   2. 移除旧备用节点上的数据目录：

      cd /opt/apigee/data/apigee-postgresql/pgdata > rm -rf *

   3. 将旧备用节点重新配置为新主节点的备用节点：

      /opt/apigee/apigee-service/bin/apigee-service apigee-postgresql setup-replication-on-standby -f configFile

   4. 确保 Postgres 在旧备用节点上运行：

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

      如果 Postgres 未运行，请启动它：

      /opt/apigee/apigee-service/bin/apigee-service edge-postgres-server start

7. 通过查看新主服务器上的 /opt/apigee/apigee-postgresql/conf/pg_hba.conf 文件，验证是否已添加新的待机节点。
8. 在管理服务器上运行以下命令，查看当前的分析和使用方群组信息：

   curl -u sysAdminEmail:password http://ms_IP:8080/v1/analytics/groups/ax

   此命令会在 name 字段中返回分析组名称，并在 consumer-groups 下的 name 字段中返回使用方群组名称。它还会在 postgres-server 字段和 datastores 字段中返回旧版 Postgres 主节点和备用节点的 UUID。您会在表单中看到输出：

   {
     "name" : "axgroup-001",
     "properties" : {
     },
     "scopes" : [ "VALIDATE~test", "sgilson~prod" ],
     "uuids" : {
       "qpid-server" : [ "8381a053-433f-4382-bd2a-100fd37a1592", "4b6856ec-ef05-498f-bac6-ef5f0d5f6521" ],
       "postgres-server" : [
         "ab1158bd-1d59-4e2a-9c95-24cc2cfa6edc:27f90844-efab-4b32-8a23-8f85cdc9a256"
       ]
     },
     "consumer-groups" : [ {
       "name" : "consumer-group-001",
       "consumers" : [ "8381a053-433f-4382-bd2a-100fd37a1592", "4b6856ec-ef05-498f-bac6-ef5f0d5f6521" ],
       "datastores" :
         [ "ab1158bd-1d59-4e2a-9c95-24cc2cfa6edc:27f90844-efab-4b32-8a23-8f85cdc9a256" ],
         "properties" : {     }
       }
     ],
     "data-processors" : {
     }
   }

9. 在旧主节点上运行以下 curl 命令，获取旧主节点的 UUID 地址：

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

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

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

10. 重复上一步，获取旧备用节点和新主节点的 IP 地址。
11. 从使用方群组中移除旧主节点和备用节点：

    curl -u sysAdminEmail:password -X DELETE \
      "http://ms_IP:8080/v1/analytics/groups/ax/axgroup-001/consumer-groups/consumer-group-001/datastores/masterUUID,standbyUUID" -v

    其中，axgroup-001 和 consumer-group-001 是分析组和使用方组的默认名称。masterUUID,standbyUUID 的顺序与您在上面查看当前分析和消费者群体信息时看到的顺序相同。您可能需要将它们指定为 standbyUUID,masterUUID。

    consumer-groups 的 datastores 属性现在应为空。

12. 从分析组中移除旧的主节点和备用节点：

    curl -u sysAdminEmail:password -X DELETE \
      "http://ms_IP:8080/v1/analytics/groups/ax/axgroup-001/servers?uuid=masterUUID,standbyUUID&type=postgres-server" -v

    uuids 下的 postgres-server 属性现在应为空。

13. 向分析组和使用方组注册新的 PG 主节点和备用节点：
    

    curl -u sysAdminEmail:password -X POST -H "Content-Type: application/json" -d ''
      "http://ms_IP:8080/v1/analytics/groups/ax/axgroup-001/servers?uuid=masterUUID,standbyUUID&type=postgres-server" -v
    curl -u sysAdminEmail:password -X POST -H "Content-Type:application/json" -d ''
      "http://ms_IP:8080/v1/analytics/groups/ax/axgroup-001/consumer-groups/consumer-group-001/datastores?uuid=masterUUID,standbyUUID" -v

14. 验证分析组：

    curl -u sysAdminEmail:password http://ms_IP:8080/v1/analytics/groups/ax

    您应该会在分析组和使用方组中看到新主节点和备用节点的 UUID。

15. 重启边缘管理服务器：

    /opt/apigee/apigee-service/bin/apigee-service edge-management-server restart

16. 重启所有 Qpid 服务器：

    /opt/apigee/apigee-service/bin/apigee-service edge-qpid-server restart

17. 重启所有 Postgres 服务器：

    /opt/apigee/apigee-service/bin/apigee-service edge-postgres-server restart

18. 在两个服务器上发出以下脚本，验证复制状态。系统应在两个服务器上显示相同的结果，以确保复制成功：

    在新的主实例上，运行以下命令：

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

    请验证它是否为主设备。在旧备用节点上：

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

    确认它处于待机状态。

19. 发出多个 API 请求后，重复执行上一步，以确保节点保持同步。
20. 使用将 Apigee Edge 4.16.01/4.16.05 更新为 4.17.09 中的步骤停用旧的 Postgres 主服务器。

    或者，您也可以从旧主服务器上卸载 Qpid，并在新主服务器节点上安装 Qpid。卸载 Qpid 后，您可以停用旧的主节点。

回滚 mTLS

如需回滚 mTLS 更新，请在所有主机上执行以下步骤：

1. 停止 Apigee：

   apigee-all stop

2. 停止 mTLS：

   apigee-service apigee-mtls uninstall

3. 重新安装 mTLS：

   apigee-service apigee-mtls install
   apigee-service apigee-mtls setup -f /opt/silent.conf