OlenCom MG-iP Series User manual

MG-iP-
TDM Over IP Gateway
October 2006
Copyright © 2006 OlenCom Electronics ltd.. All rights reserved.
Specifications and information are subject to change without notice.

MG-IP – TDM Over IP Gateway Reference Manual
MG-IP Reference Manual
Notice Page
Release Information
Date Rev. Change Level Comments Catalog No.
June 2006 3.3.0 Firmware
version 3.3.0 Revised with additional information on CLI, RCP, and
other subjects
DC-RM-MG-IP-
1/MG-IP-4
October 2006 3.4.0 Firmware
version 3.4.0 Revised with additional information on Clock Recovery,
Download Files, Corrections to a
number of incorrect CLI examples
DC-RM-MG-IP-
1/MG-IP-4
Proprietary Notice
No part of this publication may be copied in any form, by photocopy, microfilm, retrieval system, or by
any means now known or hereafter invented without the prior written permission of Olencom Inc.
Olencom Inc. and the Olencom logo are trademarks of Olencom Inc.
All other trademarks used in this document are the property of their respective owners.
Olencom Inc. reserves the right to make changes to the product(s) or information contained herein
without notice. No liability is assumed as a result of their use or application. No rights under any patent
accompany the sale of any such product(s) or information.
Contact Information
Technical Support
e-Mail: [email protected]
OlenCom ltd. Web Site
www.olencom.com

MG-IP – TDM Over IP Gateway Reference Manual
About this Document
The MG-IP-1 and MG-IP-4 units are fully integrated TDM over Packet (TDMoP) gateways that
multiplex T1/E1 circuits and 100 Mbps user Ethernet data ports onto any standard Ethernet/IP network
or link. The units support rapid design of standards-compliant TDM over packet circuit emulation
equipment. They can be used in standalone applications or in hosted environments. The MG-IP-1,
which supports a single E1/T1 port only, is targted as a CPE device and is limited to a single
pseudowire session, while the MG-IP-4 provides support for 4 E1/T1 ports and may be configured as
an aggregator, aggregating multiple pseudowires opposite multiple MG-IP-1 devices. This document
describes the functionality, pinout, power requirements, and management of the MG-IP-1 and the MG-
IP-4. Loopback mechanisms and troubleshooting suggestions are also provided.
The MG-IP-1 and MG-IP-4 feature identical software and board layouts. All CLIs
and management options are exactly the same on both modules. While many of
the examples in this manual focus on the MG-IP-1, they are equally applicable to
the MG-IP-4.
Further Reading
If you would like further information about the MG-IP-1 and MG-IP-4, or if you have questions not
answered by these documents, please contact [e-mail] or visit our web site at
http://www.olencom.com.
Feedback
We welcome feedback on our products and our documentation.
If you have any comments or suggestions about this product, contact your supplier and give them the
product name and a concise explanation.
Alternatively, you can send your feedback directly to us at [e-mail] with the following
information:
The document title
The document’s catalog number
The page number(s) to which your comments refer
Your comments

Contents i
Table of Contents
1Functional Description.....................................................................................11
Overview......................................................................................................................... 11
Circuit Emulation Service (CES)..................................................................................... 11
MG-IP CES Operation...................................................................................................12
MG-IP in CES Topology................................................................................................12
Fractional Operation ....................................................................................................... 12
CAS Signaling.................................................................................................................12
Grooming.........................................................................................................................12
CCS Signaling.................................................................................................................12
Header Options...............................................................................................................12
Timing Modes ................................................................................................................. 13
Classic TDM Timing.......................................................................................................14
Loopback Timing............................................................................................................14
Internal Timing................................................................................................................14
External Timing...............................................................................................................15
Line Timing......................................................................................................................15
Differential Timing ..........................................................................................................16
Recovered Clock Mode.................................................................................................17
Adaptive Timing..............................................................................................................17
Cascading Two Modules...............................................................................................21
Recovered Timing Holdover.........................................................................................22
Packet Delay Variation (Jitter) Buffer..........................................................................22
Packet Reordering .........................................................................................................22
Interfaces........................................................................................................................ 22
IP Address Configuration..............................................................................................23
WAN IP Configuration Limitations ...............................................................................24
DHCP Option Support...................................................................................................24
Functional Block Diagram............................................................................................... 26
T1/E1 to Packet..............................................................................................................26
Packet to T1/E1..............................................................................................................26
LAN to WAN....................................................................................................................26
WAN to LAN....................................................................................................................27
Ethernet Configuration...................................................................................................27
Control Processor...........................................................................................................27
UART.............................................................................................................................. 27
LED Interface.................................................................................................................. 28
MG-IP Configuration....................................................................................................... 28

