Google 会使用 AI 技术将内容翻译成您偏好的语言。AI 翻译可能包含错误。

4.18.01 回滚流程

Edge for Private Cloud v4.18.01

如果在更新到 Edge 4.18.01 期间发生错误，您可以回滚导致错误的组件，然后再次尝试更新。例如，如果 Postgres 9.6 的更新失败，您可以仅回滚 Postgres 节点，然后重试更新。

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

回滚到旧版本。例如，从 4.18.01 降级到 4.17.01。
回滚到同一版本中的旧版本。

请按照以下步骤针对这两种情况执行回滚。

谁可以执行回滚

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

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

哪些组件可以回滚

执行回滚时，您应注意以下情况：

下面列出的五个 Edge 组件共享通用代码。因此，如需回滚节点上的五个组件中的任何一个，您必须回滚节点上安装的五个组件中的任何一个。例如，如果您在节点上安装了管理服务器、路由器和消息处理器，则要回滚其中任何一个，您必须回滚所有这三个。

共享代码的五个组件包括：
- 管理服务器
- 路由器
- 消息处理器
- Qpid 服务器
- Postgres 服务器
如果您要从 Edge 4.16.01 进行更新，请勿回滚 Cassandra。此版本的 Edge 包含 Cassandra 的更新版本。如果您回滚任何组件，请将 Cassandra 保持在 4.18.01 版本。

回滚 4.18.01

本部分介绍了将 Edge 4.18.01 回滚到先前版本的过程。本部分分为两个部分：

回滚 Postgres 更新
每个更新过程的最后一部分是将 Postgres 节点更新到 9.6 版。如果该更新失败，您可以使用此过程回滚更新。
回滚所有其他 Edge 组件
使用此过程可回滚任何其他 Edge 组件。

回滚 Postgres 9.6 更新

如需在主备配置中更新 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 主节点：

将新的备用节点提升为新的主节点：
```
> apigee-service apigee-postgresql promote-standby-to-master new_standby_IP
```
如果出现提示，请输入“apigee”用户的 Postgres 密码，默认为“postgres”。

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

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

配置新主实例：

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

重新构建旧备用节点：

修改用于安装当前 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

如果未运行，请启动它：

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

通过在旧主节点上运行以下 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
```
此命令的输出会列出每个 Postgres 节点的 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。

重启 Edge Management Server：

> /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 请求后，重复上一步，以确保节点同步。
使用将 Apigee Edge 4.16.01/4.16.05 更新到 4.17.09 中的过程停用旧 Postgres 主实例。
注意：如果旧主节点正在运行 Qpid，您可以让该服务器继续运行 Qpid。确保其正在运行。如果未启动，请启动它：
```
> /opt/apigee/apigee-service/bin/apigee-service edge-management-server start
```
或者，您可以从旧主节点中卸载 Qpid，并在新主节点上安装 Qpid，如下所述。卸载 Qpid 后，您可以停用旧的主节点。

从旧主节点卸载 Qpid，并在新主节点上安装 Qpid

请按照以下步骤从旧主节点中卸载 Qpid，并将其安装在新主节点上：

在所有消息处理器上运行以下命令，阻止消息处理器访问旧主实例上的 Qpid 端口 5672：
```
> iptables -A OUTPUT -p tcp -d 10.233.147.20 --dport 5672 -j DROP
```
运行以下命令，确保 Qpid 消息队列为空。在 Qpid 处理完所有待处理的消息之前，您无法将其卸载：
```
> qpid-stat -q
```
此命令会显示一个包含 msg, msgIn, and msgOut 计数的表。当 msg=0 且 msgIn=msgOut 时，所有消息都将被处理。
在旧主节点上运行以下命令，确定旧主节点上 Qpid 服务器的 UUID。保存此信息，以便在后续过程中使用：
```
> curl -u sysAdminEmail:password http://node_IP::8083/v1/servers/self
```

在旧主节点上停止 Qpid：

> /opt/apigee/apigee-service/bin/apigee-service edge-qpid-server stop
> /opt/apigee/apigee-service/bin/apigee-service apigee-qpidd stop

卸载 Qpid 服务器：

> /opt/apigee/apigee-service/bin/apigee-service edge-qpid-server uninstall
> /opt/apigee/apigee-service/bin/apigee-service apigee-qpidd uninstall

从分析和使用方群组中移除旧 Qpid 服务器：

> curl -u sysAdminEmail:password -X DELETE -H "Content-Type: application/json" -d ''
  "http://ms_IP:8080/v1/analytics/groups/ax/axgroup-001/consumer-groups/consumer-group-001/consumers/qpid_UUID" -v
> curl -u sysAdminEmail:password -X DELETE
  "http://ms_IP:8080/v1/analytics/groups/ax/axgroup-001/servers?uuid=qpid_UUID&type=qpid-server" -v

从 Zookeeper 中移除旧 Qpid 服务器：

> curl -u sysAdminEmail:password -X DELETE
  http://ms_IP:8080/v1/servers/qpid_UUID

在新主节点上安装 Qpid：

> /opt/apigee/apigee-setup/bin/setup.sh -p qs -f configFile

通过在新主服务器上运行以下命令，确定新主服务器上的 Qpid 服务器的 UUID。保存此信息，以便在后续过程中使用：
```
> curl -u sysAdminEmail:password
  http://node_IP::8083/v1/servers/self
