2 Debian/Ubuntu

概述

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

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

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

在升级过程中,运行两个并行的 SSH 会话可能会很方便,一个会话执行升级步骤,另一个会话监控服务器/代理日志。例如,在第二个 SSH 会话中运行 tail -f zabbix_server.logtail -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.*'