You are on page 1of 84

GSM/EDGE BSS, Rel.

RG20(BSS), Operating
Documentation, Issue 11

ETP Service Terminal Commands


DN0984303
Issue 01
Approval Date 2010-12-20
Confidential

Nokia Siemens Networks is continually striving to reduce the adverse environmental effects of
its products and services. We would like to encourage you as our customers and users to join
us in working towards a cleaner, safer environment. Please recycle product packaging and
follow the recommendations for power use and proper disposal of our products and their components.
If you should have questions regarding our Environmental Policy or any of the environmental
services we offer, please contact us at Nokia Siemens Networks for any additional information.

ETP Service Terminal Commands

The information in this document is subject to change without notice and describes only the
product defined in the introduction of this documentation. This documentation is intended for the
use of Nokia Siemens Networks customers only for the purposes of the agreement under which
the document is submitted, and no part of it may be used, reproduced, modified or transmitted
in any form or means without the prior written permission of Nokia Siemens Networks. The
documentation has been prepared to be used by professional and properly trained personnel,
and the customer assumes full responsibility when using it. Nokia Siemens Networks welcomes
customer comments as part of the process of continuous development and improvement of the
documentation.
The information or statements given in this documentation concerning the suitability, capacity,
or performance of the mentioned hardware or software products are given "as is" and all liability
arising in connection with such hardware or software products shall be defined conclusively and
finally in a separate agreement between Nokia Siemens Networks and the customer. However,
Nokia Siemens Networks has made all reasonable efforts to ensure that the instructions
contained in the document are adequate and free of material errors and omissions. Nokia
Siemens Networks will, if deemed necessary by Nokia Siemens Networks, explain issues which
may not be covered by the document.
Nokia Siemens Networks will correct errors in this documentation as soon as possible. IN NO
EVENT WILL Nokia Siemens Networks BE LIABLE FOR ERRORS IN THIS DOCUMENTATION OR FOR ANY DAMAGES, INCLUDING BUT NOT LIMITED TO SPECIAL, DIRECT, INDIRECT, INCIDENTAL OR CONSEQUENTIAL OR ANY LOSSES, SUCH AS BUT NOT LIMITED
TO LOSS OF PROFIT, REVENUE, BUSINESS INTERRUPTION, BUSINESS OPPORTUNITY
OR DATA,THAT MAY ARISE FROM THE USE OF THIS DOCUMENT OR THE INFORMATION
IN IT.
This documentation and the product it describes are considered protected by copyrights and
other intellectual property rights according to the applicable laws.
The wave logo is a trademark of Nokia Siemens Networks Oy. Nokia is a registered trademark
of Nokia Corporation. Siemens is a registered trademark of Siemens AG.
Other product names mentioned in this document may be trademarks of their respective
owners, and they are mentioned for identification purposes only.
Copyright Nokia Siemens Networks 2010. All rights reserved

Important Notice on Product Safety


This product may present safety risks due to laser, electricity, heat, and other sources
of danger.
Only trained and qualified personnel may install, operate, maintain or otherwise handle
this product and only after having carefully read the safety information applicable to this
product.
The safety information is provided in the Safety Information section in the Legal, Safety
and Environmental Information part of this document or documentation set.

The same text in German:

Wichtiger Hinweis zur Produktsicherheit


Von diesem Produkt knnen Gefahren durch Laser, Elektrizitt, Hitzeentwicklung oder
andere Gefahrenquellen ausgehen.
Installation, Betrieb, Wartung und sonstige Handhabung des Produktes darf nur durch
geschultes und qualifiziertes Personal unter Beachtung der anwendbaren Sicherheitsanforderungen erfolgen.
Die Sicherheitsanforderungen finden Sie unter Sicherheitshinweise im Teil Legal,
Safety and Environmental Information dieses Dokuments oder dieses Dokumentationssatzes.

Id:0900d80580825b1d
Confidential

DN0984303

ETP Service Terminal Commands

Table of contents
This document has 84 pages.

DN0984303

1
1.1
1.2
1.3
1.4
1.5
1.5.1
1.5.2
1.5.3
1.6
1.7

Overview of ETP Service Terminal Commands. . . . . . . . . . . . . . . . . . . . 9


Service Terminal in ETP Unit. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 9
Special Characteristics of Service Terminal commands . . . . . . . . . . . . 10
Service Terminal Authentication . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 10
Service Terminal prompt . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 11
Service Terminal Connectivity . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 11
Access through Serial Interface . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 11
Access through Ethernet interface. . . . . . . . . . . . . . . . . . . . . . . . . . . . . 11
Access through BSC/MML interface . . . . . . . . . . . . . . . . . . . . . . . . . . . 12
Service Terminal Commands Output. . . . . . . . . . . . . . . . . . . . . . . . . . . 12
Service Terminal Commands Output Redirection . . . . . . . . . . . . . . . . . 12

2
2.1
2.1.1
2.1.2
2.1.3
2.1.4
2.1.5
2.1.6
2.1.7
2.1.8
2.1.9
2.1.10
2.1.11
2.1.12
2.1.13
2.1.14
2.1.15
2.1.16
2.1.17
2.2
2.2.1
2.2.2
2.2.3
2.2.4
2.2.5
2.2.6
2.2.7
2.2.8
2.2.9
2.2.10
2.2.11
2.2.12

Service terminal commands. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .


Service Terminal Commands for Core Platform . . . . . . . . . . . . . . . . . .
etpexit . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
etphelp . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
ecm (Enable Continuous Mode) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
dcm (Disable Continuous Mode) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
dai (Display Application Ids). . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
dbu (Display Buffer Usage) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
dbp (Display Buffer Per application) . . . . . . . . . . . . . . . . . . . . . . . . . . .
dbs (Display Buffer Statistics) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
dtp (Display Timer Per application) . . . . . . . . . . . . . . . . . . . . . . . . . . . .
dtu (Display Timer Statistics per Unit) . . . . . . . . . . . . . . . . . . . . . . . . . .
etptop . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
acd_dsp . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
mbbrbb. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
acd . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
lnx-hsdiag . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
ddspinfo (Display DSP information) . . . . . . . . . . . . . . . . . . . . . . . . . . . .
co_unit_status . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
General Purpose Commands provided by Linux OS . . . . . . . . . . . . . . .
date . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
uname . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
ls . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
cat . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
rm. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
mkdir . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
rmdir. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
top . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
mv . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
exit . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
ftpput . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Redirection (>) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

Id:0900d80580825b1d
Confidential

13
13
13
13
14
15
16
17
18
19
20
21
21
22
23
23
24
25
26
27
27
27
28
28
29
29
29
30
30
31
31
32

ETP Service Terminal Commands

2.3
2.3.1
2.3.2
2.3.3
2.4
2.4.1
2.4.2
2.4.3
2.4.4
2.5
2.5.1
2.5.1.1
2.5.1.2
2.5.1.3
2.5.1.4
2.5.1.5
2.5.1.6
2.5.1.7
2.5.1.8
2.5.2
2.5.2.1
2.5.2.2
2.5.2.3
2.5.2.4
2.5.2.5
2.5.2.6
2.5.2.7
2.5.2.8
2.5.3
2.5.3.1
2.5.3.2
2.5.3.3
2.5.3.4
2.5.3.5
2.5.3.6
2.5.3.7
2.5.3.8
2.5.3.9
2.5.3.10
2.5.3.11
2.5.3.12
2.5.3.13
2.5.3.14
2.5.3.15
2.5.3.16
2.5.3.17
2.5.3.18

Telnet Server Administration Commands . . . . . . . . . . . . . . . . . . . . . . . . 32


etc (Enable telnet for specified IP address or for All IPs) . . . . . . . . . . . . 32
dtc (Disable telnet for specified IP address or for All IPs) . . . . . . . . . . . . 33
tcstatus (Display list of authenticated IP for telnet connections). . . . . . . 33
Memory manipulation Commands . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 34
dmem (Dump MEMory Contents of Octeon Management Core) . . . . . . 34
wmem (Write to MEMory location of Octeon Management Core) . . . . . 35
dmemdsp (Dump MEMory Contents in a DSP Core) . . . . . . . . . . . . . . . 35
wmemdsp (Write to MEMory location in a DSP Core) . . . . . . . . . . . . . . 36
Service Terminal Commands for Other Platform Modules . . . . . . . . . . . 37
ST Commands for CM module . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 37
cdp (Create a Dynamic Process) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 37
ddp (Delete a Dynamic Process) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 37
rdp (Restart a Dynamic Process) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 38
ddps (Display Dynamic Process State). . . . . . . . . . . . . . . . . . . . . . . . . . 39
ddpl (Display Dynamic Process List) . . . . . . . . . . . . . . . . . . . . . . . . . . . 39
pdp (Prioritize a Dynamic Process). . . . . . . . . . . . . . . . . . . . . . . . . . . . . 40
sett (Set Time) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 40
etpreset (Reset the system) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 41
Utilities Message Monitoring . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 41
emm (Enable Message Monitoring) . . . . . . . . . . . . . . . . . . . . . . . . . . . . 41
dmm (Disable Message Monitoring) . . . . . . . . . . . . . . . . . . . . . . . . . . . . 42
dimm (Display Message Monitoring Configuration) . . . . . . . . . . . . . . . . 42
damm (Disable All Message Monitoring) . . . . . . . . . . . . . . . . . . . . . . . . 43
femm (Fastpath Enable Message Monitoring) . . . . . . . . . . . . . . . . . . . . 44
fdmm (Fastpath Disable Message Monitoring) . . . . . . . . . . . . . . . . . . . . 44
dfimm (Display Fastpath Message Monitoring Configuration) . . . . . . . . 45
sm (Send Message) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 45
Utilities Logging . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 46
sll (Set the Log Level) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 46
ssl (Set the Software Layer) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 47
slf (Set the Logger Feature) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 48
dld (Display the Log Details) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 49
dlf (Display the Logger Feature) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 50
efl (Enable Logging to file) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 51
dfl (Disable Logging to file) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 51
esd (Enable System Dumps) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 52
dsd (Disable System Dumps) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 52
sfs (Set File Size) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 52
gfs (Get File Size) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 53
esl (Enable ST Logging) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 53
dsl (Disable ST Logging). . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 54
dlfi (Display Logging to a File Information) . . . . . . . . . . . . . . . . . . . . . . . 54
remove (remove Logging Files) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 55
emml (Enable MM Data Logging) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 56
dmml (Disable MM Data Logging) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 57
emptylogfile (Empty Log File) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 57

Id:0900d80580825b1d
Confidential

DN0984303

ETP Service Terminal Commands

2.5.3.19
2.5.4
2.5.4.1
2.5.5
2.5.5.1
2.5.5.2
2.5.5.3
2.5.5.4
2.5.5.5
2.5.6
2.5.6.1
2.5.7
2.5.7.1
2.5.7.2
2.5.7.3
2.5.7.4
2.5.8
2.5.8.1
2.5.8.2
2.5.8.3
2.5.8.4
2.5.8.5
2.5.8.6
2.5.8.7
2.6
2.6.1
2.7
2.7.1
2.8
2.8.1
2.8.2
2.9
2.9.1
2.9.2
2.9.2.1
2.9.2.2
2.9.3
2.10
2.10.1
2.10.2
2.10.2.1
2.10.2.2
2.10.2.3
2.10.2.4

antiskid. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 58
Utilities Alarms . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 58
daa (Display active alarms) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 59
Utilities Statistics . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 59
dsco (Display Statistics for a specific COunter) . . . . . . . . . . . . . . . . . . . 59
dsca (Display Statistics Counter for specific CAtegory). . . . . . . . . . . . . 60
rsca (Reset Statistics Counter for specific CAtegory) . . . . . . . . . . . . . . 61
rsco (Reset Statistics for a specific COunter) . . . . . . . . . . . . . . . . . . . . 62
dscfp (Display SCTP Forwarded Packets Counter). . . . . . . . . . . . . . . . 62
Service Terminal Command for HDLC/ML/MC-PPP links management 63
dhdlcinfo . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 63
Service Terminal Command for Interface Manager module . . . . . . . . . 64
dbcfinfo (Display BCF Information for ETPT/E/A) . . . . . . . . . . . . . . . . . 64
dinterface (Display status of the active and protecting interfaces). . . . . 65
dbscp (Display BSC level parameters of the ETPA/C/E/T) . . . . . . . . . . 66
etp_ifconfig (Display Ethernet, VLAN and IP configuration of external and
internal interfaces) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 67
Service Terminal Command for Software Download module . . . . . . . . 69
ssv . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 69
hardware_info . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 70
dbl . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 71
config_etpc_etpsigm_ip . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 71
change_ftp_authentication. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 72
etpsig_m_info . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 72
flash_upgrade . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 73
Service Terminal Command for Message Router module . . . . . . . . . . . 74
etpsig_c_info . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 74
Service Terminal Command for SyncE Handler module . . . . . . . . . . . . 74
dsynce . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 74
Service Terminal Application Commands . . . . . . . . . . . . . . . . . . . . . . . 75
detpps (Display ETP Packet Switched Connections) . . . . . . . . . . . . . . 75
detpcs (Display Ongoing Call Information in ETPT / ETPE / ETPC / ETPA)
76
Service Terminal - Aditional Features . . . . . . . . . . . . . . . . . . . . . . . . . . 78
Commands in Continuous mode . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 78
Disclaimer and Welcome note . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 78
Welcome message . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 78
Disclaimer . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 78
Bootup Phases and Traces . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 78
Service Terminal Commands Related information . . . . . . . . . . . . . . . . 79
Application ids for commands . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 79
Counter ids for DSCO Command . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 81
List of Counters Support in ETPE . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 81
List of Counters Support in ETPT . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 81
List of Counters Support in ETPA . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 82
List of Counters Support in ETPC . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 83
Related information. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 84

DN0984303

Id:0900d80580825b1d
Confidential

ETP Service Terminal Commands

List of figures
Figure 1

ETP Service Terminal . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 9

Id:0900d80580825b1d
Confidential

DN0984303

ETP Service Terminal Commands

List of tables
Table 1
Table 2
Table 3
Table 4
Table 5
Table 6
Table 7
Table 8
Table 9

DN0984303

Service Terminal Parameter Interpretation . . . . . . . . . . . . . . . . . . . . . .


Service Terminal Prompt Description . . . . . . . . . . . . . . . . . . . . . . . . . .
124 - Packet Abis Traffic measurement . . . . . . . . . . . . . . . . . . . . . . . .
128 - ETP Ethernet BSC measurement. . . . . . . . . . . . . . . . . . . . . . . . .
124 - Packet Abis Traffic measurement . . . . . . . . . . . . . . . . . . . . . . . .
128 - ETP Ethernet BSC measurement . . . . . . . . . . . . . . . . . . . . . . . .
130-AoIP Traffic BSC measurement . . . . . . . . . . . . . . . . . . . . . . . . . . .
131-AoIP Traffic TCSM measurement . . . . . . . . . . . . . . . . . . . . . . . . .
129-ETP Ethernet TCSM measurement . . . . . . . . . . . . . . . . . . . . . . . .

Id:0900d80580825b1d
Confidential

10
11
81
81
81
82
82
83
83

ETP Service Terminal Commands

Id:0900d80580825b1d
Confidential

DN0984303

ETP Service Terminal Commands

Overview of ETP Service Terminal Commands

1 Overview of ETP Service Terminal


Commands
Service Terminal is a visual display terminal connected to either a serial, Ethernet or
BSC MML interface to the ETP. Service terminal is used in monitoring of the system as
well as in fault investigations. Operator starts a service terminal session either on a
serial terminal physically connected to an ETP unit or via an ethernet interface using the
telnet protocol or via the MML interface by establishing a remote service terminal
session using the appropriate MML command. Serial port settings used in ETP Service
Terminal are as follows :

1.1

Baud Rate : 9600


Data Bits : 8
Parity : None
Stop Bits : 1
Flow Control : None

Service Terminal in ETP Unit


The ETP Release 1 Service Terminal functionality is based on Linux shell running on
Management Core of Octeon. DSPs do not have a direct Service Terminal interface.
Commands to the DSPs are sent via the Octeon.
ETP Service Terminal operating environment is depicted in the below figure:

Figure 1

DN0984303

ETP Service Terminal

Id:0900d80580825c29
Confidential

Overview of ETP Service Terminal Commands

1.2

ETP Service Terminal Commands

Special Characteristics of Service Terminal commands


ETP Service terminal commands are different from the MML commands. The ETP
Service Terminal commands follow the Linux command syntax. Following points needs
to be taken care of when using the ETP Service Terminal commands:

The ETP Service Terminal commands follow the Linux command syntax i.e. the
parameters are separated via a space separator and commands are considered to
be complete and interpreted when the Enter key is pressed.
Help on ETP commands is obtained by typing
etphelp
etphelp <command>
? <command>
ETP Service Terminal commands are case sensitive. The commands are entered
using lower case letters.
The syntax of every command is documented in this Manual. Detailed help on each
command and its syntax is obtained by typing etphelp <command name>. The
parameters are to be interpreted as explained below:
Parameter
Syntax

[<Parameter>]

Interpretation
Specifies that the parameter Parameter is Optional and its
value is not mandatory to specify. e.g. the syntax of help
command is etphelp [<command>] this command can be
executed as:
etphelp dai or
etphelp

