moshell commands.doc

7/28/2019 moshell commands.doc

1/15

----------------------------------- BASIC MO COMMANDS -------------------------

mom[tc] Print description of MO classes, CM/FM attributes, actions

, enums and structs.lt/ltc[1-9] Load MO tree (full or partial) and build proxy table.lc[1-9]/lcc Load MO tree (full or partial) and build proxy table.pr/lpr Print MO LDNs and proxy ids for all or part of the MO treecurrently loaded in moshell.ma/lma Add MO(s) to an MO group.mr/lmr Remove an MO group or remove MOs from an MO group (MOs will NOT be deleted, only the group).mp Print all defined MO groups.get/lget Read CM/FM attribute(s) from MO(s).hget[c]/lhget[c] Read CM/FM attribute(s) from MO(s), print horizontally one

line per MO (instead of one line per attribute).kget/lkget Display CM/FM attributes in exportable printout format.fro/lfro[m] Read MAO data of an MO and/or froid of the MO. Data read from sql table modata_r2 instead of via MO service.st/lst Print state of MOs (operationalState and administrativeState when applicable).prod Print productData of MO(s).lk/llk View all MO's linked to an MO, and their states (admStateand opState).lko/llko The old lk. Messier than lk but supports a wider range of

MO classes.set[m]/lset[m] Set an attribute value on one or several MO's.rset/lrset Set attribute value on a restricted attribute or change thOFFLINE>bl[s]/lbl[s] Lock or soft-lock MO(s).


2/15

deb/ldeb Unlock MO(s).acl/lacl Lists available MO actions.acc/lacc Execute an MO action.cr Create an MO.

del/ldel Delete MO(s).rdel/lrdel Delete MO(s) together with children and reserving MOs.u+[s]/u-/u?/u! Handling of undo mode (for undo of del/rdel/set commands).Can be used for generation of MO scripts as well.run Run a command file in moshell format.trun[i] Run a command file in EMAS/MoTester format.ctrl-z Abort an MO command or a "for" loop. Type "touch /tmp/;fg" to resume the moshell session.pol[s] Poll the node until the CM service is up.re[i] Disconnect and reconnect to the CM service (mobrowser) and/or the PM service (pmtester).getmom Check the MOM version currently stored on the node.

parsemom Parse an xml MOM file.flt/fltc Load proxys for an MO type that is not defined in the MOM.("Force" lt/ltc).ld Load one MO from the tree and add to the proxy table.fget/lfget Read attributes that are not described in the MOM ("Force"get).sget/lsget Read CM/FM attributes from MO(s), one by one ("Slow" get).

fset/lfset Set an attribute that is not described in the MOM ("Force"set).

facc/lfacc Perform actions that are not defined in the MOM ("Force" action).----------------------------------- OTHER MO COMMANDS -----------------------

cvls/cvmk/cvms/cvset/cvrm/cvcu/cvls1 ConfigurationVersion (CV) handling.


3/15

inv[hr] Complete HW/SW inventory. Includes information about RPUs,licensing, JVM, devices, XPs, etc.cab[slxradgtm] Display of miscellaneous COLI printouts relating to hw, sw, restarts, leds, cpu load, errors, disk/ram usage

stc[p][r] Display state and configuration of AtmCrossConnections.std Display state and configuration of devices (RNC and MGW only).stv[b][r] Display state, user, and bandwidth usage for ATM ports andchannels.stt[r] Display state and user of Physical Ports and Ds0Bundles.hc Run a general healthcheck on the node.diff/ldiff Parameter auditing or MO dump comparisons.str[12ft] Print status of the IubLinks/AbisLinks and their associated Cells and Channels (RNC/BSC only).lki Resource usage and configuration of IubLinks (RNC only).

remod[u][2] Remodule an IubLink (RNC only).tg[r][c][d] Print Resource Object information for all MOs in LmCell (RNC only).uer Print UE context data for all active calls (RNC only).al[atk] Print the list of active alarms.lg[aevsmircdyuolh] Fetching and processing of logs (alarm, event, availability, system, etc)----------------------------------- OTHER COMMANDS -------------------------

uv Print or change moshell configuration settings (also calle

d "user variables").pv Print scripting variables.!/l Execute a unix command on the PC/workstation.l+[m][m][s][o]/l-/l? Open/close moshell logfiles.ose/coli command Send a COLI command to the node's OSE shell. Type "h ose"


4/15

for syntax help and "?" to view available commands.bo[r]/ba[swdp]/br[wd]/bp Manage board groups that can be used for running COLIcommands on multiple boards.lh Run COLI commands on all boards of a board group.

