Cacti监控系统从0.8.7i到1.2.30版本的重大升级指南

升级背景与挑战

Cacti作为一款经典的开源网络性能监测工具，其版本迭代过程中数据库结构和功能模块都发生了显著变化。从0.8.7i这样的早期版本直接升级到1.2.x系列版本，面临着多重技术挑战，包括PHP版本兼容性、数据库结构调整以及数据迁移等问题。

环境准备

PHP版本要求

原始环境中使用的是PHP 5.4.16，这已经远远不能满足现代Cacti版本的需求。升级过程中需要先将PHP升级到8.1或更高版本，这是Cacti 1.2.x系列的基本要求。

数据库升级

MariaDB需要升级到10.x版本，以支持新版本Cacti的数据结构和功能特性。在升级过程中，数据库表结构的变更可能导致各种兼容性问题。

升级过程中的关键问题

执行超时问题

初始升级尝试中出现了"Maximum execution time"错误，即使将超时时间从30秒增加到1000秒仍无法解决。这表明升级脚本在数据处理阶段遇到了性能瓶颈。

数据库表结构不兼容

升级过程中报错显示缺少多个关键列和表：

• sync_interval列缺失
• deleted列缺失
• user_auth_row_cache表不存在

这些错误反映了新旧版本间数据库结构的重大差异。

解决方案与升级步骤

分阶段升级策略

1. 环境准备阶段：

   • 升级PHP到8.1+版本
   • 升级MariaDB到10.x版本
   • 备份现有Cacti数据和配置

2. 强制数据库升级： 使用专门的升级脚本强制将数据库版本提升到中间版本：

   php -q upgrade_database.php --forcever=1.0.4
   

3. 关键代码修改： 在install/upgrades/1_0_5.php文件中修正数据源配置文件处理逻辑，解决"Array to string conversion"错误。

升级后验证

完成升级后，需要：

• 检查所有监测项是否正常采集
• 验证图表生成功能
• 确认告警规则是否生效
• 测试用户权限系统

经验总结

1. 版本跨度大的升级建议先在测试环境验证，特别是生产环境使用的监测系统。

2. 升级顺序很重要：先升级依赖环境(PHP/MySQL)，再升级应用本身。

3. 监测系统升级期间应暂停数据采集任务，避免数据不一致。

4. 插件兼容性需要单独验证，特别是像Weathermap这样的常用插件。

通过系统化的升级方法和针对性的问题解决，成功实现了从0.8.7i到1.2.30版本的跨越式升级，为系统带来了更多新功能和更好的性能表现。