{Parameter}

Specifies that the parameter Parameter is conditionally


optional and needs to be specified only under a certain condition, as explained in the command description.e.g. the syntax
of dbu command is dbu <processor type>{:<dsp block id>} this
command can be executed as:
dbu oct or
dbu dsp:1 but not dbu dsp

<Parameter>

Specifies that the parameter Parameter is mandatory parameter and its value must be specified. e.g. the syntax of ecm
command is ecm <refresh time in seconds> this command can
be executed as:
ecm 3

Table 1

1.3

Service Terminal Parameter Interpretation

Service Terminal Authentication


Service Terminal authenticates every operator from DX (with username and password)
for the Serial and Telnet interface.

g
10

No Authentication is done for the Service Terminal sessions originating from the BSC
MML interface.

Id:0900d80580825c29
Confidential

DN0984303

ETP Service Terminal Commands

1.4

Overview of ETP Service Terminal Commands

Service Terminal prompt


The ETP Service Terminal prompt displays the ETP Identifiers.
Prompt

Explanation

ETPX/Y/Z>

The ST Prompt displays the ETP Identifier.X is the ETP Variant,


Y is the ETP unit type and Z is the etp index

Possible Suffixes

Explanation

/C

If the continuous mode is enabled the ST prompt will change so


as to indicate to the user that this mode has been enabled. The
prompt will be as: ETPE/1/0/C>

/L

If the esl command has been run, the Service Terminal


Logging mode has been switched ON. The prompt will be as:
ETPE/1/0/L>

Table 2

Service Terminal Prompt Description

Service Terminal prompt can be a combination of any of the suffixes specified above
e.g. if the user has enabled both the continuous mode and Logging mode, the prompt
will look like ETPE/0/1/C/L>.

1.5

Service Terminal Connectivity


ETP Service Terminal can be accessed through a Serial Interface, Ethernet interface or
via the BSC MML interface. The Sections below highlights how to access the ETP
Service Terminal through the various available interfaces.

1.5.1

Access through Serial Interface


ETP Service Terminal can be accessed through the Serial Interface. The operator
needs to configure a connection in the software to choose the correct COM port. In case
the operator is using Windows OS then a third party software like TeraTerm can be used
to access the ETP Service Terminal. As soon as the operator connects the terminal
through the Serial Interface and press enter, the Service Terminal login prompt would
appear.

1.5.2

Access through Ethernet interface


Service Terminal can be accessed through the Ethernet Interface. This requires that the
operator has a Telnet Client from the source machine. For e.g.: if the operator is trying
to access the ETP Service terminal through a Windows machine, then the scenario
would be as explained below:
The operator opens a command prompt and enters the following command:
telnet 139.85.241.14
Where 139.85.241.14 is the IP Address of the ETP management interface (i.e ETPSIGm ip address). The operator would get the Service Terminal login prompt.

DN0984303

Id:0900d80580825c29
Confidential

11

Overview of ETP Service Terminal Commands

1.5.3

ETP Service Terminal Commands

Access through BSC/MML interface


Service Terminal can be accessed through the BSC MML Interface. This requires that
the operator has already logged in to the Service Terminal of BSC and there the
operator executes BSC MML command to login to the Service Terminal of ETP.
Operator would use commands ZRS/ZRSS to connect through BSC MML interface.

1.6

Service Terminal Commands Output


All the ST Commands will contain a header, which displays the Date and Timestamp,
so as to enable the user to do offline analysis, especially in commands related Statistics
measurement. The format of the header is as follows:

-------------------------------------------------------------------------------------> Command XXX executed on [dd/mm/yyyy Hr:Min:Sec:Micro-Seconds] <------------------------------------------------------------------------------------Where XXX is the command name e.g. if etphelp Command is executed the header
format is as follows:
----------------------------------------------------------------------------------------> Command etphelp executed on [01/04/2009 12:06:36:260001] <----------------------------------------------------------------------------------------

1.7

Service Terminal Commands Output Redirection


Almost all the ST commands generate some form of output. The output of all the ETP
commands (except the Linux Commands) can be redirected to a file , using esl
command, while the output of all the linux commands can be redirected to a file, by a
special output redirection symbol >, e.g.: The operator wants to redirect the output of
the ps command, the operator can type ps > ps_output.txt, This does not generate any
output on the Service Terminal Screen but redirects the command output which is generated as a direct result of this command to a file called ps_output.txt. The contents of
this file can then be seen by typing the command cat ps_output.txt on the service
terminal screen.

12

Id:0900d80580825c29
Confidential

DN0984303

ETP Service Terminal Commands

Service terminal commands

2 Service terminal commands


2.1

Service Terminal Commands for Core Platform


The commands described below relate to the complete ETP system.

2.1.1

etpexit
Function
With this command you exit the current session and return to the login prompt.
Syntax
etpexit
Examples
1. Exit the service terminal session.
etpexit
Execution printouts

ETPT/1/0>etpexit
------------------------------------------------------------------------------------> Command etpexit executed on [1/4/2009 0:13:10:793502] <-----------------------------------------------------------------------------------Connection closed

2.1.2

etphelp
Function
With this command you print the syntax and a short explanation for each of the ETP ST
command.
Syntax
etphelp [<command>]
Examples
1. To display help and listing of all the ETP ST commands available in the system
etphelp
2. To display help on a specific command named dai
etphelp dai
Execution printouts

etphelp command is invoked without any parameter, the output is as


followsETPT/1/0>etphelp
------------------------------------------------------------------------------------> Command etphelp executed on [12/3/2009 20:12:20:374161] <-------------------------------------------------------------------------------------------------------------------------------------------------------------------Detailed help and syntax of any command can be displayed

DN0984303

Id:0900d80580825b4d
Confidential

13

Service terminal commands

ETP Service Terminal Commands

By Typing etphelp <command name>


For e.g.: etphelp dai
Interractive help mode can be invoked
By Typing etphelp -i
--------------------------------------------------------------------------------Command | Description
------------------------------------------------------------------------------------------------------------------------------------------------------------------------- ST Commands For Core Platform-------------------------------------------------------------------------------------------------<command name>
| <command description>
<command name>
| <command description>
<command name>
| <command description>
<command name>
| <command description>
<command name>
| <command description>
----------------------------------------------------------------------------------------- Telnet Server Administration Commands ------------------------------------------------------------------------------------------<command name>
| <command description>
<command name>
| <command description>
<command name>
| <command description>
----------------------------------------------------------------------------------------- Memory Manipulation Commands --------------------------------------------------------------------------------------------<command name>
| <command description>
----------------------------------------------------------------------------------------- ST Commands For Message Monitoring Utilities ------------------------------------------------------------------------------------------------------<command name>
| <command description>
<command name>
| <command description>
<command name>
| <command description>

2.1.3

ecm (Enable Continuous Mode)


Function
With this command you set the ETP commands in Continuous mode. When the continuous mode is set, certain commands executed by the operator would run continuously
after every specified number of seconds. The operator can stop the command execution
by executing Control-C characters. The ETP Service Terminal Prompt is changed,
when the continuous mode is set.
Syntax
ecm <refresh time in seconds>

14

Id:0900d80580825b4d
Confidential

DN0984303

ETP Service Terminal Commands

Service terminal commands

Examples
1. To enable continuous mode with a refresh interval of 3 seconds
ecm 3
2. To enable continuous mode with a refresh interval of 6 seconds
ecm 6
Execution printouts
ETPT/1/0>ecm 3
------------------------------------------------------------------------------------> Command ecm executed on [1/4/2009 0:55:49:732112] <-----------------------------------------------------------------------------------Refresh time configured '3' seconds
Enabling Continuous mode for the following commands
--------------------------------------------------------------------------------etptop
daa
dbu
dbp
dbs
dtu
dtp
dsco
dsca
---------------------------------------------------------------------------------

2.1.4

dcm (Disable Continuous Mode)


Function
With this command you disable the ETP ST commands in Continuous mode. After this,
the commands would not execute in continuous mode and would exit after a single execution.
Syntax
dcm
Examples
1. To disable the continuous mode
dcm
Execution printouts

ETPT/1/0/C>dcm
------------------------------------------------------------------------------------> Command dcm executed on [1/4/2009 0:56:44:826240] <-----------------------------------------------------------------------------------Disabling Continuous mode for the following commands
--------------------------------------------------------------------------------etptop
daa
dbu

DN0984303

Id:0900d80580825b4d
Confidential

15

Service terminal commands

ETP Service Terminal Commands

dbp
dbs
dtu
dtp
dsco
dsca
---------------------------------------------------------------------------------

2.1.5

dai (Display Application Ids)


Function
With this command you display the list of application ids on Octeon and DSP, so as to
assist the operator in order to give correct application ids in the ETP ST Commands.
Syntax
dai
Examples
1. To display the application ids
dai
Execution printouts

ETPT/1/0>dai
------------------------------------------------------------------------------------> Command dai executed on [1/4/2009 0:56:44:826240] <------------------------------------------------------------------------------------

************************************************************
Application Name
Application ID
**************************************************************
Application IDs for Octeon
**************************************************************
--------------------------------------------------------------------------------MR
1
SDL
2
.
.
.
--------------------------------------------------------------------------------Application Ids on DSP
--------------------------------------------------------------------------------CM
1
Logger
2
.
.
.
---------------------------------------------------------------------------------

16

Id:0900d80580825b4d
Confidential

DN0984303

ETP Service Terminal Commands

2.1.6

Service terminal commands

dbu (Display Buffer Usage)


Function
With this command you display buffers per unit.
Syntax for Octeon
dbu <processor type>
Syntax for DSP
dbu <processor type>{:<dsp block id>}{:<dsp core id>}
Examples
1. To display buffers used by Octeon
dbu oct
2. To display buffers used by DSP
dbu dsp <dsp id> <dsp core id>
Execution printouts
Execution printouts for Octeon:

ETPE/3/0>dbu oct
---------------------------------------------------------------> Command dbu executed on [12/1/2001 1:6:26:434323] <---------------------------------------------------------------

--------------------------------------------------------------------------------Pool Buffer
Busy
Free
Current
Max
Total
Used
Free
ID
Size
Buffers Buffers
Usage
Usage
Bytes
Bytes
Bytes
----------------------------------------------------------------------------------------------------------------------------------------------------------------FPA Pools
4
2048
152
12848
1.169231
1.776923
26624000
311296
26312704
5
8320
1
6999
0.014286
0.014286
58240000
8320
58231680
6
1150080
61
4
93.846153
96.923080 74755200
70154880 4600320
7
16240128 0
1
0.000000
0.000000
16240128
0
16240128
--------------------------------------------------------------------------------Total:
175859328
70474496
105384832
--------------------------------------------------------------------------------Internal Pools
8
28
0
200
0.000000
0.500000
5600
0
5600
9
40
0
200
0.000000
0.000000
8000
0
8000
10 852
0
200
0.000000
0.000000
170400
0
170400
11 16384
0
100
0.000000
1.000000
1638400
0
1638400
12 65512
0
25
0.000000
0.000000
1637800
0
1637800
13 148032
0
1
0.000000
0.000000
148032
0
148032
14 400000
0
1
0.000000
0.000000
400000
0
400000
15 1397760 0
2
0.000000
0.000000
2795520
0
2795520
16 5592000 0
2
0.000000
0.000000
11184000
0
11184000
17 48000000 0
1
0.000000
0.000000
48000000
0
48000000

DN0984303

Id:0900d80580825b4d
Confidential

17

Service terminal commands

ETP Service Terminal Commands

18 2000
0
000
0.000000
0.000000
10000000
0
10000000
--------------------------------------------------------------------------------Total:
75987752
0
75987752
--------------------------------------------------------------------------------ETPE/3/0>
Execution printouts for DSP:
ETPE/3/0>dbu dsp:2:1
---------------------------------------------------------------> Command dbu executed on [12/1/2001 1:9:8:233132] <---------------------------------------------------------------

-------------------------------------------------------------------------------Buffer Busy
Free
Current
Max
Total
Used
Free
size
buffers buffers
usage
usage
bytes
bytes
bytes
-------------------------------------------------------------------------------8
0
32624
0.00%
0.00%
260992
0
260992
20
0
33621
0.00%
0.00%
672420
0
672420
24
7
64126
0.01%
0.01%
1539192
168 1539024
32
3
267
1.11%
1.11%
8640
96
8544
48
0
695
0.00%
0.00%
33360
0
33360
76
0
784
0.00%
0.00%
59584
0
59584
132
0
352
0.00%
0.00%
46464
0
46464
256
0
611
0.00%
0.00%
156416
0
156416
516
0
28
0.00%
0.00%
14448
0
14448
700
0
29
0.00%
0.00%
20300
0
20300
1564
2
1026
0.19%
0.19%
1607792
3128 1604664
3572
0
29
0.00%
0.00%
103588
0
103588
6144
1
65
1.51%
1.51%
405504
6144
399360
6532
0
42
0.00%
0.00%
274344
0
274344
9608
0
30
0.00%
0.00%
288240
0
288240
23564
0
73
0.00%
0.00%
1720172
0 1720172
-------------------------------------------------------------------------------Total
0.13%
0.13%
7211456
9536 7201920
-------------------------------------------------------------------------------ETPE/3/0>

2.1.7

dbp (Display Buffer Per application)


Function
With this command you display buffer statistics for a particular application.
Syntax for Octeon
dbp <processor type>:<application id>

18

Id:0900d80580825b4d
Confidential

DN0984303

ETP Service Terminal Commands

Service terminal commands

Syntax for DSP


dbp <processor type>{:<dsp block id>}{:<dsp core
id>}:<application id>
Examples
1. To display buffers used on Octeon for a particular application
dbp oct:<application id>
2. To display buffers used on DSP for a particular application
dbp dsp <dsp block id> <dsp core id> <application id>
Execution printouts
ETPT/1/0>dbp dsp:1:2:5-----------------------------------------------------------------------------------> Command dbp executed on [29/6/2009 10:14:39:576256] <-----------------------------------------------------------------------------------Buffer statistics for application 5
--------------------------------------------------------------------------------Buffer size
Buffer address
Allocation time (in millisecs)
--------------------------------------------------------------------------------32
0xe2fc43a8
21
--------------------------------------------------------------------------------Total memory usage
32
Peak memory usage
32
Minimum memory usage
32
---------------------------------------------------------------------------------

2.1.8

dbs (Display Buffer Statistics)


Function
With this command you display statistics of buffers of a particular size.
Syntax for Octeon
dbs <processor type> <buffer size>
Syntax for DSP
dbs <processor type>{:<dsp block id>} {:<dsp core id>}
<buffer size>
Examples
1. To display statistics for a particular buffer used on Octeon
dbs oct:<buffer size>
2. To display statistics for a particular buffer used on DSP
dbs dsp <dsp block id> <dsp core id>< buffer size >
Execution printouts

ETPT/1/0>dbs dsp:1:2 32
------------------------------------------------------------------------------------> Command dbs executed on [29/6/2009 10:18:17:688252] <------------------------------------------------------------------------------------

DN0984303

Id:0900d80580825b4d
Confidential

19

Service terminal commands

ETP Service Terminal Commands

Buffer statistics for size 32


--------------------------------------------------------------------------------Owner's appid
Buffer address
Allocation time(in millisecs)
--------------------------------------------------------------------------------24
0xe2fc42e8
13
4
0xe2fc4318
6616713
1
0xe2fc4348
13
28
0xe2fc4378
13
5
0xe2fc43a8
21
4
0xe2fc4408
6616713
---------------------------------------------------------------------------------

2.1.9

dtp (Display Timer Per application)


Function
With this command you display the timers per application.
Syntax for Octeon
dtp <processor type>:<application id>
Syntax for DSP
dtp <processor type>{:<dsp block id>}{:<dsp core
id>}:<application id>
Examples
1. To display timers for a particular application on Octeon
dtp oct:<application id>
2. To display timers for a particular application on DSP
dtp dsp <dsp block id> <dsp core id> <application id>
Execution printouts

ETPT/1/0>dtp dsp:1:3:5
------------------------------------------------------------------------------------> Command dtp executed on [29/6/2009 10:24:21:230261] <-----------------------------------------------------------------------------------Timer statistics for application 5
--------------------------------------------------------------------------------Timer id
Timer value(ms)
Timer type
Time left till next expiry (ms)
--------------------------------------------------------------------------------0xe2fc43b8
200
periodic
18
--------------------------------------------------------------------------------ETPT/1/0>dtp oct:5
dtp oct:1
---------------------------------------------------------------> Command dtp executed on [1/1/1970 0:8:57:93523] <---------------------------------------------------------------------------------------------------------------------------------------------Core
App
Timer
Timer
Timer
Time left

20

Id:0900d80580825b4d
Confidential

DN0984303

ETP Service Terminal Commands

Service terminal commands

Group
id
Id
Value(ms)
Type
till next expiry(ms)
-------------------------------------------------------------------------------15
1
0x28174c80
5000
one shot
221
15
1
0x28175480
10000
periodic
3651
-------------------------------------------------------------------------------Total Timers Runnning for APP ID 1: 2
--------------------------------------------------------------------------------

2.1.10

