8.0.42181 升级到 8.0.44807¶

目录
8.0.42181 升级到 8.0.44807

版本支持¶

支持 8.0.35274 升级 8.0.44766
支持 8.0.41241 升级 8.0.44766
支持 8.0.42181 升级 8.0.44766
支持 8.0.44766 升级 8.0.44807

升级前建议¶

若升级前版本已是8.0.34118或者之后的版本，建议清理作业历史的日志，可加上 WHERE 限定删除某个时间点前的或非错误的日志。否则，可能会引起 backupd 升级元数据要耗时若干个小时。
```
UPDATE job_history SET log=null
WHERE start_time<'2023-01-01 00:00:00' OR -- 删除某个时间点前的作业日志，或
      state!='error'; -- 删除未发生错误的作业的历史的日志
```
- 如果后端数据库为 SQLite，连接到 /var/opt/scutech/dbackup3/backupd/hist.db 数据库
```
sqlite3 /var/opt/scutech/dbackup3/backupd/hist.db
```
- 如果后端数据库为 MySQL/MariaDB，连接到 dbackup3 数据库
```
mysql -u root -p; -- 回车输入密码
use dbackup3；-- 选择数据库
```

升级服务端¶

升级 dbackup3¶

升级命令安装包顺序: dbackup3-common, dbackup3-backupd, dbackup3-storaged, dbackup3-storaged-lanfree, dbackup3-nfsd, dbackup3-controller, dbackup3-infokist, dbackup3-nginx 。

遇到如下提示选择 Y

Configuration file '/etc/opt/scutech/dbackup3/storaged/svc.conf.d/00-base.conf'
 ==> Modified (by you or by a script) since installation.
 ==> Package distributor has shipped an updated version.
   What would you like to do about it ?  Your options are:
    Y or I  : install the package maintainer's version
    N or O  : keep your currently-installed version
      D     : show the differences between the versions
      Z     : start a shell to examine the situation
 The default action is to keep your current version.
*** 00-base.conf (Y/I/N/O/D/Z) [default=N] ?

出现此提示，一般情况为该配置文件被修改过，配置文件内容与新版本有差异。此种情况需要先备份配置文件，然后选择 Y 后，使用新版本配置文件进行覆盖，升级完成后，再在新版本的配置文件中更改的对应的选项。如在升级过程中上述步骤选择了 N ，可能会导致升级后功能不正常，可通过以下命令再次覆盖安装，重新选择 Y
```
dpkg -i --force-confask dbackup3-<module>.deb
```

若提示 dbackup3-nfsd 依赖 iproute2 无法升级成功，先安装 iproute2 再升级。
存在 D2T 或备份到磁带库的作业，需要在升级前确保作业停止，磁带库为非使用状态。升级后磁带库需要重新扫描（需要磁带库处于非使用状态才能进行重新扫描）。

升级 dbackup-server¶

升级前准备:
- 控制节点和所有存储节点必须升级到相同版本，不能只单独升级某个节点，并且务必先升级控制节点，升级成功后再升级存储节点；
- cd_server.conf文件中 db_password 和 db_username 不是空值；
- 备份cd_server.conf文件：
```
sudo cp /etc/opt/scutech/cd_server.conf /etc/opt/scutech/cd_server.conf.bak`date +'%m%d%H%M'`
```
- 备份 MySQL 数据库：
```
mysqldump -uroot -p ds_db > /tmp/mysql_`date +'%m%d%H%M'`.sql
```
- 停止块设备重删池上的作业，解挂块设备重删池，命令如下:
```
mount | grep bfs2-serverd | awk '{print "umount " $3}' | sh
```
- 如升级时仍然提示未解挂完成，使用以下命令查看是否还存在的遗留进程，用 kill -9 强制杀死该进程
```
ps aux | grep bfs
```
- 增加FusionCloud映射。若无FusionCloud，则跳过此步
```
vi /etc/hosts
添加以下语句
IP image.x.x.x.x (IP为FusionCloud的CPS的IP地址，x.x.x.x为FusionCloud CPS的安装部署域名)
```
- 增加FusionCompute备份恢复参数。
```
vi /etc/opt/scutech/dbackup_vmserver/vmserverd.xml
文件添加"<fusion_compute_client_ip>迪备存储服务器IP</fusion_compute_client_ip>"参数
```
升级dbackup-server
- Ubuntu下升级dbackup-server
  使用 dpkg -i 命令升级 dbackup-server 包，升级过程用空格选择所需要使用的功能模块。
