2 Debian/Ubuntu

概述

本章节提供了在 Debian/Ubuntu 系统上使用 Zabbix 二进制包，从 Zabbix 5.4.x 成功 upgrade 到 Zabbix 6.0.x 所需的步骤。

虽然升级 Zabbix 代理不是强制性的（但建议将其升级），但 但 Zabbix server和proxy必须具有[相同主版本]。因此，在Zabbix server 和 Zabbix proxy 的架构升级时，Zabbix server 和所有的 Zabbix proxy必须停止服务并进行升级。在Zabbix server 升级期间，保持Zabbix proxy 运行正常并不好，因为在Zabbix proxy升级期间，它们的旧数据将被丢弃，并且在Zabbix proxy配置与Zabbix server同步前并不会收集新数据。

请注意，若Proxy的数据库为SQLite类型，其保留的历史数据会在版本升级完成后全部被删除，因为不支持 SQLite 数据库升级并且必须手动删除 SQLite 数据库文件。当第一次启动Zabbix proxy并且缺少 SQLite 数据库文件时，Zabbix proxy会自动创建它。

在数据库升级到版本 6.0 时，根据数据库存储大小，可能需花很长时间升级完毕。

::: 注意事项 升级前请务必阅读相关 upgrade notes! :::

如下提供升级说明：

升级程序

1 停止 Zabbix 进程

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

# service zabbix-server stop

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

# service zabbix-proxy stop

2 备份当前的数据库

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

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

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

配置文件：

 # 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/doc/zabbix-* /opt/zabbix-backup/

4 升级 Zabbix 软件仓库配置包

在升级之前，必须卸载当前的软件仓库包：

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

然后再安装新的软件仓库包：

在 Debian 10 上运行：

# wget https://repo.zabbix.com/zabbix/6.0/debian/pool/main/z/zabbix-release/zabbix-release_6.0-1+debian10_all.deb
# dpkg -i zabbix-release_5.4-1+debian10_all.deb

在 Debian 9 上运行：

# wget https://repo.zabbix.com/zabbix/6.0/debian/pool/main/z/zabbix-release/zabbix-release_6.0-1+debian9_all.deb
# dpkg -i zabbix-release_5.4-1+debian9_all.deb

在 Debian 8 上运行：

# wget https://repo.zabbix.com/zabbix/6.0/debian/pool/main/z/zabbix-release/zabbix-release_6.0-1+debian8_all.deb
# dpkg -i zabbix-release_5.4-1+debian8_all.deb

在 Ubuntu 20.04 上运行：

# wget https://repo.zabbix.com/zabbix/5.4/ubuntu/pool/main/z/zabbix-release/zabbix-release_6.0-1+ubuntu20.04_all.deb
# dpkg -i zabbix-release_5.4-1+ubuntu20.04_all.deb

在 Ubuntu 18.04 上运行：

# wget https://repo.zabbix.com/zabbix/5.4/ubuntu/pool/main/z/zabbix-release/zabbix-release_6.0-1+ubuntu18.04_all.deb
# dpkg -i zabbix-release_6.0-1+ubuntu18.04_all.deb

在 Ubuntu 16.04 上运行：

# wget https://repo.zabbix.com/zabbix/5.4/ubuntu/pool/main/z/zabbix-release/zabbix-release_6.0-1+ubuntu16.04_all.deb
# dpkg -i zabbix-release_5.4-1+ubuntu16.04_all.deb

在 Ubuntu 14.04 上运行：

# wget https://repo.zabbix.com/zabbix/5.4/ubuntu/pool/main/z/zabbix-release/zabbix-release_6.0-1+ubuntu14.04_all.deb
# dpkg -i zabbix-release_6.0-1+ubuntu14.04_all.deb

更新软件仓库信息。

# apt-get update

5 升级Zabbix组件

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

  # 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 前端，还需运行如下命令：

    # 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 检查 Zabbix 组件配置文件的参数

在新版本中，Zabbix组件的配置文件发生了一些变化，详见升级说明 mandatory changes。

关于新的选项参数，详见此章节 What's new 。

7 启动 Zabbix 进程

启动升级后的 Zabbix 组件。

# service zabbix-server start
# service zabbix-proxy start
# service zabbix-agent start
# service zabbix-agent2 start

8 清除浏览器的 Cookies 和缓存

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

Zabbix 次要版本之间的升级

如果要升级 Zabbix 6.0.x 的次要版本（例如：从 6.0.1 升级到 6.0.3），是非常容易的。

在升级 Zabbix 所有组件的次要版本时，只需运行以下命令：

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

在升级 Zabbix server 的次要版本时，只需运行以下命令：

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

在升级 Zabbix agent 的次要版本时，只需运行以下命令：

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

在升级 Zabbix agent 2的次要版本时，只需运行以下命令：

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