爱立信基站moshell命令实战：从MOM对象树到日志分析

简介爱立信4G/5G网络运维中moshell常用指令繁多且易混淆。这份整理面向基站工程师、LTE/NR优化人员及刚接触爱立信设备的新手以英文原版Moshell Exercises为基础按MOM、MO-read、MO-write、PM、Log、Sw Management、Inventory/COLI、Transport Network、LTE/NR等模块系统梳理常用命令覆盖查询基站状态、修改参数、性能采集、日志调取、软件包管理、硬件组件查看及传输链路配置等真实场景每条命令均附格式与实例方便直接套用和排障。资源为一个doc文档约117KB目录按命令类别分章节结构清晰便于快速定位文末还涉及Scripting与Cloud RAN内容可作进阶参考。目前已有709人学习下载适合作为日常运维中的速查手册帮助提升网优与排障效率。1. MOM对象树与moshell爱立信基站维护的第一块敲门砖现场处理5G基站告警时网管界面点半天鼠标常常不如登录基站敲一条moshell命令来得快。爱立信4G/5G基站的配置、性能计数器、日志、软件版本全部挂在MOManaged Object这棵对象树上moshell就是操作这棵树的命令行入口。这份常用指令手册的价值在于它按MOM命令、MO读写、PM性能、Log日志、传输网络、LTE/NR、Scripting、Cloud RAN等模块拆开了日常运维的高频操作适合无线网优、基站工程师、核心网转无线的从业者以及在做网络自动化巡检脚本的运维开发。读懂MOM的检索逻辑比背一百条命令更能解决实际问题。2. 从MOM命令到MO-write对象检索、配置读取与安全修改2.1 MOM命令先从对象树上找到你要的东西MOMManaged Object Manager命令解决的是一个很实际的问题你记得属性名但记不清它挂在哪个MO类下面或者你只记得属性描述里有个关键词但不知道类名是什么。这时候挨个翻文档效率太低直接用mom系列命令在MOM描述文件里全文检索。mom fieldreplaceableunit momd fieldreplaceableunit .第一条mom打印MO类FieldReplaceableUnit的描述第二条momd带点号则输出该类所有属性和动作的详细描述。注意这里不需要写全类名匹配符moshell会自动做模糊处理。.后面的点号表示“所有”等价于SQL里的SELECT *。更常用的检索模式是关键词收拢momd . arfcn mom . . . . unit:.*db momd . . sequence:moref momtl lrat.enodebfunction第一条命令在所有MO类、属性、动作的描述里搜“arfcn”第二条限制描述中单位字段匹配dbdBi/dBm用于快速定位发射功率、增益等相关属性第三条找类型为sequence:moRef的组合引用属性这在处理小区与扇区绑定关系时很好用第四条momtl列出Lrat.ENodeBFunction下允许挂载的子MO类清单建站前核对对象树层级依赖。这一层命令解决的是“对象在哪儿、属性是什么类型、能取什么值”是后续读写操作的基础。我一般在新版本基站上做任何批量修改前都会先跑一遍mom upgradepackage state这类命令确认枚举值和当前版本一致避免拿到的是旧版本的属性定义。2.2 MO-read用正则和hget横向拉取配置MO-read命令是日常巡检的主力。新手最容易犯的错是pr一个MO然后把屏幕刷满再一条条肉眼看差异。正确做法是用正则表达式缩小范围再用hget横向输出。lt all pr ^fieldreplaceableunit hget ^eutrancell bandwidth|arfcn|physical|tac$lt all列出节点当前所有MO实例输出末尾会附带每个MO类的实例数量先跑这条命令对整站规模有个底。pr支持正则模式^fieldreplaceableunit只匹配以该MO类开头的对象下面挂着的RfPort、RfBranch等子对象不会一起刷出来。hget是水平读取把多个属性的值按行排列输出对比四个小区时一眼就能看出哪个EARFCN配置异常。状态过滤也是MO-read的高频场景st . 1.*06 get . administrativestate 0 lst equipment disst命令的第一个点号表示“当前节点下所有MO”1.*06是状态码正则1开头06结尾对应“unlocked disabled”第二条get按administrativestatelocked过滤注意值0通常代表locked不同版本有差异lst equipment则是把Equipment对象下所有MO的operationalStatedisabled的实例列出来。语句里的正则和值映射跟随版本有细微差别在全网批量执行前先单站验证一次。对比参数差异时用pr的diff模式pr ^eutrancellfdd diff proxy1 proxy2 proxy3这里的proxy指MO实例的代理IDdiff会把三个同类型MO的属性差异直接打印出来比手工diff输出快很多。2.3 MO-write锁站、改参、建删MO的边界MO-write命令要特别强调边界意识。锁小区、改userlabel这类操作影响面小可以直接执行但涉及整站操作或创建删除MO必须清楚哪些属性允许运行时修改。bl eutrancellfddxxx st eutrancellfddxxx deb eutrancellfddxxx bls eutrancellfddxxxbl是block硬锁会让小区直接退服deb是unblock恢复。bls是soft lock保留部分功能比如S1连接5G站点的软锁行为与4G略有差异批量执行前先在一个小区上验证。锁完立刻st查状态确认状态机切换符合预期再继续下一步。参数修改最基本的形态是set/get配对get interfaceip mtu set interfaceip mtu 1500 set equipment1 userlabel your_useridset之前先get查原值改完再get确认这是最稳妥的闭环。userlabel支持字符串直接写入日常打标签是个好习惯尤其在共享机房场景下设备归属一目了然。创建与删除MO有两条路径cr Transport1,VlanPort100 encapsulationTransport1,EthernetPortTN_B vlanId100 del VlanPort100 crn Transport1,VlanPort100 encapsulation Transport1,EthernetPortTN_B vlanId 100 endcr一次成型适合固定参数crn进入交互式创建适合参数多、需要逐条确认的场景end结束输入。删的时候del VlanPort100即可不用再带创建参数。2.4 restricted属性与undo mode改不动的东西怎么改部分属性被标记为restricted原因各不同cellId参与了对象命名改了等于换对象标识earfcndl影响空口频率需要走动作而非直接赋值。mom \.eutrancellfdd ^cellid acl ^eutrancell acc ^eutrancellfddxxx changefrequencymom加正则确认cellId的restricted状态后有两种绕行方式一是rset重建整个MO先删后建二是用MO action。acl列出EUtranCell支持的全部动作acc调用动作。changefrequency动作内部会处理频率切换涉及的一系列联动属性比直接改earfcndl安全得多。需要批量重建时用模拟撤销模式us rdel ^utrancellfddxxx u-us进入模拟撤销模式rdel标记删除u-退出moshell会生成两个脚本一个脚本执行删除另一个执行完整重建。这是爱立信基站运维里非常实用的一个技巧每次重大参数调整前先让moshell“预演”一遍脚本检查无误再进行生产操作。3. PM命令从计数器到KPI报告的性能数据提取3.1 先定位计数器在哪个scannerPM数据的提取逻辑和MOM检索类似你要的性能指标先挂在一个或多个scanner下scanner决定数据采集粒度。盲目执行pmx只会拿到“找不到counter”的报错。pst pst . activ pget . pmErabRelNormalEnbActpst列出所有scanner及其状态pst . activ只看运行中的scanner。pget返回计数器所在的scanner列表从输出里能确认这个计数器是被哪个扫描器周期性采集的。scanner没有激活时先确认PM测量开关是否打开再谈后续取值。计数器本身的语义核实同样走MOM通道pmomd . . . . fail|reject pmom . pmRrcConnEstabAtt$|pmRrcConnEstabSucc$第一条搜描述里含fail或reject的计数器第二条直接查两个RRC连接建立相关的主计数器的详细说明。注意区分主计数器primary counter和派生计数器主计数器是直接采集的原始值KPI通常是主计数器做除法和聚合算出来的排查指标异常时要先看主计数器的原始趋势。3.2 pmx系列时间跨度、时区与图形化输出pmx系列是PM取值的核心命令族后缀不同输出格式和时区处理也不同。pmx . pmRrcConnEstabAtt$|pmRrcConnEstabSucc$ -m 2 pmxz . pmRrcConnEstabAtt$|pmRrcConnEstabSucc$ -m 2 pmxlz . pmRrcConnEstabAtt$|pmRrcConnEstabSucc$ -m 2 pmxh . pmRrcConnEstabAtt$|pmRrcConnEstabSucc$ -m 2 -a四个命令的差异pmx按UTC时间输出pmxz转换为本地时区pmxlz生成可直接导入Excel的格式pmxh把计数器横向排列。-m 2表示回溯2小时取值范围从0.2515分钟到24小时甚至更长最小粒度取决于scanner配置。-a参数对时间周期做聚合输出单一汇总值而不是逐条时间序列。干扰类指标的排障也在这套逻辑里pmxe . Int_RadioRecInterferencePwrPrb -m 0.25 pmxel . Int_RadioRecInterferencePwr$ -m 2Int_RadioRecInterferencePwrPrb是物理资源块级别的干扰功率-m 0.25取最近15分钟适合快速判断当前是否有干扰突发现象Int_RadioRecInterferencePwr$是小区级平均干扰-m 2回溯2小时看趋势。5G侧NR小区的干扰排查思路一致只是计数器名称变为NR域开头。3.3 pmr报告直接输出KPI而不碰裸计数器裸计数器适合定位问题但写报告或日报时直接调KPI报告更高效。pmr命令按预定义报告号输出KPI不需要手动组合计数器。pmr -m 6 201 pmr -m 6 204 pmr -m 0.25 3015201是“LTE Node Traffic Performance, Whole Period”输出整站级RRC连接建立成功率等聚合KPI204是“LTE EUtranCell Traffic Performance, Whole Period”按小区输出两个报告搭配使用可以快速定位“整站正常但某个小区RRC成功率掉底”的场景。3015是IP接口吞吐量报告-m 0.25取最近15分钟用于确认OM接口和业务接口的实际流量判断传输侧是否被打满。pmr输出的KPI已经是聚合计算后的百分比或速率值省去了手动拿计数器做除法的步骤。需要注意的是报告号在不同版本间有少量变动执行前可以先在命令后面不带报告号敲一遍让moshell列出当前节点的可用报告列表。4. Log命令故障复盘时怎么从基站挖出历史4.1 日志族谱lga、lgh、lgx、lgo分别拿什么Log命令家族庞大但每个命令对应一类独立日志搞清楚归属关系比硬记参数更重要。命令日志类型典型应用场景lga告警历史回溯某段时间内产生和清除的告警lghAutoIntegration Log查看基站自动集成完成的时点lgx指定时间点的活动告警复盘特定时刻基站处于什么状态lglCOLI命令历史查看COLI接口上执行过的操作lgoMO命令日志追溯SET/BLOCK/DELETE等配置变更lg4APC日志外部告警、电源供电、机房环境lgy安全日志NTP校时记录、登录尝试lgzTnNetwork日志以太网端口up/down历史lgbTnApplication日志SCTP连接建立与断链记录lgd节点中断日志整站重启、部分中断记录lgg板卡重启日志板卡级crash与重启lgp崩溃转储DU上保存的crash dump文件列表lgovm合并视图多份日志按时间线合并输出lgkESI系列日志硬件、SWMI、COM告警、PNP自动集成lga -s 20230901回溯告警时输出头部会标注“Date of log collection”这行信息直接告诉你当前这份日志是哪个时间点采集的跨天分析时必须先确认这一点否则容易把采集时点当成告警发生时间。lgx -s 20230930.0900用点号分隔日期和时间输出该时刻所有处于激活状态的告警。调测现场最常见的操作是lgx对比两个时间点的active告警差异比如夜间批量操作前后各抓一次。4.2 排障组合NTP、SCTP、板卡重启与crash dump告警日志能告诉你“发生了什么”但根因往往藏在更底层时钟跳变导致小区失步、传输链路闪断引发SCTP重建、板卡固件异常触发连续重启。lgy | grep -i ntp lgy | grep -i login lgz | grep Ethernet lgb | grep -i enabled lgdlgy管道grep是安全日志的两种高并发用法ntp过滤时钟调整记录批量排查全网时钟失步时先看某个站点的NTP校时频次是否异常login过滤登录尝试确认是否有非本人操作过的账号在特定时段登录。lgz | grep Ethernet查看以太网端口全部up/down事件每次事件自带时间戳和端口号lgb | grep -i enabled查找SCTP链路的启用与断链事件这两个输出对齐时间线时能把“传输闪断导致SCTP重建进而引发小区重启”的因果链完整还原。lgd输出节点重启与中断历史包括重启类型手动、自动、电源、看门狗和恢复耗时。配合lgg查板卡重启记录、lgp列出DU上的所有crash dump注意lgp的结果里每条记录带时间戳把dump时间点和lgg的重启时间点对齐基本能锁定是哪块板卡、哪个模块先出了问题。lgovm -m 10lgovm把MO命令日志和可用性日志合并为单一时间线-m 10取最近10天。这个合并视图在处理“某个时间点既有人改了配置基站又重启了”的争议场景时价值很大直接用时间线判断先后顺序。4.3 合并视图与Cloud RAN日志ESI日志Enhanced System Integration是新一代基站的硬件与软件集成日志Cloud RAN场景下CU和DU分离故障定位时常需要拉多份日志对照。lgk -x hw lgkm -x swmi,erl lgk -x comal lgk -x pnplgk -x hw输出ESI硬件日志lgkm -x swmi,erl打印SWMI软件管理集成日志和Erlang日志并合并lgk -x comal取COM告警日志lgk -x pnp取即插即用日志。Cloud RAN节点上CU侧集中了控制面功能DU侧负责基带处理跨节点问题比如F1接口建立失败往往需要在两端分别抓取lgz和lgk输出再做关联分析。5. 离线分析不连网也能把dcgm里的配置与日志调出来5.1 把采集包当节点连现场基站退服或无法远程登入时最有效的排查方式是用采集工具导出dcgm压缩包回到办公环境后用moshell离线模式直接打开。moshell会把zip包里的MO描述文件、PM数据、日志文件组织成一个可查询的“虚拟节点”所有MO检索、配置读取和日志命令都能正常工作。moshell /path/to/C77A02X_230922_100150_EDT_MSRBS-LN_CXP9024418-15_R74F31_esidec_dcgm.zip路径以实际导出的zip文件名为准。连入后先执行lt all和pv mom确认当前的MO实例数量和MOM版本再根据故障现象选择对应的日志命令继续挖。提示离线模式是只读的bl、set、cr、del这类变更操作不可用但MOM检索、配置对比、日志查询、PM取值全部支持。5.2 离线包里的高频用法离线包最有价值的用法是配置漂移对比。现场改过参数但没记录变更人时用MO命令日志回放整个操作过程。lgo | grep -i ,eutrancell | grep -i administrativestate这条命令过滤EUtranCell上所有administrativeState相关操作每一行输出会带有完整的时间戳。配合lgovm -m 10把变更操作和节点告警合并到一条时间线就能判断“先改配置后出告警”还是“先出告警后改配置”。多个dcgm包之间做差异对比时用pr的diff模式pr ^eutrancellfdd diff proxy1 proxy2 proxy3proxy可以来自两个不同的离线包moshell跨包对比时会自动读取各自的MOM描述和属性值输出差异行。这种对比在补丁版本升级前的健康检查中很好用快速确认现网配置和基线配置之间的所有偏移点。对于Cloud RAN节点离线包同样适用。CU和DU的zip包分别加载后先用momtl确认对象树层级再用lgk -x swmi,erl拉软件集成和Erlang日志F1接口建立失败这类跨节点问题基本都能从这两份日志里找到根因。处理完一轮后把离线包存档时建议在文件名后追加采集时间和站点名方便后续重建现场时直接索引。本文还有配套的精品资源点击获取