mon/mon+/mon-/mon? Start/stop/check the target monitor server on the node and/or start the monitor client for one or more board Group(s).sql+/sql-/sql? Start/stop/check the SQL client on the node (CXC1325608).pgu[c][f] Program Upgrade. For STP use only, eg, to load black LMs.ftree Recursive listing on the node's file system (equivalent to"ls -lR" in unix).ftget[c]/ftput[c] Transfer files or directories to/from the node, using ftp.

htget Transfer files from the node using http.edit Edit a file on the node.fclean[f|ff|d|e] Removal of obsolete loadmodules OR recursive removal of a

directory on the node.hi Print history of moshell commands entered during the current session.lmid[c] Print translation of loadmodule product number or T&E error codes.p/w/pw/b Change moshell prompt and/or window title.prox Toggle display of proxy identities in printout of getcommand.col Toggle display of colors.ul Toggle display of userlabel in st/lst and pget/lpget print

out.conf[bld] Toggle confirmation on various MO commands.gs/gsg Toggle display of old/new attribute value in set/bl/deb commands.ip2d/d2ip Convert an IP address into the format used in the fRO (sql


5/15

database) or vice-versa.h2d/d2h Convert an integer to hexadecimal or viceversa.h2b/b2h Convert a binary to hexadecimal or viceversa.wait Specify a delay in hrs, mins, secs, or rops. Similar to th

e unix "sleep" command (scripting).return Exit from a command file without exiting from moshell (scripting).print Print a line or variable (scripting).alias/unalias Print or define command aliases.q/by/exit/quit Exit moshell.----------------------------------- PM COMMANDS ----------------------------------pmom[ac]/lmom[c] Print description of PM counters (pmom) or log attributes(lmom, CDMA only).pget/lpget Read PM attribute(s) from MO(s).

hpget[c]/lhpget[c] Read PM attribute(s) from MO(s), print horizontally one line per MO (instead of one line per attribute).pdiff/lpdiff Print incrementation of PM attributes.pmx[hfdn] Display counter values, extracted from the statistics ROPfiles.pmr[ag] Produce PM KPI reports, based on counter values in statistics ROP files and formulas in CPI documentation.pme[fd][cgu] Fetch/decode event ROP files (RNC/RBS only).pst List all PM scanners and their state.pgets[n] Print scanner contents.pcr[cfd]/lpcr[cfd] Create a statistics scanner.pbl Suspend a scanner.pdeb Resume a scanner.pdel Delete a scanner.emom Display list of events available for each kind of event-ba


6/15

sed scanner.pset[d] Set the contents of an event-based scanner (RNC/RBS only).

----------------------------------- HELP CHAPTERS -------------------------

0 Installation, security, and user settings1 Revision History2 Tutorial3 Command syntax, regular expressions4 Command descriptions5 Lazy6 Scripting7 Utilities8 Server Maintenance9 Offline Mode

Type: - h to view command description, e.g: h pget- h to view a chapter, e.g: h 3

==========================================================Command syntax, regular expressions

3.1- How MOs are identified

- RDN (Relative Distinguished Name)This is used to identify an MO in relation to its nearest parent in the MO tree.


7/15

The RDN contains MO Class (also called MO Type), the equal sign, and MO identity.Example: AtmPort=MS-24-1 ===> "AtmPort" is the MO Class, "MS-24-1" is the identity- LDN (Local Distinguised Name)This is used to uniquely identify an MO within a node.

The LDN shows the hierarchy above the MO, within the Managed Element's MO tree.Example: ManagedElement=1,TransportNetwork=1,AtmPort=MS-24-1- FDN (Full Distinguished Name)This is used to uniquely identify an MO within a network (used by RANOS/CNOSS).Example:SubNetwork=AUS,SubNetwork=H2RG_0201,MeContext=St_Leonards_Station_2065010,ManagedElement=1,TransportNetwork=1,AtmPort=MS-24-1

3.2- How to address the MOs in MO-related commands

The first argument in the MO-related commands is usually used to specify the MOs that should be affected by the command.Six ways can be used to specify the MO(s):1) all===> all MOs in the proxy table will be affectedExample: get all userlabel ====> get attribute "UserLabel" on all MOsNote: instead of "all", it is also possible a wildcard such as "." or "*". This has the same effect.

2) proxy id(s)===> MO(s) with the given proxy id(s) will be affected.To specify several MO proxies, there are two ways:

- Specify each proxy id with a space in betweenExample: pr 0 2 5 ===> print MO proxies 0, 2, and 5

- Give a rangeExample: pr 4-10 ===> print MO proxies from 4 to 10

