银行案例|Zabbix跨版本升级指南，4.2-6.0不香吗？
银行案例|Zabbix跨版本升级指南，4.2-6.0不香吗？
【作者】武玉森，就职于国内某城商行，从事运维框架及智能监控等方面工作，对操作系统、开源监控等方面具有丰富的实践经验。
Zabbix 6.0 LTS 已经发布了一段时间了，面对那么香的新鲜功能，回头看看自己 Zabbix 4.2 版本，难道只能看着眼馋嘛？！
可是如何完成跨版本升级，分析官方文档给出了以下建议：
Zabbix 4.2 → Zabbix 5.x → Zabbix 6.0
然而面对 7*24 小时的无中断业务要求，如果按部就班的逐版本升级，监控停摆周期可能不可控。仔细分析各版本数据结构及升级要求，发现最大的问题还是在数据库及数据结构这块儿，只要处理好这块儿问题，跨版本升级未必不可行，最终决定采用大版本直升的方案进行升级：
Zabbix 4.2 → Zabbix 6.0
注： 该文为后整理，缺少相关页面图示，请见谅。
资源需求
类型 | 资源 | 备注 |
|---|---|---|
数据库 | 虚机 1 台 | 部署 Mysql 8，可按需求是否做主从 |
前端服务 | 虚机 1 台 | 部署 nginx+php，根据实际需求是否需要做负载 |
后端服务 | 虚机 2 台 | 部署 zabbix server 6.0，进行主备验证 |
升级步骤
本次升级为大版本升级，升级期间新旧版本并行工作，逐步替代，不会长时间影响监控运行（约 10 分钟），但需按照以下升级步骤开展。（为简化文档说明，Proxy 相关部署直接安装新版本即可，不再赘述）
步骤 | 升级主题 | 内容简述 | 备注 |
|---|---|---|---|
1 | Mysql 8 数据库部署 | 部署8.x版本Mysql，并将mysqldump文件导入 | 该 mysqldump 为 Zabbix 4.2 版本数据库导出 |
2 | 新前端部署 | 安装 nginx 及 php | |
3 | 新Server部署 | 安装 Zabbix 6.0LTS | 该阶段启动时触发升级动作 |
数据库部署 - Mysql 8
步骤一：从原 Server 数据库导出 mysqldump 文件
因数据量过大，导出时排除了 history 和 trend 数据,但需导出表结构
mysqldump -uroot -p --databases zabbix --ignore-table=zabbix.history --ignore-table=zabbix.history_log --ignore-table=zabbix.history_str --ignore-table=zabbix.history_text --ignore-table=zabbix.history_uint --ignore-table=zabbix.trends --ignore-table=zabbix.trends_uint > zabbix_dump.sql
mysqldump -d zabbix -uroot -p --tables history history_log history_str history_text history_uint trends trends_uint > zabbix_tables.sql
步骤二：安装 Mysql8.0.28 版本
该阶段可采用了绿色免安装版，从 mysql 官网下载 mysql-8.0.28-el7-x86_64.tar.gz，并直接解压安装、初始化 mysql、创建 zabbix 用户并附权（可参考官网现有解决方案，不再赘述）。因版本跨度大，数据编码、结构均需人工干预进行处理，以下部分是成功与否的关键，此处划重点！
① 确认 my.cnf 中配置
character-set-server=utf8mb3
collation-server=utf8mb3_bin
② 创建 zabbix 库
create database zabbix character set utf8mb3 collate utf8mb3_bin;
③ 修改导出的 mysqldump 文件
导入前，需确保mysqldump中每个表的DDL语句中参数如下（可采用 sed 批量调整）
ENGINE=InodDB DEFAULT CHARSET=utf8mb3 COLLATE=utf8mb3_bin;
此步骤很重要，不然会出现索引异常的问题。
④ 导入 mysqldump
mysql -uroot -p zabbix < zabbix_dump.sql
mysql -uroot -p zabbix < zabbix_tables.sql
⑤ 创建 zabbix 用户并附权
mysql> create user zabbix@'%' identified by 'xxxxxxxx';
mysql> grant all on zabbix.\* to zabbix@'%';
mysql> flush privileges;
⑥ Zabbix plugin 加密方式的确认及修改
#查看(确保加密方式为 mysql_native_password)：
mysql> use mysql;
mysql> select user,host,plugin,authentication_string from user;
#修改：
mysql> alter user zabbix@'%' identified with mysql_native_password by 'xxxxxxx';
新前端部署
此处部署全新的 Nginx+PHP 按官网提供的部署方案部署即可，此处不再赘述。（附上官网安装步骤，依据个人喜好，可采用源码安装）
dnf module switch-to php:7.4
dnf install zabbix-web-mysql zabbix-nginx-conf zabbix-selinux-policy
新 Server 部署
可按官方提供的部署方法部署，以下为我所用的部署方案（仅供参考）。
采用源码部署方式部署，主备节点均采用以下方案部署。
① Zabbix Server 所需的依赖包安装
yum install -y gcc mariadb-devel net-snmp-devel libxml2-devel unixODBC-devel libcurl-devel openssl-devel openldap-devel pcre-devel
#需要将 libssh2-devel OpenIPMI-devel libevent-devel 上传到本地
yum localinstall libevent-devel-2.0.21-4.el7.x86_64.rpm libssh2-devel-1.8.0-4.el7.x86_64.rpm OpenIPMI-devel-2.0.27-1.el7.x86_64.rpm
#支持 java gateway
yum install -y java-1.8.0-openjdk java-1.8.0-openjdk-devel
② 编译安装
mkdir -p /home/ source-code
tar -zxvf zabbix-6.0.3.tar.gz -C /home/source-code
cd /home/ source-code/zabbix-6.0.3
./configure --prefix=/home/zabbix-server --enable-server --enable-java --enable-ipv6 --with-mysql --with-libxml2 --with-unixodbc --with-net-snmp --with-ssh2 --with-openipmi --with-openssl --with-libcurl
make && make install
③ 配置自启动服务
#vim /usr/lib/systemd/system/zabbix-server.service #内容如下：
[Unit]
Description=Zabbix Server
After=syslog.target
After=network.target
[Service]
Environment="CONFFILE=/home/zabbix-server/etc/zabbix_server.conf"
EnvironmentFile=-/etc/sysconfig/zabbix-server
Type=forking
Restart=on-failure
PIDFile=/home/zabbix-server/zabbix_server.pid
KillMode=control-group
ExecStart=/home/zabbix-server/sbin/zabbix_server -c $CONFFILE
ExecStop=/bin/kill -SIGTERM $MAINPID
RestartSec=10s
TimeoutSec=0
[Install]
WantedBy=multi-user.target
注： Zabbix 6.0LTS 支持 HA 配置，请在主从节点各自配置 Zabbix Server 配置文件
④ 主节点配置
#vi /home/zabbix-server/etc/zabbix_server.conf #修改项如下：
LogFile=/home/logs/zabbix/zabbix_server.log
LogFileSize=200
PidFile=/home/zabbix-server/zabbix_server.pid
DBHost=[数据库节点 ip]
DBName=zabbix
DBUser=zabbix
DBPassword=
StartPollers=20
StartPollersUnreachable=5
StartPingers=5
CacheSize=1024M
HistoryCacheSize=64M
HistoryIndexCacheSize=16M
TrendCacheSize=16M
ValueCacheSize=128M
Timeout=15
User=[启动用户]
StatsAllowedIP=0.0.0.0/0
HANodeName=[主节点 name]
NodeAddress=[主节点 IP]:10051
⑤ 备节点配置
#vi /home/zabbix-server/etc/zabbix_server.conf #修改项如下：
LogFile=/home/logs/zabbix/zabbix_server.log
LogFileSize=200
PidFile=/home/zabbix-server/zabbix_server.pid
DBHost=[数据库节点 ip]
DBName=zabbix
DBUser=zabbix
DBPassword=
StartPollers=20
StartPollersUnreachable=5
StartPingers=5
CacheSize=1024M
HistoryCacheSize=64M
HistoryIndexCacheSize=16M
TrendCacheSize=16M
ValueCacheSize=128M
Timeout=15
User=[启动用户]
StatsAllowedIP=0.0.0.0/0
HANodeName=[备节点 name]
NodeAddress=[备节点 IP]:10051
注： 在主节点启动服务后，会自动开启数据库表升级操作，待升级完成后在启动备节点。
⑥ 启动主节点服务，此步骤会触发数据库表升级操作
systemctl start zabbix-server
systemctl enable zabbix-server
⑦ 启动备节点服务
systemctl start zabbix-server
systemctl enable zabbix-server
至此，新 Server 部署完成。
⑧ 异常处理（★ 关键）
从前端页面登陆，如果页面显示连接数据库产生了报错（如乱码、未知报错等），产生该问题的原因大概率是因为数据库编码导致，需重新将 Mysql 8 的 zabbix 库表导出成 mysqldump 文件，并修改相关编码。具体步骤如下。
① 重新修改并确认 my.cnf 中配置
character-set-server=utf8mb4
collation-server=utf8mb4_bin
② 导出mysqldump文件
mysqldump -uroot -p --databases zabbix --ignore-table=zabbix.history --ignore-table=zabbix.history_log --ignore-table=zabbix.history_str --ignore-table=zabbix.history_text --ignore-table=zabbix.history_uint --ignore-table=zabbix.trends --ignore-table=zabbix.trends_uint > zabbix_dump.sql
mysqldump -d zabbix -uroot -p --tables history history_log history_str history_text history_uint trends trends_uint > zabbix_tables.sql
③ 重启mysql数据库
④ 删除原 zabbix 库并创建新的 zabbix 库(编码为utf8mb4)
drop database zabbix;
create database zabbix character set utf8mb4 collate utf8mb4_bin;
⑤ 修改导出的 mysqldump 文件
导入前，需确保mysqldump中每个表的DDL语句中参数如下（可采用 sed 批量调整）
ENGINE=InodDB DEFAULT CHARSET=utf8mb4 COLLATE=utf8mb4_bin;
⑥ 导入 mysqldump
mysql -uroot -p zabbix < zabbix_dump.sql
mysql -uroot -p zabbix < zabbix_tables.sql
后记
Server 版本升级完成后，这是一个全新的尚未有 Agent/Proxy 数据接入 Server 端，可逐个更改 Agent/Proxy（Proxy 版本需与 Server 端相匹配）指向来实现监控无中断。
理论上，该文档适配zabbix 4.x的任何版本的跨版本升级。然而大版本升级具有一定风险，建议在测试环境充分测试后再投入生产实施。
最后祝大家升级顺利，万事大吉！
感谢本文作者，欢迎交流！期待更多用户投稿。
-------------- --------------
7月29日，拥有Zabbix5.0认证证书的工程师想要升级为6.0，只需参与为期1天的课程（原培训为5天），省时省钱！
联系文末小Z，了解更多。