从ONOS 1.10.0升级到1.15.0，我踩了这些坑：日志命令、GUI激活与依赖项变化全记录-编程实验室

从ONOS 1.10.0升级到1.15.0的实战避坑指南

当你从ONOS 1.10.0升级到1.15.0时，可能会遇到一系列意料之外的"惊喜"。作为一个刚从这场升级大战中幸存下来的老兵，我想分享一些血泪教训和实用技巧，帮助后来者少走弯路。

1. 升级前的准备工作

升级ONOS不是简单的替换二进制文件那么简单。在动手之前，有几个关键步骤必须完成：

完整备份当前配置：包括$ONOS_ROOT/config/目录下的所有文件，特别是cluster.json和components.json
记录当前运行状态：使用onos> apps -a -s命令列出所有激活的应用及其状态
检查系统依赖：新版ONOS可能对Java、Maven等有不同要求

注意：ONOS 1.15.0要求Java 11+，而1.10.0可以在Java 8上运行。升级前务必确认Java版本兼容性。

我曾经遇到过因为没检查Java版本，导致升级后整个系统无法启动的情况。解决方法很简单但很耗时：

# 检查当前Java版本 java -version # 如果需要升级Java sudo apt install openjdk-11-jdk sudo update-alternatives --config java

2. CLI命令的变化与适配

ONOS 1.15.0对命令行接口做了不少调整，最让人头疼的是日志相关命令的变化。

2.1 日志命令的演变

在1.10.0中，我们习惯使用log:tail来实时查看日志，但在1.15.0中，这个命令变成了：

onos> log:tail # 1.15.0中需要改用 onos> log:watch

更复杂的是，日志过滤语法也发生了变化：

功能	1.10.0语法	1.15.0语法
按级别过滤	`log:tail ERROR`	`log:watch -l ERROR`
按类名过滤	`log:tail com.example.*`	`log:watch -c com.example.*`
多条件组合	不支持	`log:watch -l ERROR -c com.example.*`

2.2 其他常用命令的变化

除了日志命令，还有一些常用命令也发生了变化：

应用管理：
- 旧版：app activate/deactivate org.onosproject.app
- 新版：app enable/disable org.onosproject.app
网络配置：
- 旧版：cfg set直接修改配置
- 新版：需要先进入配置模式config edit，修改后config submit

3. GUI系统的重大调整

ONOS 1.15.0对GUI系统进行了重构，这可能是升级过程中最令人困惑的部分。

3.1 新旧GUI架构对比

1.10.0使用的是传统的AngularJS实现的GUI，而1.15.0引入了全新的GUI2架构：

特性	1.10.0 GUI	1.15.0 GUI2
技术栈	AngularJS	Polymer + Web Components
访问方式	自动启用	需要手动激活
性能	相对较慢	显著提升
扩展性	有限	模块化设计

3.2 激活GUI2的完整流程

在1.15.0中，GUI2默认不激活，需要手动操作：

# 首先确保GUI2应用已安装 onos> apps -s | grep gui # 如果没有显示，需要安装 onos> app install org.onosproject.gui2 # 激活GUI2 onos> app enable org.onosproject.gui2 # 检查状态 onos> apps -a -s | grep gui2

如果访问时仍然遇到404错误，可能是反向代理配置问题。检查/etc/nginx/sites-available/onos中的配置：

location /onos-gui2/ { proxy_pass http://localhost:8181/onos-gui2/; proxy_set_header Host $host; proxy_set_header X-Real-IP $remote_addr; }

4. 依赖项与配置的潜在陷阱

升级过程中最隐蔽的问题往往来自依赖项和配置的变化。

4.1 关键依赖项变化

ONOS 1.15.0引入了一些新的依赖，同时移除了部分旧的依赖：

新增依赖：
- Google Protocol Buffers 3.0+
- gRPC 1.0+
- Apache Karaf 4.2+
移除依赖：
- Apache Felix 5.6.x
- Jersey 1.x

4.2 配置文件的兼容性问题

许多配置文件格式发生了变化，需要特别注意：

网络配置：
- 旧版：netcfg.json
- 新版：支持多种格式，推荐使用netcfg.yaml
安全配置：
- 1.15.0加强了安全性，需要更新jaas.config和keyStore
日志配置：
- logback.xml的配置语法有细微调整，特别是自定义appender部分

5. 升级后的性能调优

成功升级只是第一步，要充分发挥1.15.0的性能优势，还需要一些调优技巧。

5.1 内存管理优化

1.15.0的内存管理机制有所改进，建议调整JVM参数：

# 在$ONOS_ROOT/bin/onos-service文件中修改 JAVA_OPTS="-server -Xms4G -Xmx4G -XX:+UseG1GC"

5.2 集群配置优化

对于集群部署，1.15.0引入了更智能的节点发现机制：

// config/cluster.json { "nodes": [ { "id": "node1", "ip": "192.168.1.101", "tcpPort": 9876, "raftPort": 9877 } ], "partitions": [ { "id": 1, "members": ["node1"] } ] }

5.3 监控与诊断工具

1.15.0提供了更强大的内置诊断工具：

# 查看系统健康状态 onos> health # 详细性能指标 onos> metrics # 线程分析 onos> thread dump

6. 回滚策略与应急方案

即使准备再充分，升级也可能失败。提前制定回滚方案至关重要。

6.1 快速回滚步骤

停止ONOS服务
恢复备份的配置文件和数据库
重新安装旧版ONOS
验证所有功能正常

6.2 常见问题应急方案

问题现象	可能原因	解决方案
GUI无法访问	GUI2未激活或Nginx配置错误	检查app enable和Nginx配置
日志命令不工作	使用了旧版语法	改用log:watch及相关新参数
应用无法加载	依赖项缺失	检查并安装缺失的依赖
性能下降	JVM参数未优化	调整Xmx和GC参数