zabbix 3.4.x 二进制包升级至 Zabbix 4.0

Zabbix 3.4.x 二进制包升级至 Zabbix 4.0

一、官方文档

Red Hat Enterprise Linux/CentOS:
https://www.zabbix.com/documentation/4.0/zh/manual/installation/upgrade/packages/rhel_centos

Debian/Ubuntu:
https://www.zabbix.com/documentation/4.0/zh/manual/installation/upgrade/packages/debian_ubuntu

虽然升级 Zabbix agent 不是强制性的，但建议将其升级，而 Zabbix server 和 Zabbix proxy 必须具备 相同的主要版本。所以，在 Zabbix server 和 Zabbix proxy 的架构升级时，Zabbix server 和全部的 Zabbix proxy 必须中止并升级。

为了最大限度地减小升级期间的停机时间和数据丢失的概率，建议先停机并升级 Zabbix server，而后再逐个停机并升级 Zabbix proxy，待升级完毕后，先启动 Zabbix proxy，再启动 Zabbix server。在 Zabbix server 停机期间，运行中的 Zabbix Proxy 将继续采集和存储数据，并在 Zabbix server 启动并运行后，将数据传递给 Zabbix server。 只有在升级的 Zabbix server 启动后，才会生成 Zabbix server停机期间出现问题的任何通知。

根据其数据库大小，数据库升级到 4.0 版本可能须要很长时间。

二、系统环境

系统：CentOS Linux release 7.5.1804 (Core)
安装方式：yum
zabbix旧版本：3.4.2
zabbix新版本：4.0.5

三、升级步骤

3.一、中止 Zabbix 进程

中止 Zabbix server 以确保没有新数据插入数据库。

systemctl stop zabbix-server

若是须要升级 Zabbix proxy，那么一样中止 Zabbix proxy 进程。

systemctl stop zabbix-proxy

3.二、备份当前的数据库

这是很是重要的步骤。升级前请确保备份了数据库。若是升级失败（因磁盘空间不足、断电或其余意外致使的升级失败），备份的数据库将大有帮助。

3.三、备份配置文件、PHP 文件和 Zabbix 二进制文件

在升级前请确保备份了配置文件、PHP 文件和 Zabbix 二进制文件。

配置文件：

# mkdir /opt/zabbix-backup/
# cp /etc/zabbix/zabbix_server.conf /opt/zabbix-backup/
# cp /etc/httpd/conf.d/zabbix.conf  /opt/zabbix-backup/

PHP 文件和 Zabbix 二进制文件：

# cp -R /usr/share/zabbix/ /opt/zabbix-backup/
# cp -R /usr/share/doc/zabbix-* /opt/zabbix-backup/

3.四、升级 Zabbix 软件仓库配置包

在升级以前，必须更新当前的软件仓库包：

rpm -Uvh https://repo.zabbix.com/zabbix/4.0/rhel/7/x86_64/zabbix-release-4.0-1.el7.noarch.rpm

3.五、升级 Zabbix 组件

依赖包：
libpthread - 编译Zabbix服务器和Zabbix代理时，如今必须使用POSIX Threads库。它是进程共享互斥锁和读写锁所必需的。若是互斥锁可用，但没法进行共享，那么Zabbix将在升级以前回退使用信号量。
zlib - 编译Zabbix服务器和Zabbix代理时，压缩库如今是必需的。

# yum install glibc-devel zlib-devel -y      # 依赖

运行如下命令以升级 Zabbix 组件：

# yum upgrade zabbix-server-mysql zabbix-web-mysql zabbix-agent

若是使用 PostgreSQL 数据库，请将命令中的mysql替换为pgsql。若是升级 Zabbix proxy，请将命令中的server替换为proxy。

3.六、检查 Zabbix 组件配置文件的参数

在新版本中，Zabbix 组件的配置文件发生了一些变化，关于这些[强制变动[(https://www.zabbix.com/documentation/4.0/manual/installation/upgrade_notes_400#configuration_parameters)，详见升级说明。

3.七、启动 Zabbix 进程

启动升级后的 Zabbix 组件。

# systemctl start zabbix-server
# systemctl start zabbix-proxy
# systemctl start zabbix-agent

3.八、清除浏览器的 Cookies 和缓存

待升级完毕后，可能须要清除浏览器的 Cookies 和缓存，以便 Zabbix 的 Web 界面能正常工做。

四、Zabbix 次要版本之间的升级

若是要升级 Zabbix 的次要版本（例如，从 4.0.1 升级至 4.0.3），是很是容易的：

在升级 Zabbix 全部组件的次要版本时，只需运行如下命令：

$ sudo yum upgrade 'zabbix-*'

在升级 Zabbix server 的次要版本时，只需运行如下命令：

$ sudo yum upgrade 'zabbix-server-*'

在升级 Zabbix agent 的次要版本时，只需运行如下命令：

$ sudo yum upgrade 'zabbix-agent-*'

请注意，您也能够在这些命令中使用 'update' 而不是 'upgrade'。 虽然 'upgrade' 会删除过期的包，但 'update' 会保留它们。

五、升级过程当中遇到的问题

5.一、前端与Zabbix数据库不匹配

The frontend does not match Zabbix database. Current database version (mandatory/optional): 3050047/3050047. Required mandatory version: 4000000. Contact your system administrator.

mysql> use zabbix;
mysql> update dbversion set mandatory=3040000;
mysql> flush privileges;

5.二、zabbix-server没法启动

若是服务端zabbix-server没法启动，查看日志/var/log/zabbix/zabbix_server.log

/var/log/zabbix/zabbix_server.log
[Z3005] query failed: [1060] Duplicate column name 'query_fields' [alter table `items` add `query_fields` varchar(2048) default '' not null]

报上面错误，请去数据库执行下面命令:

use zabbix;
alter table items drop column query_fields;
flush privileges;

end