On this page

7 升级步骤

概述

本节提供 Zabbix 7.4 的升级信息:

相关说明:

建议升级 Zabbix agent,但这不是强制要求。

强烈建议升级 Zabbix proxy。Zabbix 服务器完全支持与服务器相同主版本的 proxy。Zabbix 服务器也支持版本不早于 Zabbix 服务器上一个 LTS 版本的 proxy,但功能受限(数据采集、执行远程命令立即检查监控项值)。配置更新也会被禁用,而过期的 proxy 只能使用旧配置。

Proxy 早于上一个 Zabbix server 版本或新于 Zabbix server 主版本都不支持。 Zabbix server 将忽略来自不受支持的 proxy 的数据,并且与 Zabbix server 的所有通信都将失败并带有警告。 更多信息,请查看 版本兼容性.

为了尽量减少升级过程中的停机时间和数据丢失,建议停止、升级并启动 Zabbix server 和 然后一个接一个地停止、升级和启动 Zabbix proxy。 在 server 停机期间,运行的 proxy 将继续数据采集。 一旦 server 启动并运行, 过期 proxy 将发送数据给新的 server(proxy 配置信息不会更新),并且保留部分功能。 在 Zabbix server 停机期间的问题告警通知,将在 升级的server运行后生成。

如果 Zabbix proxy 首次启动且 SQLite 数据库文件缺失,proxy 会自动创建该文件。

注意,如果 Zabbix proxy 使用 SQLite3,并且在启动时检测到现有数据库文件版本低于所需版本,它将自动删除数据库文件并创建一个新的。因此,存储在 SQLite 数据库文件中的历史数据将会丢失。如果 Zabbix proxy 的版本低于数据库文件版本,Zabbix 将记录错误并退出。

根据数据库大小,升级到 7.4 版本的数据库可能需要很长时间。

可直接从 Zabbix 7.2.x、7.0.x、6.4.x、6.2.x、6.0.x、5.4.x、 5.2.x、5.0.x、4.4.x、4.2.x、4.0.x、3.4.x、3.2.x、 3.0.x、2.4.x、2.2.x 和 2.0.x 直接升级到 Zabbix 7.4.x。 如需从更早版本升级,请参阅 Zabbix 2.0 及更早版本的文档。

请注意,升级后 Zabbix 中某些第三方软件集成可能会受到影响,前提是外部软件与升级后的 Zabbix 版本不兼容。

以下是可用的升级说明:

从哪个版本升级 阅读完整升级说明 版本之间最重要的变更
7.2.x 适用于:
Zabbix 7.4
已停止支持 PCRE 库。
7.0.x LTS 适用于:
Zabbix 7.2
Zabbix 7.4
已停止支持 Oracle DB。
6.4.x 适用于:
Zabbix 7.0
Zabbix 7.2
Zabbix 7.4
最低要求的 PHP 版本从 7.4.0 提升到 8.0.0。
agent、HTTP agent、SNMP walk[OID] 和 SNMP get[OID] 检查改为异步轮询。
proxy 使用单独的数据库表。
Windows agent 配置文件的默认位置已更改。
Oracle DB 已弃用。
旧的数值(浮点)值类型已移除。
6.2.x 适用于:
Zabbix 6.4
Zabbix 7.0
Zabbix 7.2
Zabbix 7.4
最低要求的 MySQL 版本从 8.0.0 提升到 8.0.30。
Zabbix 服务器/proxy 需要 'libevent_pthreads' 库。
升级后首次启动时,使用 SQLite3 的 Zabbix proxy 会自动删除旧版本数据库(包括所有历史数据)并创建新数据库。
6.0.x LTS 适用于:
Zabbix 6.2
Zabbix 6.4
Zabbix 7.0
Zabbix 7.2
Zabbix 7.4
最低要求的 PHP 版本从 7.2.5 提升到 7.4.0。
服务监控进行了大幅重构。
升级期间需要创建确定性触发器。如果为 MySQL/MariaDB 启用了二进制日志,则需要超级用户权限,或设置变量/配置参数 log_bin_trust_function_creators = 1。有关如何设置该变量的说明,请参见 数据库创建脚本
5.4.x 适用于:
Zabbix 6.0
Zabbix 6.2
Zabbix 6.4
Zabbix 7.0
Zabbix 7.2
Zabbix 7.4
最低要求的数据库版本已提高。
如果数据库版本过旧,服务器/proxy 将无法启动。
由于数据库结构变更,审计日志记录会丢失。
5.2.x 适用于:
Zabbix 5.4
Zabbix 6.0
Zabbix 6.2
Zabbix 6.4
Zabbix 7.0
Zabbix 7.2
Zabbix 7.4
最低要求的数据库版本已提高。
聚合监控项已不再作为单独类型提供。
5.0.x LTS 适用于:
Zabbix 5.2
Zabbix 5.4
Zabbix 6.0
Zabbix 6.2
Zabbix 6.4
Zabbix 7.0
Zabbix 7.2
Zabbix 7.4
最低要求的 PHP 版本从 7.2.0 提升到 7.2.5。
密码哈希算法从 MD5 更改为 bcrypt。
4.4.x 适用于:
Zabbix 5.0
Zabbix 5.2
Zabbix 5.4
Zabbix 6.0
Zabbix 6.2
Zabbix 6.4
Zabbix 7.0
Zabbix 7.2
Zabbix 7.4
已停止支持 IBM DB2。
最低要求的 PHP 版本从 5.4.0 提升到 7.2.0。
最低要求的数据库版本已提高。
Zabbix PHP 文件目录已更改。
4.2.x 适用于:
Zabbix 4.4
Zabbix 5.0
Zabbix 5.2
Zabbix 5.4
Zabbix 6.0
Zabbix 6.2
Zabbix 6.4
Zabbix 7.0
Zabbix 7.2
Zabbix 7.4
已移除 Jabber、Ez Texting 媒体类型。
4.0.x LTS 适用于:
Zabbix 4.2
Zabbix 4.4
Zabbix 5.0
Zabbix 5.2
Zabbix 5.4
Zabbix 6.0
Zabbix 6.2
Zabbix 6.4
Zabbix 7.0
Zabbix 7.2
Zabbix 7.4
较旧的 proxy 将无法再向已升级的服务器报告数据。
较新的 agent 将无法再与较旧的 Zabbix 服务器配合工作。
3.4.x 适用于:
Zabbix 4.0
Zabbix 4.2
Zabbix 4.4
Zabbix 5.0
Zabbix 5.2
Zabbix 5.4
Zabbix 6.0
Zabbix 6.2
Zabbix 6.4
Zabbix 7.0
Zabbix 7.2
Zabbix 7.4
现在必须使用 'libpthread' 和 'zlib' 库。
已停止支持纯文本协议,且必须包含头部。
不再支持 1.4 之前版本的 Zabbix agent。
被动 proxy 配置中的 Server 参数现在为必填项。
3.2.x 适用于:
Zabbix 3.4
Zabbix 4.0
Zabbix 4.2
Zabbix 4.4
Zabbix 5.0
Zabbix 5.2
Zabbix 5.4
Zabbix 6.0
Zabbix 6.2
Zabbix 6.4
Zabbix 7.0
Zabbix 7.2
Zabbix 7.4
Zabbix 服务器/前端的后端数据库不再支持 SQLite。
改为支持 Perl Compatible Regular Expressions (PCRE),而不是 POSIX 扩展正则表达式。
Zabbix 服务器现在必须使用 'libpcre' 和 'libevent' 库。
为用户参数、远程命令以及未使用 'nowait' 标志的 system.run[] 监控项,以及由 Zabbix 服务器执行的脚本,新增了退出码检查。
必须升级 Zabbix Java 网关以支持新功能。
3.0.x LTS 适用于:
Zabbix 3.2
Zabbix 3.4
Zabbix 4.0
Zabbix 4.2
Zabbix 4.4
Zabbix 5.0
Zabbix 5.2
Zabbix 5.4
Zabbix 6.0
Zabbix 6.2
Zabbix 6.4
Zabbix 7.0
Zabbix 7.2
Zabbix 7.4
数据库升级可能较慢,具体取决于 history 表的大小。
2.4.x 适用于:
Zabbix 3.0
Zabbix 3.2
Zabbix 3.4
Zabbix 4.0
Zabbix 4.2
Zabbix 4.4
Zabbix 5.0
Zabbix 5.2
Zabbix 5.4
Zabbix 6.0
Zabbix 6.2
Zabbix 6.4
Zabbix 7.0
Zabbix 7.2
Zabbix 7.4
最低要求的 PHP 版本从 5.3.0 提升到 5.4.0。
必须指定 LogFile agent 参数。
2.2.x LTS 适用于:
Zabbix 2.4
Zabbix 3.0
Zabbix 3.2
Zabbix 3.4
Zabbix 4.0
Zabbix 4.2
Zabbix 4.4
Zabbix 5.0
Zabbix 5.2
Zabbix 5.4
Zabbix 6.0
Zabbix 6.2
Zabbix 6.4
Zabbix 7.0
Zabbix 7.2
Zabbix 7.4
已移除基于节点的分布式监控。
2.0.x 适用于:
Zabbix 2.2
Zabbix 2.4
Zabbix 3.0
Zabbix 3.2
Zabbix 3.4
Zabbix 4.0
Zabbix 4.2
Zabbix 4.4
Zabbix 5.0
Zabbix 5.2
Zabbix 5.4
Zabbix 6.0
Zabbix 6.2
Zabbix 6.4
Zabbix 7.0
Zabbix 7.2
Zabbix 7.4
最低要求的 PHP 版本从 5.1.6 提升到 5.3.0。
为了让服务器正常工作,需要使用区分大小写的 MySQL 数据库;Zabbix 服务器要正常与 MySQL 数据库配合工作,需要字符集 utf8 和 utf8_bin 排序规则。请参见 数据库创建脚本
需要 'mysqli' PHP 扩展,而不是 'mysql'。