MG-IP TDM Over IP Gateway Reference Manual
Contents
ii
Pseudowire Sessions...................................................................................................... 28
Configuration Database.................................................................................................. 28
WAN.................................................................................................................................28
LAN/Management (rear panel).....................................................................................29
T1/E1 Interface...............................................................................................................29
TDM over Packet Application ......................................................................................... 30
Packet Headers .............................................................................................................. 30
CAS Signaling with CESoPSN and CESoEth Headers.................................................. 31
Jitter Buffer/Underrun/Overrun ....................................................................................... 32
Replacement Frames and Packet Reordering...........................................................33
Jitter Buffer Operation....................................................................................................33
End-To-End Delay Calculation.....................................................................................34
Bandwidth per Pseudowire...........................................................................................34
Framing and Signaling Options ...................................................................................... 35
Clocks ............................................................................................................................. 35
LED Interface.................................................................................................................. 36
LEDs ............................................................................................................................... 37
TDM and Pseudowire Error Handling............................................................................. 38
System Overview............................................................................................................38
TDM Defects and Failures............................................................................................38
Status Indications...........................................................................................................43
Error Handling.................................................................................................................46
Application Signaling......................................................................................................52
Errored Second Counters.............................................................................................53
CES Configuration Parameters....................................................................................53
References......................................................................................................................53
2Management Options.......................................................................................55
The Command Line Interface (CLI)................................................................................ 55
CLI Script Files................................................................................................................55
Script File Format...........................................................................................................55
TLV Files......................................................................................................................... 57
TLV Structure..................................................................................................................57
Rules of Construction ....................................................................................................58
SNMP.............................................................................................................................. 60
Automatic Management and Provisioning...................................................................... 60
Safe Download (UDL) Mode.........................................................................................60
File Download via TFTP Client.....................................................................................60
Dynamic Downloading/Processing of CLI Script-based Configuration..................61
Dynamic Firmware Download through a TFTP/DHCP Client..................................61
Syslog Error Reporting..................................................................................................61

Contents iii
3Configuring The MG-IP via CLI........................................................................65
Configuring the Management PC ................................................................................... 66
TELNET Using LAN........................................................................................................ 68
Managing Users.............................................................................................................. 68
User Management Tasks..............................................................................................69
Manage User Accounts Example ................................................................................... 70
Managing the CONSOLE Interface ................................................................................ 74
CONSOLE Management Tasks...................................................................................75
CONSOLE Management Example..............................................................................75
Managing Basic Functionality......................................................................................... 75
Basic Board Management Tasks.................................................................................76
Global Configuration Status............................................................................................ 81
Managing LAN and WAN Interfaces............................................................................... 83
LAN/WAN Management Tasks....................................................................................83
Ethernet Interface Information......................................................................................84
Sample Ethernet Configuration....................................................................................89
Managing the T1/E1 Interface ........................................................................................ 91
T1/E1 Management Tasks............................................................................................92
T1/E1 Interface Information..........................................................................................93
T1/E1 Example Configuration......................................................................................... 99
Managing the MG-IP unit.............................................................................................. 103
Sessions and Pseudowires.........................................................................................103
Out of Stream Signaling..............................................................................................103
Default Configuration...................................................................................................105
Getting Started..............................................................................................................106
Session Management Tasks in Unstructured Mode...............................................116
Session Management Tasks in Structured Mode....................................................118
Structured Mode Example 1 – CESoPSN................................................................121
Structured Mode Example 2 – MEF-8 (CESoEth)...................................................123
Managing SNMP........................................................................................................... 125
SNMP Management Tasks.........................................................................................125
Request Managers.......................................................................................................127
Trap Managers .............................................................................................................128
4SNMP Support.................................................................................................131
The Management Model............................................................................................... 131
SNMP Management Information Base (MIB) ............................................................... 132
MG-IP SNMP Support................................................................................................... 133
MIB Support.................................................................................................................. 133
Standard MIBs..............................................................................................................133
Draft MIBs......................................................................................................................135