dtu (Display Timer Statistics per Unit)


Function
With this command you list the timer statistics per application for all the applications, on
Octeon only.
Syntax
dtu
Examples
1. To display the timers currently started in the Octeon processor
dtu
Execution printouts

ETPT/1/0> dtu-----------------------------------------------------------------------------------> Command dtu executed on [11/7/20085:9:59:212769] <------------------------------------------------------------------------------------------------------------------------------------------------------------------Core


App
Timer
Timer
Timer
Time left
Group
id
id
value(ms)
type
till next expiry(ms)
--------------------------------------------------------------------------------15
1
0x736e3a8
70
periodic
46
1
5
0x736e078
1000
periodic
284
2
7
0x736e108
1800000
periodic
1250468
2
7
0x736e138
1800000
periodic
1250642
--------------------------------------------------------------------------------Total Timers Running: 4
---------------------------------------------------------------------------------

2.1.11

etptop
Function
This command specifies load in percentage of requested processor in the system.
Syntax
etptop <processor type>{:<octeon core id/dsp block
id>}{:<dsp core id/no_of_processes>}

DN0984303

Id:0900d80580825b4d
Confidential

21

Service terminal commands

ETP Service Terminal Commands

Examples
1. To display the load of the octeon management core
etptop oct:0
2. To display the load of 2nd core of DSP block 1
etptop dsp:2:1
3. To display top 7 loading processes of Octeon management core
etptop oct:0:7
Execution printouts
ETPT/1/0>etptop oct:0
------------------------------------------------------------------------------------> Command etptop executed on [29/6/2009 10:24:21:230261] <-----------------------------------------------------------------------------------CPU usage of management core is 0.0%
---------------------------------------------------------------------------------

2.1.12

acd_dsp
Function
With this command you display latest crashed dsp cores last stack trace (function call).
Syntax
acd_dsp <dsp block id>:<dsp core id>
Examples
1. To display last stack trace of crashed dsp core
acd_dsp <dsp block id>:<dsp core id>
Execution printouts

ETPT/1/0> acd_dsp 1:5


------------------------------------------------------------------------------------> Command acd_dsp executed on [29/6/2009 10:24:21:230261] <-----------------------------------------------------------------------------------0xe0191b98 0xe0191b98 _stub_ret
0x009a3992 0x009a38e0 odo_error
0x009a39f4 0x009a39e0 error
0x009908a0 0x0099088e nmi_handler
0xe0122d7c 0xe0122d24 dlrlc_check_radio_priority_reduction
0xe01294a4 0xe0129374 dlrlc_remove_expired_llc_pdus
0xe012cf14 0xe012cb04 dlrlc_insert_llc_pdu_in_queue
0xe0138964 0xe01386d8 dlrlc_process_pdm_llc_pdu_req
0x00991fc8 0x00991dec dlrlc_tbf_state_machine
---------------------------------------------------------------------------------

22

Id:0900d80580825b4d
Confidential

DN0984303

ETP Service Terminal Commands

2.1.13

Service terminal commands

mbbrbb
Function
This command is used to read multiple black boxes of a particular dsp/octeon core (function calls).
Syntax
mbbrbb <processor type> {:<dsp block id>/<octeon core
id>}{:<dsp core id>} -all | -n
Examples
1. To display last stack trace of crashed dsp/octeon core
mbbrbb oct/dsp {:<dsp block id>/<octeon core id>}{:<dsp core
id>} -all | -n
Execution printouts

ETPT/1/0>mbbrbb dsp 1:5


------------------------------------------------------------------------------------> Command mbbrbb executed on [29/6/2009 10:24:21:230261] <-----------------------------------------------------------------------------------0xe0191b98 0xe0191b98 _stub_ret
0x009a3992 0x009a38e0 odo_error
0x009a39f4 0x009a39e0 error
0x009908a0 0x0099088e nmi_handler
0xe0122d7c 0xe0122d24 dlrlc_check_radio_priority_reduction
0xe01294a4 0xe0129374 dlrlc_remove_expired_llc_pdus
0xe012cf14 0xe012cb04 dlrlc_insert_llc_pdu_in_queue
0xe0138964 0xe01386d8 dlrlc_process_pdm_llc_pdu_req
0x00991fc8 0x00991dec dlrlc_tbf_state_machine
---------------------------------------------------------------------------------

2.1.14

acd
Function
This command is used to display latest crashed Octeon cores last stack trace (function
call).
Syntax
acd <octeon core id>
Examples
1. To display last stack trace of crashed octeon core
acd <octeon core id>
Execution printouts

ETPT/1/0>acd 0
------------------------------------------------------------------------------------> Command acd executed on [7/8/2008 1:54:35:567605] <------------------------------------------------------------------------------------

DN0984303

Id:0900d80580825b4d
Confidential

23

Service terminal commands

ETP Service Terminal Commands

MC crashed on
Mon Sep 21 11:01:02 2009
func : log_sw_level_str

120191404

func : log_sw_level_str - 12019140c


---------------------------------------------------------------------------------

2.1.15

lnx-hsdiag
Function
With this command you execute command line diagnosis tests from ST. It accepts six
options; each corresponds to one diagnosis tests.
Syntax
lnx-hsdiag <option>
Examples
1. To start Memory Test
lnx-hsdiag -1
2. To start Timing Test
lnx-hsdiag -2
3. To start GigE Test
lnx-hsdiag -3
4. To start Synchronization Test
lnx-hsdiag -4
5. To start Hotlink Interface Test
lnx-hsdiag -5
6. To start Switchover Logic
lnx-hsdiag -6
Execution printouts

ETPT/1/0> lnx-hsdiag -1
---------------------------------------------------------------------------------->Command lnx-hsdiag executed on [7/8/2008 1:54:35:567605] <----------------------------------------------------------------------------------lnx-hsdiag: Memory Test is initiated.
lnx-hsdiag: ETP is going to restart. Result of test will be shown on Serial
Terminal.
--------------------------------------------------------------------------------ETPT/1/0> lnx-hsdiag -2
---------------------------------------------------------------------------------->Command lnx-hsdiag executed on [7/8/2008 1:54:35:567605] <----------------------------------------------------------------------------------Test Executed. Timing Test Result: TEST PASSES.
--------------------------------------------------------------------------------ETPT/0/1> lnx-hsdiag -3
---------------------------------------------------------------------------------

24

Id:0900d80580825b4d
Confidential

DN0984303

ETP Service Terminal Commands

Service terminal commands

-->Command lnx-hsdiag executed on [7/8/2008 1:54:35:567605] <----------------------------------------------------------------------------------GigE Interface Test Executed. Diagnosis Result:
Eth SFP0 status:00
Eth SFP1 status:11
MB PHY1 IF status: 1011
MB PHY2 IF status: 1000
DB PHY1 IF status: 1111
DB PHY1 IF status: 1111
Where,
Eth SFP<id> status: <Rx LOSS><Tx Fault>
MB(Mother Board) PHY<ID> status: <PORT0><PORT1><PORT2><PORT3>
DB(Daughter Board) PHY<ID> status: <PORT0><PORT1><PORT2><PORT3>
--------------------------------------------------------------------------------ETPT/1/0> lnx-hsdiag -4
---------------------------------------------------------------------------------->Command lnx-hsdiag executed on [7/8/2008 2:54:35:567605] <----------------------------------------------------------------------------------Test Executed. Synchronous Test Result: TEST PASSES
--------------------------------------------------------------------------------ETPT/1/0> lnx-hsdiag -5
---------------------------------------------------------------------------------->Command lnx-hsdiag executed on [7/8/2008 1:54:35:567605] <----------------------------------------------------------------------------------Hotlink Interface Test Executed. Diagnosis Result:
Hotlink Status:3
--------------------------------------------------------------------------------ETPT/1/0> lnx-hsdiag -6
---------------------------------------------------------------------------------->Command lnx-hsdiag executed on [7/8/2008 1:54:35:567605] <----------------------------------------------------------------------------------Switchover Logic Test Result: TEST PASSES
--------------------------------------------------------------------------------ETPT/1/0>

2.1.16

ddspinfo (Display DSP information)


Function
With this command you displays the DSP information.
Syntax
ddspinfo [<dsp block id>][:<dsp core id>]
ddspinfo all
Examples
1. To display the information about DSP core 2 in DSP block 1
ddspinfo 1 2

DN0984303

Id:0900d80580825b4d
Confidential

25

Service terminal commands

ETP Service Terminal Commands

2. To display the state information of all the DSPs


ddspinfo all
Execution printouts
ETPT/1/0> ddspinfo 1 2
------------------------------------------------------------------------------------> Command ddspinfo executed on [7/8/2008 1:54:35:567605] <-----------------------------------------------------------------------------------DSP Block
DSP Core
STATE
1
2
1 (DSP READY)
Where DSP state,
0 - DSP_UNKNOWN
1 - DSP_READY
2 - DSP_FAILED
3 - DSP_NOT_FUNCTIONAL
ETPE/1/0>ddspinfo all
---------------------------------------------------------------> Command ddspinfo executed on [29/6/2010 14:59:10:935381] <--------------------------------------------------------------DSP Block
STATE
Core crashed
0
1 (READY)
1
1 (READY)
2
1 (READY)
3
1 (READY)
4
1 (READY)
5
1 (READY)
6
1 (READY)
7
1 (READY)
ETPE/3/0>

2.1.17

co_unit_status
Function
With this command you display the status of pair as well as current ETP unit in case of
ETPE/C/T variants. The status information displays the state and role of the ETP unit.
Syntax
co_unit_status
Examples
1. To display status of co_unit
co_unit_status
Execution printouts

ETPE/3/0>co_unit_status
---------------------------------------------------------------> Command co_unit_status executed on [1/7/2010 12:32:33:26807] <----

26

Id:0900d80580825b4d
Confidential

DN0984303

ETP Service Terminal Commands

Service terminal commands

-----------------------------------------------------------------------------------------------------------------------------Current Unit Role = PROTECTING


Current Unit State = UNIT_STATE_T_WOEX_C
CO Unit State
= UNIT_STATE_T_WOEX_C
CO Unit Role
= ACTIVE
------------------------------------------------------------------ETPE/3/0>

2.2

General Purpose Commands provided by Linux OS


This Section contains the commands, which are provided by the Linux OS itself and no
change have been done in their functionality. This section highlights the commands,
which apply to the General Category of the Service Terminal commands.

2.2.1

date
Function
This command is used to display the date of the system. The date displayed is in the
format yyyy-Month-DD.
Syntax
date
Examples
1. To display the current date of the system
date
Execution printouts

ETPE/1/0>date
Wed Apr 1 18:21:32 IST 2009

2.2.2

uname
Function
This command displays the version of the Linux kernel.
Syntax
uname
Examples
1. To display the running OS name
uname
2. To display the version of Linux kernel
uname -a

DN0984303

Id:0900d80580825b4d
Confidential

27

Service terminal commands

ETP Service Terminal Commands

Execution printouts
ETPE/1/0>uname
Linux
ETPE/1/0>uname -a
Linux (none) 2.6.27.18-LOCAL-WR3.0bg_standard-dirty #1 SMP PREEMPT Wed Jun 16
21:47:23 IST 2010 mips64 unknownETPE/1/0>

2.2.3

ls
Function
The ls command lists the specified files or the files and subdirectories in that directory
where the command is executed. Two option flags are possible.
Syntax
ls [<options>][<dirname/filename>]
Examples
1. To display the listing of files in the current directory
ls
2. To display the long listing of files in the current directory
ls l
Execution printouts

ETPC/1/0>ls
ram
dump.dat
IGWBTDSD.hex
IGWDGDSD.hex
IGWMNDSD.hex
log_file.txt
etc

2.2.4

cat
Function
The cat command concatenates files. It reads each <filename> in sequence and outputs
the file's data on the standard output. Without filename, it reads from standard input. Exit
the standard input read mode by pressing Ctrl-c.
Syntax
cat [<filename>]
Examples
1. To display the contents of an already existing file named abc.txt on the screen
cat abc.txt
Execution printouts

ETPE/1/0>cat abc.txt
/* This is a sample text file called abc.txt */

28

Id:0900d80580825b4d
Confidential

DN0984303

ETP Service Terminal Commands

2.2.5

Service terminal commands

rm
Function
The rm command removes (deletes) the specified files. The file(s) must not be open.
Syntax
rm [-f] <filename>
Examples
1. To remove a file named log_file.txt
rm log_file.txt
Execution printouts

ETPT/1/0>rm log_file.txt
Could not remove 'log_file.txt': Permission denied.

2.2.6

mkdir
Function
The mkdir command creates the specified directory.
Syntax
mkdir <directory>
Examples
1. To create directory named /ram/mydir
mkdir /ram/mydir
Execution printouts

ETPT/1/0>mkdir /ram/mydir
Could not create directory '/ram/mydir': File exists.

2.2.7

rmdir
Function
The rmdir command deletes the specified directory.
Syntax
rmdir <directory>
Examples
1. To remove a directory named /ram/mydir
rmdir /ram/mydir
Execution printouts

ETPE/1/0>rmdir /ram/mydir
Could not remove directory '/ram/mydir': No such file or directory.

DN0984303

Id:0900d80580825b4d
Confidential

29

Service terminal commands

2.2.8

ETP Service Terminal Commands

top
Function
The top command is used display top CPU processes on the management core only.
Syntax
top n 1
Examples
1. To display the top CPU processes in the Octeon management core :
top n 1
Execution printouts

ETPT/1/0> top n 1
Mem: 185036K used,
CPU: 0.0% usr 0.2%
Load average: 0.00
PID PPID USER STAT
982 799 root R
751 1
root S
799 798 root S
798 714 root S
716 1
root S
714 1
root S
1
0
root S
725 2
root SWN
673 2
root SW<
7
2
root SW<
2
0
root SW<
3
2
root SW<
4
2
root SW<
5
2
root SW<
6
2
root SW<
33 2
root SW<
58 2
root SW
59 2
root SW
60 2
root SW<
102 2
root SW<
ETPT/1/0>

2.2.9

326112K free, 0K shrd, 0K buff, 50368K cached


sys 0.0% nice 99.8% idle 0.0% io 0.0% irq 0.0% softir
0.13 0.09
VSZ
%MEM %CPU COMMAND
3668 0.7 0.2 top
279m 55.9 0.0 /et_seum.elf
18204 3.5 0.0 ./bash etp telnetd
8664 1.6 0.0 in.telnetd: 10.1.6.9
8576 1.6 0.0 /sbin/mingetty ttyS0
3776 0.7 0.0 xinetd
3488 0.6 0.0 init
0
0.0 0.0 [jffs2_gcd_mtd2]
0
0.0 0.0 [BOND0]
0
0.0 0.0 [khelper]
0
0.0 0.0 [kthreadd]
0
0.0 0.0 [migration/0]
0
0.0 0.0 [ksoftirqd/0]
0
0.0 0.0 [watchdog/0]
0
0.0 0.0 [events/0]
0
0.0 0.0 [kblockd/0]
0
0.0 0.0 [pdflush]
0
0.0 0.0 [pdflush]
0
0.0 0.0 [kswapd0]
0
0.0 0.0 [aio/0]

mv
Function
The mv command moves or renames the specified file or directory.
Syntax
mv

30

<source>

<destination>

Id:0900d80580825b4d
Confidential

DN0984303

ETP Service Terminal Commands

Service terminal commands

Examples
1. To mv a file named test.log to test_old.log
mv /ram/test.log /ram/test_old.log
Execution printouts
ETPT/1/0>mv /ram/test.log /ram/test_old.log
Could not open file '/ram/test.log' : No such file or directory.

2.2.10

exit
Function
This command is used to exit the current session.
Syntax
exit
Examples
1. To exit form the current session
exit
Execution printouts

ETPT/1/0>exit

2.2.11

ftpput
Function
The ftpput command can be used to transfer a file from ETP to either a Windows host
machine or to a Linux host machine. Before transferring the file, FTP Server is needed
to run on the host.
Syntax
ftpput -v <Destination IP> -u <Username> -p <Password>
<Path on Destination Machine> <Filename>
Examples
1. To ftp a file named core_dump to host with IP as 10.14.14.20 in the path /home/etp
using the username and password as etp and etp respectively.
ftpput -v 10.14.14.20 -u etp -p etp /home/etp/core_dump
core_dump
Execution printouts

ETPT/1/0> ftpput -v 10.14.14.20 -u etp -p etp /home/etp/core_dump core_dump


Connecting to 10.14.14.20 (10.14.14.20:21)
ftpput: cmd (null) (null)
ftpput: cmd USER etp
ftpput: cmd PASS etp
ftpput: cmd TYPE I (null)
ftpput: cmd PASV (null)
ftpput: cmd STOR /home/etp/core_dump
ftpput: cmd (null) (null)

DN0984303

Id:0900d80580825b4d
Confidential

31

Service terminal commands

ETP Service Terminal Commands

ftpput: cmd QUIT (null)


ETPT/1/0>

2.2.12

Redirection (>)
Function
This command can be used to direct the output of any command to a file, with the
filename specified by the user and can also be used for redirecting the output of any
command which produces synchronous output only.
Syntax
<command> > <filename>
Examples
1. To redirect the output of the ps command to a file ps_output.txt
ps > ps_output.txt
Execution printouts

