[comment]: # translation:outdated [comment]: # ({c79ab4f5-7900383c}) # 1 从源码包升级 [comment]: # ({/c79ab4f5-7900383c}) [comment]: # ({b26314f8-92c7a8e5}) #### 概述 本节提供了使用官方 Zabbix 源码从 Zabbix **6.4**.x 升级到 Zabbix **7.0**.x 的步骤。 ::: notewarning 在升级之前，请务必阅读相关的 [**升级说明**](/manual/installation/upgrade)！ ::: 您可能还需要查看 7.0 的 [要求](/manual/installation/requirements)。 ::: notetip 在升级过程中，运行两个并行的 SSH 会话可能会很方便，一个会话执行升级步骤，另一个会话监控服务器/代理日志。例如，在第二个 SSH 会话中运行 `tail -f zabbix_server.log` 或 `tail -f zabbix_proxy.log`，实时显示最新的日志文件条目和可能的错误。这对于生产环境实例来说可能是至关重要的。 ::: [comment]: # ({/b26314f8-92c7a8e5}) [comment]: # ({f14f8b32-101d6faf}) #### Server 升级步骤 [comment]: # ({/f14f8b32-101d6faf}) [comment]: # ({8dea56cb-b8308740}) ##### 1 停止 Server 服务 停止 Zabbix server 服务并确认不再有新的数据写入数据库。 [comment]: # ({/8dea56cb-b8308740}) [comment]: # ({8091ec8a-ab13a6a4}) ##### 2 备份当前的 Zabbix 数据库 这是非常重要的一步。确保您有数据库的备份，如果升级过程失败（如磁盘空间不足、断电等任何意外问题），它将有所帮助。 [comment]: # ({/8091ec8a-ab13a6a4}) [comment]: # ({d2778675-d2778675}) ##### 3 备份配置文件、PHP 文件和 Zabbix 程序文件 备份 Zabbix 程序文件、配置文件和 PHP 文件目录。 [comment]: # ({/d2778675-d2778675}) [comment]: # ({2bb75ddd-2bb75ddd}) ##### 4 安装新的server程序文件 查看从源代码编译 Zabbix Server 的 [说明](/manual/installation/install#installing_zabbix_daemons) 。 [comment]: # ({/2bb75ddd-2bb75ddd}) [comment]: # ({fd3ed917-ec6edae7}) ##### 5 检查服务器配置参数 请务必查看 [升级说明](/manual/installation/upgrade_notes_700)，以检查是否需要更改配置参数。 有关新的可选参数，请参阅 [新特性](/manual/introduction/whatsnew700) 页面。 [comment]: # ({/fd3ed917-ec6edae7}) [comment]: # ({a01e967f-a01e967f}) ##### 6 启动新的 Zabbix 程序文件 启动新的程序文件。检查日志以确认程序文件是否成功启动。 Zabbix server 会自动升级数据库。服务启动时，Zabbix server 会报告当前的（包括强制和可选）和所需要的数据库版本。如果当前强制版本比要求的版本低，Zabbix Server 会自动执行所要求的数据库版本升级补丁。数据库升级进度（百分比）被写入 Zabbix server 的日志。当日志出现 “database upgrade fully completed” 表示数据库升级成功。如果有任何补丁升级失败，Zabbix server 将不会启动。如果当前强制数据库版本比要求的更新，Zabbix server 也不会启动。仅当当前强制数据库版本对应于所需数据库版本时，Zabbix server 才会启动。 8673:20161117:104750.259 current database version (mandatory/optional): 03040000/03040000 8673:20161117:104750.259 required mandatory version: 03040000 在启动 server 服务之前： - 确保数据库用户有足够的权限（创建表、删除表、创建索引、删除索引）； - 确保您有足够的可用磁盘空间。 [comment]: # ({/a01e967f-a01e967f}) [comment]: # ({e0d81eca-22e0e4e9}) ##### 7 安装新的 Zabbix web 界面 要求的最低 PHP 版本是 7.2.5。可参阅 [安装说明](/manual/installation/frontend)。 [comment]: # ({/e0d81eca-22e0e4e9}) [comment]: # ({d03c52a3-49e4f43e}) ##### 8 清除浏览器 cookie 和缓存 升级后，您可能需要清除 Web 浏览器的 cookie 和缓存信息，以使 Zabbix Web 界面正常工作。 [comment]: # ({/d03c52a3-49e4f43e}) [comment]: # ({4b513045-75f5b3ed}) #### Proxy 升级步骤 [comment]: # ({/4b513045-75f5b3ed}) [comment]: # ({12bb6098-f33e6ddb}) ##### 1 停止 proxy 服务 停止 proxy 服务 [comment]: # ({/12bb6098-f33e6ddb}) [comment]: # ({2e03c550-2e03c550}) ##### 2 备份配置文件和 Zabbix Proxy 旧版本程序 备份配置文件和 Zabbix Proxy 旧版本程序。 [comment]: # ({/2e03c550-2e03c550}) [comment]: # ({a0f936fc-024201dc}) ##### 3 安装新的 proxy 程序 参考从源码编译安装 Zabbix proxy 的 [说明](/manual/installation/install#installing_zabbix_daemons) 。 [comment]: # ({/a0f936fc-024201dc}) [comment]: # ({4b52f4e5-2fbda571}) ##### 4 查看 proxy 配置参数 此版本没有对 proxy 的 [参数](/manual/appendix/config/zabbix_proxy) 做强制性变更。 [comment]: # ({/4b52f4e5-2fbda571}) [comment]: # ({0954ad17-520f43c6}) ##### 5 启动新的 Zabbix proxy 启动新的 Zabbix proxy 服务。检查日志以确认是否升级成功。 Zabbix proxy 会自动升级数据库。数据库升级与启动 [Zabbix server](/manual/installation/upgrade#start_new_zabbix_binaries) 服务类似。 [comment]: # ({/0954ad17-520f43c6}) [comment]: # ({fe773e82-59736bba}) #### Agent 升级步骤 ::: noteimportant 升级 agent 不是强制性的。只有在需要使用新功能时才需要升级 agent。 ::: 本节的升级过程适用于升级 Zabbix agent 和 Zabbix agent2。 [comment]: # ({/fe773e82-59736bba}) [comment]: # ({f41c11dd-02698e69}) ##### 1 停止 agent 服务 停掉 Zabbix agent 服务。 [comment]: # ({/f41c11dd-02698e69}) [comment]: # ({50263823-50263823}) ##### 2 备份配置文件和 Zabbix agent 程序文件 备份配置文件和 Zabbix agent 程序文件。 [comment]: # ({/50263823-50263823}) [comment]: # ({467f56b3-467f56b3}) ##### 3 安装新的 agent 程序文件 参考源码编译安装 Zabbix agent 的 [说明](/manual/installation/install#installing_zabbix_daemons)。 [comment]: # ({/467f56b3-467f56b3}) [comment]: # ({cf4855ad-34721aad}) ##### 4 查看 agent 配置参数 在此版本中，[agent](/manual/appendix/config/zabbix_agentd) 和 [agent2](/manual/appendix/config/zabbix_agent2) 的参数都没有强制更改部分。 [comment]: # ({/cf4855ad-34721aad}) [comment]: # ({624e07be-04c253a7}) ##### 5 启动新的 Zabbix agent 启动新的 Zabbix agent 服务。检查日志以确认启动成功。 [comment]: # ({/624e07be-04c253a7}) [comment]: # ({aca4dda1-a06019d2}) #### 次要版本间的升级 在 7.0.x 的次要版本之间升级时（例如从 7.0.1 升级到 7.0.3），需要执行与主要版本升级时相同的服务器/代理/代理操作。唯一的区别是，在次要版本间升级时，不会对数据库进行更改。 [comment]: # ({/aca4dda1-a06019d2})