Documentation
Table of Contents
2 Debian/Ubuntu
概述
本节提供使用官方Zabbix Debian/Ubuntu软件包从Zabbix 6.4.x升级到最新version Zabbix 7.0.x的指导说明。
升级前，请仔细阅读相关upgrade notes并确保您的系统满足Zabbix 7.0的requirements。
建议在升级期间运行两个并行的SSH会话：一个用于执行升级步骤，另一个用于监控server/proxy日志。 例如，在第二个会话中使用run tail -f zabbix_server.log或tail -f zabbix_proxy.log来实时查看最新日志条目和可能的错误。 这对生产环境实例至关重要。
有关Zabbix 7.0.x小版本间升级的说明（例如从7.0.1升级到7.0.3），请参阅小版本间升级。
升级流程
1 停止Zabbix进程
停止 Zabbix server 以确保没有新数据插入到数据库中：
如果正在升级 Zabbix proxy、agent 或 agent 2，也需要停止这些组件：
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二进制文件，请运行：
4 更新仓库配置包
在进行升级之前，请卸载当前的 Zabbix 仓库包：
您可能还需要在下载新包之前手动从工作目录中移除任何旧的 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 仓库信息：
5 升级Zabbix组件
要升级 Zabbix 组件，请运行以下命令：
- 如果使用 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（Y 或 I）。
然后，要升级 Zabbix 前端并重启 Apache，请运行：
6 审查组件配置参数
查看相关的 upgrade notes，检查配置参数是否需要任何更改。
有关新的可选参数，请参阅 What's new 页面。
7 启动Zabbix进程
启动升级后的 Zabbix 组件：
systemctl start zabbix-server
systemctl start zabbix-proxy
systemctl start zabbix-agent
systemctl start zabbix-agent28 清除浏览器cookie和缓存
升级后，可能需要clear网页浏览器的Cookie和网页浏览器缓存，以确保Zabbix前端界面正常工作。
小版本间升级
可在Zabbix 7.0.x 次版本之间进行升级（例如，从 7.0.1 升级到 7.0.3）。
首先，update 存储库信息：
然后，要升级所有Zabbix组件，请运行：
- 仅升级 Zabbix server，请将命令中的
'zabbix*'替换为'zabbix-server*'。 - 仅升级 Zabbix proxy，请将命令中的
'zabbix*'替换为'zabbix-proxy*'。 - 仅升级 Zabbix agent，请将命令中的
'zabbix*'替换为'zabbix-agent*'。 - 仅升级 Zabbix agent 2，请将命令中的
'zabbix*'替换为'zabbix-agent2*'。