2 Debian/Ubuntu

概述

本节提供有关使用适用于 Debian/Ubuntu 的官方 Zabbix 软件包将 Zabbix 从 6.4.x 升级到最新 version 的 7.0.x 版本的说明。

::: notewarning 升级前,请查阅相关的 upgrade notes 并确保您的系统满足 requirements 的要求,以适配 Zabbix 70。 仅返回OutputFormat格式要求结果

::: noteclassic 在升级过程中,请考虑运行两个并行的SSH会话:一个用于执行升级步骤,另一个用于监视server/proxy日志。 例如,在第二个会话中使用 run tail -f zabbix_server.logtail -f zabbix_proxy.log 来实时查看最新的日志条目和可能的错误。 这对于生产实例来说可能是关键的。 仅返回OutputFormat格式要求结果

有关在 Zabbix 7.0.x 次版本之间升级的说明(例如,从 7.0.1 升级到 7.0.3),请参阅次版本之间的升级

升级流程

1 停止Zabbix进程

停止 Zabbix server 以确保没有新数据插入到数据库中:

systemctl stop zabbix-server

如果正在升级 Zabbix proxy、agent 或 agent 2,也需要停止这些组件:

systemctl stop zabbix-proxy
       systemctl stop zabbix-agent
       systemctl stop zabbix-agent2
2 备份Zabbix数据库

备份现有的 Zabbix 数据库以防止升级失败(例如,磁盘空间 问题、断电或意外问题)。

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

备份现有的Zabbix配置文件、PHP文件和Zabbix二进制文件。

对于配置文件,请运行:

mkdir /opt/zabbix-backup/
       cp /etc/zabbix/zabbix_server.conf /opt/zabbix-backup/
       cp /etc/apache2/conf-enabled/zabbix.conf /opt/zabbix-backup/

对于PHP文件和Zabbix二进制文件,请运行:

cp -R /usr/share/zabbix/ /opt/zabbix-backup/
       cp -R /usr/share/zabbix-* /opt/zabbix-backup/
4 更新仓库配置包

在进行升级之前,请卸载当前的 Zabbix 仓库包:

rm -Rf /etc/apt/sources.list.d/zabbix.list

您可能还需要在下载新包之前手动从工作目录中移除任何旧的 Zabbix 包(例如,rm zabbix-release_latest+debian12_all.deb),以防止包管理器在升级过程中重复使用过时的 version。

然后,安装最新的仓库配置包,以确保与最新包的兼容性,并包含任何最新的安全补丁或错误修复。

Debian 12 上运行以下命令:

wget https://repo.zabbix.com/zabbix/7.0/debian/pool/main/z/zabbix-release/zabbix-release_latest+debian12_all.deb
       dpkg -i zabbix-release_latest+debian12_all.deb

对于较旧的 Debian 版本,请将上面的链接替换为 Zabbix repository 中的正确链接。但是请注意,这些版本的软件包可能不包含所有 Zabbix 组件,若要从软件包升级这些组件,请考虑升级您的操作系统。有关包含的组件列表,请参见 Zabbix repository

Ubuntu 24.04 上运行以下命令:

wget https://repo.zabbix.com/zabbix/7.0/ubuntu/pool/main/z/zabbix-release/zabbix-release_latest+ubuntu24.04_all.deb
       dpkg -i zabbix-release_latest+ubuntu24.04_all.deb

Ubuntu 22.04 上运行以下命令:

wget https://repo.zabbix.com/zabbix/7.0/ubuntu/pool/main/z/zabbix-release/zabbix-release_latest+ubuntu22.04_all.deb
       dpkg -i zabbix-release_latest+ubuntu22.04_all.deb

对于较旧的 Ubuntu 版本,请将上面的链接替换为 Zabbix repository 中的正确链接。但是请注意,这些版本的软件包可能不包含所有 Zabbix 组件,若要从软件包升级这些组件,请考虑升级您的操作系统。有关包含的组件列表,请参见 Zabbix packages

您可能会看到有关 Zabbix 仓库配置的提示:

Configuration file '/etc/apt/sources.list.d/zabbix.list'
       ==> Deleted (by you or by a script) since installation.
       ==> Package distributor has shipped an updated version.
       What would you like to do about it ?  Your options are:
       Y or I  : install the package maintainer's version
       N or O  : keep your currently-installed version
       D       : show the differences between the versions
       Z       : start a shell to examine the situation
       The default action is to keep your current version.
       *** zabbix.list (Y/I/N/O/D/Z) [default=N] ?

输入 Y(或 I)以安装 Zabbix 仓库配置的包维护者的 version。

然后,update 仓库信息:

apt update
5 升级Zabbix组件

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

apt install --only-upgrade zabbix-server-mysql zabbix-frontend-php zabbix-agent
  • 如果使用 PostgreSQL,请在命令中将 mysql 替换为 pgsql
  • 如果正在升级 proxy,请在命令中将 server 替换为 proxy
  • 如果正在升级 Zabbix agent 2,请在命令中将 zabbix-agent 替换为 zabbix-agent2 zabbix-agent2-plugin-*

使用 apt install zabbix-agent2 命令升级 Zabbix agent 2 可能会导致错误。 有关详细信息,请参阅 已知 问题

您可能会看到有关 Zabbix server(或 proxy)配置的提示:

Configuration file '/etc/zabbix/zabbix_server.conf'
       ==> Modified (by you or by a script) since installation.
       ==> Package distributor has shipped an updated version.
       What would you like to do about it ?  Your options are:
       Y or I  : install the package maintainer's version
       N or O  : keep your currently-installed version
       D       : show the differences between the versions
       Z       : start a shell to examine the situation
       The default action is to keep your current version.
       *** zabbix_server.conf (Y/I/N/O/D/Z) [default=N] ?

请输入最适合您情况的选项。 例如,输入 D 以比较当前和新的配置,然后决定是否安装软件包维护者的 version(YI)。

然后,要升级 Zabbix 前端并重启 Apache,请运行:

apt install zabbix-apache-conf
       systemctl restart apache2
6 审查组件配置参数

查看相关的 upgrade notes,检查配置参数是否需要任何更改。

有关新的可选参数,请参阅 What's new 页面。

7 启动Zabbix进程

启动升级后的 Zabbix 组件:

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

升级后,可能需要clear网页浏览器的Cookie和网页浏览器缓存,以确保Zabbix前端界面正常工作。

小版本间升级

可在Zabbix 7.0.x 次版本之间进行升级(例如,从 7.0.1 升级到 7.0.3)。

首先,update 存储库信息:

apt update

然后,要升级所有Zabbix组件,请运行:

apt install --only-upgrade 'zabbix*'
  • 仅升级 Zabbix server,请将命令中的 'zabbix*' 替换为 'zabbix-server*'
  • 仅升级 Zabbix proxy,请将命令中的 'zabbix*' 替换为 'zabbix-proxy*'
  • 仅升级 Zabbix agent,请将命令中的 'zabbix*' 替换为 'zabbix-agent*'
  • 仅升级 Zabbix agent 2,请将命令中的 'zabbix*' 替换为 'zabbix-agent2*'