ETPT/1/0 > ps > ps_output.txt


ETPT/1/0 >

2.3

Telnet Server Administration Commands


This section describes the Service Terminal commands to enable/disable telnet connectivity.

2.3.1

etc (Enable telnet for specified IP address or for All IPs)


Function
This command is used to enable telnet for specified IP address or for All IPs.
Syntax
etc <"all"|ipv4_address>
Examples
1. To enable telnet for specified IP address
etc 192.168.0.11
2. To enable telnet for All IPs
etc all
Execution printouts

ETPT/1/0>etc 192.168.0.11
------------------------------------------------------------------------------------------> Command etc executed on [29/6/2009 10:24:21:230261] <---------------ETPT/1/0>
ETPT/1/0>etc all
------------------------------------------------------------------------------------------> Command etc executed on [29/6/2009 10:28:21:230261] <-----------------------------------------------------------------------------------------------All blocked telnet IP lists would be deleted

32

Id:0900d80580825b4d
Confidential

DN0984303

ETP Service Terminal Commands

Service terminal commands

---------------------------------------------------------------------------------

2.3.2

dtc (Disable telnet for specified IP address or for All IPs)


Function
This command is used to disable telnet for specified IP address or for All IPs.
Syntax
dtc <"all"|ipv4_address>
Examples
1. To disable telnet for specified IP address
dtc 192.168.0.11
2. To disable telnet for All IPs
dtc all
Execution printouts

ETPT/1/0>dtc 192.168.0.11
-------------------------------------------------------------------------------------------> Command dtc executed on [29/6/2009 10:24:21:230261] <----------------------------------------------------------------------------------------------ETPT/0/1>
ETPT/1/0>dtc all
-------------------------------------------------------------------------------------------> Command dtc executed on [29/6/2009 10:29:21:230261] <---------------------------------------------------------------------------------------------All allowed telnet IP lists would be deleted
--------------------------------------------------------------------------------ETPT/1/0>

2.3.3

tcstatus (Display list of authenticated IP for telnet connections)


Function
This command is used to display the list of authenticated IPs for telnet connections.
Syntax
tcstatus
Examples
1. To display list of authenticated IP for telnet connections
tcstatus
Execution printouts

ETPT/1/0>etc all
-------------------------------------------------------------------------------------------> Command etc executed on [29/6/2009 10:24:21:230261] <----------------------------------------------------------------------------------------------All blocked telnet IP lists would be deletedETPT/1/0>ETPT/1/0>tcstatus

DN0984303

Id:0900d80580825b4d
Confidential

33

Service terminal commands

ETP Service Terminal Commands

--------------------------------------------------------------------------------------------> Command tcstatus executed on [29/6/2009 10:28:21:230261] <----------------------------------------------------------------------------------------Telnet allowed from all IP addresses
--------------------------------------------------------------------------------ETPT/1/0>
ETPT/1/0>
ETPT/1/0>dtc all
------------------------------------------------------------------------------------------> Command etc executed on [29/6/2009 10:34:21:230261] <-----------------------------------------------------------------------------------------------All allowed telnet IP lists would be deleted
--------------------------------------------------------------------------------ETPT/1/0>
ETPT/1/0>tcstatus
------------------------------------------------------------------------------------------> Command tcstatus executed on [29/6/2009 10:37:21:230261] <------------------------------------------------------------------------------------------Telnet blocked from all IP addresses
--------------------------------------------------------------------------------ETPT/1/0>
ETPT/1/0>etc 192.168.0.11
------------------------------------------------------------------------------------------> Command etc executed on [29/6/2009 10:40:21:230261] <-----------------------------------------------------------------------------------------------ETPT/1/0>
ETPT/1/0>tcstatus
------------------------------------------------------------------------------------------> Command tcstatus executed on [29/6/2009 10:44:21:230261] <------------------------------------------------------------------------------------------Telnet allowed from only following IP addresses
192.168.0.11
--------------------------------------------------------------------------------ETPT/1/0>

2.4

Memory manipulation Commands


This Section contains the Commands related to memory manipulation. This category
included command for writing to a memory location also, this command should not be
used on the running system, the consequences of using these commands may have
unforeseen consequences on the stability of the System.

2.4.1

dmem (Dump MEMory Contents of Octeon Management Core)


Function
This command takes the address as the input and the number of bytes to be dumped
on the screen. The operator must be very cautious while reading a memory location, this
may cause the system to behave unpredictably.

34

Id:0900d80580825b4d
Confidential

DN0984303

ETP Service Terminal Commands

Service terminal commands

Syntax
dmem <memory location> <number of bytes>
Examples
1. To display 10 bytes of memory location starting from the address 0x2dc03e0
dmem 0x2dc03e010
Execution printouts
ETPT/1/0>dmem 0x2dbe750 50
-------------------------------------------------------------------------------------------> Command dmem executed on [1/1/1970 6:31:44:581361] <-----------------------------------------------------------------------------------------------00000000 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 ................
00000010 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 ................
00000020 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 ................
00000030 00 00
..
---------------------------------------------------------------------------------

2.4.2

wmem (Write to MEMory location of Octeon Management Core)


Function
This command takes the address as the input and the bytes to be written at the location.
The operator must be very cautious while writing to a memory location, this may cause
the system to behave unpredictably.
Syntax
wmem <memory location> <memory content>
Examples
1. To write the bytes 10 20 30 10 20 30 starting from memory location 0x2dc03e0
wmem 0x2dc03e0 10 20 30 10 20 30
Execution printouts

ETPT/1/0>wmem 0x2dc03e0 "10 20 30 10 20 30"


------------------------------------------------------------------------------------------> Command wmem executed on [1/1/1970 6:36:4:463289] <-------------------------------------------------------------------------------------------------Contents to memory Written
---------------------------------------------------------------------------------

2.4.3

dmemdsp (Dump MEMory Contents in a DSP Core)


Function
This takes the address as the input and the number of bytes to be dumped on the
screen. The operator must be very cautious while reading a memory location, this may
cause the system to behave unpredictably.

DN0984303

Id:0900d80580825b4d
Confidential

35

Service terminal commands

ETP Service Terminal Commands

Syntax
dmemdsp <dsp block id>:<dsp core id> <memory location>
<number of bytes>
Examples
1. To display 10 bytes of memory location starting from the address 0x2dc03e0
dmemdsp 2:4 0x2dc03e010
Execution printouts
ETPT/0/1>dmemdsp 2:4 0x2dbe750 50
------------------------------------------------------------------------------------------------> Command dmemdsp executed on [1/1/1970 6:31:44:581361] <---------------------------------------------------------------------------------------00000000 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 ................
00000010 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 ................
00000020 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 ................
00000030 00 00
..
---------------------------------------------------------------------------------

2.4.4

wmemdsp (Write to MEMory location in a DSP Core)


Function
This takes the address as the input and the bytes to be written at the location. The
operator must be very cautious while writing to a memory location, this may cause the
system to behave unpredictably.
Syntax
wmemdsp <dsp block id>:<dsp core id> <memory location>
<memory content>
Examples
1. To write the bytes 10 20 30 10 20 30 starting from memory location 0x2dc03e0
wmemdsp 2:4 0x2dc03e0 10 20 30 10 20 30
Execution printouts

ETPT/0/1>wmemdsp 2:4 0x2dc03e0 "10 20 30 10 20 30"


-----------------------------------------------------------------------------------------------> Command wmemdsp executed on [1/1/1970 6:36:4:463289] <-----------------------------------------------------------------------------------------Contents to memory Written
---------------------------------------------------------------------------------

36

Id:0900d80580825b4d
Confidential

DN0984303

ETP Service Terminal Commands

2.5
2.5.1

Service terminal commands

Service Terminal Commands for Other Platform Modules


ST Commands for CM module
This Section contains the commands needed for process manipulation like creation,
deletion of a process, restarting of a process, displaying its status, changing process priority, displaying the list of processes. These are primarily used for debugging particular
process start-up failure scenarios.

2.5.1.1

cdp (Create a Dynamic Process)


Function
This command will create any ETP application/platform process. The component
manager maintains the list of all ETP application/platform processes. This application id
is statically allocated and is well known. Application ids can be displayed using dai
command.
Syntax
cdp <processor type>{:<octeon group id/dsp block id>}{:<dsp
core id>}:<application id>
Examples
1. To create the process of application with application ID 7 on Octeon 0
cdp oct:0:7
2. To create the process of application with application ID 7 on DSP block 0 , core 0
cdp dsp:0:0:6
Execution printouts

ETPT/1/0>cdp oct:0:7
---------------------------------------------------------------> Command cdp executed on [1/1/1970 0:0:42:785505] <---------------------------------------------------------------The spawn process command has been executed successfully for thread MR
ETPE/1/0>cdp dsp:0:0:7
---------------------------------------------------------------> Command cdp executed on [5/5/2009 5:7:42:683270] <---------------------------------------------------------------SENT REQUEST TO DSP 0 ...
The command cdp has been executed successfully

2.5.1.2

ddp (Delete a Dynamic Process)


Function
This command will delete any ETP application/platform process. The component
manager maintains the list of all ETP application/platform processes. This application id
is statically allocated and is well known. Application ids can be displayed using dai
command.

DN0984303

Id:0900d80580825b4d
Confidential

37

Service terminal commands

ETP Service Terminal Commands

Syntax
ddp <processor type>{:<octeon group id/dsp block id>}{:<dsp
core id>}:<application id>
Examples
1. To delete the process of application with application ID 7 on Octeon group 0
ddp oct:0:7
2. To delete the process of application with application ID 7 on DSP block 0 core 0
ddp dsp:0:0:7
Execution printouts
ETPE/1/0>ddp oct:0:7
---------------------------------------------------------------> Command ddp executed on [1/1/1970 0:3:20:327669] <--------------------------------------------------------------The stop process command has been executed successfully for thread MR
ETPE/1/0>ddp dsp:0:0:7
---------------------------------------------------------------> Command ddp executed on [5/5/2009 5:7:52:251070] <--------------------------------------------------------------SENT REQUEST TO DSP 0 ...
The command ddp has been executed successfully

2.5.1.3

rdp (Restart a Dynamic Process)


Function
This command will restart any ETP application/platform process. The component
manager maintains the list of all ETP application/platform processes. This application id
is statically allocated and is well known. Application ids can be displayed using dai
command.
Syntax
rdp <processor type>{:<octeon group id/dsp block id>}{:<dsp
core id>}:<application id>
Examples
1. To restart the process of application with application ID 6 on Octeon
rdp oct:0:6
2. To restart the process of application with application ID 7 on DSP block 0 core 0
rdp dsp:0:0:7
Execution printouts

ETPT/1/0>rdp oct:0:6
---------------------------------------------------------------> Command rdp executed on [1/1/1970 0:1:15:41978] <---------------------------------------------------------------The restart process command has been executed successfully for thread PMS
ETPT/1/0>rdp dsp:0:0:7
------------------------------------------------------------

38

Id:0900d80580825b4d
Confidential

DN0984303

ETP Service Terminal Commands

Service terminal commands

----> Command rdp executed on [5/5/2009 5:8:5:483085] <-------------------------------------------------------------SENT REQUEST TO DSP 0 ...
The command rdp has been executed successfully

2.5.1.4

ddps (Display Dynamic Process State)


Function
This command will display ETP application/platform process state. The component
manager maintains the list of all ETP application/platform processes. This application id
is statically allocated and is well known. Application ids can be displayed using dai
command.
Syntax
ddps <processor type>{:<octeon group id/dsp block
id>}{:<dsp core id>}:<application id>
Examples
1. To display the process state of application with application ID 7 on Octeon 0
ddps oct:0:7
2. To display the process state of application with application ID 4 on DSP block 0 core
0
ddps dsp:0:0:4
Execution printouts

ETPT/1/0>ddps oct:0:7
---------------------------------------------------------------> Command ddps executed on [23/12/2009 14:13:34:292740] <--------------------------------------------------------------The thread MR with appid 7 is running
ETPT/1/0>ddps dsp:0:0:4
---------------------------------------------------------------> Command ddps executed on [5/5/2009 5:8:59:431186] <-------------------------------------------------------------SENT REQUEST TO DSP 0 ...
The command ddps has been executed successfully,the process is started
-----------------------------------------------------------------------

2.5.1.5

ddpl (Display Dynamic Process List)


Function
This command will display ETP application/platform processes currently running on the
ETP unit.
Syntax
ddpl <processor type>:<octeon group id>

DN0984303

Id:0900d80580825b4d
Confidential

39

Service terminal commands

ETP Service Terminal Commands

Examples
1. To display the process list on octeon management group 0
ddpl oct:0
Execution printouts
ETPE/1/0>ddpl oct:0
---------------------------------------------------------------> Command ddpl executed on [23/12/2009 14:13:57:900375] <--------------------------------------------------------------Thread IPCM with appid 27 is running
Thread LOGGER with appid 3 is running
Thread ARS with appid 9 is running
Thread ST with appid 13 is running
Thread STA with appid 18 is running
Thread SYSMON with appid 20 is running
Thread MR with appid 7 is running
Thread SDL with appid 8 is running
Thread HWS with appid 15 is running
Thread IM with appid 17 is running
Thread FFC with appid 21 is running

2.5.1.6

pdp (Prioritize a Dynamic Process)


Function
This command will change priority of only ETP application/platform process running on
Octeon. The Priority cannot be set outside the allowable range(1-31). Application ids
can be get using dai command.
Syntax
pdp <processor type>:<octeon group id>:<application
id>:<new priority>
Examples
1. To change the priority of a process of application with application ID 6 to a priority 23
pdp oct:0:6:23
Execution printouts

ETPT/1/0>pdp oct:0:6:23
---------------------------------------------------------------> Command pdp executed on [1/1/1970 0:0:51:362513] <--------------------------------------------------------------Priority is set for the thread PMS

2.5.1.7

sett (Set Time)


Function
This command is used to set the system time.

40

Id:0900d80580825b4d
Confidential

DN0984303

ETP Service Terminal Commands

Service terminal commands

Syntax
sett
<year:month:day:hours:minute:seconds:hundredths_of_sec>
Examples
1. To set the date and time
sett 2009:12:23:14:12:12:12
Execution printouts
ETPT/1/0>sett 2009:12:23:14:12:12:12
---------------------------------------------------------------> Command sett executed on [23/12/2009 14:12:42:77122] <-------------------------------------------------------------Time has been set

2.5.1.8

etpreset (Reset the system)


Function
This command is used for soft reset of the system
Syntax
etpreset
Examples
1. To reset the system
etpreset
Execution printouts

ETPT/1/0>etpreset
-----------------------------------------------------------------------------------------> Command etpreset executed on [11/7/20097:10:24:77124] <----------------------------------------------------------------------------------------Octeon Processor etpreset...
---------------------------------------------------------------------------------

2.5.2

Utilities Message Monitoring


This Section contains the Commands for message monitoring and message manipulation like sending of messages to other modules.

2.5.2.1

emm (Enable Message Monitoring)


Function
This command can be used to activate the message-monitoring feature with the desired
filtering criteria.

DN0984303

Id:0900d80580825b4d
Confidential

41

Service terminal commands

ETP Service Terminal Commands

Syntax
emm <processor type>{:<grp_id>}{:<dsp_id>}[:<src app id>]
<processor type>{:<grp_id>}{:<dsp_id>}[:<dst app id>]
<direction_flag> [<msg type>]
Examples
1. To enable message monitoring from application 1 on Octeon 0 to application 5 on
DSP block1,core2 for message type as 12, to monitor at both directions
emm oct:0:1 dsp:1:2:5 0 12
Execution printouts
ETPT/1/0> emm oct:0:1 dsp:1:2:5 0 12
---------------------------------------------------------------------------------------> Command emm executed on [2/7/2009 11:45:30:123] <------------------------------------------------------------------------------------MM Enable successful
---------------------------------------------------------------------------

2.5.2.2

dmm (Disable Message Monitoring)


Function
This command can be used to De-activate the message-monitoring feature with the
desired filtering criteria.
Syntax
dmm <processor type>{:<octeon group id/dsp block id>}{:<dsp
core id>}{:<src app id>} <processor type>{:<octeon group
id/dsp block id>}{:<dsp core id>}{:<dst id>}
<direction_flag> [<msg type>]
Examples
1. To disable message monitoring from application 1 on Octeon 0 to application 5 on
DSP block1,core2 for message type as 12, to monitor at both directions
dmm oct:0:1 dsp:1:2:5 0 12
Execution printouts

ETPT/1/0> dmm oct:0:1 dsp:1:2:5 0 12


---------------------------------------------------------------------------------------> Command dmm executed on [2/7/2009 11:45:30:123] <------------------------------------------------------------------------------------------MM Disable successful
----------------------------------------------------------------------------Consecutively No Log messages shall be generated by the applications

2.5.2.3

dimm (Display Message Monitoring Configuration)


Function
This command can be used to display the Message Monitoring Configuration.

42

Id:0900d80580825b4d
Confidential

DN0984303

ETP Service Terminal Commands

Service terminal commands

