7 升级程序
请按照以下步骤进行Zabbix的升级操作。
概览
本节提供Zabbix 7.0的升级信息：
- 使用软件包进行Red Hat Enterprise Linux或Debian/Ubuntu
- 使用sources
相关说明：
- 对于高可用性（HA）集群中的服务器，请参阅Upgrading HA cluster
- 对于TimescaleDB数据库，请参阅Upgrading TimescaleDB schema
Zabbix agent 建议升级但不强制
强烈建议升级 Zabbix proxy 。Zabbix server 完全支持相同主版本的 proxy 。Zabbix server 也支持 不早于 上一个 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 将自动创建。
Note 如果 Zabbix proxy 使用 SQLite3，并且在启动时检测到现有数据库文件 版本早于要求的，自动删除数据库文件 并且创建一个新的文件。 然后，存储在 SQLite 数据库文件的历史数据将丢失。如果 Zabbix proxy 版本早于数据库文件版本，Zabbix 将记录错误信息并且退出。
如果数据库文件较大，升级至 7.0 版本将花费较长时间。
可以从 Zabbix 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.0.x。
要从更早期版本升级，请参阅 2.0 及更早版本的 Zabbix 文档。
请注意，升级后，如果外部软件与升级后的 Zabbix 版本不兼容，Zabbix 中的某些第三方软件集成可能会受到影响。
以下升级说明可供参考：
| 升级自 | 阅读完整升级说明 | 版本间最重要的变更 |
|---|---|---|
| 6.4.x | 对于： Zabbix 7.0 |
最低所需PHP版本从7.4.0提升至8.0.0。 为agent, HTTP agent和SNMP walk[oid]检查引入异步轮询器。 proxies的独立数据库表。 Windows agent配置文件的默认位置已更改。 Oracle DB已废弃。 旧的数值(float)值类型已删除。 |
| 6.2.x | 对于： Zabbix 6.4 Zabbix 7.0 |
最低所需MySQL版本从8.0.0提升至8.0.30。 需要'libevent_pthreads'库用于Zabbix server/proxy。 升级后首次启动时，Zabbix proxy使用SQLite3自动删除旧版本的数据库（包括所有历史记录），并创建一个新的数据库。 |
| 6.0.x LTS | 对于： Zabbix 6.2 Zabbix 6.4 Zabbix 7.0 |
最低所需PHP版本从7.2.5提升至7.4.0。 服务监控进行了重大改进。 确定性触发器需要在升级期间创建。如果为MySQL/mariadb启用了二进制日志记录，这需要超级用户权限或设置变量/配置参数 log_bin_trust_function_creators = 1。请参阅Database creation scripts以获取设置变量的说明。 |
| 5.4.x | 对于： Zabbix 6.0 Zabbix 6.2 Zabbix 6.4 Zabbix 7.0 |
最低所需数据库版本已提升。 server/proxy在过时的数据库下将无法启动。 由于数据库结构变更，审计日志记录丢失。 |
| 5.2.x | 对于： Zabbix 5.4 Zabbix 6.0 Zabbix 6.2 Zabbix 6.4 Zabbix 7.0 |
最低所需数据库版本已提升。 聚合监控项作为单独类型已移除。 |
| 5.0.x LTS | 对于： Zabbix 5.2 Zabbix 5.4 Zabbix 6.0 Zabbix 6.2 Zabbix 6.4 Zabbix 7.0 |
最低所需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 |
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 |
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 |
较旧的proxies不再能向升级后的服务器报告数据。 较新的agents将无法与较旧的Zabbix server协同工作。 |
| 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 |
'libpthread'和'zlib'库现在是强制性的。 对纯文本协议的支持已取消，且需要使用头部。 预1.4版本的Zabbix agents不再受支持。 被动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 |
SQLite作为后端数据库的支持在Zabbix server/前端已取消。 支持Perl兼容正则表达式（PCRE）而非POSIX扩展。 'libpcre'和'libevent'库对于Zabbix server是强制性的。 为用户参数、远程命令和system.run[] 监控项（不包含'nowait' flag）以及Zabbix server执行的脚本添加了退出代码检查。 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 |
数据库升级可能很慢，具体取决于历史表的大小。 |
| 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 |
最低所需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 |
基于节点的分布式监控已移除。 |
| 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 |
最低所需PHP版本从5.1.6提升至5.3.0。 大小写敏感的MySQL数据库对于服务器的正常工作是必需的；utf8字符集和utf8_bin排序规则对于Zabbix server与MySQL数据库正常协同工作是必需的。请参阅database creation scripts。 需要'mysqli' PHP扩展而非'mysql'。 |