- CentOS下升级dbackup-server
  使用命令 rpm -Uvh dbackup-server_version.rpm 命令升级 dbackup-server 安装包。

升级完成后，检查项。

升级完成后，查看 cd_server.conf 中 db_password 和 db_username 是否是空值。若不为空，则跳过此步。若为空值,处理方式如下：

/opt/scutech/dbackup_seserver/db_util config db_username db_password （db_password  db_username 是mysql非root用户名和密码）
cat /etc/opt/scutech/cd_server.conf（若db_password 和db_username 已经有值，代表写入成功）
dpkg -i dbackup-server_version.deb(覆盖安装一次)

升级完成后若块设备重删池未自动挂载，可通过重启 se_server 服务解决。

注意¶

服务端升级后会检测存储服务器 /infokist 目录的文件系统类型，若文件系统类型是 ZFS，则允许创建合成池，不允许创建重删池；若文件系统非 ZFS 则允许创建重删池不允许创建合成池，其他类型的存储池不受影响。
升级前非 ZFS 文件系统，安装了dbackup3-storaged-lanfree 后可创建合成池，升级后将不支持创建。
若升级后仍需要创建不受支持的存储池，可通过如下步骤启用：admin 登录迪备，打开 global-config 页面，在【存储管理】中设置“ZFS 文件系统下不支持的存储池” 和 “ZFS 文件系统下才支持的存储池” 选项。
新版本 nginx 的 backupd 和 storaged 的 ssl 端口配置文件，在 location /d2 配置块中，增加了 include proxy_timeout_params; ，若升级前手工配置过其他的端口代理 ssl ，需要手工添加 include proxy_timeout_params; 配置，或用最新的配置文件为模板重新配置 DBackup3_Nginx_配置默认端口
若升级前添加有 NDMP 主机，升级后，需进入资源界面，修改 NDMP 主机，选择一个客户端。
若打开了 “配置文件防篡改”功能，一定要先关闭再进行升级。

从 SQLite 迁移到 MySQL¶

注意：SQLite 迁移 MySQL 前，一定要先检查界面、backupd 服务和日志等是否正常，若不正常应先排查问题，再迁移。

查看当前数据是否已迁移到 MySQL

# 登录 MySQL 查看是否有 dbackup3 库
show databases;

# 使用db_config查看 host 、port、passowrd、user、connector属性及值
/opt/scutech/dbackup3/bin/db_config list -n common

若已经是 MySQL，则跳过【从 SQLite 迁移到 MySQL】相关迁移操作。

配置 MySQL 连接¶

配置时提示重启backupd服务，请输入N

root@ubuntu:~# /etc/init.d/dbackup3-backupd config mysql
Please input MySQL host[127.0.0.1]: 
Please input MySQL port[3306]: 
Please input MySQL user[root]: 
Please input MySQL password: 
Loaded /opt/scutech/dbackup3/lib/libmysqlclient.so with flags 0x00000101(RTLD_LAZY | RTLD_GLOBAL)
Test MySQL connectivity OK!
Do you want to restart backupd? [Y]: N

迁移数据库 （迁移数据库之前先停相关dbackup3服务）

/etc/init.d/dbackup3-backupd stop
/etc/init.d/dbackup3-storaged stop
/opt/scutech/dbackup3/bin/db_migrate  sqlite  mysql
/etc/init.d/dbackup3-backupd  restart
/etc/init.d/dbackup3-storaged  restart

升级用户手册¶

用root权限执行手册run脚本（manual_run/manual-8.0.xxxx.run），按照提示输入即可。

chmod +x manual-8.0.xxxx.run
./manual-8.0.xxxx.run

代理端升级¶

dbackup3 代理端¶

