一、背 景
为了进一步保障业务的稳定运行，云数据库GaussDB管理平台（TPOPS）需要从24.1.30升级到24.7.32。
二、升级流程
三、升级流程说明
|--------|----------|
| 任务 | 预计耗时 |
| 升级前准备 | 60分钟 |
| 升级操作 | 120分钟 |
| 验证升级结果 | 20分钟 |
四、注意事项
为了减少升级对系统的影响，请尽量选择在业务量较低时进行升级操作。
由于需要通过网络控制主机上的软件进行升级，所以升级前，请确保局点环境中所有主机处于正常运行状态，且升级过程中不能出现主机断电、断网、缩容的情况。
操作各节点主机的文件可能会影响升级判断流程，禁止用户在升级过程中操作任何文件。
在升级过程中，禁止用户进行业务配置更改操作（角色、主机名、服务、template、网络、主机、hostcfg、证书、虚拟机、域名的配置变更、扩容），避免业务数据丢失或其他不可预知的错误。
升级期间不允许在升级节点进行除升级外的任何操作。
五、升级影响
|-----------------|----------|----------------------------------------------|---------------|
| 影响类型 | 阶段 | 具体信息 | 严重 程度 |
| 升级过程中 对现行系统 的影响 | 升级 执行 阶段 | 无影响 | 无 |
| _ | 升级 完成 阶段 | 无影响 | 无 |
| 对业务 的影响 | - | 用户感受到大约20秒的停顿，期间云数据库GaussDB管理平台（TPOPS）业务不可用。 | 一般 |
| 对网络 通信的 影响 | - | 无影响 | 无 |
六、TPOPS升级步骤
当前仅支持微服务包、数据包、GaussDB实例安装包的升级以及docker-service包的自升级。
操作步骤以/data/docker-service目录为例，请在docker-service实际所在目录执行操作。
完整升级过程，预计耗时40分钟左右。
升级前置检查要求系统根目录（/）可用磁盘空间大于1GB，docker-service目录所在磁盘可用空间大于15GB，系统可用内存大于1GB，管理面节点之间的时间差小于30s。
24.7.30.32版本升级完成后，Web端的访问地址为https://\{EIP}:8002/gaussdb/#/login，其中访问端口变更为8002端口。
如果需要支持IPv6登录，IPv6地址应该配置在node1_ip、node2_ip、node3_ip对应网卡上，且地址范围为Global全局可见，请参考A.6 配置并启用IPv6（可选）章节进行升级节点的IPv6地址配置。
云数据库GaussDB管理平台升级完成后，已有实例的版本不会发生变化。
1、登录节点
以root用户登录待升级的云数据库GaussDB管理平台（TPOPS）的任一节点。
2、备份原安装包
执行以下命令，删除历史残留的升级目录。无历史残留的升级目录，可跳过该步骤。
3、创建升级目录
4、解压新的docker-service
将新的docker-service包上传到升级目录（/data/docker-service/upgrade），并执行以下命令解压。
5、上传升级安装包
执行以下命令，进入待升级安装包的上传路径。
只需上传待升级的安装包即可，全量安装包如下所示：
6、执行升级
执行以下命令，进入到升级脚本所在路径并执行升级命令。
升级过程中禁止手动退出。
完整的升级过程大约40分钟。
回显出现如下信息时，说明升级完成。
七、GaussDB实例升级步骤
云数据库GaussDB管理平台（TPOPS）提供了灰度升级的方式。升级结束后会触发自动备份，开启关闭的归档日志。
升级待观察：将数据库升级过程细分为升级和提交两个阶段，本次操作属于升级阶段。升级阶段滚动升级完成后可以对实例进行业务测试；提交阶段可以根据测试情况选择提交升级或者升级回退。每个主DN或者CN组件升级就有一次10秒业务中断。待所有分片都升级完成，且业务测试正常后，可以提交升级。如果升级观察时，由于业务原因，需要回退，可以选择升级回退。
1、手工全备
在TPOPS进行手工全备
逻辑备份：
2、备份参数文件
3、执行升级
步骤1：登录云数据库GaussDB管理平台（TPOPS）。
步骤2：单击左侧目录"实例管理"，进入"实例列表"页面。
步骤3：选择待升级的实例，单击"更多 > 版本升级"。
步骤4：选择升级方式为"灰度升级"，操作方式为"升级待观察"，选择"升级可用区"以及目标版本。
步骤5：输入"YES"字样并单击"确定"。
待全部AZ升级之后处于待观察阶段，可以提交升级。
步骤6：满足提交升级条件后，再次选择该实例，单击"更多 > 版本升级"。
步骤7：选择升级方式"灰度升级"，操作方式"提交升级"以及目标版本。
步骤8：输入"YES"字样并单击"确定"，提交升级。
八、TPOPS升级回退步骤
在升级完成后，运维人员可执行回退操作。
升级实施期间，如果出现业务面大面积故障（例如：业务网络中断、存储读取失败或业务无法访问等现象），可以触发回退。
升级实施流程出现错误，且无法在计划的时间窗内完成升级，可以触发回退。
回退需要经过客户与技术支持工程师的共同决策后，再启动回退。
回退流程说明
|--------|----------|
| 任务 | 预计耗时 |
| 回退 | 60分钟 |
回退注意事项
开始回退前，必须将升级生效后的业务配置更改操作（角色、主机名、服务、template、网络、主机、hostcfg、证书、虚拟机、域名的配置变更、扩容）恢复到升级前配置，否则会造成业务数据丢失或其他不可预知的错误。
登录节点
以root用户登录待回退的云数据库GaussDB管理平台（TPOPS）的任意一个节点。
创建回退目录
执行以下命令创建回退目录，并将待回退版本的DBS-docker-service*.tar.gz包上传到回退目录（/data/docker-service/rollback），并解压。
复制原安装包
将全量回退的安装包上传到回退目录的安装包存放目录下
回退准备
分别登录influxdb的安装节点并执行以下命令，关闭influxdb的用户认证。
执行回退
执行以下命令，进行回退。
九、GaussDB实例升级回退步骤
如果升级观察时，因为业务原因需要回退，或使用升级待观察方式升级失败时，可参考如下内容，手动执行升级回退操作。
执行回退
步骤1：登录云数据库GaussDB管理平台（TPOPS）。
步骤2：单击左侧目录"实例管理"，进入"实例列表"页面。
步骤3：选择待回退的实例，单击"更多 > 版本升级"。
步骤4：选择升级方式"灰度升级"，操作方式"升级回退"以及回退版本。
步骤5：输入"YES"字样并单击"确定"。