概述

    虽然升级 Zabbix agent 不是强制性的，但建议将其升级，而 Zabbix server 和 Zabbix proxy 必须具有 。因此，在 Zabbix server 和 Zabbix proxy 的架构升级时，Zabbix server 和所有的 Zabbix proxy 必须停止并升级。

    为了最大限度地减少升级期间的停机时间和数据丢失的几率，建议先停机并升级 Zabbix server，然后再逐个停机并升级 Zabbix proxy，待升级完毕后，先启动 Zabbix proxy，再启动 Zabbix server。在 Zabbix server 停机期间，运行中的 Zabbix Proxy 将继续采集和存储数据，并在 Zabbix server 启动并运行后，将数据传递给 Zabbix server。 只有在升级的 Zabbix server 启动后，才会生成 Zabbix server停机期间出现问题的任何通知。

    请注意，对于 Zabbix proxy 上的 SQLite 数据库，升级前 Zabbix proxy 的历史数据将丢失，因为不支持 SQLite 数据库升级，而且必须手动删除 SQLite 数据库文件。 当第一次启动 Zabbix proxy 并且缺少 SQLite 数据库文件时，Zabibx proxy 会自动创建它。

    根据其数据库大小，数据库升级到 4.0 版本可能需要很长时间。

    值得注意的是，在升级之前，请务必阅读相关的升级说明！

    请阅读下面的升级说明：

    Upgrade fromRead full upgrade notesImportant notes/changes between versions
    3.4.xFor 4.0‘libpthread’ and ‘zlib’ libraries now mandatory;
    Support for plain text protocol dropped and header is mandatory;
    Pre-1.4 version Zabbix agents are no longer supported;
    The Server parameter in passive proxy configuration now mandatory
    3.2.xAlso SQLite support as backend database dropped for Zabbix server/frontend;
    Perl Compatible Regular Expressions (PCRE) supported instead of POSIX extended;
    ‘libpcre’ and ‘libevent’ libraries mandatory for Zabbix server;
    Exit code checks added for user parameters, remote commands and system.run[] items without the ‘nowait’ flag as well as Zabbix server executed scripts;
    Zabbix Java gateway has to be upgraded to support new functionality
    3.0.xAlso for 3.2Database upgrade may be slow, depending on the history table size

    此外，还需检查升级至 Zabbix 4.0 的。

    建议在升级期间运行两个 SSH 会话，其中一个会话执行升级步骤，另一个会话监控其升级期间的日志。例如，在第二个 SSH 会话上运行 或 tail -f zabbix_proxy.log，以实时显示最新的常规日志输出或错误日志输出。这对生产环境至关重要。

    升级步骤

    1 停止 Zabbix 进程

    停止 Zabbix server 以确保没有新数据插入数据库。

    如果需要升级 Zabbix proxy，那么同样停止 Zabbix proxy 进程。

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

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

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

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

    配置文件：

    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 升级 Zabbix 软件仓库配置包

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

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

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

    在 Debian 9 上运行：

    在 Debian 8 上运行：

    2. # dpkg -i zabbix-release_4.0-2+jessie_all.deb

    在 Ubuntu 18.04 上运行：

    1. # wget https://repo.zabbix.com/zabbix/4.0/ubuntu/pool/main/z/zabbix-release/zabbix-release_4.0-2+bionic_all.deb

    在 Ubuntu 16.04 上运行：

    1. # wget https://repo.zabbix.com/zabbix/4.0/ubuntu/pool/main/z/zabbix-release/zabbix-release_4.0-2+xenial_all.deb
    2. # dpkg -i zabbix-release_4.0-2+xenial_all.deb
    1. # wget https://repo.zabbix.com/zabbix/4.0/ubuntu/pool/main/z/zabbix-release/zabbix-release_4.0-2+trusty_all.deb
    2. # dpkg -i zabbix-release_4.0-2+trusty_all.deb

    更新软件仓库信息。

    5 升级 Zabbix 组件

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

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

    如果使用 PostgreSQL 数据库，请将命令中的 替换为 pgsql。如果升级 Zabbix proxy，请将命令中的 server 替换为 proxy。

    6 检查 Zabbix 组件配置文件的参数

    在新版本中，Zabbix 组件的配置文件发生了一些变化，关于这些强制变更，详见升级说明。

    关于新的选项参数，详见 章节。

    7 启动 Zabbix 进程

    启动升级后的 Zabbix 组件。

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

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

    Zabbix 次要版本之间的升级

    如果要升级 Zabbix 的次要版本（例如，从 4.0.1 升级至 4.0.3），是非常容易的：

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

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

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

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