此页面由 Cloud Translation API 翻译。

回滚 Apigee Edge 4.52.01

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

您可以将 Edge 4.52.01 回滚到以下主要发布版本：

版本 4.52.00
版本 4.51.00

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

回滚到上一个主要或次要版本。例如， 4.52.01 至 4.52.00。
在 Google Cloud 控制台中发布版本。例如，从 4.52.00.02 更新为 4.52.00.01。

如需了解详情，请参阅 Apigee Edge 版本过程。

哪些人可以执行回滚

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

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

具有通用代码的组件

以下 Edge 组件具有相同的代码。因此，如果要回滚因此您必须回滚该节点上的所有这些组件。

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

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

回滚到上一个主要或次要版本

要回滚到之前的主要或次要版本，请在托管组件：

下载要回滚到的版本的 bootstrap.sh 文件：
- 如需回滚到 4.51.00，请下载 bootstrap_4.51.00.sh：
```
curl https://software.apigee.com/bootstrap_4.51.00.sh -o /tmp/bootstrap_4.51.00.sh 
```

停止要回滚的组件：

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

/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

如需回滚节点上的任何其他组件，只需停止相应组件即可：
- ```
/opt/apigee/apigee-service/bin/apigee-service component stop
```

如果您要回滚创收功能，请将其从所有管理服务器和邮件中卸载处理器节点：
```
/opt/apigee/apigee-service/bin/apigee-service edge-mint-gateway uninstall
```
卸载该组件以在节点上进行回滚：
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. 要回滚边缘路由器，您必须删除 /opt/nginx/conf.d 文件。 edge-gateway 组件组：
```
cd /opt/nginx/conf.d
rm -rf *
```

卸载 4.52.01 版本的 apigee-setup：

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

安装 4.51.00 版的 apigee-service 实用程序及其依赖项。以下示例将安装 4.51.00 版 apigee-service：
```
sudo bash /tmp/bootstrap_4.51.00.sh apigeeuser=uName apigeepassword=pWord
```
其中，uName 和 pWord 是您收到的用户名和密码如果您省略 pWord，系统会提示您输入。

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

安装 apigee-setup：

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

安装旧版组件：
```
/opt/apigee/apigee-setup/bin/setup.sh -p component -f configFile
```
其中，component 是要安装的组件，configFile 是指要安装的组件旧版本的配置文件。
如果要回滚 Qpid，请清空 iptables：
```
sudo iptables -F
```
对托管要回滚的组件的每个节点重复此过程。

回滚到上一个补丁版本

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

下载特定的组件版本：
```
/opt/apigee/apigee-service/bin/apigee-service component_version install
```
其中 component_version 是要安装的组件和补丁版本。例如：
```
/opt/apigee/apigee-service/bin/apigee-service edge-ui-4.51.05-0.0.3749 install
```
如果您使用的是 Apigee 在线代码库，则可以确定可用的组件可以使用以下命令：
```
yum --showduplicates list comp
```
例如：
```
yum --showduplicates list edge-ui
```
使用 apigee-setup 安装组件：
```
/opt/apigee/apigee-setup/bin/setup.sh -p comp -f configFile
```
例如：
```
/opt/apigee/apigee-setup/bin/setup.sh -p ui -f configFile
```
请注意，在安装组件时，您只需指定组件名称，而无需指定版本。
对托管要回滚的组件的每个节点重复此过程。

回滚 Postgres 10.17 更新

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

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

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

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

确保新的备用 Postgres 节点正在运行：

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

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

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

确保在旧主节点和旧备用节点上停止 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

如果已安装，请在旧备用节点上启动 Qpid：
```
/opt/apigee/apigee-service/bin/apigee-service edge-qpid-server start
```
注意：在许多配置中，旧备用节点只能托管 Postgres，不能托管 Qpid。
将新的备用节点提升为 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
```
如果您已将旧备用节点升级到较新版本，则必须首先在旧备用节点上降级 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
```

重新构建旧备用节点：

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

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

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

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

将旧备用节点重新配置为新主实例的备用节点：

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

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

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

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

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

通过查看 /opt/apigee/apigee-postgresql/conf/pg_hba.conf 文件。

通过运行以下命令，查看当前的分析和使用方群组信息在管理服务器上执行下列操作：

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

此命令会返回 name 字段中的分析群组名称， consumer-groups 下的 name 字段中的使用方群组名称。它还返回旧 Postgres 主实例和备用节点的 postgres-server 字段和 datastores 字段。您应该会看到输出格式为：

{
  "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" : {
  }
}

在旧主节点上运行以下 curl 命令，获取旧主节点的 UUID 地址：
```
curl -u sysAdminEmail:password http://node_IP:8084/v1/servers/self
```
您应该会在输出末尾看到该节点的 UUID，格式如下：
```
"type" : [ "postgres-server" ],
"uUID" : "599e8ebf-5d69-4ae4-aa71-154970a8ec75"
```
注意：edge-postgres-server 服务运行状态如果 Postgres 服务器未运行，则可以在用于确定 UUID 的管理服务器：
```
curl -u sysAdminEmail:password http://ms_IP:8080/v1/servers?pod=analytics
```
此命令的输出列出了每个 Postres 节点 IP 地址的 UUID。
重复上一步，获取旧备用节点和新备用节点的 IP 地址主版本。
从使用方组中移除旧的主节点和备用节点：
```
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 属性现在应为为空。

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

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 属性现在应为空。

向分析组和使用方组注册新的 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

验证分析群组：
```
curl -u sysAdminEmail:password http://ms_IP:8080/v1/analytics/groups/ax
```
您应该会看到分析组中列出的新主节点和备用节点的 UUID 和消费者群体

重启边缘管理服务器：

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

重启所有 Qpid 服务器：

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

重启所有 Postgres 服务器：

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

通过在两台服务器上发出以下脚本来验证复制状态。系统应在两个服务器上显示相同的结果，以确保复制成功：
在新主实例上，运行以下命令：
```
/opt/apigee/apigee-service/bin/apigee-service apigee-postgresql postgres-check-master
```
验证它是否为主实例。在旧备用节点上：
```
/opt/apigee/apigee-service/bin/apigee-service apigee-postgresql postgres-check-standby
```
确认它处于待机状态。
在发出几个 API 请求后重复执行上一步，以确保节点同步。
使用停用 Postgres 节点。
注意：如果旧主节点运行的是 Qpid，您可以让该服务器保持运行状态以运行 Qpid。确保其正在运行。如果没有，请启动该虚拟机：
```
/opt/apigee/apigee-service/bin/apigee-service edge-management-server start
```
或者，您也可以从旧主服务器上卸载 Qpid，并在新主服务器节点上安装 Qpid。卸载 Qpid 后，您可以停用旧主节点

回滚 mTLS

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

停止 Apigee：
```
apigee-all stop
```
停止 mTLS：
```
apigee-service apigee-mtls uninstall
```

重新安装 mTLS：

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