这是原厂英文文档的翻译页面. 欢迎帮助我们 完善文档.

1 Red Hat Enterprise Linux/CentOS

概述

本节提供了使用用于Red Hat Enterprise Linux / CentOS的官方Zabbix软件包从Zabbix 4.4.x成功升级到Zabbix 5.0.x所需的步骤。

虽然不是强制性升级Zabbix agent(但建议升级),但是Zabbix server和agent必须具有相同的主版本。 因此,在server-proxy设置中,必须停止并升级Zabbix server和所有agent。 在agent升级期间,不再使agent保持运行状态将带来任何好处,因为在agent升级期间,其旧数据将被丢弃,并且在agent配置与server同步之前不会收集新数据。

请注意,对于agent上的SQLite数据库,升级之前来自agent的历史记录数据将丢失,因为不支持SQLite数据库升级,并且必须手动删除SQLite数据库文件。 首次启动agent并且缺少SQLite数据库文件时,agent会自动创建它。

根据数据库大小,数据库升级到版本5.0可能会花费很长时间。

<note warning>值得注意的是,在升级之前,请务必阅读相关的升级说明! :::

RHEL / CentOS 7用户,升级前端时请注意PHP> = 7.2版本要求!请务必阅读相关文档!

请阅读下面的升级说明:

早期版本 详细的 本升级说明 版本之间升级的重要说明/
4.4.x For:
Zabbix5.0
IBM DB2的支持下降;
所需的最低PHP版本从5.4.0升级到7.2.0;
升级了所需的最低数据库版本。
4.2.x For:
Zabbix 4.4
Zabbix5.0
Jabber,Ez Texting媒体类型已删除。
4.0.x LTS For:
Zabbix 4.2
Zabbix 4.4
Zabbix5.0
较旧的代理不再可以将数据报告给已升级的服务器;
较新的agent不再能够与较旧的Zabbix server一起使用。
3.4.x For:
Zabbix 4.0
Zabbix 4.2
Zabbix 4.4
Zabbix5.0
'libpthread'和'zlib'库现在是必需的;
支持删除纯文本协议,并且标头是必需的;
不再支持1.4版之前的Zabbix agent;
现在,被动代理配置中的Server参数是必需的。
3.2.x For:
Zabbix 3.4
Zabbix 4.0
Zabbix 4.2
Zabbix 4.4
Zabbix5.0
SQLite支持作为Zabbix server/前端的后端数据库删除;
支持Perl兼容正则表达式(PCRE),而不是POSIX扩展;
Zabbix server必需的'libpcre'和'libevent'库;
添加了退出代码检查,以检查用户参数,远程命令和system.run []项目(不带'nowait'标志)以及Zabbix server执行的脚本;
Zabbix Java gateway必须升级以支持新功能。
3.0.x LTS For:
Zabbix3.2
Zabbix 3.4
Zabbix 4.0
Zabbix 4.2
Zabbix 4.4
Zabbix5.0
数据库升级可能会很慢,具体取决于历史记录表的大小。

您可能还需要检查5.0的要求

<note tip>在升级过程中运行两个并行的SSH会话可能很方便,在一个过程中执行升级步骤,而在另一个过程中监视server/proxy日志。 例如,在第二个SSH会话中运行tail -f zabbix_server.logtail -f zabbix_proxy.log,向您显示最新的日志文件条目和实时可能的错误。 这对于生产实例可能至关重要。。 :::

升级步骤

1 停止 Zabbix 进程

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

# systemctl stop zabbix-server

如果需要升级 Zabbix proxy,那么同样停止 Zabbix proxy 进程。

# systemctl stop zabbix-proxy

<note important>无法再启动已升级的server,并且无法使用较旧但尚未升级的proxy将数据报告给较新的server。 从4.1之前的任何版本升级到5.0(或更高版本)时,此方法从未被Zabbix推荐或支持,现已正式禁用,因为server将忽略来自未升级proxy的数据。 :::

2 备份当前的数据库

这是非常重要的步骤。升级前请确保备份了数据库。如果升级失败(因磁盘空间不足、断电或其他意外导致的升级失败),备份的数据库将大有帮助。

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/
4 升级 Zabbix 软件仓库配置包

在升级之前,必须更新当前的软件仓库包:

RHEL/CentOS 8

# rpm -Uvh https://repo.zabbix.com/zabbix/5.0/rhel/8/x86_64/zabbix-release-5.0-1.el8.noarch.rpm

RHEL/CentOS 7

# rpm -Uvh https://repo.zabbix.com/zabbix/5.0/rhel/7/x86_64/zabbix-release-5.0-1.el7.noarch.rpm
5 升级 Zabbix 组件

运行以下命令以升级 Zabbix 组件:

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

如果使用PostgreSQL,请在命令中将mysql替换为pgsql。 如果要升级proxy,请在命令中用proxy替换server。 如果要升级agent 2,请在命令中将zabbix-agent替换为zabbix-agent2

要在RHEL 8上使用Apache正确升级Web前端,请运行:

# yum install zabbix-apache-conf

并对此文件进行必要的更改

更改要升级RHEL 7上的Web前端,请遵循本页上的说明(安装PHP 7.2或更高版本需要额外的步骤)。 特别是,如果使用Apache Web服务器,请确保安装zabbix-apache-conf-scl软件包。

 # yum install zabbix-apache-conf-scl
6 检查 Zabbix 组件配置文件的参数

有关强制性更改的详细信息,请参阅升级说明

7 启动 Zabbix 进程

启动升级后的 Zabbix 组件。

# systemctl start zabbix-server
       # systemctl start zabbix-proxy
       # systemctl start zabbix-agent
       # systemctl start zabbix-agent2
8 清除浏览器的 Cookies 和缓存

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

Zabbix 次要版本之间的升级

可以在5.0.x的次要版本之间进行升级(例如,从5.0.1升级到5.0.3)。 在次要版本之间升级很容易。

要执行Zabbix次要版本升级,需要运行:

$ sudo yum upgrade 'zabbix-*'

在升级 Zabbix server 的次要版本时,只需运行以下命令:

$ sudo yum upgrade 'zabbix-server-*'

在升级 Zabbix agent 的次要版本时,只需运行以下命令:

$ sudo yum upgrade 'zabbix-agent-*'

或者,对于Zabbix agent 2:

$ sudo yum upgrade 'zabbix-agent2-*'  

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