NetRing 系列命令行手册.docx

1、NetRing 系列命令行手册NetRing 系列命令行手册第一章 系统介绍 NetRing 600结构 NetRing 2500 结构 NetRing 10000第二章 配置概述 CLI环境 命令树结构 通用类型介绍 事务机制第三章 数据库第四章 网元属性第五章 单板配置第六章 业务配置 业务创建 业务删除 配置业务查询 配置生效业务查询 以太网业务配置第七章 保护配置 SNCP配置 MSP配置第八章 时钟配置第九章 ECC配置第十章 公务配置第十一章 维护命令 告警 性能 黑匣子 单板命令附录.A 典型的PP保护配置附录.B 典型的二纤复用段段环附录.C 以太网业务配置附录.D ECC配置

2、指导附录.E 告警规格整理附录.F 性能规格整理第一章 系统介绍NetRing 600结构风扇PWR-AIU2-扩展板PWR-BIU1-系统板 NetRing 600中光口板，电口板，以太网板都在IU1和IU2上，在逻辑上板位划分如下：1.系统板上的时钟板的板位为12.系统板上的光口板的板位为33.系统板上的电口板的板位为44.扩展板上的电口板的板位为55.扩展板上的光口板的板位为66.扩展板上的以太网板的板位为7NetRing 2500 结构IU1IU2风扇IU3IU4IU5IU6IU7IU8IU9IU10NetRing 2500 支持的单板类型单板规格合法槽位安装属性OAMP主控/公务/电

3、源/时钟板IU1-IU2自动安装SEXT扩展子架连接板IU9/IU10手工安装EGEF022口千兆以太网板IU3/IU4/IU5/IU6/IU7/IU8/IU9/IU10手工安装S01F01单光口STM-1板IU3/IU4/IU5/IU6/IU7/IU8/IU9/IU10手工安装S01F02双光口STM-1板IU3/IU4/IU5/IU6/IU7/IU8/IU9/IU10手工安装S01F04四光口STM-1板IU3/IU4/IU5/IU6/IU7/IU8/IU9/IU10手工安装S04F01单光口STM-4板IU3/IU4/IU5/IU6/IU7/IU8/IU9/IU10手工安装S04F02双

4、光口STM-4板IU3/IU4/IU5/IU6/IU7/IU8/IU9/IU10手工安装S04F04四光口STM-4板IU3/IU4/IU5/IU6/IU7/IU8/IU9/IU10手工安装S16F01单光口STM-16板IU3/IU4/IU5/IU6/IU7/IU8/IU9/IU10手工安装EFET088口10/100M兆以太网板IU3/IU4/IU5/IU6/IU7/IU8/IU9/IU10手工安装PE1T2121口E1处理板IU3/IU4/IU5/IU6/IU7/IU8/IU9/IU10手工安装NetRing 10000OAMP1SAIU风扇OAMP2RESVIU1IU2IU3IU4IU

5、5XMC1XMC2XMC3IU6IU7IU8IU9IU10PDC1PDC3PDC5PIU1PDC2PDC4PDC6PIU2NetRing 10000 支持的单板类型单板规格合法槽位安装属性OAMP主控/电源/时钟板OAMP1/OAMP2自动安装EGEF044口千兆以太网板IU1-IU10手工安装S01F01单光口STM-1板IU1-IU10手工安装S01F02双光口STM-1板IU1-IU10手工安装S01F04四光口STM-1板IU1-IU10手工安装S04F01单光口STM-4板IU1-IU10手工安装S04F02双光口STM-4板IU1-IU10手工安装S04F04四光口STM-4板IU

6、1-IU10手工安装S16F02双光口STM-16板IU1-IU10手工安装S16F01单光口STM-16板IU1-IU10手工安装EFET088口10/100M兆以太网板IU1-IU10手工安装PE1T6363口E1处理板IU1-IU10手工安装S64F01单光口STM-64板IU1-IU10手工安装A01F088口155M AT M光接口板IU1-IU10手工安装A01F168口155M AT M光接口板IU1-IU10手工安装XMCS0440G交叉板XMC1/XMC2/XMC3手工安装XMCS0880G交叉板XMC1/XMC2/XMC3手工安装第二章 配置概述CLI环境 连接网元命令行采

7、用telnet工具接入，端口为3333。语法：telnet neip 3333例如：telnet 192.168.0.13 3333由于命令行不支持行编辑，建议使用commander，commander的相关操作请参考commander的帮助。登入网元语法：login username,password例如：login 1,1命令行回显语法：echo on | off参数说明：on 打开回显，off关闭回显例如：echo on查看帮助语法：help列出命令行支持的系统命令退出命令行语法：exit改变命令树位置语法：cd newpos例如：cd $.ne.status.0同DOS下的目录操作类似

