简介这份PPT面向从事爱立信网络运维的工程师与网优人员系统梳理Moshell/AMOS命令行工具在CPP节点操作维护中的常用指令。内容涵盖工具介绍、AMOS登录与应用、基本指令及注意事项四大板块涉及WCDMA、LTE、NR等多制式网元并延伸至登录站点、查询小区状态与告警、修改带宽功率、闭解操作、邻区查询、硬件光衰与License查询、NR与反开AAS_TDD共模参数、干扰查询及批量操作等实战场景。资源包共1个pptx文件约3.21MB以图文幻灯片形式呈现便于按章节查阅与培训讲解。目前已有335人学习下载适合需要快速上手Moshell/AMOS指令、对照排查基站问题或整理培训材料的读者参考。1. 5G基站维护绕不开的Moshell从一条指令到一次排障手里同时开着AMOS和Moshell两个终端窗口这大概是每个5G基站维护工程师的日常。Moshell是爱立信网元管理体系中一个基于命令行的操作维护工具它通过MO模型Managed Object对基站进行参数查询、配置修改和状态监控。相比图形化的AMOS界面Moshell在批量操作、脚本自动化和远程应急排障场景下效率高出一个量级——尤其是当你需要在一个晚上完成几十个基站的参数核查时敲一条st命令远比在AMOS里逐个点开节点快得多。这篇文章面向的是刚接触5G基站维护、或者从4G时代转过来发现指令体系变了的工程师。我会把Moshell在5G场景下最常用的操作指令按实际工作流拆开讲怎么连上基站、怎么查小区状态、怎么改参数、怎么批量执行脚本以及那些让我翻过车的参数陷阱。每条指令都给出完整的执行上下文和参数说明你照着敲就能复现。2. Moshell环境搭建与5G基站连接从安装到首次登录2.1 Moshell的获取与Java环境依赖Moshell本身是一个Java应用核心是一个jar包加上若干脚本文件。常见做法是从爱立信官方渠道获取对应版本的Moshell压缩包解压到本地目录即可不需要安装程序。但这里有个容易翻车的点Moshell对Java版本有要求5G基站常用的Moshell版本一般需要JDK 8或JDK 11版本不匹配时启动会直接报UnsupportedClassVersionError。我一般会在Linux跳板机上统一部署Moshell因为跳板机到基站的网络路径最稳定。部署步骤大致如下# 创建Moshell工作目录 mkdir -p /opt/moshell cd /opt/moshell # 解压Moshell包假设已上传 tar -xzf moshell_xxx.tar.gz # 确认Java版本 java -version # 如果系统默认Java版本过高需要指定JDK路径 export JAVA_HOME/usr/lib/jvm/java-11-openjdk export PATH$JAVA_HOME/bin:$PATH # 设置Moshell环境变量 export MOSHELL_HOME/opt/moshell export PATH$MOSHELL_HOME:$PATH环境变量配置完成后执行moshell命令应该能看到版本信息和命令提示符。如果提示找不到命令检查PATH是否包含Moshell目录以及脚本文件是否有可执行权限chmod x。注意不同版本的Moshell对Java版本要求不同部署前先确认版本兼容性。我遇到过用JDK 17启动旧版Moshell直接崩溃的情况换回JDK 11后正常。2.2 连接5G基站的三种方式与登录指令Moshell连接基站主要有三种方式通过IP直连、通过网元名称连接、通过脚本批量连接。日常单站操作最常用的是IP直连# 基本连接语法 moshell 基站IP或主机名 # 示例连接一个gNB基站 moshell 192.168.1.100 # 指定端口默认22 moshell 192.168.1.100 22 # 使用特定用户名登录 moshell -u admin 192.168.1.100连接成功后命令提示符会变成类似192.168.1.100的格式表示当前已登录到该网元。此时所有Moshell指令都作用于这个基站。对于需要同时操作多个基站的场景可以用Moshell的批量模式# 创建一个基站列表文件 cat /tmp/enb_list.txt EOF 192.168.1.100 192.168.1.101 192.168.1.102 EOF # 批量连接并执行指令 moshell -f /tmp/enb_list.txt -c st cell-f参数指定基站列表文件-c参数指定要执行的指令。这个组合在批量核查参数时非常实用比如一次性检查所有基站的小区状态。2.3 登录后的第一组指令确认网元状态连上基站后不要急着改参数。我习惯先跑三条指令确认网元基本状态# 查看网元整体状态 st # 查看所有小区状态 st cell # 查看基站软件版本 st swst是Moshell中最基础的查询指令全称是status。单独执行st会列出当前网元下所有MO类的概要信息。st cell则专门查询小区相关MO的状态输出中会显示每个小区的管理状态Locked/Unlocked和运行状态。这里有个细节5G基站的小区MO路径和4G不同。4G时代常用EUtranCellFDD或EUtranCellTDD5G则对应NRCellDU和NRCellCU。如果你从4G转过来用老路径查5G小区会直接报错找不到MO。# 5G小区查询的正确路径 st NRCellDU st NRCellCU # 查看特定小区的详细参数 st NRCellDUCell1NRCellDU代表5G基带单元侧的小区对象NRCellCU代表中央单元侧的小区对象。在独立组网SA架构下这两个MO都需要关注。NSA架构下则还要看EUtranCellFDD锚点小区。3. 5G Moshell常用指令分类实操查询、修改与批量脚本3.1 查询类指令lt、st、get的用法与区别Moshell的查询指令主要有三个lt、st和get。很多人分不清它们的区别我刚开始也经常混用。简单说ltlist列出指定MO类下的所有实例不显示参数值ststatus显示指定MO实例的状态和关键参数get获取指定MO实例的特定参数值# 列出所有NRCellDU实例 lt NRCellDU # 查看Cell1的状态 st NRCellDUCell1 # 获取Cell1的特定参数 get NRCellDUCell1 administrativeState get NRCellDUCell1 cellLocalIdget指令在需要精确提取某个参数值时特别有用比如写脚本批量采集PCI时# 批量获取所有小区的PCI for cell in $(lt NRCellDU | grep NRCellDU); do pci$(get $cell physicalCellId 2/dev/null) echo $cell PCI$pci done这段脚本的逻辑是先用lt NRCellDU列出所有小区实例然后逐个用get提取physicalCellId参数。2/dev/null是为了屏蔽某些小区查询失败时的错误输出。参数说明physicalCellId是5G小区的物理小区标识取值范围0-1007。这个参数在PCI规划时是关键输入PCI冲突会导致小区间干扰。3.2 修改类指令set、setmo、acc的正确姿势修改参数是Moshell操作中风险最高的部分。一条错误的set指令可能导致小区退服。我一般遵循“先查后改、改前备份”的原则。# 查看当前值 get NRCellDUCell1 administrativeState # 修改参数将小区解锁 set NRCellDUCell1 administrativeState 1 # 批量修改多个参数 setmo NRCellDUCell1 administrativeState 1 cellReservedForOperatorUse 0set和setmo的区别在于set一次修改一个参数setmo可以一次修改同一个MO下的多个参数。setmo的效率更高但也更容易因为参数写错而翻车。acc指令用于执行MO上的动作action比如小区复位# 复位Cell1 acc NRCellDUCell1 reset注意acc执行的动作通常是不可逆的执行前确认小区没有承载业务。我在夜间窗口执行acc reset时都会先确认该小区下的用户数已经归零。修改参数后需要用st确认修改是否生效# 确认修改结果 st NRCellDUCell1如果修改后状态没有变化可能是参数需要特定条件才能生效或者该参数是只读的。Moshell不会对所有参数修改都给出明确报错有些参数修改会被静默忽略这是最坑的地方。3.3 批量脚本与CVS文件操作一次改100个基站单个基站操作熟练后真正的效率提升来自批量脚本。Moshell支持通过CVSCommand Via Script文件批量下发指令。# 创建一个CVS脚本文件 cat /tmp/batch_modify.cvs EOF # 批量修改小区功率 set NRCellDUCell1 configuredMaxTxPower 430 set NRCellDUCell2 configuredMaxTxPower 430 set NRCellDUCell3 configuredMaxTxPower 430 EOF # 在单个基站上执行CVS脚本 moshell 192.168.1.100 -c cvs /tmp/batch_modify.cvs # 在多个基站上批量执行 moshell -f /tmp/enb_list.txt -c cvs /tmp/batch_modify.cvsconfiguredMaxTxPower是小区最大发射功率单位是0.1dBm。430对应43dBm即20W。这个参数在覆盖优化时经常需要调整但要注意不能超过基站的硬件能力上限。CVS脚本的一个关键优势是支持变量和条件判断# 带变量的CVS脚本 cat /tmp/conditional_modify.cvs EOF # 获取当前功率 get NRCellDUCell1 configuredMaxTxPower # 如果功率低于400则设置为430 if $lastResult 400 set NRCellDUCell1 configuredMaxTxPower 430 end EOF$lastResult是Moshell内置变量保存上一条指令的返回值。这个机制让CVS脚本可以实现简单的逻辑控制。批量操作最大的坑是脚本执行到一半失败时前面已经执行的修改不会自动回滚。所以我在执行批量修改前一定会先用st或get把原始值导出备份# 导出当前配置作为备份 moshell -f /tmp/enb_list.txt -c st NRCellDU /tmp/backup_$(date %Y%m%d).txt这个备份文件在出问题时就是后悔药。虽然恢复需要手动操作但至少知道原始值是什么。4. 5G Moshell排障避坑那些让我半夜爬起来处理的坑4.1 连接超时与认证失败现象、原因与解决现象执行moshell 192.168.1.100后卡在Connecting...几分钟后报Connection timed out。原因最常见的是网络不通或防火墙拦截。5G基站的管理面通常走独立VLAN如果跳板机的路由表没有指向该VLAN的条目就会超时。另一个原因是基站的安全策略限制了源IP。解决先用ping确认基础连通性再用telnet 192.168.1.100 22确认SSH端口是否开放。如果端口不通检查中间防火墙策略。如果端口通但Moshell连不上检查Moshell使用的协议版本是否与基站匹配。4.2 参数修改不生效MO路径写对了但值没变现象set NRCellDUCell1 configuredMaxTxPower 430执行后没有报错但get查询发现值还是原来的。原因5G基站的参数生效机制比4G复杂。部分参数修改后需要执行特定动作才能生效比如acc NRCellDUCell1 reset。还有些参数是“协商类”参数实际生效值取决于多个MO的联合配置。解决修改后先执行st NRCellDUCell1查看完整状态确认参数是否在“pending”状态。如果是执行对应的acc动作触发生效。如果st输出中该参数根本没变化说明这个参数在当前软件版本下可能是只读的需要查对应版本的MO模型文档确认。4.3 批量脚本执行中断一半基站改了另一半没改现象用moshell -f enb_list.txt -c cvs batch.cvs批量执行时中间某个基站连接失败后续基站全部跳过。原因Moshell默认在遇到第一个错误时停止执行。这个行为在单站操作时是保护机制但在批量场景下会导致“部分成功”的尴尬状态。解决在CVS脚本开头加上on error continue指令让Moshell在遇到错误时继续执行后续基站。同时把执行日志完整保存下来事后根据日志逐站核查。# 带错误继续的批量执行 moshell -f /tmp/enb_list.txt -c on error continue; cvs /tmp/batch.cvs 21 | tee /tmp/batch_log_$(date %Y%m%d_%H%M).txt4.4 小区状态异常Unlocked但业务不通现象st NRCellDUCell1显示administrativeState为UnlockedoperationalState为Enabled但UE无法接入。原因小区状态正常但业务不通问题通常不在小区MO本身而在传输层或核心网侧。常见原因包括NG接口未建立、SCTP链路断、或者AMF侧没有该基站的注册信息。解决用st查看传输相关MO重点检查GNBDUFunction下的NG连接状态。如果NG接口异常需要检查基站到AMF的IP路径和SCTP端口配置。# 检查NG接口状态 st GNBDUFunction1 st NG14.5 Moshell版本与基站软件版本不匹配现象连接基站后执行某些指令报Unknown command或MO class not found。原因Moshell的MO模型定义需要与基站软件版本匹配。用旧版Moshell连接新版基站时新增的MO类无法识别。解决确认基站软件版本st sw然后获取对应版本的Moshell。如果暂时无法升级Moshell可以尝试用lt列出所有可用MO类找到实际存在的类名后再操作。5. 用CVS脚本做5G参数批量核查一个可复用的模板批量核查是Moshell最有价值的应用场景之一。我把自己常用的核查脚本整理成一个模板你可以直接改成自己需要的参数。#!/bin/bash # 5G基站参数批量核查脚本 # 用法./audit.sh enb_list.txt ENB_LIST$1 DATE$(date %Y%m%d_%H%M) OUTPUT_DIR/tmp/audit_${DATE} mkdir -p $OUTPUT_DIR # 定义要核查的参数 cat /tmp/audit.cvs EOF # 小区基础信息 st NRCellDU # PCI核查 get NRCellDUCell1 physicalCellId get NRCellDUCell2 physicalCellId get NRCellDUCell3 physicalCellId # 功率核查 get NRCellDUCell1 configuredMaxTxPower get NRCellDUCell2 configuredMaxTxPower get NRCellDUCell3 configuredMaxTxPower # 状态核查 get NRCellDUCell1 administrativeState get NRCellDUCell2 administrativeState get NRCellDUCell3 administrativeState EOF # 逐站执行并保存结果 while read enb; do echo Auditing $enb ... moshell $enb -c cvs /tmp/audit.cvs ${OUTPUT_DIR}/${enb}.txt 21 done $ENB_LIST echo Audit complete. Results in ${OUTPUT_DIR}这个脚本的逻辑是读取基站列表对每个基站执行预定义的CVS核查脚本结果按基站IP分别保存。执行完成后你可以用grep快速筛选异常项# 查找所有PCI冲突的小区 grep -h physicalCellId ${OUTPUT_DIR}/*.txt | sort -k3 -n | uniq -f2 -D # 查找所有功率异常的小区低于400 grep -h configuredMaxTxPower ${OUTPUT_DIR}/*.txt | awk $3 400 {print}参数说明uniq -f2 -D表示跳过前两个字段后查找重复行用于发现PCI冲突。awk $3 400筛选功率值低于400的条目。这个模板的价值在于可复用。你只需要修改/tmp/audit.cvs中的参数列表就能适配不同的核查任务。我一般会在月初做一次全量核查把结果存档月底再跑一次做对比这样能发现参数被意外修改的情况。最后说一个血泪教训永远不要在生产基站上直接测试不熟悉的指令。我刚开始用Moshell时在一个忙时基站上执行了一条acc指令结果小区直接复位周边用户投诉电话立刻打到了值班室。从那以后我养成了一个习惯——任何set或acc指令先在实验室基站上跑一遍确认行为符合预期后再上生产。希望这个习惯也能帮到你。本文还有配套的精品资源点击获取