一、背 景

为了进一步保障业务的稳定运行，云数据库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"字样并单击"确定"。