8、，注意返回上一级只能用cd .，命令树可以用绝对路径表示，也可以用相对路径表示，提示符为当前所在的路径。列出子节点或子属性语法：ls pos同UNIX下的ls操作类似查看命令帮助语法：la command | pos例如：la $.ne.cfg.0.SaveCfg如果没有参数，就列出当前节点所有的命令帮助。参数列表中参数类型前的in表示是命令行输入参数，out表示命令行返回的参数。查看命令参数中的类型含义语法：info tid_name例如：info SrpsLogAttrib注意tid_name不能是扩展类型（后缀_XXX为扩展类型，请去掉_XXX后查询，后缀为_Eu1说明参数为枚举类型，_

9、Seq说明参数为一序列）。设置节点属性语法：set attribute_name value例如：set $.ne.cfg.ne.0.name “NE1”value的语法和C语言中类似。查看节点属性语法：get attribute_name例如：get $.ne.cfg.ne.0.name设置属性显示模式语法：title 0 | 1例如：title 11打开属性显示，0关闭属性显示。设置事件上报语法：evt evt_name on | off例如：evt EVTSncStatusChg onon为打开事件上报，off关闭事件上报。查看所有上报事件语法：evtlist查找类型语法：lkuptid

10、 tid_name例如：lkuptid EVT*tid_name支持通配符命令树结构$- ne:1 chss:1 实际单板管理接口区 cfg:2 网元配置管理接口区 ne:1 网元属性管理接口区 neExt:2 扩展网元管理接口区 chss:3 单板配置管理接口区 service:6 业务配置管理接口区 cfging:1 配置业务管理接口区 valid:2 生效业务管理接口区 property:3 业务属性管理接口区 msp:7 复用段管理接口区 log:11 黑匣子管理接口区通用类型介绍使用la查看命令帮助，常会返回许多参数类型，例如：$la $.ne.cfg.msp.0.SetApsWTR

11、Time$.ne.cfg.msp.0.SetApsWTRTime :NICfgMsp Octet_Exc r SetApsWTRTime(in Octet apsIdx, in UShort apsWTRTime) Total: 1在这里参数类型前有个in，表示该参数是输入参数，如果是out则表示是输出参数。下面介绍几个 通用类型Octet：整数，范围（0 255）UShort：无符短整型，范围（0 65535）ULong：无符长整型，范围（0 4294967295）Char：字符型，要用 单引号括起来，例如， y，注意单引号要用英文的标点符号。也可以用整数表 示，范围（-128 127）Sh

12、ort：短整型，范围（-32768 32767）Long：长整型，范围（-2147483648 2147483647）String：字符串类型，要用双引号括起来，例如，“UTStarcom”，注意双引号要用英文的标点符号。除了这几个通用的类型外，还有许多特殊的类型，可以用info 类型名，查看类型的定义。还有两类比较特殊的类型，后缀是_Eu1的为枚举类型，比如ELsrStatus_Eu1，可以用info ELsrStatus查看该枚举类型包含哪些值，比如这里返回open，close两个值，作为输入参数的话，只要选择其中之一就可以了；后缀为_Seq的为序列类型，表示该参数可以重复很多组，比如，S

13、LpsDevAttrib_Seq，可以理解为lpsDevAttrib1,lpsDevAttrib2,lpsDevAttrib3，这里lpsDevAttrib1、lpsDevAttrib2、lpsDevAttrib3的类型为SLpsDevAttrib，比如这里这个参数可以是3,1,4,1,5,1。事务机制为保证业务的安全性以及配置过程中网元与网管数据的一致性，该系统在业务配置过程中引入了事务机制，事务为一系列操作的集合通过事务机制，可以保证配置操作的批处理。即一次事务中的任何一次失败时，都可以将配置退回到本次事务开始前的状态。为防止因通讯中断等原因而导致事务挂起的情形发生，事务引入了超时机制。即

14、一次事务有一个生命周期。超过生命周期的事务将自动被终结(即被放弃)。事务机制是由一系列事务接口实现的，主要包括:Begin开始事务Try预配置事务Commit提交事务Abort放弃事务Continue继续配置事务网元配置事务不支持事务嵌套,即不允许同时存在两个事务处于活动状态事务ID： 所有配置接口都需要输入事务ID(提示为transIdx)，为用户配置方便起见，系统提供一 个ID号为0的特殊事务ID。该事务ID不必通过Begin获取。任何ID非0的事务在Commit 或Abort后，系统均进入ID=0的配置事务状态。亦即这时所有的接口的transIdx只需输入0 即可 配置.ID=0事务只是