需要检查备份服务器是否已安装 rpm 和 gnupg 工具，若无可使用 tools/rpm-gnupg-offline.tar.gz 离线包安装。
```
dpkg -l | grep -E "rpm|gnupg" 
```
HP-UX、Solaris 、AIX 代理端不支持升级，需手动升级；
其他 dbackup3 代理端，使用界面上传 dbackup3 包进行升级；
KingBase V7 及 V8 版本在 Linux 平台统一使用 agent-postgres 安装包
KingBase V8R3 及以上版本升级后继续使用 agent-postgres 包，KingBase V7在服务端升级后需先卸载 agent-kingbase 包，重新安装 agent-postgres 包。
Windows DB2 升级代理端，若存在 DB2 自动归档日志备份作业时，需要将该作业删除。否则会因某些 DLL 进程被占用，使得升级代理端失败。

注意：

公钥过期解决办法1：低于 8.0.28885 版的迪备的公钥已在 2021-05-16 过期，因此低版本升级需要先手动升级到8.0.28885之后的版本，才可进行页面升级。
RPM 包推送升级，需检查服务端是否安装 rpm 和 gnupg 包，安装完成后需重启 dbackup3-backupd 服务

datasender 代理端¶

dpkg -i dbackup-datasender-version.deb

filesender 代理端¶

FusionCloud 虚拟化平台代理端由 filesender 变更为统一使用 datasender，需要卸载 filesender 重装成 datasender 代理端。

        dpkg -P dbackup-filesender

        dpkg -i dbackup-datasender-version.deb

Kubernetes 代理端¶

Kubernetes 代理端升级需要修改 agent.yaml 中的 image 参数，然后重新执行 kubectl apply -f agent.yaml

image: registry.docker.scutech.com/k8s-backup/centos/stable/dbackup3-agent-k8s:version.dbg

Catalog 回滚 SQLite 配置¶

注意：适用于现场升级可能因为某种原因（如数据迁移时数据量过大，错过用户升级时间窗口）导致迁移失败需要回滚配置的场景。

回退配置的方法：

版本号 >= 8.0.36352，使用命令设置回滚
```
 /etc/init.d/dbackup3-backupd config sqlite
```

8.0.32567 <= 版本号 < 8.0.36352

cd /var/opt/scutech/dbackup3/backupd
mv database-conf.d database-conf.d.bak
/etc/init.d/dbackup3-backupd restart

回滚配置后可使用如下命令确认是否回滚成功

root@ubuntu:# /opt/scutech/dbackup3/bin/db_config list -n common
Database: common
    backend-config-path: "" 
    backup: true
    backup-pages_number: 1000
    backup-sleep-msec: 100
    charset: "" 
    connect-timeout: 5
    connector: "sqlite" 
    host: "" 
    init-command: "" 
    journal-mode: "" 
    max-conn-number: 8
    max-conn-pool-size: 6
    metadata: "common" 
    password: "" 
    path: "/var/opt/scutech/dbackup3/backupd/common.db" 
    port: 0
    ssl-ca: "" 
    ssl-ca_path: "" 
    ssl-certificate: "" 
    ssl-cipher: "" 
    ssl-key: ""

sql_mode配置¶

低版本（8.0.32567 <=版本号< 8.0.36208-1）升级到8.0.36208-1及之后的版本，升级完成后 不再需要在 mysqld.conf 中配置 sql_mode='ONLY_FULL_GROUP_BY‘ ，配置中已有的可忽略不管。
```
root@ubuntu:~# cat /etc/mysql/mysql.conf.d/mysqld.cnf 
```

升级有MySQL资源的代理端时，若升级存在以下依赖问题¶

libmysqlclient.so.18()(64bit) 被 (已安裝) postfix-2:2.10.1-6.el7.x86_64 需要
libmysqlclient.so.18(libmysqlclient_18)(64bit) 被 (已安裝) postfix-2:2.10.1-6.el7.x86_64 需要

需要手动升级：

rpm -Uvh dbackup3-common-verision.rpm dbackup3-agent-version.rpm dbackup3-agent-mysql-version.rpm --nodeps

解决特定版本无法广播升级问题¶

影响版本：8.0.44439 <=版本号< 8.0.45457
临时解决方案：手动调用广播升级的请求，请求中传入禁止检查签名的标识。

POST /d2/r/v2/agent/action?name=upgrade
{
    "check_sign": false
}

名称

大小

修改时间

操作

提示信息