Syntax
dimm <processor type>{:<octeon group id/dsp block
id>}{:<dsp core id>}
Examples
1. To display the message monitoring configuration for octeon 1 core
dimm oct:1
2. To display the message monitoring configuration for dsp block 1 core2
dimm dsp:1:2
Execution printouts

Refer S as Source and D as Destination in the following output.

ETPT/1/0> dimm oct:0


-----------------------------------------------------------------------------------------> Command dimm executed on [2/7/2009 11:45:30:123] <---processor_type:<grp_id/dsp_blk_id>:<dsp_core_id>:src_app_id S<direction>D
processor_type:<grp_id/dsp_blk_id>:<dsp_core_id>:dst_app_id [msg_type]
oct:0:1 S->D oct:1:1 [12]
oct:0:3 S->D dsp:0:3:4 *
ETPT/1/0> dimm dsp:1:2
----------------------------------------------------------------------------------------> Command dimm executed on [2/7/2009 11:50:30:157] <----processor_type:<grp_id/dsp_blk_id>:<dsp_core_id>:src_app_id S<direction>D
processor_type:<grp_id/dsp_blk_id>:<dsp_core_id>:dst_app_id [msg_type]
oct:0:1 S->D dsp:1:2:6 [12]
oct:0:3 S->D dsp:1:2:4 [21]
-------------------------------------------------------------------------

2.5.2.4

damm (Disable All Message Monitoring)


Function
This command can be used to disable all Message Monitoring.
Syntax
damm
Examples
1. To disable all message monitoring enabled
damm
Execution printouts

ETPT/1/0> damm
-----------------------------------------------------------------------------------------> Command damm executed on [2/7/2009 11:45:30:123] <---------------------------------------------------------------------------------------Disabled all message monitoring...

DN0984303

Id:0900d80580825b4d
Confidential

43

Service terminal commands

ETP Service Terminal Commands

-----------------------------------------------------------------------------

2.5.2.5

femm (Fastpath Enable Message Monitoring)


Function
This command can be used to activate the message-monitoring feature with the desired
filtering criteria.
Syntax
femm <processor type>{:<grp_id>}{:<dsp_id>}[:<src port no>]
<processor type>{:<grp_id>}{:<dsp_id>}[:<dst port no>]
<direction_flag>
Examples
1. To enable message monitoring from port 1024 on Octeon 1 to DSP block1,core1 for
port 2000, to monitor at both directions
femm oct:1:1024 dsp:1:1:2000 0
Execution printouts

ETPE/3/0>femm oct:1:1024 dsp:1:1:2000 0


---------------------------------------------------------------> Command femm executed on [30/6/2010 12:8:50:482168] <-------------------------------------------------------------Dest Port is 2000
MM Enable successful
ETPE/1/0>

2.5.2.6

fdmm (Fastpath Disable Message Monitoring)


Function
This command can be used to deactivate the message-monitoring feature with the
desired filtering criteria.
Syntax
fdmm <processor type>{:<grp_id>}{:<dsp_id>}[:<src app id>]
<processor type>{:<grp_id>}{:<dsp_id>}[:<dst app id>]
<direction_flag>
Examples
1. To disable message monitoring from port 1024 on Octeon 1 to application 1 on DSP
block1,core2 for port 2000, to monitor at both directions
fdmm oct:1:1024 dsp:1:1:2:2000 0
Execution printouts

ETPT/1/0> fdmm oct:1:1024 dsp:1:1:2:2000 0


-------------------------------------------------------------------------------------------> Command fdmm executed on [2/7/2009 11:45:30:123] <--------------------------------------------------------------------------------------------

44

Id:0900d80580825b4d
Confidential

DN0984303

ETP Service Terminal Commands

Service terminal commands

MM Disable successful
------------------------------------------------------------------------------Consecutively No Log messages shall be generated by the applications

2.5.2.7

dfimm (Display Fastpath Message Monitoring Configuration)


Function
This command can be used to display the Fastpath Message Monitoring Configuration
(dfimm).
Syntax
dfimm <processor type>{:<grp_id>}{:<dsp_id>}
Examples
1. To display the message monitoring configuration for octeon
dfimm oct
2. To display the message monitoring configuration for dsp block 1 core2
dfimm dsp:1:2
Execution printouts

ETPE/3/0>dfimm oct:1
---------------------------------------------------------------------------------------> Command dfimm executed on [30/6/2010 11:48:22:314035] <------------------------------------------------------------------------------------------------processor_type:<grp_id/dsp_blk_id>:<dsp_core_id>:src_app_id S<direction>D
processor_type:<grp_id/dsp_blk_id>:<dsp_core_id>:dst_app_id [msg_type]
oct:1024 dsp:4:0:2
oct:1024 dsp:4:0:2
ETPE/3/0>dfimm

2.5.2.8

sm (Send Message)
Function
This command can be used to send a message to any application in the system. The
src id must always be of any application on the management core of Octeon.
Syntax
sm <src id> <processor type>{:<group id/dsp block
id>}{:<dsp core id>}{:<dst id>} <msg id> <message>
Examples
1. To send a message from app id 11 to app id 10 on octeon with message type as
12 and message as 01 02 03
sm 11 oct:0:10 12 01 02 03
2. To send a message from app id 11 to app id 4 on core 2 of 7th block of DSP with
msg type as 12 and message as 01
sm 11 dsp:7:2:4 12 01

DN0984303

Id:0900d80580825b4d
Confidential

45

Service terminal commands

ETP Service Terminal Commands

3. To send a message from app id 11 on management core of Octeon to OMU with


message type as 12 and the message as 01 02 03
sm 11 omu 12 01 02 03
Execution printouts
ETPT/1/0> sm 11 dsp:2:4:11 15 "01 02 03"
----------------------------------------------------------------------------------------> Command sm executed on [1/1/1970 7:49:40:365722] <-----------------------------------------------------------------------------------Message Sent Successfully
------------------------------------------------------------------------

2.5.3

Utilities Logging
This Section contains the Commands related to the Logging facility provided in the ETP
system for debugging purposes. By invoking these commands the user can change the
log level of various applications. These commands are for all ETP variants.

2.5.3.1

sll (Set the Log Level)


Function
This command can be used to change the existing log level.

The Logs produced as a result of successful execution of this command will only be
seen on the Service Terminal sessions that have enabled the display of Logs by executing the esd Command
Syntax
sll <processor_type>{:<se group id/dsp block id>}{:<dsp
core id>}[:<application id>] <log_levels>
Examples
1. To set the log level 1,2 for application Id 15 on the management core
sll octeon:15 1:2
2. To set the log level 1,2 for application id 15 se core id 1
sll se:1:15 1:2
3. To set the log level of application 5 on core 1 of dsp 0 to 1,2,6,7
sll dsp:0:1:5 1:2:6:7
Execution printouts

ETPE/1/0>sll octeon:15 1:2


---------------------------------------------------------------------------------------> Command sll executed on [2/7/2009 11:45:30:123] <---------------------------------------------------------------------------------------Application [15]:
LOG LEVEL:
WARNING,INFO1
LOG SOFTWARE LEVEL:
APPLICATION

46

Id:0900d80580825b4d
Confidential

DN0984303

ETP Service Terminal Commands

Service terminal commands

---------------------------------------------------------------------------ETPE/1/0>sll se:1:15 1:2


---------------------------------------------------------------------------------------> Command sll executed on [2/7/2009 11:45:30:123] <---------------------------------------------------------------------------------------SE Grp Id: [1] Application [15]:
LOG LEVEL:
WARNING,INFO1
LOG SOFTWARE LEVEL:
--------------------------------------------------------------------------ETPE/1/0>sll dsp:0:1:5 1:2:6:7
--------------------------------------------------------------------------------------> Command sll executed on [2/7/2009 11:45:30:123] <-------------------------------------------------------------------------------------Application [5]:
LOG LEVEL:
WARNING,INFO1,ERROR,DETAIL1
LOG SOFTWARE LEVEL:
APPLICATION
---------------------------------------------------------------------------

2.5.3.2

ssl (Set the Software Layer)


Function
Application processes can be classified into various categories, and this command can
be used to change the filtering criterion regarding the Software Layer. Appropriate Logs
will be generated as per this filtering criterion.
Syntax
ssl <processor type>{:<se group id/dsp block id>}{:<dsp
core id>}[:<application id>] <software layer>
Examples
1. To set the software level 1,2,3 for application Id 17 on the management core
ssl octeon:17 1:2:3
2. To set the software level 1,2,3 for application id 17 on se core 1
ssl se:1:17 1:2:3
3. To set the software level of application with application id as 1 on core 2 of dsp 1
processor to 1 and 3
ssl dsp:1:2:1 1:2:3
Execution printouts

ETPE/1/0>ssl octeon:17 1:2:3


---------------------------------------------------------------------------------------> Command ssl executed on [2/7/2009 11:45:30:123] <------------------------------------------------------------------------------Application [17]:
LOG LEVEL:
ERROR

DN0984303

Id:0900d80580825b4d
Confidential

47

Service terminal commands

ETP Service Terminal Commands

LOG SOFTWARE LEVEL:


KERNEL,COMPUTING_PLATFORM,SWITCHING_PLATFORM
------------------------------------------------------------------------ETPE/1/0> ssl se:1:17 1:2:3
---------------------------------------------------------------> Command ssl executed on [12/6/2010 15:28:41:920595] <--------------------------------------------------------------SE Grp Id: [1] Application [17]:
LOG LEVEL:
WARNING,ERROR,CRITICAL
LOG SOFTWARE LEVEL:
KERNEL,COMPUTING_PLATFORM,SWITCHING_PLATFORM
ETPE/1/0>
ETPE/1/0> ssl dsp:1:2:1 1:2:3
---------------------------------------------------------------> Command ssl executed on [12/6/2010 10:59:39:644972] <---------------------------------------------------------------Application [1]:
LOG LEVEL:
CRITICAL
LOG SOFTWARE LEVEL:
KERNEL,COMPUTING_PLATFORM,SWITCHING_PLATFORM
ETPE/1/0>

2.5.3.3

slf (Set the Logger Feature)


Function
This command can be used to enable/disable the logging facility on the ETP System.
Syntax
slf <processor type>{:<se group id/dsp block id>}{:<dsp
core id>} <flag>
Examples
1. To Enable the logger feature on management core
slf octeon 1
2. To enable the logger feature on se protocol group
slf se:1 1
3. To enable the logger feature on core 2 of dsp 1
slf dsp:1:2 1
Execution printouts

ETPE/1/0>slf octeon 1
----------------------------------------------------------------------------------------> Command slf executed on [2/7/2009 11:45:30:123] <--------------------------------------------------------------------------------------Logger is [1] [1: Enabled, 0: DISABLED].
---------------------------------------------------------------------------ETPE/1/0>slf se:1 1

48

Id:0900d80580825b4d
Confidential

DN0984303

ETP Service Terminal Commands

Service terminal commands

---------------------------------------------------------------------------------------> Command slf executed on [2/7/2009 11:45:30:123] <---------------------------------------------------------------------------------------The logger is [1] [1: Enabled, 0: DISABLED].
---------------------------------------------------------------------------ETPE/1/0>slf dsp:1:2 1
---------------------------------------------------------------------------------------> Command slf executed on [2/7/2009 11:45:30:123] <--------------------------------------------------------------------------------------The logger is [1] [1: Enabled, 0: DISABLED].
---------------------------------------------------------------------------

2.5.3.4

dld (Display the Log Details)


Function
This command can be used to examine the existing log level and Software levels of the
applications.
Syntax
dld <processor type>{:<se group id/dsp block id>}{:<dsp
core id>} [<application id>]
Examples
1. To display the log/software level details of application with application id 1 on management core
dld octeon:1
2. To display the log/software level details of application with application id 1 of se
protocol group
dld se:2:1
3. To display the log/software level details of application with application id 5 on core
2 of dsp 1
dld dsp:0:2:5
Execution printouts

ETPE/0/1>dld octeon 1
----------------------------------------------------------------------------------------> Command dld executed on [2/7/2009 11:45:30:123] <--------------------------------------------------------------------------------------Application [1]:
LOG LEVEL:
LOG_WARNING, LOG_INFO_1
LOG SOFTWARE LEVEL:
LOG_COMPUTING_PLATFORM
---------------------------------------------------------------------------ETPE/1/0> dld se:2:1
-----------------------------------------------------------------------------------> Command dld executed on [1/1/1970 0:8:29:961468] <------------------------------------------------------------------------------------------Displaying SE config

DN0984303

Id:0900d80580825b4d
Confidential

49

Service terminal commands

ETP Service Terminal Commands

SE Grp Id: [2] Application [1]:


LOG LEVEL:
LOG_NULL
LOG SOFTWARE LEVEL:
LOG_NULL
ETPE/1/0>dld dsp:0:2 5
----------------------------------------------------------------------------------------> Command dld executed on [2/7/2009 11:45:30:123] <--------------------------------------------------------------------------------------Application [5]:
LOG LEVEL:
ERROR
LOG SOFTWARE LEVEL:
APPLICATION
----------------------------------------------------------------------------

2.5.3.5

dlf (Display the Logger Feature)


Function
This command can be used to display the existing set options to enable/disable the
logging facility in the ETP System.
Syntax
dlf <processor type>{:<se group id/dsp block id>}{:<dsp
core id>}
Examples
1. To display the current setting of the logger feature on management core
dlf octeon
2. To display the current setting of the logger feature on se protocol group
dlf se:1
3. To display the current setting of the logger feature on core 2 of dsp 1
dlf dsp:1:2
Execution printouts

ETPE/1/0>dlf octeon
---------------------------------------------------------------------------------------> Command dlf executed on [2/7/2009 11:45:30:123] <---------------------------------------------------------------------------------------Logger is [1] (1->ENABLED, 0->DISABLED).
---------------------------------------------------------------------------ETPE/1/0>dlf se:1
---------------------------------------------------------------------------------------> Command dlf executed on [2/7/2009 11:45:30:123] <---------------------------------------------------------------------------------------Logger is [1] (1->ENABLED, 0->DISABLED).
---------------------------------------------------------------------------ETPE/1/0>dlf dsp:0:1
----------------------------------------------------------------------------

50

Id:0900d80580825b4d
Confidential

DN0984303

ETP Service Terminal Commands

Service terminal commands

------------> Command dlf executed on [2/7/2009 11:45:30:123] <---------------------------------------------------------------------------------------The logger is 1 [1: Enabled, 0: DISABLED].
----------------------------------------------------------------------------

2.5.3.6

efl (Enable Logging to file)


Function
This command can be used to enable logging to file at the ETP. By enabling file logging,
ETP starts logs writing to the /log_dir/log_file.txt file.
Syntax
efl
Examples
1. To enable file logging
efl
Execution printouts

ETPE/1/0>efl
---------------------------------------------------------------------------------------> Command efl executed on [2/7/2009 11:45:30:123] <---------------------------------------------------------------------------------------Logging to file enabled.
----------------------------------------------------------------------------

2.5.3.7

dfl (Disable Logging to file)


Function
This command can be used to disable logging to file at the ETP. By disabling file logging,
ETP stops logs writing to the /log_dir/log_file.txt file.
Syntax
dfl
Examples
1. To disable file logging
dfl
Execution printouts

ETPE/1/0>dfl
---------------------------------------------------------------------------------------> Command dfl executed on [2/7/2009 11:45:30:123] <---------------------------------------------------------------------------------------Logging to file disabled
----------------------------------------------------------------------------

DN0984303

Id:0900d80580825b4d
Confidential

51

Service terminal commands

2.5.3.8

ETP Service Terminal Commands

esd (Enable System Dumps)


Function
By Default as and when the user logs in through the service terminal, he would not get
any Traces/logs on the screen, This feature has been added so that the user can do the
desired operation and not disturbed with frequent traces like if message monitoring is
enabled the user will be bombarded with logs, this would create a lot of confusion for the
user and disallow him to execute any further command.
Syntax
esd
Examples
1. To enable System dump on the existing service terminal session
esd
Execution printouts

ETPE/1/0>esd
Enabled System Dump for this Service Terminal

2.5.3.9

dsd (Disable System Dumps)


Function
After the user invokes this command the output of the Logging and Traces messages
shall not appear on the screen.
Syntax
dsd
Examples
1. To disable the System Dumps on the existing service terminal session
dsd
Execution printouts

ETPE/1/0>dsd
Disabled System Dump for this Service Terminal

2.5.3.10

sfs (Set File Size)


Function
This command can be used to change/set file size of /log_dir/log_file.txt file. File size
should be greater than 5000.
Syntax
sfs

52

<file_size(in bytes)>

Id:0900d80580825b4d
Confidential

DN0984303

ETP Service Terminal Commands

Service terminal commands

Examples
1. To change/set size of log_file.txt to 6000
sfs 6000
Execution printouts
ETPE/1/0>sfs 6000
---------------------------------------------------------------------------------------> Command sfs executed on [2/7/2009 11:45:30:123] <--------------------------------------------------------------------------------------File size is changed from [1572864] bytes to [6000] bytes
---------------------------------------------------------------------------

2.5.3.11

gfs (Get File Size)


Function
This command can be used to display size of /log_dir/log_file.txt file.
Syntax
gfs
Examples
1. To display file size
gfs
Execution printouts