15、不需要Begin，其余操作与其它事务完全一致。接口详细具体介绍：o开始事务Begin.事务ID(非0)是配置方和被配置方对在一次事务中的唯一联系纽带.事务ID是由网元发放的.无论是命令行还是网管，均需要通过该接口获取配置事务ID号.由于系统不支持事务嵌套,故在一个网元接入用户开始了一个事务后，其它网元接入用户在开始事务时系统将提醒失败.由于事务引入了超时机制，用户开始一次事务时,要求提供事务的超时时间设置(单位为秒),输入为0表示事务超时时间为无穷大,亦即禁止事务超时.oTry预配置事务.预配置事务需要提供事务ID.预配置的结果可以指导用户对当前配置事务作如何处理.如果Try成功，用户可以通过

16、Commit命令提交事务；如果失败,则可以通过Abort放弃.Try后的事务处于锁定状态,这时任何使用该事务进行的配置都是禁止的.oCommit提交事务.只有Try成功的事务才允许提交，即配置生效。oAbort放弃事务.在事务提交以前，可以随时通过Abort终止当前正在配置的事务.oContinue继续配置事务.在Try失败时,用户如果直接使用Abort，则本次事务中的配置将完全放弃.如果用户打算对前面的配置进行适当修正,可以通过该接口使当前事务再次进入配置中状态.oTryCommit.该接口的功能为:如果事务Try成功,则自动提交该事务。注意:如果Try失败,则当前事务仍然处于锁定状态.事务

17、机制下的配置流程： o开始事务：从系统获取一个ID号，也可略个此步，在后续配置中使用缺省事务ID0。o配置网元：使用从BEGIN获取的事务ID号，配置对象包括：扩展网元、单板、复用段、业务、CFP等。o预配置事务：使系统尝试配置，如果成功，则可以提交配置；否则只能废弃当前配置。o提交事务：使配置生效。o放弃事务：放弃使前面的所有配置，系统配置回到本次配置之处的状态。事务相关命令 初始化网元配置 语法：$.ne.cfg.0.InitAll transIdx 参数说明：transIdx 事务号 例如：$.ne.cfg.0.InitAll 0 开始一次事务配置 语法：$.ne.cfg.0.Begin

18、 transIdx 参数说明：transIdx 事务号 例如：$.ne.cfg.0.Begin 0 预配置事务 语法：$.ne.cfg.0.Try transIdx 参数说明：transIdx 事务号 例如：$.ne.cfg.0.Try 0 预配置事务正确则提交 语法：$.ne.cfg.0.TryCommit transIdx 参数说明：transIdx 事务号 例如：$.ne.cfg.0.TryCommit 0 提交配置事务 语法：$.ne.cfg.0.Commit transIdx 参数说明：transIdx 事务号 例如：$.ne.cfg.0.Commit 0 终止配置事务 语法：$.n

19、e.cfg.0.Abort transIdx 参数说明：transIdx 事务号 例如：$.ne.cfg.0.Abort transIdx 如果一次事务没有检验成功，只有用Abort命令才能退出该次事务配置。 继续事务配置 语法：$.ne.cfg.0.Continue transIdx 参数说明：transIdx 事务号 获取当前事务信息 语法：$.ne.cfg.0.GetTransInfo第三章 数据库 保存当前生效配置到DB1 语法：$.ne.cfg.0.SaveCfg 备份DB1到DB2 语法：$.ne.cfg.0.BakCfg tagInfo 参数说明：tagInfo 标签，为字符串

20、例如：$.ne.cfg.0.BakCfg “20030417” 查询历史库标签信息 语法：$.ne.cfg.0.QueryBakCfgTag 将当前配置恢复到DB2状态 语法：$.ne.cfg.0.ResumeBakCfg 将当前配置恢复到DB1状态 语法：$.ne.cfg.0.LoadCfg 第四章 网元属性 设置网元时间 语法：$.ne.status.0.SetNeTime year,month,day,hour,minute,second,centisecond 例如：$.ne.status.0.SetNeTime 2003,4,17,12,12,0,0 查询网元时间 语法：$.ne.s

21、tatus.0.GetNeTime 查询主控版本 语法：$.ne.status.0.Version 查询系统信息 语法：$.ne.status.0.Show 主控复位 语法：$.ne.status.0.Reboot type 参数说明：type 可以是“hardreboot”或者“softreboot” 例如：$.ne.status.0.Reboot “hardreboot”第五章 单板配置 创建单板 语法：$.ne.cfg.chss.0.Create TransIdx, chssPos, chssType 参数说明：TransIdx 事务号 chssPos 单板所在板位 chssType 单