pr 10-4 ===> print MO proxies from 10 to 4 (reverse order, useful for deleting MOs)


8/15

acc 10-20 restart ====> restart MOs with proxy 10 to 20

3) link handler (for pluginunit and spm MOs only)Example: acc 001400 restart ====> to restart the MO Subrack=MS,Slot=14,PlugInUnit=1

bl 001900/sp0.lnh ====> to lock the spm Subrack=MS,Slot=19,PlugInUnit=1,Spu=1,Spm=1

4) mo group===> MO(s) belonging to the given MO group will be operated upon.MO groups can be created using the commands ma/lma and mr/lmr, as well as hget/lhget, lk/llk, st/lst.See command description for these commands.Note: In RNC, running the "bo" command will automatically create a number of MO groups containing the cc/dc/pdr device MOs for eachmodule.

5) board group===> MOs (PlugInUnit or Spm) mapped onto the boards belonging to the given board group will be operated upon.

Example1: baw sccp sccp ====> all boards with the swallocation matching "sccp" will go into the board group "sccp"bl sccp ====> all PlugInUnit or Spm MOs connected to boards of this board group will be locked

Example2:In RNC, using the default board groups created after running the bo command:acc mod10 restartpr dc10acc dc10 restart (the board group dc10 is mapped onto the Spm MOs)bl dc10dev (in this case we are using the MO group containing the Device MOs, see paragraph 4. above)

6) mo-filter===> MO(s) whose LDN/RDN match the pattern will be operated upon.If the command starts with "l" then the pattern will match agains the LDN.If the command doesn't start with "l", then the pattern will match against the RDN.Example:=>=> pr ms-24-1returns: TransportNetwork=1,AtmPort=MS-24-1


9/15

=>=> lpr ms-24-1returns: TransportNetwork=1,AtmPort=MS-24-1

TransportNetwork=1,AtmPort=MS-24-1,VplTp=vp1TransportNetwork=1,AtmPort=MS-24-1,VplTp=vp1,VpcTp=1

TransportNetwork=1,AtmPort=MS-24-1,VplTp=vp1,VpcTp=1,VclTp=vc32TransportNetwork=1,AtmPort=MS-24-1,VplTp=vp1,VpcTp=1,VclTp=vc33TransportNetwork=1,AtmPort=MS-24-1,VplTp=vp1,VpcTp=1,VclTp=vc337TransportNetwork=1,AtmPort=MS-24-1,VplTp=vp1,VpcTp=1,VclTp=vc332TransportNetwork=1,AtmPort=MS-24-1,VplTp=vp2TransportNetwork=1,AtmPort=MS-24-1,VplTp=vp2,VpcTp=1TransportNetwork=1,AtmPort=MS-24-1,VplTp=vp2,VpcTp=1,VclTp=vc34TransportNetwork=1,AtmPort=MS-24-1,VplTp=vp2,VpcTp=1,VclTp=vc35TransportNetwork=1,AtmPort=MS-24-1,VplTp=vp2,VpcTp=1,VclTp=vc40TransportNetwork=1,AtmPort=MS-24-1,VplTp=vp2,VpcTp=1,VclTp=vc64

When using the mo-filter, it is a good idea to test the pattern with "pr/lpr" command before issuing a get/set/acc/cr/del command, in order to see

which MOs will be matched by the pattern.

Sometimes, a second or third argument can be given, which is usually a string matching the attribute or attribute value that you want to display.

The search string that is used in the filters is a Unix Regular Expression (like the patterns used in grepcommand). Therefore, special meta-characters such as . * [ ] ^ $ can be used. Short description of somemeta-characters:"." ===> any single character"*" ===> 0 or more occurences of the previous character[] ===> matches a character or range of characters inside the brackets[^] ===> NOT matching a character or range of characters inside the brackets| ===> OR^ ===> beginning of string$ ===> end of string! ===> negation


10/15

% ===> reverse orderE.g: "a*" means a or aa or aaa, etc.".*" is like a wildcard as it matches 0 or more occurences of any character"[a-z]" matches all letters from a to z

"[abe]" matches letters a,b, and e"[^3]" matches any character but not 33|5|6 matches 3 or 5 or 6^a.*4$ matches a string beginning with a and finishing with 4, with any character in the middle

Regular expressions can be grouped using brackets, e.g:"cell(11|23|45) matches cell11 or cell23 or cell45

!!!! Note: MOSHELL pattern matching is NOT case sensitive !!!!!

Examples of using regular expressions in the filters:

