Files
H3ConuMS-v2/docs/现场ONU故障排查指南.md
T
v6ole d222978ae4 ```
feat(import): 添加区域字段支持和改进模板路径处理

- 在OLT设备导入功能中添加region字段支持,从Excel模板读取区域信息
- 修复模板文件路径问题,使用相对路径动态构建模板文件路径
- 更新导入服务中的验证错误格式,包含行号和MAC地址信息

feat(check): 增强设备检测服务的端口信息同步

- 在CheckService中添加端口和OLT归属信息的同步逻辑
- 改进设备状态检查时的端口信息更新策略,避免用None覆盖现有值
- 扩展返回数据结构,包含端口ID、槽位号、端口号和OLT位置信息

feat(frontend): 添加设备列表刷新冷却机制和端口验证

- 实现设备状态刷新的60秒冷却时间限制,防止频繁操作
- 改进业务下发按钮的启用条件,同时支持port_id或slot_number+port_number组合
- 优化导入结果显示,显示具体的MAC地址信息

feat(olt): 添加重复MAC记录批量清除功能

- 新增批量清除重复MAC记录的功能,支持按OLT分组处理
- 实现SSH端口清除和自动忽略的批量操作流程
- 添加批量操作的进度提示和错误处理机制
```
2026-04-09 11:33:04 +08:00

19 KiB
Raw Blame History

H3ConuMS2 现场ONU故障排查指南

文档说明

版本: v1.0
适用对象: 新入职维护人员
适用场景: 用户报修处理、定期巡检发现问题
关联系统: H3ConuMS2 OLT设备监控管理系统
最后更新: 2026年4月8日


第一章:准备工作

1.1 工具准备清单