ETPE/1/0>gfs
---------------------------------------------------------------------------------------> Command gfs executed on [2/7/2009 11:45:30:123] <----The log file [/log_dir/log_file.txt] size is 6000 bytes
------------------------------------------------------------------------

2.5.3.12

esl (Enable ST Logging)


Function
This command can be used to log the output of all the ETP commands (except the
LinuxCommands) to a file. This can be typically used in scenarios where the auditing is
required for record purposes.

Running this command may affect the system performance, therefore it is recommended that it used only under very special conditions and consciously.
The user must execute the DSL command, before viewing (by the cat command) the file
generated.
Syntax
esl <Filename> <size_in_bytes>

DN0984303

Id:0900d80580825b4d
Confidential

53

Service terminal commands

ETP Service Terminal Commands

Examples
1. To enable service terminal logging to a file named st_logs. log with a maximum
size of 5000 bytes
esl st_logs.log 5000
Execution printouts
ETPT/1/0/L> esl st_logs.log 5000
-------------------------------------------------------------------------------------------> Command esl executed on [2/7/2009 11:45:30:123] <-----------------------------------------------------------------------------------------Enabling Service Terminal Logging Data to a file
Filename: /log_dir/st_logs.log
Size: 5000
Please note that after the file exceeds
Size: 5000
No Data will be logged to the file
Logging to the File
Shall automatically be switched off
----------------------------------------------------------------------------Enabling this command may affect the performance of the System
-----------------------------------------------------------------------------

2.5.3.13

dsl (Disable ST Logging)


Function
This command is used to disable the ST logging to the file mentioned in the esl
command.
Syntax
dsl
Examples
1. To disable the service terminal logging to a file
dsl
Execution printouts

ETPT/1/0/L>dsl
-------------------------------------------------------------------------------------------> Command dsl executed on [2/7/2009 11:45:30:123] <--------------------------------------------------------------------------------------Disabled Service Terminal Logging Data to a file
Filename: /log_dir/st_logs.log
Size: 5000
-----------------------------------------------------------------------------

2.5.3.14

dlfi (Display Logging to a File Information)


Function
This command is used to display the which file logging options are activated.

54

Id:0900d80580825b4d
Confidential

DN0984303

ETP Service Terminal Commands

Service terminal commands

Syntax
dlfi
Examples
1. To display the existing logging to file options
dlfi
Execution printouts
ETPT/1/0>dlfi
---------------------------------------------------------------------------------------> Command dlfi executed on [2/7/2009 11:45:30:123] <--------------------------------------------------------------------------------------Service Terminal Logging to a file mode Not activated
Service Terminal MM Logging to a file mode Not activated

ETPT/1/0>dlfi
---------------------------------------------------------------------------------------> Command dlfi executed on [2/7/2009 11:45:30:123] <--------------------------------------------------------------------------------------Service Terminal Logging to a file mode Not activated-------------------------------------------------------------------------------------------------Service Terminal MM Logging to a file mode is ON
Filename: /log_dir/st_mm_logs.log
Size: 5000
----------------------------------------------------------------------------

2.5.3.15

remove (remove Logging Files)


Function
This command can be used to remove/delete the various log files available in log directory which the user has created in order to log MM/ST outputs to a file.

The files must be closed prior to issuing this command, by disabling logging to a file for
the respective file.
Syntax
remove <filename>
Examples
1. To remove a file named log_ab.log from the Ramdisk
remove log_ab.log
2. To remove all the files with the extension .log from the Ramdisk
remove *.log
3. To remove all log files with extension .log from the Ramdisk
remove all_log_files
Execution printouts

ETPT/1/0>remove all_log_files
----------------------------------------------------------

DN0984303

Id:0900d80580825b4d
Confidential

55

Service terminal commands

ETP Service Terminal Commands

------> Command remove executed on [2/7/2009 11:45:30:123] <----------------------------------------------------------------File </log_dir/abc.log> removed


File </log_dir/xyz.log> removed
File </log_dir/lmn.log> could not be removed

---------------------------------------------------------------> Command remove executed on [2/7/2009 11:45:30:123] <----------------------------------------------------------------file does not exist

2.5.3.16

emml (Enable MM Data Logging)


Function
This command can be used to log the output of all the MM messages. This can be typically used in scenarios where the user needs to capture the output into a file for offline
analysis.

Running this command may affect the system performance, therefore it is recommended that it used only under very special conditions and consciously.
Syntax
emml <Filename> <size_in_bytes>
Examples
1. To enable Message monitoring logging to a file named st_mm_logs.log with size
of 5000 bytes
emml st_mm_logs.log 5000
2. To enable Message monitoring logging to a file named st_mm_logs.log with size
of 5000 bytes
emml st_mm_logs 5000
Execution printouts

ETPT/1/0>emml st_mm_logs.log 5000


---------------------------------------------------------------> Command emml executed on [2/7/2009 11:45:30:123] <-----------------------------------------------------------------********************************************************
Enabled MM Service Terminal Logging to a file
Filename: /log_dir/st_mm_logs.log
Size: 5000
Please note that every time the file exceeds Size: 5000 bytes
file will be wrapped around
**********************************************************************
Enabling this command may affect the performance of the System
**********************************************************************

56

Id:0900d80580825b4d
Confidential

DN0984303

ETP Service Terminal Commands

2.5.3.17

Service terminal commands

dmml (Disable MM Data Logging)


Function
This command is used to disable the MM Data Logging.
Syntax
dmml
Examples
1. To disable the message monitoring logging to a file.
dmml
Execution printouts

ETPT/1/0>dmml
---------------------------------------------------------------> Command dmml executed on [2/7/2009 11:45:30:123] <--------------------------------------------------------------********************************************************
Disabled Service Terminal MM Logging to a file
Filename: /log_dir/st_mm_logs.log
Size:5000
********************************************************

2.5.3.18

emptylogfile (Empty Log File)


Function
This command can be used to empty the /log_dir/log_file.txt file created by logger
module.
Syntax
emptylogfile
Examples
1. To empty log file
emptylogfile
Execution printouts

ETPE/1/0> emptylogfile
---------------------------------------------------------------------------------------> Command emptylogfile executed on [2/7/2009 11:45:30:123] <------------------------------------------------------------------------------------log file has been emptied
------------------------------------------------------------------------------

DN0984303

Id:0900d80580825b4d
Confidential

57

Service terminal commands

2.5.3.19

ETP Service Terminal Commands

antiskid
Function
At high CPU load ETP starts delimiting log levels even though the operator turned them
on earlier. This automatic log contol mechanism is called antiskid which helps to control
CPU load in high load conditions. This command can be used to disable/enable this
mechanism. By default it is enabled.

Disabling antiskid should be done at operators own risk. Since CPU load delimiting
mechanism is turned off, there is higher risk of CPU load crossing barriers.
Syntax
antiskid<processor_type>{:<dsp_id>:<dsp_core_id>}{:<octeon_
group_id>} <flag>
Examples
1. To enable antiskid mechanism for the management core group
oct:0 1
2. To disable antiskid mechanism for the management core group
oct:0 0
3. To enable antiskid mechanism for the dsp_id [0] and dsp_core_id[1]
dsp:0:0 1
4. To disable antiskid mechanism for the dsp_id [0] and dsp_core_id[1]
dsp:0:0 0
Execution printouts

ETPE/1/0>antiskid oct:0 1
---------------------------------------------------------------------------------------> Command antiskid executed on [2/7/2009 11:45:30:123] <----------------------------------------------------------------------------------ETPE/1/0>antiskid oct:0 0
---------------------------------------------------------------------------------------> Command antiskid executed on [2/7/2009 11:45:30:123] <----------------------------------------------------------------------------------ETPE/1/0>antiskid dsp:0:0 1
---------------------------------------------------------------------------------------> Command antiskid executed on [2/7/2009 11:45:30:123] <----------------------------------------------------------------------------------ETPE/1/0>antiskid dsp:0:0 0
---------------------------------------------------------------------------------------> Command antiskid executed on [2/7/2009 11:45:30:123] <-----------------------------------------------------------------------------------

2.5.4

Utilities Alarms
This Section contains the Commands related to the Alarm facility provided in the ETP
system for displaying active alarms present in the system.

58

Id:0900d80580825b4d
Confidential

DN0984303

ETP Service Terminal Commands

2.5.4.1

Service terminal commands

daa (Display active alarms)


Function
When Service Terminal uses this command to see all active alarms present in ETP
system, internally it calls ars_show_observations() API.
Syntax
daa
Examples
1. To display all active alarms
daa
Execution printouts

ETPT/1/0> daa
-----------------------------------------------------------------------------------------> Command daa executed on [1/1/1970 7:49:40:365722] <-----------------------------------------------------------------------------------------Current Observations in this card
All parameters displayed in hex in this display
-----------------------------------------------------------------------------alarm_number : 2794
object_type : AA
object_index : 0
marker app : 6
marker card : F
setting family :143
setting time : 1/1/2000 0:22:55:12
resetting time : 0/0/0 0:0:0:0
current state : <set>,<not reset>,<set sent>,<reset not sent>,<set acked>,<reset
not acked>
alarm description : <0 FF FF 1F >
---------------------------------------------------------------------------------

2.5.5

Utilities Statistics
This Section contains the Commands used for displaying the various Statistics being
collected in the ETP.

2.5.5.1

dsco (Display Statistics for a specific COunter)


Function
This command is used to Display Statistics for a specific COunter (dsco). This command
has first dimension, as optional parameter. If the dimensions are not passed, then
counters value for all configured dimensions is displayed.
Syntax
dsco <counter id> [<first dimension>]

DN0984303

Id:0900d80580825b4d
Confidential

59

Service terminal commands

ETP Service Terminal Commands

Examples
1.

For category having Dimension i.e Packet Abis Traffic inorder to display the statistics of counter id 124000 for cofigured BCF with id 100
dsco 124000 100
2. For category with no dimension eg. For ETP Ethernet BSC inorder to display the statistics of counter id 128000
dsco 128000
Execution printouts
ETPE/3/0>dsco 124000 100
---------------------------------------------------------------> Command dsco executed on [29/6/2010 16:46:36:891064] <-------------------------------------------------------------Counter-id:124000
BCF-ID : 100
value:1200
ETPE/3/0>
ETPE/3/0>dsco 128000
---------------------------------------------------------------> Command dsco executed on [29/6/2010 16:46:36:891064] <-------------------------------------------------------------ETP UNIT TYPE : 107
ETP INDEX: 1 value:14523703
ETPE/3/0>

2.5.5.2

dsca (Display Statistics Counter for specific CAtegory)


Function
This command is used to Display values of Statistics Counter IDs for a specific CAtegory
(dsca). This command has first dimension, as optional parameter and is required to
pass for categories having dimension.
Syntax
dsca <category id> [<first dimension>]
Examples
1. To display the statistics of category id with dimension i.e for Packet Abis category
with configured BCF id 100
dsca 124 100
2. To display the counter statistics of category with no dimension eg ETP Ethernet BSC
dsca 128
Execution printouts

ETPE/1/0>dsca 124 100


---------------------------------------------------------------> Command dsca executed on [29/6/2010 16:28:27:168029] <--------------------------------------------------------------BCF-ID = 100
cs_u_plane_rtp_packets_received = 1400
cs_u_plane_rtp_packets_lost = 2814
cs_u_plane_rtp_packets_received_too_late = 120
cs_u_plane_rtp_packets_received_too_early = 130

60

Id:0900d80580825b4d
Confidential

DN0984303

ETP Service Terminal Commands

Service terminal commands

cs_u_plane_rtp_packets_received_on_time = 110
cs_u_plane_rtp_packets_sent = 4228
ps_u_plane_rtp_packets_received = 5642
ps_u_plane_rtp_packets_lost = 7056
ps_u_plane_rtp_packets_sent = 8470
cs_u_plane_udp_packets_received = 9884
cs_u_plane_udp_packets_sent = 11298
cs_u_plane_udp_octets_received = 12712
cs_u_plane_udp_octets_sent = 14126
ps_u_plane_udp_octets_received = 28140
ps_u_plane_udp_octets_sent = 42154
ETPE/1/0>dsca 128
---------------------------------------------------------------> Command dsca executed on [29/6/2010 16:28:27:168029] <---------------------------------------------------------------ETHERNET-INTERFACE-ID = 56393
received_ethernet_frames = 1484284
errored_ethernet_frames = 0
transmitted_ethernet_frames = 538188
received_octets = 0
transmitted_octets = 168692

2.5.5.3

rsca (Reset Statistics Counter for specific CAtegory)


Function
This command is used to Reset values of Statistics Counter IDs for a specific CAtegory
(rsca). This command has first dimension, as optional parameter,.If the dimensions are
not passed, then category value for all configured dimensions are reset.
Syntax
rsca [<category id>] [<first dimension>]
Examples
1.

To reset the statistics of category id 124 with configured BCF id 1


rsca 124 1
2. To reset the statistics of category id 124 for all BCF ids
rsca 124
Execution printouts
ETPE/1/0> rsca 124 1
----------------------------------------------------------------------------------------> Command rsca executed on [1/1/1970 0:7:53:180001] <------------------------------------------------------------------------------Category counters are resetted Successfully
-------------------------------------------------------------------------ETPE/1/0> rsca 124
----------------------------------------------------------------------------------------> Command rsca executed on [1/1/1970 0:7:53:180001] <-------------------------------------------------------------------------------

DN0984303

Id:0900d80580825b4d
Confidential

61

Service terminal commands

ETP Service Terminal Commands

Category counters are resetted Successfully

2.5.5.4

rsco (Reset Statistics for a specific COunter)


Function
This command is used to Reset Statistics for a specific COunter (rsco). This command
has first dimension, as optional parameter,.If the dimensions are not passed, then
counters value for all configured dimensions are reset.
Syntax
rsco <counter id> [<first dimension>]
Examples
1.

To reset the statistics of counter id 124000 with configured BCF id 1


rsco 124000 1
2. To reset statistics of counter id 124000 for all BCFs
rsco 124000
Execution printouts
ETPE/1/0> rsco 124000 1
-------------------------------------------------------------------------------------> Command rsco executed on [1/1/1970 0:8:8:90001] <-----------------------------------------------------------------------------------Counter is resetted successfully.
ETPE/1/0> rsco 124000
-------------------------------------------------------------------------------------> Command rsco executed on [1/1/1970 0:8:8:90001] <--------------------------------------------------------------------------------Counter is resetted successfully.

2.5.5.5

dscfp (Display SCTP Forwarded Packets Counter)


Function
This command is used to Display SCTP Forwarded Packets Counter in ETPT in both
direction(Uplink and Downlink).
Syntax
dscfp
Examples
1. To display Forwarded Packets Counter
dscfp
Execution printouts

ETPT/1/0> dscfp
-------------------------------------------------------------------------------------> Command dscfp executed on [1/1/1970 0:8:8:90001] <-----------------------------------------------------------------------------------

62

Id:0900d80580825b4d
Confidential

DN0984303

ETP Service Terminal Commands

Service terminal commands

SCTP Uplink forwarded packets count is : 1642


SCTP Downlink forwarded packets count is : 4018
ETPT/1/0>
--------------------------------------------------------------------------

2.5.6

2.5.6.1

Service Terminal Command for HDLC/ML/MC-PPP links management


dhdlcinfo
Function
This command is used to display the configuration information related to a HDLC link for
the etp_bcf_id & hdlc_link_id input parameter values. If only etp_bcf_id parameter is
specified, then this command displays the information related to all the HDLC links corresponding to the BCF. This command is valid only in case of ETPT.
Syntax
dhdlcinfo <etp_bcf_id> [<hdlc_link_id>]
Examples
1. To display the HDLC Link info for a HDLC link with HDLC_LINK_ID 1 and
ETP_BCF_ID 1
dhdlcinfo 1 1
2. To display the info for all HDLC Link info for ETP_BCF_ID 1
dhdlcinfo 1
Execution printouts

ETPT/1/0>dhdlcinfo 1
---------------------------------------------------------------> Command dhdlcinfo executed on [29/6/2010 18:56:55:656171] <--------------------------------------------------------------HMC: PCM id with E1 mode and max value:0
in etp hdlc st command
ETP BCFID =1
HDLC_LINK_ID
40

PCM_ID
0

NCP State =1
Start-TSL
4

Where LCP state:


0 - ST_HDLC_STATE_INITIAL
2 - ST_HDLC_STATE_CLOSED
4 - ST_HDLC_STATE_CLOSING
6 - ST_HDLC_STATE_REQSENT
8 - ST_HDLC_STATE_ACKSENT
Where NCP state:
0 - NCP_OK
1 - NCP_NOK
ETPT/1/0>

DN0984303

1
3
5
7
9

Bandwidth
2

LCP-STATE
6

ST_HDLC_STATE_STARTING
ST_HDLC_STATE_STOPPED
ST_HDLC_STATE_STOPPING
ST_HDLC_STATE_ACKRCVD
ST_HDLC_STATE_OPENED

Id:0900d80580825b4d
Confidential

63

Service terminal commands

ETP Service Terminal Commands

ETPT>dhdlcinfo 1 1
---------------------------------------------------------------> Command dhdlcinfo executed on [29/6/2010 18:44:57:706860] <--------------------------------------------------------------HMC: PCM id with E1 mode and max value:0
in etp hdlc st command
HDLC Link ID:1 not configured on ETPT.
ETPT/1/0>
-------------------------------------------------------------------------

