GaussDB-upgrade子命令

GaussDB-upgrade子命令

该子命令用于升降级DBMind配置文件和元数据库，DBMind整体升降级还需配合DBMind主服务与exporter组件重启等操作，具体步骤如下（以配置文件路径confpath为例）：

1. 在当前版本DBMind文件路径下，停止DBMind服务。

    

   gs_dbmind service stop -c confpath

    

    

2. 在高版本DBMind文件路径下，升级配置文件和元数据库。

    

   gs_dbmind upgrade -c confpath --target dbmindpath

    

    

3. 查询reprocessing_exporter、cmd_exporter、opengauss_exporter的进程号并重启。以reprocessing_exporter为例。

    

   1. 查询进程号。

      ps ux | grep reprocessing_exporter

       
   2. 终止进程。

      kill -9 pid

       
   3. 使用目标版本DBMind启动进程，详细见component子命令。

      gs_dbmind components reprocessing_exporter

       

    

4. 在目标版本DBMind文件路径下，启动DBMind服务。

    

   gs_dbmind service start -c confpath && gs_dbmind service reload -c confpath

    

    

NOTICE:

• 升降级前需确认DBMind服务的API接口正常，否则，DBMind无法升级或升级后API接口不可用。
• 配置文件与元数据库升降级过程中，如果出现元数据无法连接等异常，会导致升级失败，此时，相关文件会自动回滚，如果回滚失败，返回255。
• 升降级前需保证配置文件夹可读写。
• 升降级过程中的硬件故障如磁盘故障、机器停止工作等，无法保证回滚成功。
• 升降级中的回滚失败时，可重新执行升降级命令进行升降级。
• 升级时回滚不成功，如需回退至旧版本，请先进行升级后再进行降级操作；降级时回滚不成功，如需回退至旧版本，请先进行降级再进行升级。
• 升降级回滚失败时，会保留${confpath}_backup和${confpath}_new_backup两个文件夹，用于升降级的重试，需保证这两个文件夹与用户文件不冲突。

命令参考

用户可以通过 --help 选项获得该模式的帮助信息，例如：

gs_dbmind upgrade --help

 

usage:  upgrade [-h] -c DIRECTORY [--target DIRECTORY]

optional arguments:
  -h, --help            show this help message and exit
  -c DIRECTORY, --conf DIRECTORY
                        set the directory of configuration files
  --target DIRECTORY    set the directory for dbmind of the target version

 

表1 gs_dbmind upgrade 子命令说明

参数	参数说明	取值范围
-h, --help	帮助命令	-
-c，--conf	配置文件目录confpath	文件夹路径
--target	配置目标版本的DBMind目录	文件夹路径，默认为gs_dbmind的文件夹路径

 

更多详情请参考GaussDB 文档中心：https://doc.hcs.huawei.com/db/zh-cn/gaussdbqlh/24.1.30/productdesc/qlh_03_0001.html