MG-IP TDM Over IP Gateway Reference Manual
Contents
iv
Private MIBs..................................................................................................................137
Irregular Functionality..................................................................................................138
Private MIB - General Definitions ................................................................................. 141
MIB Relations................................................................................................................ 141
SNMP Request Manager Configuration ....................................................................... 142
Configuration Sequence ............................................................................................... 142
Pseudowire Creation with Assigned DS-1 Port .......................................................142
Pseudowire Creation with Assigned Timeslots........................................................142
Updating DS1 Parameters..........................................................................................143
Updating the Pseudowire’s Attached Timeslots......................................................144
Setting SNMP Trap Destination.................................................................................144
Upgrading the Software Image...................................................................................145
Traps............................................................................................................................. 145
Default SNMP Settings................................................................................................. 145
Complete Configuration Examples............................................................................... 145
Unframed Pseudowire.................................................................................................146
Framed Pseudowire.....................................................................................................147
5Command Line Interface................................................................................149
How to Access the CLI.................................................................................................. 151
Connecting via the CONSOLE Port...........................................................................151
Connecting via Telnet and a Network Interface.......................................................151
CLI Command Description Conventions....................................................................... 152
CLI Command Hierarchy .............................................................................................. 153
Summary of CLI Commands ........................................................................................ 155
Configuration Commands ...........................................................................................155
Clock configurathion ....................................................................................................155
Ethernet Configuration Commands (LAN & WAN)..................................................156
T1/E1 Configuration Commands................................................................................156
Port Configuration Commands...................................................................................156
Profile Definition Commands......................................................................................157
CONSOLE Configuration Commands.......................................................................157
SNMP Configuration Commands...............................................................................157
TDM over Packet Configuration Commands............................................................157
TDM Error Reporting Commands..............................................................................158
Session Configuration Commands............................................................................159
General Configuration Commands............................................................................159
Monitoring Commands ................................................................................................159
Ethernet Monitoring Commands (LAN and WAN)...................................................160
T1/E1 Monitoring Commands.....................................................................................160
Port Monitoring Commands........................................................................................160

Contents v
Profile Definition Monitoring Commands ..................................................................161
CONSOLE Monitoring Commands............................................................................161
SNMP Monitoring Commands....................................................................................161
TDM over Packet Monitoring Commands.................................................................161
Session Configuration..................................................................................................161
General Monitoring Commands.................................................................................162
Diagnostics Commands ..............................................................................................162
Admin Commands........................................................................................................163
User Commands...........................................................................................................163
CLI Command Descriptions.......................................................................................... 163
6Testing the MG-IP...........................................................................................165
Loopback Options......................................................................................................... 165
Using the Get Status Command to Evaluate Performance.......................................... 168
Troubleshooting Guide.................................................................................................. 169
Appendix A CLI Commands ...........................................................................A-1
CLI Command Lookup Matrix........................................................................................A-1
CLI Command Descriptions...........................................................................................A-5
AddNewSession...........................................................................................................A-5
AddRequestManager...................................................................................................A-6
AddTrapManager .........................................................................................................A-7
AddUser.........................................................................................................................A-8
ApplyChanges...............................................................................................................A-9
Bert...............................................................................................................................A-10
CalibrateJitter..............................................................................................................A-11
ChangePassword.......................................................................................................A-12
ConfigHeaderCESoETH............................................................................................A-13
ConfigHeaderSAT/CESoP........................................................................................A-14
ConfigSesTargetIP.....................................................................................................A-15
ConnectClockToSession...........................................................................................A-16
DeleteUser...................................................................................................................A-17
DownLoadFile.............................................................................................................A-18
ForceUserLogout........................................................................................................A-19
FunctionalTest............................................................................................................A-20
GetActiveUsers...........................................................................................................A-21
GetBertStatus .............................................................................................................A-22
GetBoardData.............................................................................................................A-23
GetCLIPrompt.............................................................................................................A-24
GetClockStatus...........................................................................................................A-25
GetConfig.....................................................................................................................A-26
GetConfigDBStatus....................................................................................................A-31

