简介面向5G网络运维与优化人员的《5G_Moshell常用操作指令介绍》PPT课件系统梳理了爱立信Moshell/AMOS命令行工具在5G基站及网元日常操作中的核心指令与典型应用场景。资源包为单个PPT演示文稿整体大小约3.21MB内容结构清晰既适合团队集中培训也方便个人对照学习。目前已有334人学习下载。课件从Moshell/AMOS基本概念入手介绍四种操作模式与登录方式重点讲解lt、get、st、al、lg等常用指令的具体用途并结合登录站点、查询小区状态及告警、修改基站参数、闭解操作、带宽与功率调整、邻区查询、硬件状态及光衰查询、用户数查询、License Feature与常量查询、NR与反开AAS_TDD共模参数查看等实际维护场景展开能够帮助读者快速建立5G设备操作维护的知识框架提升日常巡检、排障与批量操作效率。1. 5G 维护绕不开 Moshell但你不是非要背命令做 5G 基站维护的人多多少少都听过 Moshell 这个名字。它是爱立信 OSS 里那套带着提示符的命令行工具靠一套和网元直连的交互方式完成告警查询、参数修改、邻区配置和信令跟踪。很多刚从 4G 转过来的工程师第一反应是找图形界面点鼠标真到了批量修改 5G 邻区、核查 Preamble 格式、定位 T304 超时这类场景才会发现命令行反而更快——一条cmedit指令能抵得上在 GUI 里翻七八层菜单。这篇东西会围绕 5G 场景整理一套可直接用的 Moshell 指令从登录环境开始到参数查询、邻区配置、信令跟踪最后收在脚本化输出解析上。你不一定每条都背但至少要知道查告警、改参数、看性能时该敲什么、参数怎么填、报错怎么看。内容按先能连上、再会查、然后会改、最后能排障的顺序推进适合刚接触 5G 基站维护的网优和运维工程师也适合想把手动操作固化成脚本的老手。2. 从登录到查告警5G 基站运维的 Moshell 基础指令集2.1 建立会话Moshell 的连接方式和登录参数Moshell 本身不是一个独立安装的软件它运行在爱立信 OSS 的服务器上。常见的接入方式是先通过 SSH 登录 OSS 主机再在 shell 里输入moshell唤起命令行环境。这个环境启动后你会看到moshell这样的提示符然后就可以用指令和网元建立会话了。登录后的第一步一般是确认自己能访问哪些网元。lt all是列出当前 OSS 域下所有网元的常用指令。moshell lt all这个指令会返回一个网元列表每一行包含网元的 ID、类型和状态。5G 基站通常是带有5G或NR标识的节点看到状态是Connected或Standby就说明 OSS 到网元的链路是通的。如果某个网元显示No contact那就没必要往下查业务数据了先解决传输或供电问题。接下来连接具体网元。Moshell 支持一条指令直达目标网元也可以在会话内切换目标。moshell con 网元IDcon是 connect 的简写后面跟网元 ID。连接成功后提示符会变成网元ID这时候你执行的指令就是直接打到那台 5G 基站上的。我个人习惯在脚本里直接写moshell 网元ID -c 指令这样可以跳过手动交互适合批量操作。2.1.1 连接指令的几个常用变体# 直接在命令行执行单条指令适合脚本调用 moshell 网元ID -c lt all # 连接后自动执行多条指令指令之间用分号分隔 moshell 网元ID -c lt all; alw ls-c参数让 Moshell 在非交互模式下执行指令执行完就退出。批量巡检、定时脚本基本都是这种写法。注意指令里如果包含特殊字符外层用双引号包住准没错尤其是后面要讲的cmedit参数过滤条件。2.2 5G 基站告警查询alw ls 的输出解读告警是维护 5G 基站的第一道防线。Moshell 里查告警的核心指令是alw ls它会列出网元当前所有活动告警。moshell alw ls输出一般包含告警 ID、严重级别Critical / Major / Minor / Warning、告警产生时间、告警来源对象以及一段描述文本。5G 场景里最常见的告警集中在小区状态异常、SYNC 丢失、传输断链这几类。关键是要会过滤。一个 5G 基站挂了几十个小区全量输出往往有上千行。我一般先按级别筛moshell alw ls -s critical moshell alw ls -s major -l-s指定严重级别-l是长格式输出会附带更多字段比如具体的 MO 对象路径。这个路径很重要因为后面定位问题、查参数都要靠它定位到具体的对象实例。2.2.1 告警时间、确认和清除操作# 查看最近 2 小时的告警 moshell alw ls -t 2H # 确认某条告警 moshell alw ac 告警序列号 # 清除已恢复的告警 moshell alw clr 告警序列号-t 2H是我常用的时间过滤方式2H表示从现在往前推 2 小时。告警序列号是alw ls输出里第一列的编号。确认告警是 Operation 侧的动作清除则一般只在根因已处理、告警未自动消失时才用日常不建议乱敲。2.3 小区状态怎么查cmedit 和 lst 的配合告警告诉你哪里有问题但要确认 5G 小区是否真的在服务状态需要用对象查询指令。Moshell 里最基础的对象查询是lst它按对象类列出配置实例。moshell lst EUtranCellFDD4G 小区用EUtranCellFDD5G 小区则用NRCell开头的一类对象。要看 5G 小区的状态通常会查NRCell以及它的子对象。moshell lst NRCell输出会列出小区名和关键配置但状态不一定直接显示。更常用的方式是走cmeditmoshell cmedit get NRCell 小区名 cellState2.3.1 cmedit 的输出格式和状态含义cmedit get后面依次是对象类、对象实例、参数名。返回结果一般长这样NRCell5G_CELL_001 cellState enabledcellState有enabled、disabled、locked几种取值。enabled只是说小区在配置层面激活了不代表射频通道正常工作真要判断业务是否可用还得配合alw ls和后面的性能统计来看。3. 5G 参数查询与邻区配置cmedit 的实操指令组合3.1 用 cmedit get 精确读取 5G 基站的参数清单cmedit get是整个 Moshell 指令体系里出镜率最高的命令。它的完整语法是moshell cmedit get 对象类 对象实例 参数1 参数2 ...对象实例可以写具体名字也可以写通配符。想把一个 5G 小区的波束配置、随机接入参数、定时器全部拉出来可以这样moshell cmedit get NRCell 5G_CELL_001 * -f*表示取所有参数-f表示全格式输出不要折叠长字段。这个指令会打出几十个参数项信息量很大适合做配置备份或者变更前快照。如果你只需要某几个参数就显式列出来输出更清爽moshell cmedit get NRCell 5G_CELL_001 cellState cellId physicalCellId nRTCI参数之间用空格分隔输出的顺序和指令里写的顺序一致。这里cellId是小区 IDphysicalCellId是 PCInRTCI是 NR 小区在网管侧的全局标识。查完一轮基本能确认这个小区的基础身份信息是否和规划一致。3.2 邻区配置从 add 外部邻区到创建 NRRelation5G 邻区配置是 Moshell 实操里最常被问到的一块。它的思路和 4G 一致先定义外部邻区ExternalNRCell再在服务小区上添加邻区关系NRRelation。很多新手只创建了 NRRelation忘了配 ExternalNRCell结果邻区显示添加成功切换却起不来。先看外部邻区的添加。5G 的外部邻区对象类叫ExternalNRCell它的关键参数包括邻区的 NR Cell ID、PCI、频点、TAC 等。moshell cmedit add ExternalNRCell ExternalNRCell_5G_NEI_001 \ mcc460 mnc00 eci12345678 \ physicalCellId345 nrCellId0x123456 \ dlArfcn632448mcc和mnc是运营商标识eci是邻区的小区标识在 5G 里一般是 28 bit 的 NR Cell IdentityphysicalCellId是邻区的 PCIdlArfcn是邻区的 SSB 频点。这些值必须在邻区那个站点的实际配置里核对过不能拿规划值直接填。3.2.1 NRRelation 的添加和参数校验外部邻区创建好之后再到服务小区上添加邻区关系。对象类是NRRelation实例名一般写成服务小区.邻区标识的格式。moshell cmedit add NRRelation NRRelation_5G_CELL_001_ExternalNRCell_5G_NEI_001 \ bCCH632448 mcc460 mnc00 \ nrCellId0x123456 noHofalse noRemovefalsebCCH是邻区的频点nrCellId要和外部邻区定义里一致noHo控制是否允许切换。noHofalse表示允许切换到该邻区noRemovefalse表示该邻区不允许被自动删除。这两个参数是排查邻区存在但切换失败问题时的重点检查项。添加完成后建议马上验证moshell cmedit get NRRelation NRRelation_5G_CELL_001_ExternalNRCell_5G_NEI_001输出里能看到邻区关系的完整配置。如果noHo显示为true切换肯定不触发别急着查切换参数先把这行改掉。3.3 Preamble 格式和 T304 定时器5G 随机接入的 Moshell 相关参数热词里有5g preamble序列格式中长格式有多少种和5g t304定时器这两个点正好都能在 Moshell 里查到。Preamble 格式定义在随机接入相关的对象里5G 的中长 Preamble 格式一共有 A1、A2、A3、B1、B2、B3、B4、C0、C1、C2 这十种另有短格式其中 B4 是常用的中长格式之一。具体用哪种由小区的 PRACH 配置决定。在 Moshell 里查当前小区的 Preamble 配置走的是NRCell关联的 PRACH 对象。常见对象类是NRPr achConfig不同产品版本命名可能有差异可以这样定位moshell lst NRPr achConfig moshell cmedit get NRPr achConfig 实例名 prachConfigurationIndex prachFreqOffsetprachConfigurationIndex决定了前导码格式和时频位置prachFreqOffset决定 PRACH 在频域上的起点。输出后对照规划表检查即可。如果发现格式和邻区不匹配终端在初始接入时会频繁重试表现为 RSRP 正常但接入失败。T304 定时器是切换过程中等待随机接入完成的计时器超时后 UE 会判定切换失败并回退到源小区。这个参数在 5G 里挂在移动性配置下Moshell 查询方式moshell cmedit get NRCell 5G_CELL_001 t304t304的单位是毫秒典型配置是 1000ms 或 2000ms。高速移动场景比如车联网建议调大但调太大会让切换失败后的回退变慢需要权衡。排查切换问题时先确认源小区和目标小区的t304配置是否在合理范围再看邻区关系和 PCI 混淆别一上来就改定时器。4. 5G 全网排障实战把 Moshell 指令串成一套排查流程4.1 从性能统计反查问题dud 和 perf 的查询指令5G 基站排障光看告警和参数配置是不够的必须结合 KPI 指标来定位。Moshell 里查性能统计的指令是dud或perf它们的区别是dud直接查询测量定义和结果perf则偏向实时采样的展示。实际工作中我一般先用dud查到测量对象确认指标命名再拉具体数据。moshell dud -i 网元ID -o PMRCNCell -m 测量名-i指定网元-o指定对象类-m指定测量名。5G 小区的测量集合里常用的是PMRCNCellRRC 连接管理相关的测量。查询出来的数据会按时间片列出 RRC 建立成功率、切换成功率等关键 KPI。如果你只想快速确认某个小区是否有切入切出失败的集中爆发可以用下面的方式过滤moshell dud -i 网元ID -o PMRCNCell -f periodStartTime 当前日期 00:00:00-f是过滤条件periodStartTime是时间戳字段。这个命令适合每天早上的例行巡检把前一天的指标拉出来配合告警清单一起看基本能覆盖一半以上的故障场景。4.2 信令跟踪4G 到 5G 切换失败时查什么信令跟踪在 Moshell 里不是靠一条指令完成的而是通过查看网元上的 trace 记录实现。5G 基站一般支持对指定 UE 或指定小区做信令跟踪常见的对象类是TraceSession或NRCellTrace。moshell lst TraceSession moshell cmedit get TraceSession 实例名 traceReference traceStatuslst先看有没有现成的跟踪会话traceReference是跟踪参考号traceStatus表示跟踪是否激活。如果跟踪会话已经存在且激活可以直接读取跟踪文件如果没有就需要创建新的跟踪会话但创建方式依赖具体的 OSS 版本没有统一语法需要查对应版本的产品文档。一个更实用的替代方案是用alw的输出结合切换相关参数做静态排查。比如当 NR 邻区的nRTCI配置错误或者目标小区的t304设置过短信令跟踪里能看到 UE 反复发起 RACH 但始终无法完成。这时候在 Moshell 里快速比对两个小区的配置比抓完整信令更快。4.2.1 利用 lh 命令查看历史指令记录lh是 Moshell 的本地历史记录指令它会列出当前用户在这个 OSS 上执行过的操作指令。这个指令在排障时非常有用——你可以回溯上一个工程师对这个 5G 基站做了什么变更。moshell lh -l 50-l 50表示显示最近 50 条指令。执行记录里会包含时间戳和指令原文。比如看到某个时刻有人执行了cmedit set NRRelation ... noHotrue那切换失败的根因基本就找到了。这是很多人忽略的指令但排查昨天还好好的今天不行了这类问题时它往往是最快的突破口。4.3 4G/5G 互操作参数核查一条 cmedit 搞定5G 网络目前大多是非独立组网NSA4G 和 5G 之间的互操作参数对用户体验影响巨大。Moshell 里核查这些参数主要落在 LTE 侧的邻区关系和 5G 侧的测量配置上。在 LTE 侧需要确认有没有把 5G NR 小区配成 LTE 的邻区。对象类是EUtranCellFDD关联的EUtranRelation但 NSA 场景更常见的是查看NRMeasConfig相关的配置对象。moshell cmedit get EUtranCellFDD LTE小区名 nrMeasConfig如果输出为空或者显示未配置说明这个 LTE 小区没有配置 NR 测量终端在 4G 网络下永远不会上报 5G 测量结果自然也不会触发添加 5G 载波。这种情况下用户手机显示 5G但实际流量全部走 4G用户感知就是假 5G。核查完测量配置再确认 LTE 到 NR 的邻区关系是否存在moshell lst EUtranRelation moshell cmedit get EUtranRelation 实例名 nrCellId bCCHnrCellId是目标 5G 小区的 IDbCCH是 5G 的 SSB 频点。这两个值和 5G 侧ExternalNRCell里的配置必须完全一致任何一个字段不匹配都会导致切换失败。用cmedit get把两侧配置拉出来并排比对比在 GUI 里一个个点开查看要快得多。4.4 告警和指标联动先看故障树再下结论排障最忌讳拿到一个 KPI 就猜原因。我自己的习惯是先按下面的顺序走完一遍再考虑要不要动参数用alw ls -s critical找关键告警CPRI/光模块告警优先处理。用dud拉 15 分钟粒度的 KPI看是长期劣化还是突发掉坑。用lst NRCell确认 5G 小区状态排除配置被意外修改的可能。用cmedit get比对邻区关系和随机接入参数排除 4G/5G 互操作配置问题。这套流程做完80% 以上的 5G 小区问题能定位到具体原因。剩下的 20%大概率需要抓空口信令或者查传输侧丢包那就不是 Moshell 能覆盖的范畴了别再浪费时间在网管上翻来翻去直接转给传输和射频团队。5. 把 Moshell 指令固化成脚本5G 批量查询的自动化和输出解析技巧5.1 用 shell 循环批量执行 Moshell 指令日常维护中经常遇到一种场景需要批量修改同批次 5G 基站的某个参数比如统一调整 T304 定时器。手动一台台con进去执行10 个站能花掉一下午。更好的方式是把 Moshell 嵌入到 shell 脚本里批量跑。#!/bin/bash # 批量检查 5G 基站的 T304 定时器配置 SITES5G_SITE_001 5G_SITE_002 5G_SITE_003 for site in $SITES; do echo Checking $site moshell $site -c cmedit get NRCell 5G_CELL_001 t304 21 done这段脚本的核心是利用 Moshell 的-c参数在非交互模式下执行单条指令。21把标准错误也重定向到同一个输出流这样即使某个站点连接失败也能在终端上看到报错而不是静默丢数据。执行结果会包含每个站点的 T304 配置值直接人工检查或者加grep过滤出来都行。如果要对配置不一致的站点做修改只需要把指令从get换成set但要注意set的参数格式会因对象类而异建议先在单站测试通过。5.2 输出解析让脚本自动识别异常配置终端输出是一堆文本靠眼睛一行行看终究不靠谱。更实用的做法是把 Moshell 的输出导向文件再用 awk 或 grep 提取关键字段。#!/bin/bash # 批量输出邻区状态并筛选 noHotrue 的异常配置 SITES5G_SITE_001 5G_SITE_002 for site in $SITES; do moshell $site -c cmedit get NRRelation * noHo 21 | \ tee ${site}_nrrelation.txt | \ awk /noHo/ {if ($NF true) print $site:, $0} done这个脚本的思路是把cmedit get的输出通过管道传给awk。awk会逐行扫描凡是参数名noHo且最后一个字段是true的行就加上站点名打印出来。这样你在终端上看到的就只是有问题的站点和邻区不用在几百行输出里找差异。tee命令把原始输出同时存到文件里方便留档和做变更前对比。实际生产中我会用date %Y%m%d%H%M生成带时间戳的文件名避免同名覆盖。5.3 脚本执行的几个安全习惯用脚本批量操作 Moshell 前有几个习惯必须养成。先用get验证后再用set修改。任何批量修改指令先跑一遍get把当前配置存到文件里。这个文件就是变更前的基线。执行完变更后再跑一遍get并 diff 两次输出能直观看到哪些站点没改成功。# 变更后对比配置 for site in $SITES; do moshell $site -c cmedit get NRRelation * noHo ${site}_after.txt diff ${site}_before.txt ${site}_after.txt echo $site 配置一致 donediff如果输出为空说明变更前后没有差异要么是配置没提交要么是指令执行失败。这个验证步骤看起来简单但在批量操作时能省掉后续一整轮的排查。修改指令写日志避免误操作。lh指令只能在本机看历史如果有多个人在维护同一个 5G 基站最好在自己的脚本里显式记录执行人和指令内容。常见做法是echo $(date) $USER $site $cmd change_log.txt留一份自己维护的变更日志出问题时能快速回溯是谁在什么时间执行过什么操作。5.4 顺带一提的辅助指令有几个指令在自动化场景里特别好用它们不需要con连接网元直接基于 OSS 侧执行。# 查看 OSS 上的当前用户权限 moshell whoami # 列出当前会话连接的网元 moshell lt这两个指令适合写进脚本开头用来确认当前账号权限是否足够执行后续的修改操作。权限不足时cmedit set一般会返回登录失败或没有权限相关的报错看到这类信息时第一时间检查账号角色而不是怀疑自己的指令语法。另外一个值得提的是alw ls的非交互输出格式。在脚本里加-x参数可以让输出变成易于解析的纯文本格式不带分页符和交互提示配合 awk 提取告警级别和对象路径非常稳定。不过-x的具体行为在不同 OSS 版本上有差异建议先手动跑一次对比格式差异后再写脚本。写脚本这件事核心不是追求语法花哨而是让每一次配置变更都能被记录、被比对、可回滚。能达到这个标准Moshell 在你的 5G 日常维护里就不是拦路虎而是比 GUI 更趁手的工具。本文还有配套的精品资源点击获取