2 Debian/Ubuntu

概述

本节提供了使用官方 Zabbix 软件包从 Zabbix 6.4.x 升级到 Zabbix 7.0.x 的步骤，适用于 Debian/Ubuntu。

在升级之前，请务必阅读相关的 升级说明！

您可能还需要查看 7.0 的 要求。

在升级过程中，运行两个并行的 SSH 会话可能会很方便，一个会话执行升级步骤，另一个会话监控服务器/代理日志。例如，在第二个 SSH 会话中运行 tail -f zabbix_server.log 或 tail -f zabbix_proxy.log，实时显示最新的日志文件条目和可能的错误。这对于生产环境实例来说可能是至关重要的。

升级程序

1 停止 Zabbix 进程

用户需要停止 Zabbix server服务，以确保没有新数据写入数据库。

  1. # service zabbix-server stop

若需要升级 Zabbix proxy，同样需要先停止 Zabbix proxy 进程。

  1. # service zabbix-proxy stop
2 备份当前的数据库

请用户确认，在升级前备份了数据库，这是非常关键的一步。如果升级失败（因磁盘空间不足、断电或其他意外导致的升级失败），备份的数据库将大有帮助。

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

请用户在升级前确认备份了Zabbix 二进制文件、配置文件和 PHP 文件。

配置文件：

  1.  # mkdir /opt/zabbix-backup/
  2.         # cp /etc/zabbix/zabbix_server.conf /opt/zabbix-backup/
  3.         # cp /etc/apache2/conf-enabled/zabbix.conf /opt/zabbix-backup/

PHP 文件和 Zabbix 二进制文件：

  1.  # cp -R /usr/share/zabbix/ /opt/zabbix-backup/
  2.         # cp -R /usr/share/doc/zabbix-* /opt/zabbix-backup/
4 更新软件包仓库配置

要继续更新，您当前的仓库包必须卸载。

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

然后安装新的仓库配置包。

在 Debian 12 上执行：

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

对于旧版本 Debian，使用如下链接替换 Zabbix repository. 对于旧版本 Debian，安装包可能未包含所有组件。 包含所有组件的安装包请查看 Zabbix 安装包.

在 Ubuntu 24.04 上执行：

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

在 Ubuntu 22.04 上执行：

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

对于旧版本 Ubuntu，使用如下链接替换 Zabbix repository. 对于旧版本 Ubuntu，安装包可能未包含所有组件。 包含所有组件的安装包请查看 Zabbix 安装包.

更新仓库信息。

  1. apt-get update
5 升级Zabbix组件

升级 Zabbix 组件，可以运行以下命令：

  1.   # apt-get install --only-upgrade zabbix-server-mysql zabbix-frontend-php zabbix-agent

若使用 PostgreSQL数据库，请在命令中将 mysql 替换为 pgsql。 若升级proxy，请在命令中将 server 替换为 proxy。 若升级 Zabbix agent 2，在命令中将 zabbix-agent 替换为 zabbix-agent2。

与此同时，要使得Apache 能正常升级 Web 前端，还需运行如下命令：

  1.     # apt-get install zabbix-apache-conf

发行版prior to Debian 10 (buster) / Ubuntu 18.04 (bionic) / Raspbian 10 (buster) 不提供 PHP 7.2 或更高版本，而其对Zabbix 前端 5.0又是必要的。 有关安装 Zabbix 前端旧发行版的信息，请查阅information。

6 审查组件配置参数

请务必查看升级说明，以检查是否需要更改配置参数。

对于新的可选参数，请参阅新特性页面。

7 启动 Zabbix 进程

启动升级后的 Zabbix 组件。

  1. # service zabbix-server start
  2.        # service zabbix-proxy start
  3.        # service zabbix-agent start
  4.        # service zabbix-agent2 start
8 清除浏览器的 Cookies 和缓存

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

在小版本之间升级

可以升级 7.0.x 的小版本（例如，从 7.0.1 升级到 7.0.3）。这个过程很简单。

要升级 Zabbix 小版本，请运行：

  1. sudo apt install --only-upgrade 'zabbix.*'

要升级 Zabbix 服务器的小版本，请运行：

  1. sudo apt install --only-upgrade 'zabbix-server.*'

要升级 Zabbix 代理的小版本，请运行：

  1. sudo apt install --only-upgrade 'zabbix-agent.*'

或者，对于 Zabbix agent 2，请运行：

  1. sudo apt install --only-upgrade 'zabbix-agent2.*'