2.5.7
2.5.7.1

Service Terminal Command for Interface Manager module


dbcfinfo (Display BCF Information for ETPT/E/A)
Function
This command is used to display all the BCF level parameters (like header compression,
BCF M-plane IP, etc.,) for the given BCF_ID. In case of no BCF_ID given against this
command, it displays all the configured BCF_IDs.
Syntax
dbcfinfo < bcf_id>
Examples
1. To display the BCF parameters of BCF ID 10
dbcfinfo 10
2. To display all the configured BCF IDs
dbcfinfo
Execution printouts

ETPT/1/0>dbcfinfo 10
---------------------------------------------------------------> Command dbcfinfo executed on [29/6/2010 18:58:16:377862] <--------------------------------------------------------------Etp_bcf_id:0
Bcf_id:10
BCF_M-plane_IP:10.118.66.3
BCF_M-plane Subnet Mask: 24
BCF_C/U-plane_IP:0.0.0.0
BCF_C/U-plane Subnet Mask:0
Header Compression for UDP/IP:0
Header Compression for MLPPP:0
Maximum Multiplexing wait time on ETP:2
Maximum Multiplexing packet size:300
CS UDP MUX Port:49152
PS UDP MUX Port:49154
Packet Delay Variation:5000
LSA ID:65535
Packet Connection type:1
HUB bcf id:0

64

Id:0900d80580825b4d
Confidential

DN0984303

ETP Service Terminal Commands

Service terminal commands

ETPT/1/0>
ETPT/1/0>dbcfinfo
---------------------------------------------------------------> Command dbcfinfo executed on [29/6/2010 18:44:17:274236] <-------------------------------------------------------------Bcf_id:10
Bcf_id:15
ETPT/1/0>

2.5.7.2

dinterface (Display status of the active and protecting interfaces)


Function
This command is used to display status of the active and protecting interfaces.
Syntax
dinterface
Examples
1. To display all the parameters of active and protecting interfaces
dinterface
Execution printouts

ETPE/3/0>dinterface
---------------------------------------------------------------> Command dinterface executed on [12/6/2010 15:56:52:92734] <---------------------------------------------------------------************************************************************************
BOND0 Interface
************************************************************************
IF_INDEX : 0
IP ADDRESS : a010605
NET MASK : ffffffe0
VLAN ID : 4096
VLAN PRIORITY : 0
Virtual id : 0
IF_STATUS : 1
IF_NAME : BOND0
is_tagged : 0
IF_MTU : 1500
IP Version : 0
if_attr : 0x80
phy_port : 16
IF_MAC 0:a:c:1:e:e
************************************************************************
EL0 Interface
************************************************************************
IF_INDEX : 4
IP ADDRESS : a7988d9
NET MASK : ffffff00

DN0984303

Id:0900d80580825b4d
Confidential

65

Service terminal commands

ETP Service Terminal Commands

VLAN ID : 4096
VLAN PRIORITY : 0
Virtual id : 0
IF_STATUS : 0
IF_NAME : EL0
is_tagged : 0
IF_MTU : 1500
IP Version : 0
if_attr : 0x1
IF_MAC 0:a:c:1:e:d
************************************************************************
IM0 Interface
************************************************************************
************************************************************************
IN0 Interface
************************************************************************
IF_INDEX : 35
IP ADDRESS : a0a0a0a
NET MASK : ffffff00
VLAN ID : 4096
VLAN PRIORITY : 0
Virtual id : 0
IF_STATUS : 1
IF_NAME : I
N0is_tagged : 0
IF_MTU : 1500
IP Version : 0
f_attr : 0x9
IF_MAC 0:a:c:1:e:10
************************************************************************
The Active Slave for BOND0 interface is IL0
The Active SFP for EL0 interface is NONE
ETPE/3/0>

2.5.7.3

dbscp (Display BSC level parameters of the ETPA/C/E/T)


Function
This command is used to display BSC level parameters of the ETPE/T.
Syntax
dbscp
Examples
1. To display BSC level parameters of the ETPA/C/E/T
dbscp
Execution printouts

: ETPE/3/0/L>dbscp
---------------------------------------------------------

66

Id:0900d80580825b4d
Confidential

DN0984303

ETP Service Terminal Commands

Service terminal commands

-------> Command dbscp executed on [12/6/2010 16:51:59:100033] <--------------------------------------------------------------********************************


BSC parameters
********************************
mc_ppp_dscp_mapp
class_to_be = 3
class_to_af1 = 2
class_to_af2 = 2
class_to_af3 = 2
class_to_af4 = 1
class_to_ef = 0
vlan_priority_mapp
priority_be = 0
priority_af1 = 1
priority_af2 = 3
priority_af3 = 4
priority_af4 = 5
priority_ef = 6
traffic_to_dscp
cs_traff = 34
csx_traff = 34
ps_traff = 26
sig_traff = 46
om_traff = 0
wfq_weights
af4_wfg_weight = 5000
af3_wfg_weight = 5000
af2_wfg_weight = 5000
af1_wfg_weight = 5000
be_wfg_weight = 5000
OVERLOAD PARAMETERS
----------------------OLP: Critical Limit :3
OLP: High Limit
:2
OLP: Low Limit
:1
OLP: Load Hysteresis :5
OLP: Time Hysteresis :1
0ETPE/3/0>

2.5.7.4

etp_ifconfig (Display Ethernet, VLAN and IP configuration of


external and internal interfaces)
Function
This command is used by the user to be able to view the Ethernet, VLAN and IP interface
configuration of external and internal interfaces.
Syntax
etp_ifconfig {interface/ virtual interface}

DN0984303

Id:0900d80580825b4d
Confidential

67

Service terminal commands

ETP Service Terminal Commands

Examples
1. To display the interface EL0 configuration
etp_ifconfig EL0
Execution printouts
ETPE/1/0> etp_ifconfig
--------------------------------------------------------------------------------> Command etp_ifconfig executed on [12/11/2010 2:14:45:845812] <------------------------------------------------------------------------------BOND0
Link encap:Ethernet HWaddr 00:01:01:01:01:00
UP BROADCAST RUNNING MASTER MTU:1500 Metric:1
RX packets:3195315 errors:0 dropped:61 overruns:0 frame:0
TX packets:46186 errors:0 dropped:0 overruns:0 carrier:0
collisions:0 txqueuelen:0
RX bytes:274940431 (262.2 MiB) TX bytes:6292827 (6.0 MiB)
BOND0.5
Link encap:Ethernet HWaddr 00:01:01:01:01:00
UP BROADCAST RUNNING MASTER MTU:1500 Metric:1
RX packets:26811 errors:0 dropped:0 overruns:0 frame:0
TX packets:4 errors:0 dropped:0 overruns:0 carrier:0
collisions:0 txqueuelen:0
RX bytes:1448564 (1.3 MiB) TX bytes:280 (280.0 B)
BOND0.5:0 Link encap:Ethernet HWaddr 00:01:01:01:01:00
inet addr:10.10.10.11 Bcast:10.10.10.255 Mask:255.255.255.0
UP BROADCAST RUNNING MASTER MTU:1500 Metric:1
BOND0:0
Link encap:Ethernet HWaddr 00:01:01:01:01:00
inet addr:10.118.68.233 Bcast:10.118.68.255 Mask:255.255.255.0
UP BROADCAST RUNNING MASTER MTU:1500 Metric:1
BOND0:1
Link encap:Ethernet HWaddr 00:01:01:01:01:00
inet addr:10.118.68.234 Bcast:10.118.68.255 Mask:255.255.255.0
UP BROADCAST RUNNING MASTER MTU:1500 Metric:1
EL0
Link encap:Ethernet HWaddr 00:01:01:01:01:01
UP BROADCAST RUNNING MTU:1500 Metric:1
RX packets:0 errors:0 dropped:0 overruns:0 frame:0
TX packets:40685 errors:0 dropped:0 overruns:0 carrier:0
collisions:0 txqueuelen:1000
RX bytes:0 (0.0 B) TX bytes:1708770 (1.6 MiB)
EL0:0
Link encap:Ethernet HWaddr 00:01:01:01:01:01
inet addr:10.10.80.10 Bcast:10.10.80.255 Mask:255.255.255.0
UP BROADCAST RUNNING MTU:1500 Metric:1
IL0
Link encap:Ethernet HWaddr 00:01:01:01:01:00
UP BROADCAST RUNNING SLAVE MTU:1500 Metric:1
RX packets:3195315 errors:0 dropped:61 overruns:0 frame:0
TX packets:46186 errors:0 dropped:0 overruns:0 carrier:0
collisions:0 txqueuelen:1000
RX bytes:274940431 (262.2 MiB) TX bytes:6292827 (6.0 MiB)
IL1
Link encap:Ethernet HWaddr 00:01:01:01:01:00
UP BROADCAST RUNNING SLAVE MTU:1500 Metric:1
RX packets:0 errors:0 dropped:0 overruns:0 frame:0
TX packets:0 errors:0 dropped:0 overruns:0 carrier:0
collisions:0 txqueuelen:1000

68

Id:0900d80580825b4d
Confidential

DN0984303

ETP Service Terminal Commands

Service terminal commands

RX bytes:0 (0.0 B) TX bytes:0 (0.0 B)


IM0
Link encap:Ethernet HWaddr 00:01:01:01:01:02
UP BROADCAST RUNNING MTU:1500 Metric:1
RX packets:0 errors:0 dropped:0 overruns:0 frame:0
TX packets:0 errors:0 dropped:0 overruns:0 carrier:0
collisions:0 txqueuelen:1000
RX bytes:0 (0.0 B) TX bytes:0 (0.0 B)
IN0
Link encap:Ethernet HWaddr 00:01:01:01:01:03
UP BROADCAST RUNNING MTU:1500 Metric:1
RX packets:0 errors:0 dropped:0 overruns:0 frame:0
TX packets:0 errors:0 dropped:0 overruns:0 carrier:0
collisions:0 txqueuelen:1000
RX bytes:0 (0.0 B) TX bytes:0 (0.0 B)
lo
Link encap:Local Loopback
inet addr:127.0.0.1 Mask:255.0.0.0
UP LOOPBACK RUNNING MTU:16436 Metric:1
RX packets:312 errors:0 dropped:0 overruns:0 frame:0
TX packets:312 errors:0 dropped:0 overruns:0 carrier:0
collisions:0 txqueuelen:0
RX bytes:30101 (29.3 KiB) TX bytes:30101 (29.3 KiB)
----------------------------------------------------------------------------

2.5.8
2.5.8.1

Service Terminal Command for Software Download module


ssv
Function
It is used to display the software version of the images present in the flash device specified in the command.
Syntax
ssv <flash_name>
Examples
1. To display software version of the images present in flash
ssv <flash_name>
1: Active Flash
2: Backup Flash
Execution printouts

ETPE/3/0>ssv 1
---------------------------------------------------------------> Command ssv executed on [12/6/2010 15:47:2:73469] <-------------------------------------------------------------********************************************************
The version information of flash[0] is as follows:
********************************************************
Module length:
205789441
Type duplicate:
4096

DN0984303

Id:0900d80580825b4d
Confidential

69

Service terminal commands

ETP Service Terminal Commands

Module type true_type:


Module type struc_version :
Hand group count:
Module checksum:
Descriptor Section offset:
Type Dependent offset:
Module Id:

1
0
0
3235679654
0
1409286144
GGNETPET.img ETPR1-01-E0.5P22 2010-06-10 1.20-0

ETPE/3/0>ssv 2The version information of flash[1] is as follows:


********************************************************
Module length:
2498635009
Type duplicate:
4096
Module type true_type:
1
Module type struc_version :
0
Hand group count:
0
Module checksum:
3150620236
Descriptor Section offset:
0
Type Dependent offset:
1409286144
Module Id:
GGNETPET.img ETPR1-01-E0.5P26 2010-06-21 1.21-0

2.5.8.2

hardware_info
Function
It is used to display the ETP plug in unit location information and hardware version.
Syntax
hardware_info
Examples
1. To display ETP location information and hardware version
hardware_info
Execution printouts

ETPT/1/0> hardware_info
********************************************************
The hardware information is as follows:
********************************************************
Cabinet row:
1
Cabinet column:
20
Vertical deviation:
dc
Horizontal deviation:
e6
Hardware version:
f

70

Id:0900d80580825b4d
Confidential

DN0984303

ETP Service Terminal Commands

2.5.8.3

Service terminal commands

dbl
Function
It is used to display the boot-up logs from last restart for analyzing failures.
Syntax
dbl
Examples
1. To display boot up logs from last restart
dbl
Execution printouts

ETPT/1/0> dbl
----------------------------------------------------------------------------------------> Command dbl executed on [7/8/2008 1:54:35:567605] <---------------------------------------------------------------------------------------/*Logs are displayed*/
-----------------------------------------------------------------------------

2.5.8.4

config_etpc_etpsigm_ip
Function
It is used to modify the ETPs IP address, gateway BCSUs IP address and netmask,
vlan id and default gw address for ETPC variant. The modified values are written in the
configuration file present in both the flash devices. Even if only one of the five values is
to be changed, all the five values are to be entered.
Syntax
config_etpc_etpsigm_ip <etp_ip> <bcsu_ip> <netmask>
<vlan_id> <default_gw>
Examples
1. To modify the ETP and BCSU IP address and netmask, Vlan id and default gw
values
config_etpc_etpsigm_ip <etp_ip> <bcsu_ip> <netmask> <vlan_id>
<default_gw>
Execution printouts

ETPC/1/0> config_etpc_etpsigm_ip 10.118.71.187 10.118.71.190 255.255.255.0 4096


0.0.0.0
----------------------------------------------------------------------------------> Command config_etpc_etpsigm_ip executed on [7/8/2008
1:54:35:567605] <---------------------------------------------------------------------------------/*In case of successful updation the following log is displayed*/
Updation successful
--------------------------------------------------------------------------------ETPC/1/0>

DN0984303

Id:0900d80580825b4d
Confidential

71

Service terminal commands

ETP Service Terminal Commands

ETPC/1/0> config_etpc_etpsigm_ip 10.118.71.187 10.118.71.190 255.255.255.0 4096


0.0.0.0
----------------------------------------------------------------------------------> Command config_etpc_etpsigm_ip executed on [7/8/2008
1:54:35:567605] <---------------------------------------------------------------------------------/*In case the configuration file is not found in the flash*/
ERROR:Updation unsuccessful
---------------------------------------------------------------------------------

2.5.8.5

change_ftp_authentication
Function
It is used to reconfigure username and password of the FTP server remotely at ETP.
The current username,current password, new username and new password values are
provided in the command. First the current username and current password of the FTP
server is verified against the value stored in flash memory. In case the information is
correct, the new username and new password is saved in both the flash devices. In case
the information does not match with that present in the flash unit,it just displays an error
message. Even if only one of the three values is to be changed, both the new username
and password values are to be entered.
Syntax
change_ftp_authentication <olduname> <oldpasswd> <newuname>
<newpasswd>
Examples
1. To reconfigure username and password of FTP server
change_ftp_authentication <olduname> <oldpasswd> <newuname>
<newpasswd>
Execution printouts

ETPT/1/0> change_ftp_authentication uname1 pass1 uname2 pass2


Read information from flash
user and password both are authenticated.
FTP Server information change successful on active flash
FTP Server information change successful on backup flash
Upgrade Successful

2.5.8.6

etpsig_m_info
Function
It is used to display the ETP and Gateway BCSU IP addresses and port numbers of the
ETPSIG-M interface.
Syntax
etpsig_m_info

72

Id:0900d80580825b4d
Confidential

DN0984303

ETP Service Terminal Commands

Service terminal commands

Examples
1. To display ETP and GW BCSU IP address and port numbers of the ETPSIG-M
interface
etpsig_m_info
Execution printouts
ETPT/1/0> etpsig_m_info
---------------------------------------------------------------------------------------> Command etpsig_m_info executed on [7/8/2008
1:54:35:567605] <-------------------------------------------------------------------------------------ETP IP Address:10.118.87.1
ETP port number:9900
GW BCSU IP Address:10.118.17.1
GW BCSU port number:9900
---------------------------------------------------------------------------------

2.5.8.7

flash_upgrade
Function
It is used to upgrade the flash device with the new software using FTP protocol. The
default values of username and password are as follows:Username:SYSTEMPassword:SYSTEM

Software upgrade in ETP working state may lead to higher CPU usage. So its always
advisable to move the ETP state from working to test before the software upgrade.
Syntax
flash_upgrade <flash_name> <ftp_server> <fqpn>
Examples
1. To upgrade new software to flash device
flash_upgrade <flash_name> <ftp_server> <fqpn>
flash_name is :1 for Active Flash2 for Backup Flash
Execution printouts

ETPC/1/0> flash_upgrade 1 10.118.68.24 /software/etp_image.tar