```

向分析和使用方群组注册新的 Qpid 服务器：

> curl -u sysAdminEmail:password -X POST -H "Content-Type: application/json" -d ''
  "http://ms_IP:8080/v1/analytics/groups/ax/axgroup-001/servers?uuid=qpid_UUID&type=qpid-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/consumers?uuid=qpid_UUID" -v

重启所有消息处理器：

> /opt/apigee/apigee-service/bin/apigee-service edge-message-processor restart

在新 Qpid 服务器上运行以下命令，检查队列是否已创建：
```
> qpid-stat -q
```
确保您看到 msg、msgIn 和 msgOut 在 Qpid 服务器处理消息时更新。

如需从 4.18.01 回滚各个组件，请执行以下操作：

在执行回滚的过程中，您必须下载当前 Edge 版本的 bootstrap.sh 文件：

如需回滚到 4.17.09，请下载 bootstrap_4.17.09.sh
如需回滚到 4.17.05，请下载 bootstrap_4.17.05.sh
如需回滚到 4.17.01，请下载 bootstrap_4.17.01.sh
如需回滚到 4.16.09，请下载 bootstrap_4.16.09.sh
如需回滚到 4.16.05，请下载 bootstrap_4.16.05.sh
如需回滚到 4.16.01，请下载 bootstrap.sh

对于托管要回滚的组件的每个节点：

停止要回滚的组件：
1. 如果您要回滚节点上的以下任一组件，则必须停止所有组件：Management Server、Router、消息处理器、Qpid Server 或 Postgres Server：
  - ```
  > apigee-service edge-management-server stop
```
- ```
> apigee-service edge-router stop
```
  - ```
  > apigee-service edge-message-processor stop
```
- ```
> apigee-service edge-qpid-server stop
```
  - ```
  > apigee-service edge-postgres-server stop
```
2. 如果您要回滚节点上的任何其他组件，请仅停止该组件：
  - ```
  > apigee-service comp stop
```
如果您要回滚创收功能，请从所有管理服务器和消息处理器节点中卸载该功能：
```
> apigee-service edge-mint-gateway uninstall
```
卸载组件以在节点上回滚：
1. 如果您要回滚节点上的以下任何组件，请将其全部卸载：Management Server、路由器、消息处理器、Qpid Server 或 Postgres Server：
```
> apigee-service edge-gateway uninstall
```
2. 如果您要回滚节点上的任何其他组件，请仅卸载该组件：
```
> apigee-service comp uninstall
```
3. 如果您要回滚路由器，则必须删除 /opt/nginx/conf.d 的内容：
```
> cd /opt/nginx/conf.d
> rm -rf *
```
如需回滚组件，请执行以下操作：
1. 卸载 4.18.01 版 apigee-setup：
```
> /opt/apigee/apigee-service/bin/apigee-service apigee-setup uninstall
```
2. 下载所需版本的 bootstrap.sh：例如，对于 4.16.09：
```
> curl https://software.apigee.com/bootstrap_4.16.09.sh -o /tmp/bootstrap_4.16.09.sh 
```
3. 安装 4.16.01、4.16.05 或 4.16.09 apigee-service 实用程序和依赖项。例如，对于 4.16.09：
```
> sudo bash /tmp/bootstrap_4.16.09.sh apigeeuser=uName apigeepassword=pWord
```
  其中，uName 和 pWord 是您从 Apigee 收到的用户名和密码。如果您省略 pWord，系统会提示您输入。
4. 安装 apigee-setup：
```
> /opt/apigee/apigee-service/bin/apigee-service apigee-setup install
```
5. 安装所需版本的组件：
```
> /opt/apigee/apigee-setup/bin/setup.sh -p comp -f configFile
```
  其中，comp 是要安装的组件，configFile 是所需版本的配置文件。
6. 如果您要回滚 Qpid，请刷新 iptables：
```
> sudo iptables -F
```
如需将组件回滚到 4.18.01 版本的特定版本，请执行以下操作：
1. 下载特定组件版本：
```
> /opt/apigee/apigee-service/bin/apigee-service comp-version install
```
  其中，comp-version 是要安装的组件和版本。例如：
```
> /opt/apigee/apigee-service/bin/apigee-service edge-ui-4.17.09-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
```
  请注意，您在执行安装时只需指定组件名称。

如果您在回滚时遇到问题，请与 Apigee Edge 支持团队联系。