22、板类型 例如：$.ne.cfg.chss.0.Create 0,0,S01F02 删除单板 语法：$.ne.cfg.chss.0.Del TransIdx, chssPos 参数说明：TransIdx 事务号 chssPos 单板所在板位 例如：$.ne.cfg.chss.0.Del 0,3 查询配置的单板 语法：$.ne.cfg.chss.0.QueryConfig chssPos 参数说明：chssPos 单板所在板位 查询所有配置的单板 语法：$.ne.cfg.chss.0.QueryAllConfig 查询所有配置生效的单板 语法：$.ne.cfg.chss.0.QueryAllVal

23、id 单板在线查询 语法：$.ne.cfg.chss.0.IsChssOnline chssPos 参数说明：chssPos 单板所在板位 查看指定板位的板类型 语法：$.ne.chss.0.GetChssType chssPos 参数说明：chssPos 单板所在板位 查询所有在位的单板 语法：$.ne.chss.0.QueryAll 这条命令比较常用 复位单板 语法：$.ne.chss.0.Reset chssPos, mode 参数说明：chssPos 单板所在板位 mode warm表示热复位，cold表示冷复位 例如：$.ne.chss.0.Reset 3,cold第六章 业务配置业

24、务创建创建一条普通业务语法：$.ne.cfg.service.cfging.0.CreateAtom TransIdx, idx, level,work,dst参数说明：TransIdx 事务号 idx 业务编号，通常为0 level 业务级别，可能取值VC12,VC3,VC4等，可以 通过info EserviceLevel查询系统支持的业务级别 work 业务工作端口，类型为SServicePort dst 业务目的端口，类型为SServicePort SServicePort类型定义为shelfIdx,chssIdx,portIdx,stmIdx,slotIdx shelfIdx 子架号

25、，0为主子子架，1为第一个扩展子架，2为第 二个扩展子架 chssIdx 板位号 portIdx 对光口板对应为光口号，对电口板恒定为1，对以太 网板对应为网口号 stmIdx STM编号，对光口板对应为光口内STM编号，对电 口板恒定为1 slotIdx STM内时隙编号 例如：$.ne.cfg.service.cfging.0.CreateAtom 0,0,VC12,0,3,1,1,1,0,7,1,1,1创建多条普通业务语法：$.ne.cfg.service.cfging.0.CreateAtomSeq TransIdx,num,idx,level,work,dst参数说明：num 业务数

26、量 其他参数同CreateAtom该命令以端口的时隙号递增创建多条业务，这是最常用的业务创建命令。后缀为Seq表示以时隙号递增创建业务。创建一条业务语法：$.ne.cfg.service.cfging.0.Create TransIdx, idx,level,work,dst,prt1,prt2参数说明：prt1 ,prt2为保护端口，其他参数含义同上例如：$.ne.cfg.service.cfging.0.Create 0,0,VC12,0,3,1,3,1,0,5,1,1,1,0,4,1,3,1如果没有配置保护端口就是配置了一条普通业务；配置保护的时候业务源业务要多发，具体情况请参考PP和S

27、NCP的配置。创建多条业务语法：$.ne.cfg.service.cfging.0.CreateSeq TransIdx,num,idx,level,work,dst,prt1,prt2参数说明：num为业务数，其他参数含义同上例如：$.ne.cfg.service.cfging.0.CreateSeq 0,10,0,VC12,0,3,1,3,1,0,5,1,1,1,0,4,1,3,1业务删除删除一条业务语法：$.ne.cfg.service.cfging.0.Del TransIdx,dst参数说明：dst 为目的端口删除多条业务语法：$.ne.cfg.service.cfging.0.De

28、lSeq TransIdx,num,dst例如：$.ne.cfg.service.cfging.0.DelSeq 0,10,0,5,1,1,1配置业务查询这里的命令都在$.ne.cfg.service.cfging.0节点下查询业务的统计信息语法：$.ne.cfg.service.cfging.0.QueryStat查询指定出端口的业务语法：$.ne.cfg.service.cfging.0.Query dst参数说明：dst 业务目的端口，类型请参考SServicePort例如：$.ne.cfg.service.cfging.0.Query 0,3,1,1,1查询指定出端口的业务连接配置语法

29、：$.ne.cfg.service.cfging.0.QueryLink dst参数说明：dst 业务目的端口，类型请参考SServicePort按起始业务编号查询所有普通业务语法：$.ne.cfg.service.cfging.0.QueryMAtom fromIdx参数说明：fromIdx为业务的起始编号，用1从第一条业务开始查询，0表示从上次查询位置继续查 查询，非0表示指定业务查询的ID号。例如：$.ne.cfg.service.cfging.0.QueryMAtom 1一般用法为第一条使用QueryMAtom 1从头查询业务，然后使用QueryMAtom 0继续查询业务直到返回结果为“Total Numbers: 0”为止。按起始业务编号查询所有SNCP业务语法：$.n