必备工具

  1. 笔记本电脑

    • 安装SSH客户端(如PuTTY、SecureCRT
    • 安装H3C设备管理软件(如有)
    • 确保能连接公司VPN或内网
  2. 网络测试工具

    • 网线测试仪
    • 网络抓包工具(Wireshark
    • Ping工具
  3. 光纤测试设备

    • 光功率计(带适配器)
    • 红光笔(可视故障定位仪)
    • 光纤清洁工具(清洁笔、酒精棉片)
    • 备用光纤跳线(SC/LC接口)
  4. 维修工具

    • 十字/一字螺丝刀套装
    • 尖嘴钳、斜口钳
    • 剥线钳
    • 电工胶布、扎带
    • 防静电手环
  5. 备用设备

    • 同型号ONU设备(至少1台)
    • 电源适配器(12V/1A
    • 网线(Cat5e/Cat6,不同长度)
    • 光纤跳线(SC/LC,不同长度)

软件准备

  1. H3ConuMS2系统访问

    • 确保有系统登录权限
    • 熟悉设备查询界面
    • 了解历史状态查看功能
  2. 文档资料

    • 本指南(打印版或电子版)
    • ONU设备技术手册
    • OLT设备配置手册
    • 网络拓扑图

1.2 出发前检查

信息收集

  1. 从H3ConuMS2系统获取信息

    # 查询设备当前状态
    设备名称: [从系统获取]
    OLT位置: [从系统获取]
    最后在线时间: [从系统获取]
    历史故障记录: [从系统获取]
    
  2. 联系用户了解情况

    • 故障现象描述
    • 故障发生时间
    • 受影响范围(单用户/多用户)
    • 是否尝试过重启
  3. 确认现场信息

    • 具体地址和联系人
    • 设备安装位置
    • 现场环境(机房/用户端)
    • 预计到达时间

安全准备

  1. 个人防护

    • 穿戴工作服、安全鞋
    • 携带手电筒
    • 准备口罩、手套
  2. 工作许可

    • 确认是否有进入权限
    • 是否需要用户陪同
    • 工作时间限制

1.3 故障预判

根据系统信息和用户描述,初步判断可能的问题:

故障现象 可能原因 优先级
完全无信号 电源故障、光纤断裂
信号弱/不稳定 光纤衰减大、连接器脏污
有光信号但无法上网 配置错误、网线问题
间歇性断线 设备过热、干扰

第二章:现场排查流程

2.1 到达现场后的标准操作流程

步骤1:现场环境评估

  1. 安全确认

    • 检查现场是否有安全隐患
    • 确认电源插座接地良好
    • 注意防静电措施
  2. 设备定位

    • 找到故障ONU设备
    • 确认设备型号与系统记录一致
    • 检查设备安装位置是否合适
  3. 环境检查

    • 温度是否过高(>40°C
    • 湿度是否合适(30%-70%
    • 通风是否良好
    • 是否有灰尘堆积

步骤2:初步外观检查

  1. 电源检查

    • 电源指示灯状态
    • 电源适配器是否发热
    • 电源线连接是否牢固
    • 用万用表测量输出电压(应为12V±5%)
  2. 指示灯状态分析

指示灯 正常状态 故障状态 可能原因
PWR 常亮 不亮/闪烁 电源故障
PON 常亮 闪烁/不亮 光路问题
LOS 不亮 常亮/闪烁 光信号丢失
LAN 常亮/闪烁 不亮 网线/配置问题
  1. 物理连接检查
    • 光纤连接器是否插紧
    • 网线连接是否牢固
    • 所有接口是否有松动
    • 检查线缆是否有破损

步骤3:光路测试

  1. 使用红光笔检查

    • 在OLT端发射红光
    • 在ONU端观察是否有红光
    • 确认光纤通路是否完整
  2. 光功率测量

    • 连接光功率计到ONU接收端
    • 记录接收光功率
    • 参考标准值:-8dBm ~ -27dBm

    光功率判断标准:

    • 优于-8dBm:光功率过强,可能损坏设备
    • -8dBm ~ -27dBm:正常范围
    • -27dBm ~ -30dBm:临界值,可能不稳定
    • 低于-30dBm:光功率不足
  3. 光纤清洁

    • 使用专用清洁笔清洁光纤端面
    • 检查连接器是否有划伤
    • 重新插拔光纤连接器

步骤4:网络连接测试

  1. 本地连接测试

    • 笔记本电脑直连ONU LAN口
    • 设置静态IP(如192.168.1.100
    • Ping ONU管理地址(通常192.168.1.1
  2. 上网测试

    • 如果能够Ping通ONU,尝试访问网页
    • 测试DNS解析(nslookup www.baidu.com
    • 测试下载速度
  3. 抓包分析(如需要)

    • 使用Wireshark抓取网络包
    • 分析DHCP、PPPoE等协议交互
    • 查找异常流量

步骤5:设备诊断

  1. 登录ONU管理界面

    • 默认地址:192.168.1.1
    • 用户名/密码:admin/admin 或 查看设备标签
    • 检查设备状态信息
  2. 查看关键信息

    • 光模块信息(发射/接收功率)
    • 温度信息
    • 运行时间
    • 错误日志
  3. 配置检查

    • VLAN配置是否正确
    • 业务VLAN是否匹配
    • MAC地址学习情况

步骤6OLT端检查

  1. 通过H3ConuMS2系统检查

    • 登录系统查看设备状态
    • 检查OLT端口状态
    • 查看ONU注册状态
  2. SSH登录OLT(如需要)

    # 连接OLT
    ssh admin@olt_ip
    
    # 查看ONU状态
    display onu slot X/X
    
    # 查看端口信息
    display interface gigabitethernet X/X/X
    
    # 查看告警信息
    display alarm active
    
  3. OLT端诊断命令

    • display ont info - 查看ONU信息
    • display ont optical-info - 查看光信息
    • display ont version - 查看版本信息
    • display ont statistic - 查看统计信息

2.2 故障决策树

graph TD
    A[开始排查] --> B{电源指示灯亮?}
    B -->|否| C[检查电源]
    B -->|是| D{PON指示灯状态?}
    
    D -->|不亮| E[检查光路]
    D -->|闪烁| F[检查注册状态]
    D -->|常亮| G{LAN指示灯状态?}
    
    G -->|不亮| H[检查网线/配置]
    G -->|正常| I[测试网络连接]
    
    C --> J[更换电源适配器]
    J --> K{问题解决?}
    K -->|是| L[记录并结束]
    K -->|否| M[更换ONU设备]
    
    E --> N[测试光功率]
    N --> O{光功率正常?}
    O -->|否| P[检查光纤/清洁连接器]
    O -->|是| Q[检查OLT配置]
    
    F --> R[检查ONU注册]
    R --> S{注册成功?}
    S -->|否| T[检查SN/MAC绑定]
    S -->|是| U[检查业务配置]
    
    H --> V[更换网线]
    V --> W{问题解决?}
    W -->|是| X[记录并结束]
    W -->|否| Y[检查交换机配置]
    
    I --> Z[Ping测试]
    Z --> AA{能Ping通?}
    AA -->|否| BB[检查IP配置]
    AA -->|是| CC[测试上网]
    
    CC --> DD{能上网?}
    DD -->|否| EE[检查PPPoE/DHCP]
    DD -->|是| FF[故障排除完成]

第三章:常见故障处理

3.1 电源类故障

故障现象

  • 所有指示灯不亮
  • 设备无任何反应
  • 电源适配器发热异常

处理步骤

  1. 检查电源插座

    • 使用其他设备测试插座
    • 检查插座电压(220V±10%
  2. 检查电源适配器

    • 测量输出电压(应为12V
    • 检查输出电流(应≥1A
    • 观察指示灯状态
  3. 检查设备电源接口

    • 检查接口是否松动
    • 检查内部保险丝
    • 检查电源电路

解决方案

  1. 更换电源适配器
  2. 更换电源线
  3. 更换ONU设备

3.2 光路类故障

故障现象

  • PON指示灯不亮或闪烁
  • LOS指示灯亮
  • 光功率异常

处理步骤

  1. 检查光纤连接

    • 确认光纤类型(单模/多模)
    • 检查连接器类型(SC/LC
    • 清洁光纤端面
  2. 测量光功率

    • 在ONU端测量接收功率
    • 在分光器端测量输出功率
    • 计算链路衰减
  3. 检查光纤质量

    • 检查光纤是否有弯折
    • 检查接头是否有损伤
    • 检查光纤长度是否超限

解决方案

  1. 重新制作光纤接头
  2. 更换光纤跳线
  3. 调整光功率(增加衰减器)
  4. 重新熔接光纤

3.3 注册类故障

故障现象

  • PON指示灯闪烁
  • OLT无法发现ONU
  • 注册超时

处理步骤

  1. 检查SN/MAC地址

    • 核对ONU标签上的SN
    • 检查OLT端SN绑定
    • 检查MAC地址过滤
  2. 检查OLT配置

    • 检查端口使能状态
    • 检查ONU模板
    • 检查带宽配置
  3. 检查距离限制

    • 确认光纤长度
    • 检查光功率预算
    • 确认分光比

解决方案

  1. 重新配置SN/MAC
  2. 重启ONU设备
  3. 重置ONU到出厂设置
  4. 修改OLT配置

3.4 业务类故障

故障现象

  • PON灯常亮但无法上网
  • 能获取IP但无法访问外网
  • 网速慢或不稳定

处理步骤

  1. 检查VLAN配置

    • 检查业务VLAN ID
    • 检查VLAN透传
    • 检查优先级标记
  2. 检查IP配置

    • 检查DHCP获取情况
    • 检查PPPoE拨号
    • 检查静态IP配置
  3. 检查路由配置

    • 检查默认网关
    • 检查DNS服务器
    • 检查路由表

解决方案

  1. 重新配置VLAN
  2. 重启网络服务
  3. 更新设备固件
  4. 优化网络配置

3.5 性能类故障

故障现象

  • 网速达不到标称值
  • 延迟高、抖动大
  • 频繁掉线

处理步骤

  1. 进行网络测试

    • 测试上下行带宽
    • 测试网络延迟
    • 测试丢包率
  2. 检查设备负载

    • 检查CPU使用率
    • 检查内存使用率
    • 检查温度状态
  3. 检查干扰因素

    • 检查同频干扰
    • 检查电源干扰
    • 检查环境干扰

解决方案

  1. 优化设备位置
  2. 更换更高性能设备
  3. 调整信道/频率
  4. 增加散热措施

第四章:记录与报告

4.1 故障记录规范

基本信息

故障单号: [系统生成]
报告人: [维护人员姓名]
报告时间: [YYYY-MM-DD HH:MM]
故障地点: [详细地址]
联系人: [用户姓名电话]

故障信息

设备信息:
  - 设备型号: [H3C XXX]
  - 设备SN: [XXXXXXXX]
  - MAC地址: [XX:XX:XX:XX:XX:XX]
  - 安装日期: [YYYY-MM-DD]

故障现象:
  - 用户描述: [用户原话]
  - 实际现象: [现场观察]
  - 影响范围: [单用户/多用户]

处理过程:
  - 到达时间: [HH:MM]
  - 开始处理: [HH:MM]
  - 解决时间: [HH:MM]
  - 总耗时: [X小时X分钟]

技术数据

测试数据:
  - 光功率: [接收: -XX dBm, 发射: -XX dBm]
  - 网络测试: [下载: XX Mbps, 上传: XX Mbps]
  - 延迟测试: [平均: XX ms, 最大: XX ms]
  - 丢包率: [X%]

更换部件:
  - 部件名称: [如: 电源适配器]
  - 部件型号: [如: H3C-12V-1A]
  - 更换原因: [如: 输出电压不稳定]
  - 旧件SN: [XXXXXXXX]
  - 新件SN: [XXXXXXXX]

4.2 H3ConuMS2系统更新

设备状态更新

  1. 登录系统

    • 进入设备管理界面
    • 找到故障设备
  2. 更新信息

    • 更新设备状态(在线/离线)
    • 更新最后检查时间
    • 更新维护记录
  3. 添加备注

    • 描述故障现象
    • 记录处理过程
    • 添加技术数据

生成报告

  1. 导出数据

    • 导出设备历史状态
    • 导出故障处理记录
    • 导出性能测试数据
  2. 生成报告

    • 使用系统报告功能
    • 选择报告模板
    • 自定义报告内容
  3. 提交报告

    • 提交给上级主管
    • 发送给用户确认
    • 归档到知识库

4.3 知识积累

故障案例库

  1. 记录典型案例

    • 罕见故障现象
    • 复杂处理过程
    • 创新解决方案
  2. 分析故障原因

    • 根本原因分析
    • 预防措施建议
    • 改进方案设计
  3. 分享经验

    • 团队内部分享
    • 编写技术文档
    • 培训新员工

持续改进

  1. 统计分析

    • 统计故障类型分布
    • 分析故障发生频率
    • 计算平均修复时间
  2. 优化流程

    • 根据数据优化排查步骤
    • 改进工具配置
    • 更新技术标准
  3. 预防维护

    • 制定定期检查计划
    • 预测性维护
    • 设备生命周期管理

第五章:预防措施

5.1 定期维护计划

月度检查

  1. 设备清洁

    • 清洁设备表面灰尘
    • 清洁散热孔
    • 检查风扇运转
  2. 连接检查

    • 检查所有连接器
    • 检查线缆状态
    • 检查标签完整性
  3. 性能测试

    • 测试网络速度
    • 测试光功率
    • 测试设备温度

季度检查

  1. 全面诊断

    • 完整的功能测试
    • 详细的性能测试
    • 安全漏洞扫描
  2. 配置备份

    • 备份设备配置
    • 备份系统数据
    • 验证备份完整性
  3. 固件更新

    • 检查固件版本
    • 评估更新必要性
    • 制定更新计划

年度检查

  1. 设备评估

    • 评估设备性能
    • 预测剩余寿命
    • 制定更换计划
  2. 环境评估

    • 评估安装环境
    • 检查配套设施
    • 提出改进建议
  3. 文档更新

    • 更新技术文档
    • 更新操作手册
    • 更新维护记录

5.2 设备安装规范

环境要求

  1. 温度控制

    • 工作温度:0°C ~ 40°C
    • 存储温度:-40°C ~ 70°C
    • 避免阳光直射
  2. 湿度控制

    • 工作湿度:10% ~ 90% RH
    • 避免冷凝
    • 保持通风
  3. 电源要求

    • 稳定电压:220V ±10%
    • 可靠接地
    • 防雷保护

安装规范

  1. 设备固定

    • 使用合适支架
    • 保持水平安装
    • 预留散热空间
  2. 线缆管理

    • 分类绑扎线缆
    • 预留适当余量
    • 避免弯折过度
  3. 标签标识

    • 清晰设备标签
    • 完整线缆标签
    • 准确位置标签

5.3 备件管理

备件库存

  1. 常用备件

    • ONU设备:按设备总数10%储备
    • 电源适配器:按设备总数15%储备
    • 光纤跳线:按设备总数20%储备
    • 网线:按需储备
  2. 关键备件

    • 光模块
    • 分光器
    • 交换机
  3. 工具备件

    • 测试工具
    • 维修工具
    • 安全装备

库存管理

  1. 入库管理

    • 记录备件信息
    • 测试备件功能
    • 分类存放
  2. 出库管理

    • 记录领用信息
    • 跟踪使用情况
    • 及时补充库存
  3. 定期检查

    • 检查备件状态
    • 测试备件功能
    • 更新库存记录

5.4 培训计划

新员工培训

  1. 基础培训(第1周)

    • 公司制度介绍
    • 安全规范培训
    • 工具使用培训
  2. 技术培训(第2-3周)

    • 网络基础知识
    • 光纤通信原理
    • 设备操作培训
  3. 实操培训(第4周)

    • 跟随老员工现场学习
    • 模拟故障处理
    • 独立完成简单任务

在职培训

  1. 月度培训

    • 新技术介绍
    • 案例分享
    • 经验交流
  2. 季度培训

    • 技能考核
    • 应急演练
    • 安全培训
  3. 年度培训

    • 技术更新培训
    • 认证考试
    • 职业发展规划

第六章:应急处理

6.1 紧急情况处理

重大故障

  1. 大面积断网

    • 立即上报主管
    • 启动应急预案
    • 协调多方资源
  2. 设备损坏

    • 评估影响范围
    • 准备替代方案
    • 紧急采购设备
  3. 安全事故

    • 确保人员安全
    • 保护现场证据
    • 按规定报告

沟通协调

  1. 内部沟通

    • 建立应急联络群
    • 定期更新进展
    • 协调技术支持
  2. 用户沟通

    • 及时通知用户
    • 说明处理进展
    • 提供临时方案
  3. 供应商沟通

    • 联系技术支持
    • 协调备件供应
    • 请求现场支持

6.2 应急预案

预案制定

  1. 风险评估

    • 识别潜在风险
    • 评估影响程度
    • 制定应对措施
  2. 资源准备

    • 准备应急设备
    • 准备应急人员
    • 准备应急资金
  3. 流程设计

    • 设计处理流程
    • 明确责任分工
    • 设定时间要求

预案演练

  1. 桌面演练

    • 模拟故障场景
    • 讨论处理方案
    • 优化处理流程
  2. 实战演练

    • 模拟真实故障
    • 实际处理操作
    • 评估处理效果
  3. 演练总结

    • 分析演练过程
    • 发现存在问题
    • 提出改进建议

第七章:附录

7.1 常用命令参考

OLT常用命令

# 查看ONU状态
display onu slot X/X

# 查看光信息
display ont optical-info X/X/X X

# 查看版本信息
display ont version X/X/X X

# 查看统计信息
display ont statistic X/X/X X

# 重启ONU
ont reboot X/X/X X

# 查看告警
display alarm active

# 查看端口状态
display interface gigabitethernet X/X/X

ONU管理命令

# 登录ONUTelnet/SSH
telnet 192.168.1.1

# 查看系统信息
show system

# 查看接口状态
show interface

# 查看光模块信息
show optical-module

# 查看日志
show log

# 重启设备
reboot

# 恢复出厂设置
factory-reset

7.2 技术参数参考

光功率标准

项目 标准值 警告值 危险值
接收光功率 -8 ~ -27 dBm -27 ~ -30 dBm < -30 dBm
发射光功率 0 ~ +5 dBm +5 ~ +7 dBm > +7 dBm
链路衰减 < 25 dB 25 ~ 28 dB > 28 dB

温度标准

项目 正常范围 警告范围 危险范围
工作温度 0°C ~ 40°C 40°C ~ 50°C > 50°C
存储温度 -40°C ~ 70°C - -
表面温度 < 60°C 60°C ~ 70°C > 70°C

7.3 联系信息

内部联系人

部门 联系人 电话 职责
技术支持 张三 138XXXXXXX 技术指导
备件管理 李四 139XXXXXXX 备件供应
项目管理 王五 137XXXXXXX 项目协调

供应商联系人

供应商 产品 联系人 电话 支持时间
H3C OLT设备 技术支持 400-XXXX 7x24
华为 ONU设备 技术支持 400-XXXX 7x24
中兴 光模块 技术支持 400-XXXX 工作日

7.4 模板下载

故障报告模板

[下载链接:故障报告模板.docx]

维护记录模板

[下载链接:维护记录模板.xlsx]

备件清单模板

[下载链接:备件清单模板.xlsx]


第八章:更新记录

版本 更新日期 更新内容 更新人
v1.0 2026-04-08 初始版本创建 系统团队
v1.1 - 计划更新:添加更多案例 -
v1.2 - 计划更新:优化流程图 -

使用说明

  1. 新员工必读:入职后一周内完成学习
  2. 现场携带:建议打印关键章节随身携带
  3. 定期复习:每季度复习一次
  4. 反馈建议:发现不足及时反馈
  5. 持续改进:根据实际情况更新内容

版权声明

本指南版权归H3ConuMS2项目组所有,未经许可不得外传。


祝您工作顺利,排查无忧!

如有任何问题或建议,请联系: