2 Debian/Ubuntu

概述

本章节介绍如何使用由官方发布的、基于 Debian/Ubuntu 系统的Zabbix 二进制升级包，将当前应用的Zabbix 5.4.x 版本升级到最新的 Zabbix 6.0.x 版本。

虽然Zabbix官方并未强制要求需要及时升级 Zabbix agents（推荐升级），但在使用Zabbix 的过程中，需要保持 Zabbix server 和 proxies 保持 相同的版本。因此，在服务器和代理服务器升级过程中，Zabbix Server 和所有的 proxies 都必须暂停进程以完成升级。在升级过程中不推荐坚持所有 Zabbix proxy 的运行，完成升级后所有的旧数据都会被摒弃。并且除非 proxy 的配置已完成同步操作，否则不会有新的数据上传。

请注意，若您在 proxy 端应用 SQLite 数据库，那么 proxy 升级之前所存储的数据将全部被清除。因为 SQLite 数据库的升级操作是不被支持的并且 SQLite 数据库文档需要被手动清除。当 proxy 第一次启动时，发现 SQLite 文档不存在，那么 proxy 会自动生成数据库文档。

6.0版本升级的时间长短取决于数据库的总体大小。

请务必在升级前仔细阅读相关的升级文档！

提供以下升级说明:

您也可以参考如下6.0版本的安装需求 。

对于正在运行中的项目，用户可以考虑在对 Zabbix 进行升级时，同时开启两路 SSH 协议登录，一路用于运行软件的升级操作，一路用于监控 server/proxy 的 log 文档。 举例如下： 运行tail -f zabbix_server.log或者tail -f zabbix_proxy.log在第二路SSH连接，方便用户通过最新的log文档对升级过程进行实时监控，发现可能存在的问题或错误。

升级程序

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 更新存储配置包

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

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

然后安装新的存储库配置包。

在 Debian 11 运行:

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

在 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_6.0-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_6.0-1+debian9_all.deb

在 Ubuntu 20.04 运行:

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

在 Ubuntu 18.04 运行:

# wget https://repo.zabbix.com/zabbix/6.0/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/6.0/ubuntu/pool/main/z/zabbix-release/zabbix-release_6.0-1+ubuntu16.04_all.deb
       # dpkg -i zabbix-release_6.0-1+ubuntu16.04_all.deb

在 Ubuntu 14.04 运行:

# wget https://repo.zabbix.com/zabbix/6.0/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.*'