lpr ms-24-1.*vp2TransportNetwork=1,AtmPort=MS-24-1,VplTp=vp2TransportNetwork=1,AtmPort=MS-24-1,VplTp=vp2,VpcTp=1TransportNetwork=1,AtmPort=MS-24-1,VplTp=vp2,VpcTp=1,VclTp=vc34TransportNetwork=1,AtmPort=MS-24-1,VplTp=vp2,VpcTp=1,VclTp=vc35TransportNetwork=1,AtmPort=MS-24-1,VplTp=vp2,VpcTp=1,VclTp=vc40TransportNetwork=1,AtmPort=MS-24-1,VplTp=vp2,VpcTp=1,VclTp=vc64

lpr %ms-24-1.*vp2TransportNetwork=1,AtmPort=MS-24-1,VplTp=vp2,VpcTp=1,VclTp=vc64TransportNetwork=1,AtmPort=MS-24-1,VplTp=vp2,VpcTp=1,VclTp=vc40TransportNetwork=1,AtmPort=MS-24-1,VplTp=vp2,VpcTp=1,VclTp=vc35TransportNetwork=1,AtmPort=MS-24-1,VplTp=vp2,VpcTp=1,VclTp=vc34TransportNetwork=1,AtmPort=MS-24-1,VplTp=vp2,VpcTp=1


11/15

TransportNetwork=1,AtmPort=MS-24-1,VplTp=vp2

lpr !loadmodule|program===> all MOs except those matching "loadmodule" or "program" will be printed.

lpr 20.*osEquipment=1,Subrack=1,Slot=20,PlugInUnit=1,Etm4=1,Os155PhysPathTerm=1Equipment=1,Subrack=1,Slot=20,PlugInUnit=1,Etm4=1,Os155PhysPathTerm=2

pr cc[1-4]TransportNetwork=1,AtmCrossConnection=AtmCC1TransportNetwork=1,AtmCrossConnection=AtmCC2TransportNetwork=1,AtmCrossConnection=AtmCC3TransportNetwork=1,AtmCrossConnection=AtmCC4

pr cc[135]TransportNetwork=1,AtmCrossConnection=AtmCC1TransportNetwork=1,AtmCrossConnection=AtmCC3TransportNetwork=1,AtmCrossConnection=AtmCC5

lpr =6.*prog.*=1Equipment=1,Subrack=1,Slot=6,PlugInUnit=1,Program=15Equipment=1,Subrack=1,Slot=6,PlugInUnit=1,Program=1Equipment=1,Subrack=1,Slot=6,PlugInUnit=1,Program=14Equipment=1,Subrack=1,Slot=6,PlugInUnit=1,Program=13Equipment=1,Subrack=1,Slot=6,PlugInUnit=1,Program=12Equipment=1,Subrack=1,Slot=6,PlugInUnit=1,Program=11Equipment=1,Subrack=1,Slot=6,PlugInUnit=1,Program=10Equipment=1,Subrack=1,Slot=6,PlugInUnit=1,Program=19Equipment=1,Subrack=1,Slot=6,PlugInUnit=1,Program=18


12/15

Equipment=1,Subrack=1,Slot=6,PlugInUnit=1,Program=17Equipment=1,Subrack=1,Slot=6,PlugInUnit=1,Program=16

lpr =6.*prog.*=1$

Equipment=1,Subrack=1,Slot=6,PlugInUnit=1,Program=1

lpr ms-24-1TransportNetwork=1,AtmPort=MS-24-1TransportNetwork=1,AtmPort=MS-24-1,VplTp=vp1TransportNetwork=1,AtmPort=MS-24-1,VplTp=vp1,VpcTp=1TransportNetwork=1,AtmPort=MS-24-1,VplTp=vp1,VpcTp=1,VclTp=vc32TransportNetwork=1,AtmPort=MS-24-1,VplTp=vp1,VpcTp=1,VclTp=vc33TransportNetwork=1,AtmPort=MS-24-1,VplTp=vp1,VpcTp=1,VclTp=vc337TransportNetwork=1,AtmPort=MS-24-1,VplTp=vp1,VpcTp=1,VclTp=vc332TransportNetwork=1,AtmPort=MS-24-1,VplTp=vp2

TransportNetwork=1,AtmPort=MS-24-1,VplTp=vp2,VpcTp=1TransportNetwork=1,AtmPort=MS-24-1,VplTp=vp2,VpcTp=1,VclTp=vc34TransportNetwork=1,AtmPort=MS-24-1,VplTp=vp2,VpcTp=1,VclTp=vc35TransportNetwork=1,AtmPort=MS-24-1,VplTp=vp2,VpcTp=1,VclTp=vc40TransportNetwork=1,AtmPort=MS-24-1,VplTp=vp2,VpcTp=1,VclTp=vc64

