简介中兴OLT常用命令及故障解析处理手册是一份面向运营商与政企网络运维人员的设备运维SOP聚焦中兴ZXA10 C300/C320的日常维护与故障闭环。内容先介绍设备面板、业务板卡和上联接口再给出show card、show version、show interface等高频命令并结合板卡状态字段说明如何判读单板不在位、无供电、类型不匹配等异常便于快速定位OLT侧问题。故障部分按设备板卡、ONU、光猫、上联链路等维度展开覆盖网元断链、光猫注册异常、机顶盒误获取地址、流氓光猫干扰、测速不达标及专线卡顿等真实场景的排查步骤可作一线排障手册。资源包为单个pptx演示文稿大小7.17MB以图文结合方式呈现结构清晰、分节明确适合随身查阅和团队培训。已有2789人学习尤其适合刚接触中兴OLT或需要系统梳理故障处理流程的工程师作为日常维护和故障排查的参考手册。1. 半夜被OLT告警叫醒先看懂一块“HWONLINE”板卡再动手做接入网维护的人几乎都被OLT告警在半夜叫醒过。网管弹出一条“单板不在线”或“光猫注册失败”赶到机房一查show card 输出里整整齐齐列着一堆状态值——INSERVICE、NOPOWER、HWONLINE、TYPEMISMATCH每行都像一个状态黑匣子。如果不熟悉这套 OLT 常用命令很容易把 HWONLINE 当成“在线”去处理结果板卡根本没有进入服务状态业务中断时间被白白拉长。这篇故障解析处理笔记围绕某厂商 ZXA10 C300/C320 的板卡状态、注册排查、业务故障和典型案例展开所有命令都可以直接抄到设备上执行。适合两类人新手照着命令能完成基础排障熟手能拿走一整套“现象—根因—动作”的定位思路少走弯路。2. show card 一栏读懂板卡状态七个状态值背后的硬件故障含义2.1 show card 输出里每个状态值对应什么故障业务中断时我第一件事就是把 show card 拉出来看。这条命令在 C300/C320 上都通用输出能直观反映设备里每一块板的配置类型、实际类型、端口数、软硬件版本和运行状态ZXA10-C300# show card Rack Shelf Slot CfgType RealType Port HardVer SoftVer Status ------------------------------------------------------------------------------- 1 1 0 PRWG PRWG 0 V1.0.0 INSERVICE 1 1 1 PRWG PRWG 0 V1.0.0 NOPOWER 1 1 2 GTGO GTGOG 8 V1.0.0 V2.1.0 HWONLINE 1 1 3 GTGO GTGOG 8 V1.0.0 V2.1.0 INSERVICE 1 1 4 GTGH OFFLINE 1 1 13 ETGO 8 V1.0.0 V2.1.0 TYPEMISMATCH 1 1 14 GTGH GTGHG 16 V1.0.0 V2.1.0 CONFIGING 1 1 10 SCXM SCXM 0 V1.0.0 V2.1.0 INSERVICE 1 1 11 SCXM SCXM 0 V1.0.0 V2.1.0 STANDBY这段输出看起来字段很多真正需要盯住的只有最后一列 Status。INSERVICE 表示板卡进入服务状态也就是正常承载业务NOPOWER 表示板卡在位但没有通电常见原因是电源板对应槽位供电异常或者板卡本身存在短路等硬件问题HWONLINE 表示板卡在位但不在线通常意味着设备里没有添加这块单板的配置、缺少版本文件或者单板已经损坏OFFLINE 表示板卡不在位可能是没插到位也可能是背板槽位接触不良TYPEMISMATCH 表示配置添加的板卡类型与实际插入的板卡类型不一致这是现场最容易看错的故障CONFIGING 是配置同步状态正常情况下是临时过渡状态长时间停留就说明主控和该板卡之间的通信出了问题。参数方面CfgType 是网管或配置里添加的板卡型号RealType 是系统实际识别到的型号两列不一致时系统直接回报 TYPEMISMATCH。Port 代表这块板的端口数量比如 GTGH 对应 16 口 GPON 板。HardVer 和 SoftVer 分别是硬件版本和软件版本HWONLINE 的那一行 SoftVer 经常为空原因就是版本文件没同步上去。补充一句SCXM 这类主控板还会出现 STANDBY表示它是备用主控属于正常状态不是故障。2.2 运行时间与重启痕迹show system-group 怎么用板卡状态全部正常业务却断过这时候要怀疑设备是否掉电或重启过。常见做法是执行 show system-group它会输出系统描述、软件版本、设备名称和启动时间。ZXA10-C300# show system-group System Description: C300 Version V2.1.0 Software Started before: 5 days, 16 hours, 15 minutes System name: FuWuQi-OLT-C300重点看 “Started before” 这一行它表示设备从上次启动到现在运行了多久。如果这个数值明显小于你预期的运行时长说明设备在近期掉过电或有人复位过主控。把这个时间点和网管告警记录对齐就能判断是市电输入闪断、UPS 异常还是人为操作导致的复位不用再靠猜。这个命令在“整台设备业务全部中断”的场景里价值很高很多新手会忽略它。我一般把 show system-group 和 show card 配合使用先看板卡状态有没有异常再看运行时间是否被重置过。两行输出就能区分是“单板故障”还是“整机重启”这是后续处理方向完全不同的两条路。2.3 决定设备寿命的三兄弟风扇、温度、CPU单板在线不等于设备健康。热量和 CPU 过载引发的故障往往先表现为“业务时好时坏”最后才告警属于隐蔽型故障。三条环境类命令在排障时是配套出现的ZXA10-C300# show fan Environment Temperature : 23(deg c) FanSpeedLevelPercent : 20% 35% 50% 75% Upper Fanboard Status : online FanUnitId SpeedLevel ActualSpeed(RPM) 1 2 2100 2 2 2100 3 2 2100 ZXA10-C300# show card-temperature Rack Shelf Slot Temperature Temperature(5m) Temperature(1h) 1 1 2 44 43 43 1 1 16 44 44 44 ZXA10-C300# show processor Rack Shelf Slot CPU(5s) CPU(1m) CPU(5m) PhyMem(MB) Memory 1 1 10 12% 16% 13% 510 66% 1 1 11 22% 24% 23% 510 66%show fan 里风扇的转速等级会根据环境温度自动调节只要有一组风扇 ActualSpeed 长期为 0就应该安排更换风扇模块。show card-temperature 重点看有没有超过 55℃ 的板卡PON 板的光模块对温度尤其敏感温度过高会直接造成光功率劣化和误码率上升。show processor 则看 CPU 利用率和内存若 CPU 长时间大于 60% 就需要重视长时间 99% 基本可判定为协议报文冲击这在后面流氓光猫的案例里会专门展开。这三条命令看的是“趋势”而不是“当前值”。因为 show card-temperature 本身提供了 5 分钟和 1 小时的平均值我通常会隔几分钟再执行一次看温度曲线是缓慢爬升还是突变。缓慢爬升先查风扇和机房空调突变则优先怀疑光模块或板卡寄存器异常。这一套十几秒就能敲完却能把机房环境类和协议类故障提前拦下来。3. 光猫注册失败排查从“未注册列表”到“认证拒绝”的三步定位法3.1 先查未注册列表show pon onu uncfg 与 EPON 侧的差异光猫注册不上最忌讳反复重启光猫。正确的起点是在 OLT 上确认光猫到底有没有被“看见”。GPON 侧的执行命令是 show pon onu uncfg它能列出所有未完成注册的光猫并给出 SN 和 LOID 两列关键信息ZXA10-C300# show pon onu uncfg OltIndex SN LOID gpon-olt_1/1/6 FHTT56075A10 9980991636C gpon-olt_1/14/2 SCTY40F25A38 N/A gpon-olt_1/14/8 YHTCE88A12C3 useradmin gpon-olt_1/15/2 YHTCE88AAEC0 9980260532COltIndex 表示光猫是挂在哪个框、哪个槽、哪个 PON 口下SN 是光猫序列号LOID 是逻辑标识。排查时先看 LOID 列显示 N/A 说明这台光猫的 LOID 为空需要核对开户数据是否写错显示成一串数字或字符说明 LOID 已经上报但 OLT 上可能没有这条注册记录或者 LOID/密码不匹配导致认证被拒。EPON 侧的“未注册”命令是 show onu unauthentication输出比 GPON 更直观它会直接给出 Online State 为 authentication deny意思就是光猫的认证请求被拒绝同时还能看到 MAC、SN、软硬件版本和注册时间。这里记住一个区别EPON 光猫主要靠 MAC/SN 认证GPON 光猫主要靠 LOID/SN 认证两侧未注册列表的字段含义不同不要拿 EPON 的字段去套 GPON。3.2 按 SN / LOID 反查注册位置一条命令定位光猫挂在哪如果光猫之前注册过只是现在业务不通或者现场人员不知道光猫挂在哪台设备下可以用反查命令精确定位。GPON 侧对应两条ZXA10-C300# show gpon onu by loid 9980599382C Search result ----------------- gpon-onu_1/1/1:1 ZXA10-C300# show gpon onu by sn FHTT57D2AEF0 Search result ----------------- gpon-onu_1/1/1:2返回结果里的 gpon-onu_1/1/1:1 是这台光猫在 OLT 侧的逻辑接口名框 1、槽 1、PON 口 1、ONU ID 1。如果命令返回 “%Code 62310-GPONSRV : No related information to show”说明 OLT 上根本没有这条注册记录问题大概率在开户数据和网管侧光猫本身不用动。这个反查命令在“光猫搬家”场景里特别好用——原来挂在 a PON 口下的光猫被挪到 b PON 口b 口显示未注册a 口的注册记录还占着位置需要先把旧端口的数据清理掉。EPON 侧对应命令是 show epon onu by loid使用逻辑完全一样。我习惯把未注册列表和反查命令搭着用先在 uncfg 里找到 SN再用 by sn 确认它是否注册在别的端口避免出现“新端口报未注册、旧端口还在占用”的翻车现场。3.3 注册成功但业务不通单层 VLAN 与双层 VLAN 的核查重点注册成功只是第一步业务不通还得看 ONU 的数据配置。先看 PON 口下注册了哪些光猫再切入单台光猫的详细配置ZXA10-C300# show running-config interface gpon-olt_1/7/9 interface gpon-olt_1/7/9 onu 1 type F660 loid 9980653198C onu 2 type F660 loid 9980653199C onu 12 type F660 loid 9980653227C ! ZXA10-C300# show running-config interface gpon-onu_1/7/9:12 interface gpon-onu_1/7/9:12 description $onuname$$$ sn-bind disable tcont 1 name ITMS allocid 264 profile ITMS tcont 2 name HSI allocid 267 profile HSI tcont 3 name ITV-50M allocid 265 profile ITV tcont 4 name VOIP allocid 266 profile VOIP service-port 1 vport 1 user-vlan 46 vlan 46 svlan 2270 service-port 2 vport 2 user-vlan 41 vlan 312 svlan 270 service-port 3 vport 3 user-vlan 45 vlan 45 svlan 1270 service-port 4 vport 4 user-vlan 43 vlan 43 svlan 3270 igmp fast-leave enable vport 3第一段命令看的是 PON 口下配置了哪几台光猫每行 onu 后面的数字是 ONU IDtype 是光猫型号loid 是绑定标识。第二段是单台光猫的业务配置tcont 是带宽容器allocid 是分配标识service-port 完成用户 VLAN 到运营商网络的映射转发。核查时先区分业务模型——上行直连 BAS 的service-port 通常有 vlan 和 svlan 两层上行先到汇聚交换机再转 BAS 的往往是单层 vlan。如果机顶盒获取错误地址、IPTV 点播异常优先核对 IPTV 对应 service-port 的 svlan 和组播 vlan 是否与开户模板一致。远程下发场景下还要再看一层OLT 到光猫之间的 gemport 映射。常见做法是用 show onu running config 查看 pon-onu-mng 段ZXA10-C300# show onu running config gpon-onu_1/7/9:12 pon-onu-mng gpon-onu_1/7/9:12 flow 1 pri 7 vlan 46 flow 2 pri 0 vlan 41 flow 3 pri 5 vlan 45 flow 3 pri 5 vlan 50 gemport 1 flow 1 gemport 2 flow 2 gemport 3 flow 3这段配置是光猫电口数据的下发通道起 OLT 与 ONU 之间业务流的桥梁作用。非简化模式下 flow 与 gemport 一一对应每个 flow 绑定一个业务 VLAN 和优先级简化命令模式则直接用 service 关键字把 gemport 映射到业务。这里最容易踩坑的地方是把 interface gpon-onu 下的 service-port 和 pon-onu-mng 里的 flow 混在一起看前者管 OLT 侧转发后者管光猫侧下发两者错位就会注册成功但业务全断而且从 PON 口状态上看不出任何异常。4. 业务故障处理网元断链、流氓光猫、测速不达标的现场套路4.1 板卡故障处理TYPEMISMATCH 与 HWONLINE 的动手顺序板卡状态异常的处理核心原则是“先核对配置再动硬件”。以 TYPEMISMATCH 为例它代表添加板卡与实际插入的板卡不匹配可能是施工时插入了与配置不同的板卡也可能是网管侧把槽位型号配错了。正确顺序是查看实际板卡型号→核对 CfgType→把配置改成实际型号或把板卡换成配置型号两者一致后状态才能恢复。如果只拔卡换新配置里还是错的那个型号换多少块都一样。HWONLINE 的处理稍微复杂它对应三种根因没有添加单板、没有版本文件、单板损坏。判断顺序是先用 show card 看 RealType 列有没有值有值说明板卡能被识别优先检查软件版本是否同步没值说明板卡本身或背板通信有问题再把单板重新插拔一次。注意不要在业务高峰期反复热插拔否则容易造成同槽位其他板卡误告警。如果板卡状态长时间卡在 CONFIGING说明配置同步没有完成重点查主控到该板卡的内部通信而不是马上更换板卡。这里给一张状态值与处理动作的对照表贴到值班手册里可以直接照着做状态值含义首选处理动作INSERVICE板卡正常服务无需处理NOPOWER在位不通电查电源板和供电链路HWONLINE在位不在线核对单板配置与版本文件再判断是否损坏OFFLINE不在位重新插拔或检查背板槽位TYPEMISMATCH配置与实际型号不符修改配置或更换板卡使其一致CONFIGING配置同步中观察是否恢复长时间停留查主控通信STANDBY备用板卡无需处理4.2 OLT 网元断链按“物理层→IP 层→网管通道”三层排查网元断链是网管侧最刺眼的告警之一本质是网管到 OLT 的管理通道不可达。处理时我按从下往上的顺序来每一步都有明确的退出条件。先看上联口物理状态常见做法是执行 show interface 类命令确认上联光模块是否正常、端口是否 UP、有无大量错包ZXA10-C300# show interface gei_1/12/1 ZXA10-C300# ping 网管服务器管理IP source 上联VLAN接口IP第一行看的是上联光口的物理层和链路层状态如果端口 DOWN直接查光纤和光模块不用继续往下走。第二行是从 OLT 侧主动发起 ping探测管理通道是否可达能通说明数据面转发正常问题在网管侧的服务器或路由不通则要根据 ping 结果逐段回退——先 ping 上联交换机的 VLAN 网关再 ping 网管网关用分段法把断点定位在某一跳。还有一类隐蔽原因是管理 VLAN 配置被误删或者 QoS 策略丢弃了管理报文这种场景下物理层和 IP 层看起来都通但网管就是收不到 OLT 的主动上报需要核查管理业务配置和策略。这里强调一点网元断链不一定影响用户上网但会直接影响远程运维入口所以它属于最高优先级告警之一。4.3 流氓光猫与 CPU 协议冲击一个 PON 口下所有用户掉线的元凶某个 PON 口下所有用户同时掉线、时断时续PON 板 CPU 长时间跑满这是典型的流氓光猫症状。所谓流氓光猫是指某台光猫异常发光或持续发送错误报文干扰了同 PON 口下其他光猫的上行时隙让整个 PON 口处于半瘫痪状态。最麻烦的是它可能时好时坏等你到场排查时又恢复正常常被误判为“偶发干扰”。定位手法是三步走。第一步show processor 确认 CPU 利用率是否异常长时间 99% 基本可以判定协议报文冲击第二步检查该 PON 口的收发光功率流氓光猫发作时接收光功率通常会异常升高第三步在故障发作窗口把疑似光猫逐个去激活或断开尾纤观察 CPU 利用率和 PON 口错包率是否回落回落的那个就是问题源。锁定后更换或关闭该光猫PON 口下的其他用户随即恢复。这套做法的完整流程在故障案例里写得很清楚现场按顺序执行比用排除法瞎猜快得多。测速不达标和专线卡顿也常走类似的排查链路先确认光猫的带宽模板是否满足签约速率再看上联口流量和是否存在拥塞最后才是光纤衰耗。顺序不能乱——用户侧模板没核对清楚就去动光路往往白忙一趟。常见做法是核对 tcont 对应的 profile 配置再通过上联口流量统计确认是否跑满端口带宽。5. 常见问题避坑五个让运维翻车的配置细节5.1 注册与板卡类看不懂状态值就动手越换越远现象新装光猫注册不上网管提示“认证拒绝”现场人员直接换光猫连续换了三台仍然注册失败。原因show onu unauthentication 里 Online State 已经明确显示 authentication deny这是 LOID/密码或绑定关系的问题和光猫硬件没有关系。换光猫只会重复同样的认证失败浪费备件和时间。解决先在 OLT 上用 show gpon onu by loid 或 show gpon onu by sn 核对注册记录确认 LOID 大小写、密码是否和开户数据一致确认未绑定后重新下发绑定再让光猫重新注册。整个过程不需要动光猫。现象show card 显示一块板为 TYPEMISMATCH维护人员以为是板卡损坏直接拔出来换了一块新板告警依然存在。原因CfgType 与 RealType 不一致是配置里添加的型号和实物不匹配不是实物损坏。配置里的型号不改正换再多的板也是同一个结果。解决先查该槽位配置的板卡型号和实际板卡标签核对把配置改成实物型号或者把实物换成配置型号。状态恢复正常后再观察告警是否消失。现象板卡状态显示 HWONLINE被误读为“在线”业务中断几个小时后才被重视。原因HWONLINE 的中文含义是“在位但不在线”它可能对应未添加单板、版本文件缺失或单板损坏绝不是正常服务状态。把它当成在线等于默认故障不存在。解决按 show card 里 RealType 是否有值来分流——有值则补单板配置和版本文件无值则优先怀疑硬件和背板通信必要时插拔或更换单板。5.2 业务类VLAN 与光路的问题最隐蔽现象机顶盒能拨号但获取到错误地址IPTV 直播卡顿或黑屏从 OLT 侧看 PON 口和光猫都正常。原因service-port 的 svlan 配错或者组播 VLAN 没有映射到对应 vport。IPTV 直播依赖组播组播 VLAN 一旦缺失业务表现就是“注册正常但业务异常”。解决核对 IPTV 对应 service-port 的 user-vlan、vlan、svlan 三项参数同时确认 igmp fast-leave 开启的 vport 与组播业务 vport 一致逐项对照开户模板修正。现象某个 PON 口下所有用户在同一时间段掉线过一段时间自动恢复且反复发作现场误判为外部线路故障。原因大概率是流氓光猫在特定时段异常发光干扰整个 PON 口的上行通道。这类光猫在正常时段看不出问题具有很强的隐蔽性被称作“测不出来的灵异故障”也不冤枉。解决在故障发作窗口执行 show processor 和光功率检查若 CPU 飙升或接收光功率异常逐个隔离疑似光猫定位后更换或关停问题光猫。建议保留故障时段的 CPU 和光功率记录作为隔离判断依据。现象专线测速不达标用户持续投诉现场怀疑光纤衰耗过大准备改光路。原因光路衰耗只是嫌疑之一更常见的是光猫带宽模板限速低于签约速率或者上联端口拥塞导致丢包。没核对模板就动光路指标可能毫无变化。解决先执行 show running-config 查看光猫的 tcont 和 profile 带宽参数再查上联口流量和错包统计最后测光功率。按这个顺序走大概率在不动光路的情况下就能定位。6. 快速定位思路用“现象五元组”把故障范围压缩到一块板6.1 先回答五个问题再决定敲哪条命令到现场后我第一件事不是上设备而是先把故障信息整理成五个要素影响范围是一台光猫还是一个 PON 口下的多台用户故障发生的时间点以及前后有没有配置变更OLT 侧有没有伴随告警比如单板告警或网元断链光猫的指示灯状态和注册状态是否一致这个业务是单层 VLAN 还是双层 VLAN 模型。这五个问题全部答完命令的优先级基本就定了。6.2 按故障范围选命令的对照表故障现象首选命令关键看什么单台光猫注册失败show pon onu uncfgSN、LOID、认证状态单台光猫注册成功但业务不通show running-config interface gpon-onuservice-port、tcont、vlanPON 口下全部用户异常show processor 光功率检查CPU 利用率、收发光、流氓光猫整台 OLT 管理异常show card show interface 上联口板卡状态、上联物理层环境类故障show fan / show card-temperature风扇转速、温度变化曲线这个表格可以直接打印出来贴在值班位。故障范围越大的排查层级越靠下单台光猫的问题先看注册数据和 ONU 配置PON 口级的问题优先怀疑流氓光猫和光功率整机级的问题先解决板卡和上联物理链路机房环境类问题则从风扇和温度切入。方向选对了一套命令十几分钟就能收工。从那以后我每次到现场都会先把“现象五元组”写在手机备忘录里再决定敲哪些命令。这套习惯帮我避免了很多次“命令敲了一堆、定位还在原地”的尴尬。希望帮到你。本文还有配套的精品资源点击获取