写点什么

YashanDB 滚动升级

作者:YashanDB
  • 2025-03-07
    广东
  • 本文字数:2719 字

    阅读完需:约 9 分钟

本文内容来自 YashanDB 官网,原文内容请见 https://doc.yashandb.com/yashandb/23.3/zh/%E5%AE%89%E8%A3%85%E5%92%8C%E5%8D%87%E7%BA%A7/%E5%8D%87%E7%BA%A7/%E5%8D%87%E7%BA%A7%E6%93%8D%E4%BD%9C/%E6%BB%9A%E5%8A%A8%E5%8D%87%E7%BA%A7.html


YashanDB 支持通过 yasboot 工具滚动升级已经部署的数据库,在数据库不停机的情况下,将数据库二进制文件升级到新版本。


本文将以 23.3.1.0 版本升级到 23.3.1.1 版本为例介绍数据库的滚动升级方式。

注意事项



  • 滚动升级适用范围:

  • 单机(主备)部署:主备形态部署的数据库从 23.2.0.0 及以上版本向版本号前三位相同但第四位不同的新版本进行升级。

  • 分布式部署:MN 和 DN 均为主备部署的数据库从 23.2.3.0 及以上版本向 23.2.3.100 及以上且版本号前三位相同但第四位不同的版本进行升级。

  • 请完成升级前准备要求的各项工作后再进行升级。

  • 升级时会校验新旧数据库的 dbcr 目录是否相同,如果不相同则无法滚动升级。此时滚动升级不会执行,无需回退。

  • 升级过程需使用 YashanDB 内置的 yasboot 工具,该工具的命令选项含义及说明请查阅yasboot

  • 若升级未成功,请执行滚动升级回退恢复环境。如果回退仍不成功,请联系 YashanDB 技术支持解决。

  • 升级后,需根据运行日志告警判断是否使用过时参数,告警内容请查阅参数配置中参数初始化章节示例。若使用了过时参数,需根据配置参数中对应参数的介绍判断该参数是否因改名而过时,并且是否需要将该过时参数调整为对应的新参数。若新参数未配置,则过时参数的配置值将自动转换为新参数值。

操作步骤



除特殊说明,以下步骤均在 yasboot 工具所在的服务器(已存在 hosts.toml 文件)上操作,且命令中的路径、用户、密码等需更换为实际值。

# 步骤 1:执行全量备份

YashanDB 提供两种备份的方式,分别是通过 SQL 语句和使用 yasrman 工具,如需了解更多有关备份的语法及说明请查阅备份恢复


  • SQL 语句方式:

  • SQL 语句执行备份需登录数据库实例进行操作,可通过执行如下语句执行全量备份:


    BACKUP DATABASE FULL FORMAT '/home/yashan/full_20221123' TAG 'full' PARALLELISM 3;
复制代码


Copied!
复制代码


  • yasrman 工具方式:

  • 使用 yasrman 工具进行全量备份须确保在 yasrman 工具所在服务器上操作,可通过执行如下命令执行全量备份:


        $ yasrman sys/password@IP:port -c "backup cluster tag 'full_1' format 'full_bak_1'" -D /home/yashan/catalog
复制代码


Copied!
复制代码

# 步骤 2:上传新版本安装包

  1. 创建一个空目录,该目录将作为升级安装包的临时存放路径。


    $ mkdir ~/tmp_upgrade
复制代码


Copied!
复制代码


  1. 将新版安装包上传至该目录中。

  2. 进入升级安装包的存放目录并解压安装包。


    $ cd ~/tmp_upgrade    $ tar zxf yashandb-23.3.1.1-linux-x86_64.tar.gz
复制代码


Copied!
复制代码

# 步骤 3:升级 yasom 与 yasagent

以下操作均在升级安装包的存放目录中执行。


  1. 查看当前 yasom 与 yasagent 版本。


    $ ps -ef | grep -E "yasom|yasagent" | grep -v grep    yashan 102280      1  0 16:24 ?        00:00:00 /data/yashan/yasdb_home/yashandb/23.3.1.0/bin/yasagent --init -c yashandb -l 192.168.1.2:1676 --host-id host0001 -k                  -d    yashan 102323      1  0 16:24 ?        00:00:00 /data/yashan/yasdb_home/yashandb/23.3.1.0/bin/yasom --init -c yashandb -l 192.168.1.2:1675 -k                  -d        $ /data/yashan/yasdb_home/yashandb/23.3.1.0/bin/yasom -h    Usages: yasom [<flags>] <command>        yasom daemon process, version: Debug 23.3.1.0
复制代码


Copied!
复制代码


  1. 升级 yasom 与 yasagent。


    $ ./bin/yasboot package upgrade -t /home/yashan/install/hosts.toml -p yashandb-23.3.1.1-linux-x86_64.tar.gz    upgrade package...    install version: yashandb 23.3.1.1    host0001 100% [====================================================================]    3s    upgrade host to yasom...
复制代码


Copied!
参数介绍:
复制代码


    -t, --toml  需要服务器配置文件hosts.toml,此处指部署旧版本时生成的hosts.toml文件    -p, --package  升级软件包的绝对路径
复制代码


Copied!
复制代码


  1. 检查 yasom 与 yasagent 升级后的版本。


    $ ps -ef | grep -E "yasom|yasagent" | grep -v grep    yashan 103607      1  0 16:32 ?        00:00:00 /data/yashan/yasdb_home/yashandb/23.3.1.1/bin/yasagent -c yashandb -d    yashan 103650      1  0 16:32 ?        00:00:00 /data/yashan/yasdb_home/yashandb/23.3.1.1/bin/yasom -c yashandb -d
复制代码


Copied!
复制代码

# 步骤 4:升级数据库

以下操作均在升级安装包的存放目录中执行。


Caution:

数据库升级过程中出现任何错误,请执行滚动升级回退恢复环境,升级成功后无法回退。


  1. 查看当前数据库版本。


    $ ./bin/yasboot sql -d sys/password@192.168.1.2:1688 -s 'select version from v$instance;'        VERSION                                                              ----------------------------------------------------------------     Release 23.3.1.0 x86_64    
复制代码


Copied!
复制代码


  1. 升级数据库。


    $ ./bin/yasboot cluster upgrade --cluster yashandb --rolling    type | uuid             | name                | hostid | index    | status  | return_code | progress | cost     -------------------------------------------------------------------------------------------------------------    task | 9d0041edd55f7d4f | UpgradeYasdbCluster | -      | yashandb | SUCCESS | 0           | 100      | 23       ------+------------------+---------------------+--------+----------+---------+-------------+----------+------    task completed, status: SUCCESS
复制代码


Copied!
> **Note**:> > 使用`--keep-primary`参数可以确保滚动升级后集群的主库仍为升级前的主库。
复制代码


  1. 检查数据库升级后的版本。


    $ ./bin/yasboot sql -d sys/password@192.168.1.2:1688 -s 'select version from v$instance;'        VERSION                                                              ----------------------------------------------------------------     Release 23.3.1.1 x86_64   
复制代码


Copied!
复制代码

# 步骤 5(可选):升级后操作

  • 更新环境变量

  • 升级操作不会修改服务器的YASDB_HOMEYASDB_DATALD_LIBRARY_PATH以及PATH等环境变量,若配置过环境变量,升级后需更新为新版本数据库相应的环境变量,若不更新直接使用 yasdb/yasql 等命令会继续指向旧版本数据库

  • 开启或关闭某些配置

  • 若为顺利执行升级操作而临时调整过某些配置(例如关闭仲裁),在升级完成后应按需还原配置(例如重新开启仲裁)。

发布于: 刚刚阅读数: 5
用户头像

YashanDB

关注

全自研国产新型大数据管理系统 2022-02-15 加入

还未添加个人简介

评论

发布
暂无评论
YashanDB滚动升级_数据库_YashanDB_InfoQ写作社区