lpr ms-24-1.*=vc[^3]TransportNetwork=1,AtmPort=MS-24-1,VplTp=vp2,VpcTp=1,VclTp=vc40TransportNetwork=1,AtmPort=MS-24-1,VplTp=vp2,VpcTp=1,VclTp=vc64

3.3- How to specify attribute values in set/cr/acc commands

a) For attributes of type Struct, use the following syntax: attr1=val1[,attr2=val2[,attr3=val3]]]...It is not necessary to specify all the struct members, only those that are required to change can be specified.


13/15

Example:===> set sid sib11 sib11repperiod=128===> set mtp3bspitu sppriority prioslt=2===> set mtp3bspitu sppriority prioslt=2,prioco=2

b) For attributes of type MoRef, just type the MO LDN (without "ManagedElement=1"). Eg:===> lset AtmPort=1221,VplTp=vp1 atmTrafficDescriptor transportnetwork=1,atmtrafficdescriptor=C1P4500It is also possible to skip the first parent (eg transportnetwork, swmanagement, etc). Eg:===> cr rncfunction=1,utrancell=30451,utranrelation=30451to30521Attribute 1 of 1, utrancellref (moRef:UtranCell): utrancell=30521 #in this case we don't have to specify rncfunction=1

c) For attributes of type array of MoRefs, separate each element of the array with spaces. Eg:===> set jvm admclasspath loadmodule=oms loadmodule=vbjorb loadmodule=asms_sharp loadmodule=iaik loadmodule=cmaloadmodule=roam===> acc aal2pathdistributionunit=1 addPath

Parameter 1 of 1, aal2PathVccTpId (sequence-moRef-Aal2PathVccTp): aal2pathvcctp=csa aal2pathvcctp=csb

d) For attributes of type array of Struct, separate each element of the array with semicolons. Eg:===> set rncfunction aliasPlmnIdentities mcc=300,mnc=23,mnclength=2;mcc=345,mnc=32,mnclength=2;mcc=208,mnc=123,mnclength=3

e) For attributes of type array of integer/long/float/string/boolean, separate each element of the array with commas. Eg:===> set antfeedercable=6 ulattenuation 10,10,10,10,10,10,10,10,10===> set jvm options -Xms65000k,-Dhttp.root=/c/public_html,-Dse.ericsson.security.PropertyFileLocation=/c/java/SecurityManagement.prp===> set cell=3041 ActiveOverlaidCDMAChannelList true,true,false,true===> acc managedelementdata addDhcpServerAddressParameter 1 of 1, ipAddressArray (sequence-string): 10.1.1.3,10.1.1.4

f) To input an empty value:* in set command, just leave the value field blank. Eg:

===> set 0 userlabel (# attribute type is string)


14/15

===> set reliableprogramuniter admpassiveslot (#attribute type is MoRef)* in cr command, type "null" if it's an MoRef or "d" for other attributes. This is only supported for non-mandatory (restricted) attributes,

because mandatory attributes must have a value* in acc command, type "null". This is only supported for parameters of type MoRef or String.

3.4- Moshell command line

The command line uses the Readline library from bash.Here are some of the supported function keys:- right arrow or Ctrl-f : move forward one character- left arrow or Ctrl-b : move backward one character- up arrow : previous command in history buffer- down arrow : next command in history buffer

- backspace : delete one character backward- Ctrl-d or "del" : delete one character forward- Ctrl-a or "home" : go to beginning of line- Ctrl-e or "end" : go to end of line- Ctrl-u : erase all characters backward- Ctrl-k : erase all characters forward- Alt-f : move forward one word- Alt-b : move backward one word- select or select + ctrl- : copy to clipboard- or shift- : paste from clipboardNote about command history: if you type the beginning of a command and then use the up/down arrow key, you will see all previous commandsstarting with this string

3.5- Piping


15/15

Some commands support piping, eg: OSE shell commands, lh, tg, str, etc.This is usually indicated in the menu and the help for that command.Examples:

===> te log read | grep ERROR===> lh mp te log read | grep ERROR===> str | grep cell=30456For other commands that don't support piping (like MO commands), the workaround is to save the output to a logfile then run the unix commandon that logfile by using the "l" or "!" command. Example:===> l+ #open the logfile, an arbitrary name will be given===> prod loadmodule #run the command===> l- #close the logfile===> l sort $logfile #run the unix command on the logfile. $logfile is a default variable that stores the name of the latest log created===> l grep -i basic $logfile

moshell commands.doc

Documents

Transcript of moshell commands.doc