You are on page 1of 3

[ab748c@scp-2-scripting(akr1e5enm) ~]$ amos

SLS_CERTIFICATE: info ( ): The SLS certificate is already present and is valid for next 24 hours

1) Online mode : moshell [-v uservariables] [-efg] [-a <rcfiles>] [-n] [-t <ip>[:port]] <site-name>|<ip-address>|<host-name>|<ior-file> [<command(s)>|<commandfile>] [<logfile>]
2) Offline mode: moshell [-v uservariables] [-efg] [-a <rcfiles>] [<MO-dump>|<dcglogs-zipfile>] [<command(s)>|<commandfile>] [<logfile>]
3) Multi mode : moshell [-v uservariables] [-efg] [-a <rcfiles>] -m <sitelist>|<sitefile> [<command(s)>|<commandfile>] [<logfile>]
4) SQL mode : moshell [-v uservariables] [-efg] [-a <rcfiles>] -d [-v nomo=1] <db.dat>|<>

Online means that moshell is connected to a node.

Offline is used for browsing logs with moshell, e.g. an MO-dump, a set of ROP files, or a set of CPP logfiles.
Multimode means that moshell is connected to several nodes at the same time.
SQL mode means that moshell is connected to a db.dat or (fetched with cvget).
Refer to the chapter "Offline mode and Multi mode" in the User Guide for more information.

The "-v" option is for setting uservariables from the command line. See README file chapter 0.2 for more info.
The "-v" option can also be used for setting scripting variables from the command line. In this case, the "$" sign in front of the variable name should be omitted. See README chapter
The "-n" option is for disabling the check of IP contact at startup.
The "-e" option is to skip sourcing of the global moshellrc file (moshell/jarxml/moshellrc)
The "-f" option is to skip sourcing of the user's moshellrc file (~/.moshellrc)
The "-g" option is for gzipping the logfile after completion (only applicable when a logfile has been specified)
The "-a" option is to source some additional moshellrc files, eg: -a file1,file2. These files will be sourced after the global moshellrc and before the user's .moshellrc.
The "-t" option is to use a time server when connecting to an emulated node. If the optional port argument is not specified, the default port of 8123 will be used.

The argument can be:

* <site-name> : refers to the node's name as defined in the ipdatabase file (whose path is defined in moshell file).
* <host-name> : refers to the node's name as defined in DNS.
* <ip-address>: raw ip address
* <ior-file> : an iorfile that has been stored on the workstation.
* <sitelist> : the list of sites to connect to, eg: site1,site2,site3. Applicable with option "-m" only.
* <sitefile> : the file containing the list of sites, one site per line. Applicable with option "-m" only.
* <MO-dump> : the MO dump is a file obtained with the command "dcgk" or "lt all;kget". It can be in text format, .gz format, or .zip format.
* <dcglogs-zipfile> : a zipfile containing all the logs produced by the dcgm command (,,

Logfiles and temporary files are automatically stored under ~/moshell_logfiles/logs_moshell. This path can be changed either by setting the uservariable "logdir" in the file ~/.moshellrc or from command line with the
option "-o <logdirectory>".

Examples, online mode:

* moshell
* moshell -v security_method=2,sa_credential=~/sam.pbe,sa_password=oemas
* moshell -v telnet_port=2323,http_port=8080 rnc3
* moshell rbs28 ~/tools/moshell/cmdfiles/runSwTest.cmd
* moshell bsc5 'vii ; cabslxrd ; lh mp te log read | grep ERROR ; lt plug ; st all dis ; get all all '
* moshell 'vii ; lh mp te log read | grep ERROR ' ~/moshell_logfiles/nodeTest.log
Examples, offline mode:
* moshell ~/moshell_logfiles/logs_moshell/sessionlog/ #interactive mode
* moshell ~/modumps/mgw1_kget.log.gz 'pr ; get ; st ; inv' #script mode
Examples, multimode:
* moshell -m rnc11,,
* moshell -m rbslist.txt 'lt all; kget'
Examples, sql mode:
* moshell -d ~/moshell_logfiles/logs_moshell/dcg/RNC11/
* moshell -d ~/moshell_logfiles/logs_moshell/cv/RNC11/db.dat

__ __ ____ _____
/\ | \/ |/ __ \ / ____|
/ \ | \ / | | | | (___
/ /\ \ | |\/| | | | |\___ \
/ ____ \| | | | |__| |____) |
/_/ \_\_| |_|\____/|_____/
OSS Framework for MoShell-17.0m

$amosrb_pid = 1342

QUIT : q

For offline browsing of the MIB, load an MO dump with command "lt <modump>".
The MO dump can be fetched when online, using command "dcgk"

For offline browsing of PM ropfiles, run "pmr/pmx -l <pmropfiles>".

For offline browsing of CPP logfiles, run "lg[options] -l <cpplogfiles>".
The PM ropfiles and CPP logs can be fetched when online, using command "dcgf"
To list all available facc/mcc commands, type "?"
To list all available COLI commands, type "lh all ?"

----------------------------------- BASIC MO COMMANDS ----------------------------------
mom[abcdfloprtuxsi] Print description of MO classes, CM/FM attributes, actions, enums and structs.
lt/clt/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.
ld[c] Load one MO instance and (optionally) the MO tree below it.
lu/llu Unload MOs from MO tree.
pr[s][m]/lpr[s][m] Print MO LDNs and proxy ids for all or part of the MO tree currently 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[m][i]/lget[m][i] Read CM/FM attribute(s) from MO(s).
hget[c][m][i]/lhget[c][m][i] Read CM/FM attribute(s) from MO(s), print horizontally one line per MO (instead of one line per attribute).
kget[m]/lkget[m] Display CM/FM attributes in exportable printout format.
fro[m]/lfro[m] Read MO persistent data from node database via SQL.
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 (admState and opState).
lko/llko Obsolete command, use lk/llk instead.
set[m][c][1][i]/lset[m][c][1][i] Set an attribute value on one or several MO's.
eset[c][1]/leset[c][1] Set one or several attributes on one or several MO's, using regexp matching on the attribute name.
rset/lrset Set attribute value on a restricted attribute or change the MOid of an MO.
bl[s]/lbl[s] Lock or soft-lock MO(s).
deb/ldeb Unlock MO(s).
acl/lacl Lists available MO actions.
acc[e][n]/lacc[e][n] Execute an MO action.
cr[e][n] Create an MO.
del[b]/ldel[b] Delete MO(s).
rdel/lrdel Delete MO(s) together with children and reserving MOs.
gm[c][d]/lgm[c][d] Generate MO Creation/Deletion script.
sc[g][w][d] Read/Write/Reset SystemConstants.
safe+/safe-/safe? Apply strict MO matching rules on MO WRITE commands
s+/s++/s-/s? Sort MO list in alphabetical order instead of proxy order.
u+[s]/u-/u?/u! Handling of undo mode (for cr/del/rdel/set/bl/deb/acc commands). Can be used for generation of MO scripts as well.
run[x][1][1p][1r] Run a command file in moshell format.
trun[is1cr] Run a command file in EMAS/MoTester format.
ctrl-z Abort an MO command or a "for" loop. Type "touch /tmp/<stopfile>;fg" to resume the moshell session.
pol[b][c][d][h][i][k][m][p][s][r][u][w][y] Poll the node until the MO service is up or until an operation has completed.
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 or download a MOM from newtran01 server.
parsemom Parse an xml MOM file.
eget/leget Read attributes that are not listed in the MOM (e="Extended").
sget/lsget/skget/lskget/shget/lshget Read CM/FM attributes from MO(s), one by one ("Slow" get).
flt/fltc Load proxys for an MO type that is not defined in the MOM. ("Force" lt/ltc).
fget[i]/lfget[i] Read attributes that are not listed in the MOM (f="Force").
facc/lfacc Perform actions that are not defined in the MOM ("Force" action).
fdel/lfdel Delete MO(s), including systemCreated MOs.
mcl[d] List MO-Context COMCLI commands.
mcc/lmcc Execute MO-Context COMCLI commands.
----------------------------------- OTHER MO COMMANDS ----------------------------------
cvls/cvmk/cvms/cvset/cvrm[u]/cvrbrm/cvcu/cvget[f][u]/cvput/cvls1/cvre/cvfa/cvfd CV backup handling: list, make local, make remote, remove, setstartable.
inv[hlxpbctrgf] Complete HW/SW inventory. Includes information about RPUs, licensing, JVM, devices, XPs, ISL, etc.
cab[adefghlmrstxc] 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 Atm/Tdm CrossConnections.
std[ar] Display state and configuration of devices (RNC and MGW only).
stv[b][r] Display state, user, and bandwidth usage for ATM ports and channels.
stt[r] Display state and user of Physical Ports and Ds0Bundles.
ste[gr] Display state and configuration of Ethernet Ports.
sti[bcfopr] Display state and configuration of IP interfaces.
sts Display state and configuration of Network Synchronization.
str[123ft] Print status of the IubLinks/AbisLinks and their associated Cells and Channels (RNC/BSC only).
hc Run a general healthcheck on the node. Obsolete ! Use dcg command instead.
dcg[meiasrfkx] Fetch data for TRs/CSRs, according to the Data Collection Guidelines.
diff[a][d][m][o][x][i]/ldiff[a][d][m][o][x][i] Parameter auditing or MO dump comparisons.
lkr[a] Print RNC Iub resources allocation.
resub Moving Iub resources within or across Subracks (RNC >= P5).
ir[cdpsomt] Iub Redundancy operations for RNC in pool.
rinp[c][m] Live Node Migration to RNC in Pool.
tg[r][c][d] Print Resource Object information for all MOs in LmCell (RNC only).
ueregprint/uer[d][t][i][s][p][v] Print UE registry or UE context data (serving or drifting) for all active calls (RNC only).
ced[h][p][s][g][r] Print consumption of cell resources and rbs hw, cell supported features, cell coordinates (RNC only).
al[atkcg][u] Print the list of active alarms. Acknowledge/Unacknowledge an alarm.
lg[abcdefghijklmnopqrstuvwxyz012345] Fetching and processing of node logs
----------------------------------- OTHER COMMANDS ----------------------------------
uv Print or change moshell configuration settings (also called "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.
dbc[s][a] Database consistency check
dbd[p] Database comparison.
dbcv[r] Perform a DB consistency check (dbc) on the db.dat files of the CVs stored on the node.
ose/coli command Send COLI commands to the CPP node's OSE shell. Type "h ose" for syntax help and "?" to view available commands.
coli Open an interactive COLI or RCS-COLI session to the node.
bo[ar]/ba[swdpmu]/br[wdm]/be[0-50]/bp Manage board groups that can be used for running COLI commands on multiple boards.
lh[z] Run COLI commands on all boards of a board group or MO group.
mon[?][d][u][f][s][t][k][a][-] Start/stop/check CPP target monitor or Linux monitor session in TCP mode, UDP mode, or disk mode.
sql+/sql-/sql? Start/stop/check the SQL client on the node (CXC1325608).
pgu[c][f][r] Program Upgrade. For lab use only, eg, to load black LMs.
procload/proctemp Print processor load or temperature.
proglist/progkill List or restart programs on boards or board groups.
fte Filtered te (trace and error) command.
goxb[acib] Run shell commands in XB boards (CMXB/SCXB/SMXB)
ftree[f][d][1] Recursive listing of a directory on the file system of the node or the workstation.
ftget[c]/ftput[c]/ftdel[a]/ftrun Transfer files or directories to/from the node, using ftp or sftp.
htget Download files using http or https.
edit Edit a file on the node.
fclean[f|ff|a|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.
time[t] Measure time taken by an moshell command or by each command in a moshell command file.
lmid[c][h]/upid[om] Print translation of loadmodule/upgradepackage 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 get <mo> <attribute> command.
col Toggle display of colors.
ul Toggle display of userlabel in st/lst and pget/lpget printout.
conf[bld][+-] Toggle confirmation on various MO commands.
gs[+-]/gsg[+-] Toggle display of old/new attribute value in set/bl/deb commands.
ip2d Convert an IP address to a decimal number.
d2ip/h2ip Convert a decimal or hexadecimal number to an IP address.
h2d/d2h Convert an integer to hexadecimal or viceversa.
h2b/b2h Convert a binary to hexadecimal or viceversa.
d2b/b2d Convert a binary to decimal or viceversa.
rb2ip Print the mapping of RNC IubLink MOs to RBS O&M IP addresses. Only supported in OSSRC.
encpw Create an encoded password for use in Moshell
mos2ro Generate an installation package for moshell read-only version.
gpg Decrypt a gpg-encrypted ESI or PMD file, standalone or contained in a zip/tgz archive.
wait Wait of a specific duration in hrs, mins, secs, rops, or until specified time.
wf[o][a][t] Write lines to a file.
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.
lf[c] Load a moshellrc file or a offline COLI file.
bg[g]/bgs/bgw Run some moshell commands in background or check status of background jobs.
smd[slcr] Server Maintenance - disk usage
pe[c][l][k] CPP post event functions
q/by/exit/quit Exit moshell.
----------------------------------- PM COMMANDS ----------------------------------
pmom[acdpo] Print description of PM counters.
kmom[d] Print description and formulas of KPIs.
pget[m]/lpget[m] Read PM attribute(s) from MO(s).
spget/lspget Read PM attribute(s) one by one ("slow pget").
hpget[c][m]/lhpget[c][m] 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.
hpdiff[m]/lhpdiff[m] Print incrementation of PM attributes, horizontally one line per MO (instead of one line per attribute)
pmx[hfdnsckwlb3zeit] Display counter or KPI values, extracted from the statistics ROP files, or from the MOs in real-time.
pmr[agfkwop3z] Produce PM KPI reports, based on counter values in statistics ROP files and formulas in CPI documentation.
pme[fd][cgurv] Fetch/decode event ROP files (RNC/RBS/ERBS/MSRBS).
pst List all PM scanners and their state.
pgets[n][m][r] Print scanner contents.
pcr[cfpdaz]/lpcr[cfpda] Create a Statistics Scanner or PmJob.
pbl Suspend a scanner.
pdeb Resume a scanner.
pdel[p] Delete a scanner.
emom Display list of events available for each kind of event-based scanner.
pset[d] Set the contents of an event-based scanner (RNC/RBS/ENB/MSRBS).
----------------------------------- HELP CHAPTERS ----------------------------------
0 Revision History
1 Introduction
2 Installation, and user settings
3 Command syntax, regular expressions
4 Command descriptions
5 Lazy
6 Scripting
7 Utilities
8 Server Maintenance
9 Offline Mode and Multi Mode

Type: - h <command> to view command description, e.g: h pget

- h <pattern> to view commands whose description match a string, e.g: h change.*prompt
- h <chapter> to view a chapter, e.g: h 3