MG-IP TDM Over IP Gateway Reference Manual
Contents
vi
GetConfigIfs................................................................................................................A-32
GetConfigUarts...........................................................................................................A-33
GetDateTime...............................................................................................................A-34
GetDefGateway..........................................................................................................A-35
GetFirmwareStatus....................................................................................................A-36
GetGlobalConfig.........................................................................................................A-37
GetGlobalStatus.........................................................................................................A-38
GetInitDnldStatus.......................................................................................................A-41
GetMacAddress..........................................................................................................A-42
GetModifiedConfigPorts............................................................................................A-43
GetRequestManagers................................................................................................A-44
GetRequestTrapPorts................................................................................................A-45
GetRunningConfigPorts ............................................................................................A-46
GetSessionTimeSlots................................................................................................A-47
GetSnmpStatistics......................................................................................................A-48
GetStatistics................................................................................................................A-52
GetStatus.....................................................................................................................A-55
GetStatusBoard..........................................................................................................A-58
GetStatusIfs.................................................................................................................A-59
GetSystemDesc..........................................................................................................A-61
GetTimeSlotMap.........................................................................................................A-62
GetTrapManagers......................................................................................................A-63
GetUsers......................................................................................................................A-64
GetVersion...................................................................................................................A-65
ListClocks....................................................................................................................A-66
ListOfSessions............................................................................................................A-67
PwTDMCfgRtpHdrUsed............................................................................................A-68
Reload..........................................................................................................................A-69
RemoveRequestManager.........................................................................................A-70
RemoveSession .........................................................................................................A-71
RemoveSyslogServer................................................................................................A-72
RemoveTrapManager................................................................................................A-73
RenameSession.........................................................................................................A-74
Replace........................................................................................................................A-75
ReplaceReload...........................................................................................................A-76
SatopSendLBitOnAIS................................................................................................A-77
SetActiveClock............................................................................................................A-78
SetCESappTestMode................................................................................................A-79
SetChannelBandwidth...............................................................................................A-80
SetCLIPrompt .............................................................................................................A-81

Contents vii
SetConfigBitStreamClockingMode ..........................................................................A-82
SetConfigCESClock...................................................................................................A-83
SetConfigCESEmulationType..................................................................................A-84
SetConfigCESIP.........................................................................................................A-85
SetConfigCESPaylength...........................................................................................A-86
SetConfigCESVlan.....................................................................................................A-87
SetConfigEth...............................................................................................................A-88
SetConfigEthFlowControl..........................................................................................A-89
SetConfigEthLimit.......................................................................................................A-90
SetConfigLIUlineBuildout..........................................................................................A-91
SetConfigLIULineCode..............................................................................................A-92
SetConfigLIURxTerm.................................................................................................A-93
SetConfigMPLS..........................................................................................................A-94
SetConfigUART..........................................................................................................A-95
SetDateTime...............................................................................................................A-96
SetDefaultDB..............................................................................................................A-97
SetDefGateway...........................................................................................................A-98
SetDynamicMACLpbk................................................................................................A-99
SetEmulationCircuitID..............................................................................................A-100
SetExternalClockDirection......................................................................................A-101
SetExternalClockFreq..............................................................................................A-102
SetFramedParams...................................................................................................A-103
SetIdlePattern...........................................................................................................A-104
SetIPConfig...............................................................................................................A-105
SetLayer2App...........................................................................................................A-106
SetLFlagPolicy..........................................................................................................A-107
SetLIUDynamicLpbk................................................................................................A-108
SetLIULpbk................................................................................................................A-109
SetLOPSPolicy.........................................................................................................A-110
SetPayloadSuppression..........................................................................................A-111
SetPingEnable..........................................................................................................A-112
SetPortsDisable........................................................................................................A-113
SetPortsEnable.........................................................................................................A-114
SetPortState..............................................................................................................A-115
SetRDPolicy..............................................................................................................A-116
SetRequestPort........................................................................................................A-117
SetRFlagPolicy.........................................................................................................A-118
SetRxEqualizerGainLimit........................................................................................A-119
SetSessionPorts.......................................................................................................A-120
SetSessionTimeSlots...............................................................................................A-121