---------------------------------------------------------------------------------------> Command flash_upgrade executed on [7/8/2008
1:54:35:567605] <-------------------------------------------------------------------------------------/*In case flash upgrade succeeds*/
Flash upgrade is successful
--------------------------------------------------------------------------------ETPC/1/0>
ETPC/1/0> flash_upgrade 1 10.118.68.24 /software/etp_image.tar
---------------------------------------------------------------------------------------> Command flash_upgrade executed on [7/8/2008
1:54:35:567605] <-------------------------------------------------------------------------------------/*In case flash upgrade fails*/
ERROR:Upgrade unsuccessful

DN0984303

Id:0900d80580825b4d
Confidential

73

Service terminal commands

ETP Service Terminal Commands

---------------------------------------------------------------------------------

2.6
2.6.1

Service Terminal Command for Message Router module


etpsig_c_info
Function
It is used to display the ETP IP, BCSU IP and port numbers of the ETPSIG-C interface.
Syntax
etpsig_c_info
Examples
1. To display ETP IP, BCSU IP address and port numbers of the ETPSIG-C interface
etpsig_c_info
Execution printouts

ETPC/1/0>
etpsig_c_info
ETP IP address:
ETP Port Number:
BCSU IP address:
BCSU Port Number:
.
.
.
.
ETP IP address:
ETP Port Number:
BCSU IP address:
BCSU Port Number:

10.1.6.25
9900
10.1.6.2
9900

10.1.6.25
9900
10.121.134.154
9900

2.7
2.7.1

Service Terminal Command for SyncE Handler module


dsynce
Function
It is used to display the SyncE parameters in ETPE.
Syntax
dsynce

74

Id:0900d80580825b4d
Confidential

DN0984303

ETP Service Terminal Commands

Service terminal commands

Examples
1. To display SyncE parameters
dsynce
Execution printouts
ETPE/1/0> dsynce
---------------------------------------------------------------> Command dsynce executed on [1/1/2010 0:10:51:930001] <---------------------------------------------------------------SyncE Mode 1
SSM Mode 1
QL Value 0010
ETPE/1/0>

2.8
2.8.1

Service Terminal Application Commands


detpps (Display ETP Packet Switched Connections)
Function
This can be used to view the connected PCU2s with the ETP. This command displays
the connected PCU2-D/E with ETP. For PCU2-D it displays the information about the
HDLC Connections allocated to each PCU2-D. It also displays the IP of the connected
PCU2-E s.
Syntax
detpps
Examples
1. To display the information of connected PCU2 with ETP
detpps
Execution printouts

ETPE/1/0>detpps
---------------------------------------------------------------> Command detpps executed on [11/1/2011 12:45:33:81380] <----------------------------------------------------------------------------------------PCU2E-----------------------BCSU Logical Address : 5
PCU Index : 3
IP Version : 4
IP Address : 10.1.10.6
--------------------------PCU2D-----------------------BCSU Logical Address: 1
PCU Index: 0
HDLC INDEX : 0HDLC PIPE ID : 0 HDLC STATE : CREATED
HDLC INDEX : 1HDLC PIPE ID : 32HDLC STATE : CREATED
HDLC INDEX : 2HDLC PIPE ID : 64HDLC STATE : CREATED

DN0984303

Id:0900d80580825b4d
Confidential

75

Service terminal commands

ETP Service Terminal Commands

HDLC INDEX : 3HDLC PIPE ID : 96HDLC STATE : CREATED


HDLC INDEX : 4HDLC PIPE ID : 128HDLC STATE : CREATED
HDLC INDEX : 5HDLC PIPE ID : 160HDLC STATE : CREATED
HDLC INDEX : 6HDLC PIPE ID : 192HDLC STATE : CREATED
HDLC INDEX : 7HDLC PIPE ID : 224HDLC STATE : CREATED
---------------------------------------------------------------Number of PCU2E connected :: 1
Number of PCU2D connected :: 1

2.8.2

detpcs (Display Ongoing Call Information in ETPT / ETPE / ETPC /


ETPA)
Function
This can be used to log the output of all the active calls. This can be typically used in
scenarios where the user needs to capture the output into a file for offline analysis.
Syntax
detpcs <all>
Examples
1. To list the number of ongoing CS calls
detpcs
2. To list the number of calls and detailed call information
detpcs all
Execution printouts

In case of ETPE Variant:


ETPE/1/0>detpcs all
--------------------------------------------------------------------------------------------> Command detpcs executed on [1/1/2010 0:10:51:930001] <--------------------------------------------------------------------------------------------Call 1 Info:
---------------------------------------------------Call-TYPE
::
TC in BSS
BCF-ID/RCP
::
53 / 16384
BCF U-plane IP
::
0xa764434
DSP-ID/Core-ID
::
0 / 0
Payload Type
::
3
ETP-T/E RTP Port ::
63448
Call 2 Info:
---------------------------------------------------Call-TYPE
::
TC in MGW
BCF-ID/RCP
::
5 / 16388
BCF U-plane IP
::
0xa764434
ETPA TLA
::
0xa764435 / 0xc004
ETP-T/E RTP Port ::
63450
********************************************************
Total running calls
:: 2
*********************************************************************

76

Id:0900d80580825b4d
Confidential

DN0984303

ETP Service Terminal Commands

Service terminal commands

Enabling this command may affect the performance of the System


**********************************************************************
--------------------------------------------------------------------------------In case of ETPC Variant:
ETPC/0/1>detpcs all
--------------------------------------------------------------------------------------------> Command detpcs executed on [1/1/2010 0:10:51:930001] <--------------------------------------------------------------------------------------------Call Id: 1
State : ACTIVE
PCM/ TSL/ ETPC PORT
::
0 / 1 / 57346
MGW TLA
::
0xa764424 / 49522
DSP Port/ Core Id/ Ch No
::
49150 / 0 / 0
********************************************************
Total running calls
:: 1
*********************************************************************
Enabling this command may affect the performance of the System
**********************************************************************
--------------------------------------------------------------------------------In case of ETPA Variant:
ETPA/0>detpcs all
--------------------------------------------------------------------------------------------> Command detpcs executed on [1/1/2010 0:10:51:930001] <--------------------------------------------------------------------------------------------ETPA BASE UDP PORT = 49152
ETPA Call 1 Info:
---------------------------------------------------Connection ID/Local ID
::
0x88/53
ETPT/E TLA
::
10.203.173.12 / 0xf800
MGW TLA
::
10.118.58.76 / 0x5004
BCSU_Index
::
0x4d5a
CallState
::
HANDOVER
New ETPT/E TLA
::
10.203.173.22 / 0xf810
New/Old StreamId
::
1/0
Call 2 Info:
---------------------------------------------------Connection ID/Local ID
::
0x90/54
ETPT/E TLA
::
10.203.173.12 / 0xf804
MGW TLA
::
10.118.58.76 / 0x5008
BCSU_Index
::
0x4d5a
CallState
::
ACTIVE
********************************************************
Total running calls
:: 2
Total No of HO calls running = 1
*********************************************************************
Enabling this command may affect the performance of the System
**********************************************************************
---------------------------------------------------------------------------------

DN0984303

Id:0900d80580825b4d
Confidential

77

Service terminal commands

2.9
2.9.1

ETP Service Terminal Commands

Service Terminal - Aditional Features


Commands in Continuous mode
Some Service Terminal commands can be run in continuous mode. This feature can be
invoked by enabling/disabling continuous mode.
e.g.: ecm <refresh time in seconds>
After this mode is set the commands mentioned below would run every time period
seconds, giving the user a continuous update on the list of processes running and their
status.
The commands, which can be run in continuous mode, are:

2.9.2

etptop
daa
dbu
dbp
dbs
dtu
dtp
dsco
dsca

Disclaimer and Welcome note


When the User logged in to the ETP PIU through the Service Terminal. The following
disclaimer and welcome note is displayed.

2.9.2.1

Welcome message
Sample Welcome message display for ETPT variant with index 0 and ETPSIG-m plane
IP as 10.23.45.45:

WELCOME TO ETP SERVICE TERMINAL DIALOGUE, ETPT/4/0,2010-4-21 0:7:40

2.9.2.2

Disclaimer

ETP SERVICE TERMINAL IS A SPECIALIST TOOL. UNAUTHORIZED USAGE MAY CAUSE DAMAGE

2.9.3

Bootup Phases and Traces


When the Service Terminal boots up, Traces are displayed on the Serial interface to
provide the operator with the information and indications of what phase is currently in
progress in the system.

78

Id:0900d80580825b4d
Confidential

DN0984303

ETP Service Terminal Commands

2.10
2.10.1

Service terminal commands

Service Terminal Commands Related information


Application ids for commands
This is a sample application id list and is not exhaustive (i.e. it does not contains the all
ETP application ids).

ETPE/1/0>dai
---------------------------------------------------------------> Command dai executed on [1/1/1970 0:1:54:978090] <--------------------------------------------------------------**********************************************************************************
Application Name
Application ID
**********************************************************************************
Platform Component IDs common to Octeon and DSP
**********************************************************************************
Component manager(CM)
1
Inter Process Communication(IPC)
2
Logger(LOGGER)
3
DSP Manager(DSPM)
4
Black Box (BB)
5
**********************************************************************************
Platform Component IDs common to Octeon Management and SE core
**********************************************************************************
Performance Management System (PMS)
6
Alarm Server(ARS)
9
Interface Manager (IM)
17
System Packet Interface(SPI)
24
Octeon Packet Handler(OPH)
25
IPC Management(IPC)
27
**********************************************************************************
Platform Component IDs for Octeon Management Core
**********************************************************************************
Message Router(MR)
7
Software Download(SDL)
8
Diagnostics(DIAG)
11
DSP Resource Manager(DSPRM)
12
Service Terminal (ST)
13
Redundancy Framework (RF)
14
Hardware Supervision (HWS)
15
Service Terminal Agent(STA)
18
PCM FPGA Controller(PCM FPGA)
19
System Monitor(SYSMON)
20
Frontend FPGA Controller(FE-FPGA)
21
FPGA Common App Id(FPGA)
22
General Purpose Input and Output(GPIO)
23
HDLC/ML/MC-PPP Controller (HMC)
29
**********************************************************************************
Platform Component IDs for Octeon SE core
**********************************************************************************

DN0984303

Id:0900d80580825b4d
Confidential

79

Service terminal commands

ETP Service Terminal Commands

Buffer Frames(BF)
16
Simple Executive(SE)
26
Simple Executive System Monitoring
28
LCP/NCP Manager(LCP NCP)
30
Serial Frame Packet
31
Sychnronous Ethernet
32
**********************************************************************************
Application Component IDs for OCTEON Management Core
**********************************************************************************
CS Call Handler(CCH)
33
Packet Switch Management Plane(PSMP)
34
Resource Manager(RM)
35
**********************************************************************************
Application Component IDs for OCTEON SE CORE
**********************************************************************************
Packet Switch User Plane (PSUP)
36
CS PS handler (CPH)
37
Demultiplexer (DEMUX)
38
Uplink packet Controller (UPC)
39
Downlink packet Controller (DPC)
40
Multiplexer (MUX)
41
ETPT IPHC Compressor (IPHCC)
42
ETPT IPHC Decompressor (IPHCD)
43
**********************************************************************************
Platform Component IDs for DSP
**********************************************************************************
DSP CPU MON APP ID
7
Telecom Serial Interface Port
8
TSIP Frames in Transmit Direction
9
TSIP Frames in Receive Direction
10
TSIP0 Excetption Handler
11
TSIP1 Excetption Handler
12
TSIP Super Frames in Transmit Direction
13
TSIP Super Frames in Receive Direction
14
IPC over TCP (IPCA)
15
Data Transfer Task Packet Switch(DTTPS)
18
Data Transfer Task Circuit Switch(DTTCS)
17
DSP Interrupt Service Routine (DSP AET)
16
**********************************************************************************
Application Component IDs for DSP
**********************************************************************************
DSP Packet Switch management Plane(DPSMP)
19
DSP Packet Switch User Plane (DPSUP)
20
Downlink CS Call Handler (DCCH)
21
Uplink Packet Handler (UPH)
22
Downlink packet handler (DPH)
23
RTP TRAU Handler (RTH)
24
ETP Framer Deframer (EFD)
25

80

Id:0900d80580825b4d
Confidential

DN0984303

ETP Service Terminal Commands

2.10.2
2.10.2.1

Service terminal commands

Counter ids for DSCO Command


List of Counters Support in ETPE
Statistics Counter Name

Counter
Number

CS U-PLANE RTP PACKETS RECEIVED

124000

BCF ID

CS U-PLANE RTP PACKETS LOST

124001

BCF ID

CS U-PLANE RTP PACKETS RECEIVED TOO LATE

124002

BCF ID

CS U-PLANE RTP PACKETS RECEIVED TOO EARLY 124003

BCF ID

CS U-PLANE RTP PACKETS RECEIVED ON TIME

124004

BCF ID

CS U-PLANE RTP PACKETS SENT

124005

BCF ID

PS U-PLANE RTP PACKETS RECEIVED

124006

BCF ID

PS U-PLANE RTP PACKETS LOST

124007

BCF ID

PS U-PLANE RTP PACKETS SENT

124008

BCF ID

CS U-PLANE UDP PACKETS RECEIVED

124009

BCF ID

CS U-PLANE UDP PACKETS SENT

124010

BCF ID

CS U-PLANE UDP OCTETS RECEIVED

124011

BCF ID

CS U-PLANE UDP OCTETS SENT

124012

BCF ID

PS U-PLANE UDP OCTETS RECEIVED

124013

BCF ID

PS U-PLANE UDP OCTETS SENT

124014

BCF ID

Table 3

124 - Packet Abis Traffic measurement

Statistics Counter Name

Counter Number

RECEIVED ETHERNET FRAMES

128000

ERRORED ETHERNET FRAMES

128001

TRANSMITTED ETHERNET FRAMES

128002

RECEIVED OCTETS

128003

TRANSMITTED OCTETS

128004

Table 4

2.10.2.2

128 - ETP Ethernet BSC measurement

List of Counters Support in ETPT


Statistics Counter Name
CS U-PLANE RTP PACKETS RECEIVED
Table 5

DN0984303

First
Dimension

Counter
Number
124000

First
Dimension
BCF ID

124 - Packet Abis Traffic measurement

Id:0900d80580825b4d
Confidential

81

Service terminal commands

ETP Service Terminal Commands

Statistics Counter Name

124001

BCF ID

CS U-PLANE RTP PACKETS RECEIVED TOO LATE

124002

BCF ID

CS U-PLANE RTP PACKETS RECEIVED TOO EARLY 124003

BCF ID

CS U-PLANE RTP PACKETS RECEIVED ON TIME

124004

BCF ID

CS U-PLANE RTP PACKETS SENT

124005

BCF ID

PS U-PLANE RTP PACKETS RECEIVED

124006

BCF ID

PS U-PLANE RTP PACKETS LOST

124007

BCF ID

PS U-PLANE RTP PACKETS SENT

124008

BCF ID

CS U-PLANE UDP PACKETS RECEIVED

124009

BCF ID

CS U-PLANE UDP PACKETS SENT

124010

BCF ID

CS U-PLANE UDP OCTETS RECEIVED

124011

BCF ID

CS U-PLANE UDP OCTETS SENT

124012

BCF ID

PS U-PLANE UDP OCTETS RECEIVED

124013

BCF ID

PS U-PLANE UDP OCTETS SENT

124014

BCF ID

124 - Packet Abis Traffic measurement (Cont.)

List of Counters Support in ETPA


Statistics Counter Name

Counter Number

RECEIVED ETHERNET FRAMES

128000

ERRORED ETHERNET FRAMES

128001

TRANSMITTED ETHERNET FRAMES

128002

RECEIVED OCTETS

128003

TRANSMITTED OCTETS

128004

Table 6

128 - ETP Ethernet BSC measurement

Statistics Counter Name

Counter Number

RTP PACKETS RECEIVED

130000

RTP PACKETS LOST

130001

RTP PACKETS SENT

130002

RTP PACKET OCTETS RECEIVED

130003

RTP PACKET OCTETS SENT

130004

Table 7

82

First
Dimension

CS U-PLANE RTP PACKETS LOST

Table 5

2.10.2.3

Counter
Number

130-AoIP Traffic BSC measurement

Id:0900d80580825b4d
Confidential

DN0984303

ETP Service Terminal Commands

2.10.2.4

Service terminal commands

List of Counters Support in ETPC


Statistics Counter Name

Counter Number

RTP PACKETS RECEIVED

131000

RTP PACKETS LOST

131001

RTP PACKETS SENT

131002

RTP PACKET OCTETS RECEIVED

131003

RTP PACKET OCTETS SENT

131004

RTP PACKETS RECEIVED TOO LATE

131005

RTP PACKETS RECEIVED TOO EARLY

131006

Table 8

131-AoIP Traffic TCSM measurement

Statistics Counter Name


RECEIVED ETHERNET FRAMES

129000

ERRORED ETHERNET FRAMES

129001

TRANSMITTED ETHERNET FRAMES

129002

RECEIVED OCTETS

129003

TRANSMITTED OCTETS

129004

Table 9

DN0984303

Counter Number

129-ETP Ethernet TCSM measurement

Id:0900d80580825b4d
Confidential

83

Related information

ETP Service Terminal Commands

Related information
Service terminal commands

84

The command outputs provided in this document are illustrative and the actual outputs
may differ.

Id:
Confidential

DN0984303