MTX 4104 SIP Manual v5-0 Rev04
MTX 4104 SIP Manual v5-0 Rev04
Mediatrix® 4104
Analog Access Device
Reference Manual
SIP Version
Pb
RoHS
COMPLIANT
2002/95/EC
Mediatrix Telecom, a Division of Media5 Corporation Reference Manual
Portions of this code are copyright (c) 2001, Cambridge Broadband Ltd.
All rights reserved.
Redistribution and use in source and binary forms, with or without modification, are permitted provided that the
following conditions are met:
• Redistributions of source code must retain the above copyright notice, this list of conditions and the
following disclaimer.
• Redistributions in binary form must reproduce the above copyright notice, this list of conditions and the
following disclaimer in the documentation and/or other materials provided with the distribution.
• The name of Cambridge Broadband Ltd. may not be used to endorse or promote products derived from this
software without specific prior written permission.
THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDER “AS IS” AND ANY EXPRESS OR IMPLIED
WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY
AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT
HOLDER BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR
CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE
GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER
CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
(INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS
SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
Mediatrix Telecom, a Division of Media5 Corporation Reference Manual
OpenSSL License
THIS SOFTWARE IS PROVIDED BY ERIC YOUNG “AS IS” AND ANY EXPRESS OR IMPLIED WARRANTIES,
INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS
FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE AUTHOR OR
CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR
CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE
GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER
CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
(INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS
SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
The licence and distribution terms for any publicly available version or derivative of this code cannot be changed.
i.e. this code cannot simply be copied and put under another distribution licence [including the GNU Public
Licence.]
Mediatrix Telecom, a Division of Media5 Corporation Reference Manual
Reference Manual (SIP Version)
Contents
Preface
About this Manual ............................................................................................................ xxi
Document Objectives................................................................................................................................. xxi
Intended Audience..................................................................................................................................... xxi
Related Documentation ............................................................................................................................. xxi
Document Structure.................................................................................................................................. xxii
Document Conventions ........................................................................................................................... xxiv
Warning Definition ................................................................................................................................................... xxiv
Where to find Translated Warning Definition........................................................................................................... xxiv
Other Conventions .................................................................................................................................................. xxiv
SCN vs PSTN........................................................................................................................................................... xxv
Standards Supported ............................................................................................................................................... xxv
Obtaining Documentation ......................................................................................................................... xxv
Mediatrix Download Portal ....................................................................................................................................... xxv
Documentation Feedback ........................................................................................................................................ xxv
Unit Manager Network – Element Management System ......................................................................... xxvi
End User Technical Support.................................................................................................................... xxvi
Chapter 1
Installation ........................................................................................................................... 3
Requirements ...............................................................................................................................................3
Safety Recommendations.............................................................................................................................3
Package Contents ........................................................................................................................................3
Overview.......................................................................................................................................................4
About the Mediatrix 4104 ............................................................................................................................................ 4
Placing a Call .............................................................................................................................................................. 4
Management Choices ................................................................................................................................................. 5
Panels...........................................................................................................................................................6
Front Indicators ........................................................................................................................................................... 6
Rear Connectors ......................................................................................................................................................... 7
Choosing a Suitable Installation Site ..........................................................................................................8
Location....................................................................................................................................................................... 8
Wall-Mounting ............................................................................................................................................................. 9
Free Standing Unit ...................................................................................................................................................... 9
Condensation .............................................................................................................................................................. 9
Cleaning ...................................................................................................................................................................... 9
Hardware Connection .................................................................................................................................10
Reserving an IP Address........................................................................................................................................... 10
Installing the Mediatrix 4104...................................................................................................................................... 10
Starting the Mediatrix 4104 for the First Time.............................................................................................11
Initial Provisioning Sequence .................................................................................................................................... 11
Special Vocal Features ............................................................................................................................................. 12
LED Behaviour in Starting Mode ............................................................................................................................... 12
Chapter 2
Web Interface – Introduction............................................................................................ 21
Introduction .................................................................................................................................................21
Using the Web Interface .............................................................................................................................21
System Status of the Mediatrix 4104......................................................................................................................... 22
Menu Frame .............................................................................................................................................................. 23
Content Frame .......................................................................................................................................................... 24
Submitting Changes ...................................................................................................................................24
Syslog Monitoring .......................................................................................................................................25
Configuring the Syslog Daemon Application ............................................................................................................. 26
Chapter 3
Web Interface – Management........................................................................................... 27
Admin Page ................................................................................................................................................27
HTTP Server Password............................................................................................................................................. 27
System Management ................................................................................................................................................ 29
Group Port Management........................................................................................................................................... 30
Interface Management .............................................................................................................................................. 30
Network Settings.........................................................................................................................................31
Ethernet Connection Speed ...................................................................................................................................... 31
Network Settings ....................................................................................................................................................... 33
SNTP Settings ........................................................................................................................................................... 34
Configuration File Download.......................................................................................................................37
Configuration File Download Server.......................................................................................................................... 37
Configuration File Server Settings............................................................................................................................. 38
Setting up the Configuration File Download .............................................................................................................. 39
Configuration Files Encryption .................................................................................................................................. 42
Configuration Download Procedure .......................................................................................................................... 43
Automatic Configuration Update ............................................................................................................................... 44
Error Handling ........................................................................................................................................................... 46
Firmware Download....................................................................................................................................49
Before Downloading .................................................................................................................................................. 49
Firmware Servers Configuration................................................................................................................................ 50
Setting up the Firmware Download ........................................................................................................................... 51
Firmware Download Procedure................................................................................................................................. 55
Chapter 4
Web Interface – SIP Parameters ...................................................................................... 61
SIP Servers Configuration ..........................................................................................................................61
SIP Servers ............................................................................................................................................................... 61
SIP Configuration ...................................................................................................................................................... 62
SIP User Agent.......................................................................................................................................................... 64
SIP Registration ........................................................................................................................................................ 65
SIP Publication .......................................................................................................................................................... 65
SIP Interop..................................................................................................................................................66
SIP Penalty Box ........................................................................................................................................................ 66
SIP Transport Type ................................................................................................................................................... 67
SIP Authentication ......................................................................................................................................68
Chapter 5
Web Interface – Telephony............................................................................................... 71
Digit Maps...................................................................................................................................................71
Syntax ....................................................................................................................................................................... 71
Special Characters .................................................................................................................................................... 72
How to Use a Digit Map............................................................................................................................................. 72
General Parameters .................................................................................................................................................. 74
Allowed Digit Maps.................................................................................................................................................... 75
Blocked Digit Maps.................................................................................................................................................... 76
Voice & Fax Codecs ...................................................................................................................................76
G.711 PCMA and PCMU........................................................................................................................................... 77
G.726......................................................................................................................................................................... 77
G.723.1...................................................................................................................................................................... 78
G.729......................................................................................................................................................................... 78
General Parameters .................................................................................................................................................. 79
G.711 Codec Parameters.......................................................................................................................................... 82
G.729 Codec Parameters.......................................................................................................................................... 83
G.723 Codec Parameters.......................................................................................................................................... 83
G.726 Codecs Parameters ........................................................................................................................................ 84
Fax Parameters ......................................................................................................................................................... 85
Call Forward ...............................................................................................................................................88
On Busy..................................................................................................................................................................... 88
On No Answer ........................................................................................................................................................... 90
Unconditional............................................................................................................................................................. 91
Services ......................................................................................................................................................93
Call Transfer.............................................................................................................................................................. 93
Call Waiting ............................................................................................................................................................... 95
Conference................................................................................................................................................................ 97
Call Hold.................................................................................................................................................................... 99
Second Call ............................................................................................................................................................... 99
Automatic Call ......................................................................................................................................................... 100
Miscellaneous ...........................................................................................................................................100
Country Selection .................................................................................................................................................... 100
Custom Tone Configuration .................................................................................................................................... 102
Message Waiting Indicator ...................................................................................................................................... 109
Mediatrix 4104 ix
Contents
Chapter 6
Web Interface – Advanced.............................................................................................. 113
Quality of Service (QoS) ...........................................................................................................................113
802.1q Configuration ............................................................................................................................................... 113
DiffServ Configuration ............................................................................................................................................. 115
Emergency Page ......................................................................................................................................116
Emergency Call Configuration................................................................................................................................. 116
STUN Configuration..................................................................................................................................117
SIP Outbound Proxy................................................................................................................................................ 117
Restrictions on the Mediatrix STUN Implementation............................................................................................... 117
STUN Client Configuration ...................................................................................................................................... 118
SIP Custom NAT Traversal ..................................................................................................................................... 119
SNMP Configuration
Chapter 7
MIB Structure and SNMP ................................................................................................ 123
SNMP Overview .......................................................................................................................................123
Definitions................................................................................................................................................................ 123
SNMP Versions ....................................................................................................................................................... 124
SNMP Behaviour..................................................................................................................................................... 125
SNMPv3 Special Behaviour .................................................................................................................................... 126
SNMP Configuration via a Configuration File .......................................................................................................... 127
MIB Structure............................................................................................................................................131
Textual Conventions................................................................................................................................................ 132
Objects, Conformance, and Events......................................................................................................................... 132
IP Addresses ........................................................................................................................................................... 133
Persistence.............................................................................................................................................................. 133
Changing a Parameter Value .................................................................................................................................. 133
Tables .......................................................................................................................................................134
Generic Variables .................................................................................................................................................... 134
Variables for Administrative Commands ................................................................................................................. 135
SNMP Service Agent ................................................................................................................................136
Current MIB Version .................................................................................................................................136
Sending Configuration Data to the Mediatrix 4104 ...................................................................................136
Configuration File .................................................................................................................................................... 136
Management Information Base – MIB ..................................................................................................................... 136
Chapter 8
IP Address and Network Configuration ........................................................................ 137
IP Addresses ............................................................................................................................................137
IP Addresses Formats in the DHCP Server ............................................................................................................ 137
Provisioning Source ................................................................................................................................................ 138
Services ....................................................................................................................................................139
Configuration Source............................................................................................................................................... 139
Local Host ............................................................................................................................................................... 140
Static DNS............................................................................................................................................................... 142
Image ...................................................................................................................................................................... 143
x Mediatrix 4104
Reference Manual (SIP Version)
Chapter 9
SIP Servers ...................................................................................................................... 157
Registrar Server........................................................................................................................................157
Configuration Source............................................................................................................................................... 157
Proxy Server .............................................................................................................................................159
Configuration Source............................................................................................................................................... 159
Outbound Proxy Server ............................................................................................................................161
Configuration Source............................................................................................................................................... 161
Loose Router Configuration .................................................................................................................................... 163
Presence Compositor Server....................................................................................................................164
Configuration Source............................................................................................................................................... 164
Chapter 10
DNS SRV Configuration.................................................................................................. 167
What is a DNS SRV?................................................................................................................................167
Priority vs Weight .................................................................................................................................................... 167
DNS SRV Call Flow................................................................................................................................................. 168
Enabling DNS SRV on the Mediatrix 4104 ...............................................................................................168
DNS SRV Record Lock.............................................................................................................................169
DNS SRV-Oriented Settings.....................................................................................................................169
Chapter 11
Country-Specific Configuration ..................................................................................... 171
Caller ID Information.................................................................................................................................171
Caller ID Generation................................................................................................................................................ 171
ADSI ........................................................................................................................................................................ 172
Mediatrix 4104 xi
Contents
Chapter 12
Configuration File Download ......................................................................................... 181
Configuration File Download Server .........................................................................................................181
Configuring the TFTP Server .................................................................................................................................. 181
Configuring the SNTP Server.................................................................................................................................. 181
Configuring the HTTP Server .................................................................................................................................. 181
Configuration File Server Settings........................................................................................................................... 181
Setting up the Configuration File Download ............................................................................................................ 183
Configuration Update Status ................................................................................................................................... 184
Configuration Files Encryption ................................................................................................................................ 186
Configuration Download via TFTP .......................................................................................................................... 187
Configuration Download via HTTP .......................................................................................................................... 188
Automatic Configuration Update ............................................................................................................................. 189
Error Handling ......................................................................................................................................................... 191
Management Server .................................................................................................................................194
Management Server Configuration ......................................................................................................................... 194
Downloading from the Management Server ............................................................................................................ 194
Error Handling ......................................................................................................................................................... 195
Syslog Messages .................................................................................................................................................... 196
Configuration File Example.......................................................................................................................197
Supported Characters ............................................................................................................................................. 197
Chapter 13
Software Download ......................................................................................................... 199
Before Downloading .................................................................................................................................199
Configuring the TFTP Server .................................................................................................................................. 199
Configuring the SNTP Server.................................................................................................................................. 199
Configuring the HTTP Server .................................................................................................................................. 199
Software Servers Configuration................................................................................................................200
DHCP Configuration................................................................................................................................................ 200
Static Configuration ................................................................................................................................................. 201
Download Procedure ................................................................................................................................202
Extracting the Zip File.............................................................................................................................................. 202
Setting up the Image Path....................................................................................................................................... 202
Software Download Status ...................................................................................................................................... 204
Download via TFTP................................................................................................................................................. 206
Download via HTTP ................................................................................................................................................ 207
Automatic Software Update..................................................................................................................................... 208
Spanning Tree Protocol (STP) ................................................................................................................................ 210
Software Downgrade ................................................................................................................................211
Emergency Software Procedure...............................................................................................................211
Using the Emergency Software............................................................................................................................... 211
Chapter 14
Line Configuration .......................................................................................................... 213
Lines Administrative State ........................................................................................................................213
Temporary Administrative State .............................................................................................................................. 213
Permanent Administrative State.............................................................................................................................. 214
Unregistered Line Behaviour ....................................................................................................................214
Flash Hook Detection ...............................................................................................................................215
Source Line Selection...............................................................................................................................215
Examples of Source Line Selection Use ................................................................................................................. 216
Loop Current.............................................................................................................................................217
Callee Hang-up Supervision .....................................................................................................................218
Line Reversal............................................................................................................................................219
Blanking of an Anonymous Caller ID ........................................................................................................219
Chapter 15
Voice Transmissions ...................................................................................................... 221
Codec Descriptions...................................................................................................................................221
G.711 PCMA and PCMU......................................................................................................................................... 221
G.726....................................................................................................................................................................... 222
G.723.1.................................................................................................................................................................... 222
G.729....................................................................................................................................................................... 223
Preferred Codec .......................................................................................................................................223
Enabling Individual Codecs ......................................................................................................................224
Packetization Time ...................................................................................................................................225
DTMF Transport Type ..............................................................................................................................227
DTMF Transport Using SIP INFO ........................................................................................................................... 228
DTMF Payload Type ............................................................................................................................................... 229
DTMF – RFC 2833 Events ...................................................................................................................................... 229
DTMF Transport over the SIP Protocol ................................................................................................................... 230
Adaptative Jitter Buffer .............................................................................................................................231
About Changing Jitter Buffer Values ....................................................................................................................... 231
Voice Activity Detection ............................................................................................................................232
G.711 and G.726 VAD ............................................................................................................................................ 232
G.729 VAD .............................................................................................................................................................. 233
Echo Cancellation.....................................................................................................................................233
Comfort Noise...........................................................................................................................................234
User Gain..................................................................................................................................................235
Chapter 16
Fax Transmission............................................................................................................ 237
Introduction ...............................................................................................................................................237
Fax Calling Tone Detection ......................................................................................................................237
Clear Channel Fax....................................................................................................................................238
T.38 Fax....................................................................................................................................................239
T.38 No-Signal ........................................................................................................................................................ 240
Chapter 17
Bypass Configuration ..................................................................................................... 241
Bypass Connector Settings ......................................................................................................................241
Standard Bypass ..................................................................................................................................................... 241
Chapter 18
SIP Protocol Features ..................................................................................................... 243
User Agents ..............................................................................................................................................243
Home Domain Override........................................................................................................................................... 244
SIP User Agent Header ........................................................................................................................................... 244
Session Timers .........................................................................................................................................245
Session Timer Version ............................................................................................................................................ 245
Background Information .......................................................................................................................................... 246
Authentication ...........................................................................................................................................246
Line-Specific Authentication .................................................................................................................................... 246
Unit Authentication .................................................................................................................................................. 247
Authentication Request Protection .......................................................................................................................... 247
SIP Trusted Sources.................................................................................................................................248
NAT Traversal...........................................................................................................................................248
Mediatrix 4104 Configuration .................................................................................................................................. 249
NAT System Configuration...................................................................................................................................... 249
SIP Transport Type...................................................................................................................................249
Transport Parameter ............................................................................................................................................... 250
UDP Source Port Behaviour.................................................................................................................................... 250
SIP Penalty Box........................................................................................................................................251
Penalty Box vs Transport Types ............................................................................................................................. 251
Penalty Box Configuration....................................................................................................................................... 251
Registration Parameters ...........................................................................................................................252
Refreshing Registration........................................................................................................................................... 252
Registration Expiration ............................................................................................................................................ 253
Default Registration Expiration................................................................................................................................ 253
Publication Parameters.............................................................................................................................254
Refreshing Publications........................................................................................................................................... 254
Publications Expiration ............................................................................................................................................ 254
Default Publication Expiration ................................................................................................................................. 255
Interop Parameters ...................................................................................................................................255
Call Transfer Capacity............................................................................................................................................. 255
Transmission Timeout ............................................................................................................................................. 257
Max-Forwards Header............................................................................................................................................. 258
Referred-By Field .................................................................................................................................................... 258
Direction Attributes in a Media Stream .................................................................................................................... 259
Local Ring Behaviour on Provisional Response ..................................................................................................... 260
SIP Credential ......................................................................................................................................................... 260
Branch Parameter Settings ..................................................................................................................................... 261
Ringing Response Code ......................................................................................................................................... 262
URI-Parameters ...................................................................................................................................................... 262
Unsupported INFO Request.................................................................................................................................... 262
Outbound Proxy Usage ........................................................................................................................................... 263
International Code Mapping .................................................................................................................................... 263
T.38 Negotiation Syntax .......................................................................................................................................... 263
Addressing Failed Registration Attempts ................................................................................................................ 264
SIP Domain in Request URI.................................................................................................................................... 264
Network Asserted Caller ID ..................................................................................................................................... 264
Payload Type Settings ............................................................................................................................................ 265
Controlling the Call Waiting Tone via SIP INFO ...................................................................................................... 266
Ignore Username Parameter ................................................................................................................................... 266
Offer/Answer Model ..................................................................................................................................267
UDP Checksum ........................................................................................................................................267
Chapter 19
STUN Configuration ........................................................................................................ 269
What is STUN? .........................................................................................................................................269
SIP Outbound Proxy................................................................................................................................................ 269
Restrictions on the Mediatrix STUN Implementation............................................................................................... 269
STUN Client Configuration .......................................................................................................................270
Chapter 20
SNTP Settings.................................................................................................................. 271
Enabling the SNTP Client .........................................................................................................................271
Configuration Source ................................................................................................................................272
DHCP Configuration................................................................................................................................................ 272
Static Configuration ................................................................................................................................................. 272
Defining a Custom Time Zone ..................................................................................................................273
STD / DST ............................................................................................................................................................... 273
OFFSET .................................................................................................................................................................. 273
START / END .......................................................................................................................................................... 273
Example .................................................................................................................................................................. 274
Chapter 21
Digit Maps ........................................................................................................................ 275
What is a Digit Map?.................................................................................................................................275
Syntax.......................................................................................................................................................275
Special Characters ...................................................................................................................................276
How to Use a Digit Map ............................................................................................................................276
Combining Several Expressions ............................................................................................................................. 276
Using the # and * Characters .................................................................................................................................. 277
Using the Timer ....................................................................................................................................................... 277
Calls Outside the Country ....................................................................................................................................... 277
Example .................................................................................................................................................................. 277
Validating a Digit Map ............................................................................................................................................. 277
Setting up Digit Maps................................................................................................................................278
Refused Digit Maps ................................................................................................................................................. 278
Digit Maps Timeouts................................................................................................................................................ 279
Digit Map Examples..................................................................................................................................279
Digit Map Example 1 – Standard Calls.................................................................................................................... 279
Digit Map Example 2 – PBX Emulation ................................................................................................................... 281
Chapter 22
Telephony Features ........................................................................................................ 283
Making Calls .............................................................................................................................................283
Complete Dialing Sequence.................................................................................................................................... 283
Dialing a Telephone Number or Numerical Alias .................................................................................................... 283
Mediatrix 4104 xv
Contents
Chapter 23
Subscriber Services........................................................................................................ 285
Service Activation Processing ..................................................................................................................285
Call Hold ...................................................................................................................................................286
Enabling Call Hold................................................................................................................................................... 286
Using Call Hold........................................................................................................................................................ 287
Second Call ..............................................................................................................................................287
Enabling Second Call .............................................................................................................................................. 287
Using Second Call................................................................................................................................................... 287
Call Forward .............................................................................................................................................288
Unconditional........................................................................................................................................................... 288
On Busy................................................................................................................................................................... 290
On No Answer ......................................................................................................................................................... 292
Call Waiting...............................................................................................................................................294
Setting up Call Waiting ............................................................................................................................................ 294
Using Call Waiting ................................................................................................................................................... 294
Call Transfer .............................................................................................................................................296
Blind Transfer .......................................................................................................................................................... 296
Attended Transfer.................................................................................................................................................... 297
Conference Call ........................................................................................................................................298
Requirements .......................................................................................................................................................... 298
Enabling the Conference Call Feature .................................................................................................................... 299
Managing a Conference Call................................................................................................................................... 299
Chapter 24
Telephony Attributes ...................................................................................................... 301
Automatic Call...........................................................................................................................................301
Call Direction Restriction ..........................................................................................................................302
Hook Flash Processing.............................................................................................................................302
IP Address Call Service ............................................................................................................................303
Enabling IP Address Calls....................................................................................................................................... 303
Dialing an IP Address.............................................................................................................................................. 303
PIN Dialing................................................................................................................................................304
Remote Line Extension.............................................................................................................................305
Delayed Hot Line ......................................................................................................................................307
Chapter 25
Message Waiting Indicator ............................................................................................. 309
What is Message Waiting Indicator (MWI)?..............................................................................................309
Standard MWI Methods ............................................................................................................................309
MWI Method #1 ....................................................................................................................................................... 309
MWI Method #2 ....................................................................................................................................................... 311
MWI Notify Service ...................................................................................................................................311
How does the Service Work? .................................................................................................................................. 311
Configuring the IP Communication Server .............................................................................................................. 312
Configuring the Mediatrix 4104 ............................................................................................................................... 312
Chapter 26
Management Server Configuration................................................................................ 313
Using the Management Server .................................................................................................................313
Configuration Source............................................................................................................................................... 313
Chapter 27
Quality of Service (QoS) ................................................................................................. 315
Differentiated Services (DS) Field ...........................................................................................................315
IEEE 802.1q..............................................................................................................................................316
VLAN ........................................................................................................................................................317
Chapter 28
Syslog Daemon ............................................................................................................... 319
Syslog Daemon Configuration ..................................................................................................................319
Configuration Source............................................................................................................................................... 320
Customizing Syslog Messages ............................................................................................................................... 321
Configuring the Syslog Daemon Application ........................................................................................................... 321
Chapter 29
Statistics .......................................................................................................................... 323
RTP Statistics ...........................................................................................................................................323
Statistics Buffers...................................................................................................................................................... 323
How are Statistics Collected?.................................................................................................................................. 323
Statistics by Syslog ................................................................................................................................................. 324
Example .................................................................................................................................................................. 325
Chapter 30
Maximum Transmission Unit (MTU) .............................................................................. 327
What is MTU? ...........................................................................................................................................327
Mediatrix 4104 MTU .................................................................................................................................327
Possible Hardware Problem .....................................................................................................................327
Chapter 31
Troubleshooting .............................................................................................................. 329
General Operation Issues.........................................................................................................................329
Calling Issues ...........................................................................................................................................332
Fax Issues ...............................................................................................................................................333
Tested Fax Models.................................................................................................................................................. 334
Issues Arising from Specific Combinations/Scenarios ............................................................................................ 335
Configuration Issues .................................................................................................................................336
Software Upgrade Issues .........................................................................................................................337
SNMP Management Software Issues.......................................................................................................338
Appendices
Appendix A
Standards Compliance and Safety Information ........................................................... 343
Standards Supported................................................................................................................................343
Disclaimers ...............................................................................................................................................344
Federal Communications Commission (FCC) Part 15 ............................................................................................ 344
Federal Communications Commission (FCC) Part 68 ............................................................................................ 344
Industry Canada ...................................................................................................................................................... 345
CE Marking.............................................................................................................................................................. 345
Translated Warning Definition ..................................................................................................................346
Safety Warnings .......................................................................................................................................347
Circuit Breaker (15A) Warning ................................................................................................................................ 347
TN Power Warning .................................................................................................................................................. 347
Product Disposal Warning....................................................................................................................................... 347
No. 26 AWG Warning.............................................................................................................................................. 347
LAN and FXS port 1 to 4 Connector Warning ......................................................................................................... 347
Socket Outlet Warning ............................................................................................................................................ 347
Safety Recommendations.........................................................................................................................348
Appendix B
Standard Hardware Information..................................................................................... 349
Industry Standard Protocols .....................................................................................................................349
Hardware Features ...................................................................................................................................350
Display..................................................................................................................................................................... 350
Interfaces................................................................................................................................................................. 350
Power ...................................................................................................................................................................... 350
Casing / Installation ................................................................................................................................................. 350
Product Architecture Details .....................................................................................................................350
Real Time Fax Router Technical Specifications .......................................................................................351
Analog Line Interface (FXS) .....................................................................................................................351
Audio Specifications .................................................................................................................................352
DTMF Tone Detection ..............................................................................................................................352
DTMF Tone Generation............................................................................................................................352
MTBF Value..............................................................................................................................................352
Power Consumption .................................................................................................................................353
Measurements at the DC input................................................................................................................................ 353
Operating Environment.............................................................................................................................353
Dimensions and Weight............................................................................................................................353
Warranty ...................................................................................................................................................353
Appendix C
Cabling Considerations .................................................................................................. 355
RJ-45 Cable..............................................................................................................................................355
Straight Through Cable ........................................................................................................................................... 355
Crossover Cable...................................................................................................................................................... 356
RJ-11 (Telephone) Cable .........................................................................................................................357
Wiring Conventions ................................................................................................................................................. 357
Appendix D
Country-Specific Parameters ......................................................................................... 359
Definitions .................................................................................................................................................359
Conventions ............................................................................................................................................................ 359
Distinctive Ring........................................................................................................................................................ 361
Australia....................................................................................................................................................362
Australia 1 ............................................................................................................................................................... 362
Australia 2 ............................................................................................................................................................... 363
Australia 3 ............................................................................................................................................................... 364
Austria.......................................................................................................................................................365
Austria 1 .................................................................................................................................................................. 365
Austria 2 .................................................................................................................................................................. 366
Brazil.........................................................................................................................................................367
Chile..........................................................................................................................................................368
Chile 1 ..................................................................................................................................................................... 368
Chile 2 ..................................................................................................................................................................... 369
China ........................................................................................................................................................370
Czech Republic.........................................................................................................................................371
Denmark ...................................................................................................................................................372
France.......................................................................................................................................................373
Germany ...................................................................................................................................................374
Germany 1............................................................................................................................................................... 374
Germany 2............................................................................................................................................................... 375
Germany 3............................................................................................................................................................... 376
Hong Kong................................................................................................................................................377
Indonesia ..................................................................................................................................................378
Israel .........................................................................................................................................................379
Italy ...........................................................................................................................................................380
Japan ........................................................................................................................................................381
Malaysia....................................................................................................................................................382
Mexico ......................................................................................................................................................383
Netherlands ..............................................................................................................................................384
New Zealand.............................................................................................................................................385
North America...........................................................................................................................................386
North America 1 ...................................................................................................................................................... 386
North America 2 ...................................................................................................................................................... 387
Russia.......................................................................................................................................................388
Spain.........................................................................................................................................................389
Sweden.....................................................................................................................................................390
Switzerland ...............................................................................................................................................391
Thailand ....................................................................................................................................................392
UK.............................................................................................................................................................393
Appendix E
Glossary ........................................................................................................................... 395
Appendix F
List of Acronyms ............................................................................................................. 403
Appendix G
List of MIB Parameters ................................................................................................... 405
xx Mediatrix 4104
P R E F A C E
Document Objectives
The Mediatrix 4104 Reference Manual provides technical information for the Mediatrix 4104.
Use the Mediatrix 4104 Reference Manual in conjunction with the appropriate publications listed in “Related
Documentation” on page xxi.
Intended Audience
This manual provides all the technical information needed to install and manage the Mediatrix 4104. It is
intended for network administrators and system managers who install and set up network equipment;
consequently, it assumes a basic working knowledge of LANs.
From the perspective of the LAN administrator, a Mediatrix 4104 presents itself like another device to add to
the LAN. It requires the same kind of TCP/IP addressing. The Mediatrix 4104 can also use a DHCP server on
the LAN to automatically receive its IP configuration assignment.
Related Documentation
In addition to this manual, the Mediatrix 4104 document set includes the following:
MIB Reference Manual
Lists and explains all parameters in the MIB structure.
Mediatrix 4104 Quick Start Guide
This printed booklet allows you to quickly setup and work with the Mediatrix 4104.
Be sure to read any readme files, technical bulletins, or additional release notes for important information.
Document Structure
Title Summary
“Chapter 2 - Web Interface – Introduction” on Describes how to access the embedded web server of
page 21 the Mediatrix 4104 to set parameters by using the
HTTP protocol.
“Chapter 3 - Web Interface – Management” on Describes the Management page of the web interface,
page 27 which allows you to configure the configuration file
download and firmware download parameters of the
Mediatrix 4104.
“Chapter 4 - Web Interface – SIP Parameters” on Describes the SIP page of the web interface, which
page 61 allows you to configure various SIP-related
parameters of the Mediatrix 4104.
“Chapter 5 - Web Interface – Telephony” on Describes the Telephony page of the web interface,
page 71 which allows you to configure the various telephony
parameters of the Mediatrix 4104.
“Chapter 6 - Web Interface – Advanced” on Describes the Advanced page of the web interface,
page 113 which allows you to configure various system and
network parameters of the Mediatrix 4104.
SNMP Configuration
“Chapter 7 - MIB Structure and SNMP” on Describes how the Mediatrix 4104 uses the SNMP
page 123 protocol for its configuration.
“Chapter 8 - IP Address and Network Describes how to set IP information in the Mediatrix
Configuration” on page 137 4104 and how to configure a DHCP server.
“Chapter 9 - SIP Servers” on page 157 Describes how to configure the Mediatrix 4104 to
properly use the SIP servers.
“Chapter 10 - DNS SRV Configuration” on Describes the Mediatrix 4104’s behaviour with a DNS
page 167 SRV.
“Chapter 11 - Country-Specific Configuration” on Describes how to set the Mediatrix 4104 with the
page 171 proper country settings.
“Chapter 12 - Configuration File Download” on Describes how to use the configuration file download
page 181 feature to update the Mediatrix 4104 configuration.
Title Summary
“Chapter 13 - Software Download” on page 199 Describes how to download a software version
available on the designated software server into the
Mediatrix 4104.
“Chapter 14 - Line Configuration” on page 213 Describes the features available on the lines
connected to the Mediatrix 4104.
“Chapter 15 - Voice Transmissions” on page 221 Describes the various codecs the Mediatrix 4104
supports for transmitting audio signals.
“Chapter 16 - Fax Transmission” on page 237 Describes how to perform fax transmissions in clear
channel and T.38 with the Mediatrix 4104.
“Chapter 17 - Bypass Configuration” on Describes the Bypass feature that can be used in the
page 241 event of a power failure or network failure.
“Chapter 18 - SIP Protocol Features” on Describes the SIP-specific feature to set up to properly
page 243 use the SIP signalling programs and information
defined in the Mediatrix SIP stack.
“Chapter 19 - STUN Configuration” on page 269 Describes how to configure the STUN client of the
Mediatrix 4104.
“Chapter 20 - SNTP Settings” on page 271 Describes how to configure the Mediatrix 4104 to
enable the notion of time (date, month, time) into it.
“Chapter 21 - Digit Maps” on page 275 Describes how to use a Digit Map to compare the
number users dialed to a string of arguments.
“Chapter 22 - Telephony Features” on page 283 Explains how to perform basic calls with the Mediatrix
4104 and set the telephony variables of the unit to
define the way it handles calls.
“Chapter 23 - Subscriber Services” on page 285 Describes how to set and use the subscriber services
available on the user’s telephone.
“Chapter 24 - Telephony Attributes” on page 301 Describes the telephony attributes available on the
Mediatrix 4104.
“Chapter 25 - Message Waiting Indicator” on Explains how to set the Mediatrix 4104 to use the
page 309 Message Waiting Indicator service.
“Chapter 27 - Quality of Service (QoS)” on Defines the QoS (Quality of Service) features
page 315 available on the Mediatrix 4104.
“Chapter 28 - Syslog Daemon” on page 319 Describes how to configure and use the Syslog
daemon.
“Chapter 29 - Statistics” on page 323 Defines the statistics the Mediatrix 4104 can collect.
“Chapter 30 - Maximum Transmission Unit Describes the MTU (Maximum Transmission Unit)
(MTU)” on page 327 requirements of the Mediatrix 4104.
“Chapter 31 - Troubleshooting” on page 329 Examines some of the problems you may experience
when connecting the Mediatrix 4104 to the network
and provides possible solutions.
Title Summary
Appendices
“Appendix A - Standards Compliance and Safety Lists the various standards compliance of the
Information” on page 343 Mediatrix 4104.
“Appendix B - Standard Hardware Information” Lists the technical hardware information of the
on page 349 Mediatrix 4104.
“Appendix C - Cabling Considerations” on Describes the pin-to-pin connections for cables used
page 355 with the Mediatrix 4104.
“Appendix D - Country-Specific Parameters” on Lists the various parameters specific to a country such
page 359 as loss plan, tones and rings, etc.
Document Conventions
The following information provides an explanation of the symbols that appear on the Mediatrix 4104 and in the
documentation for the product.
Warning Definition
Warning: Means danger. You are in a situation that could cause bodily injury. Before you work on any
equipment, you must be aware of the hazards involved with electrical circuitry and be familiar with standard
practices for preventing accidents.
Other Conventions
The following are other conventions you will encounter in this manual.
Caution: Caution indicates a potentially hazardous situation which, if not avoided, may result in minor or
moderate injury and/or damage to the equipment or property.
Standards Supported Indicates which RFC, Draft or other standard document is supported for a
specific feature.
This symbol indicates you can also set the current configuration by using the Unit Manager Network Graphical
User Interface. The text will provide the location in the Unit Manager Network Administration Manual where to
find information related to the specific configuration.
SCN vs PSTN
In Mediatrix’ and other vendor’s documentation, the terms SCN and PSTN are used. A SCN (Switched Circuit
Network) is a general term to designate a communication network in which any user may be connected to any
other user through the use of message, circuit, or packet switching and control devices. The Public Switched
Telephone Network (PSTN) or a Private Branch eXchange (PBX) are examples of SCNs.
Standards Supported
When available, this document lists the standards onto which features are based. These standards may be
RFCs (Request for Comments), Internet-Drafts, or other standard documents.
The Mediatrix 4104’s implementations are based on the standards, so it’s possible that some behaviour differs
from the official standards.
For more information on and a list of RFCs and Internet-Drafts, refer to the IETF web site at http://www.ietf.org.
Obtaining Documentation
Documentation Feedback
Mediatrix welcomes your evaluation of this manual and any suggestions you may have. These help us to
improve the quality and usefulness of our publications.
Please send your comments to:
Mediatrix Telecom
Attention: Documentation Department
4229, Garlock Street
Sherbrooke, Quebec
Canada J1L 2C8
FAX: +1 (819) 829-5100
We appreciate your comments.
The Unit Manager Network is a user-friendly element management system designed to facilitate the
deployment, configuration and provisioning of Mediatrix access devices and gateways.
The Unit Manager Network offers the following key features, enabling the simple and remote configuration and
deployment of numerous Mediatrix units:
Detection of the state of each Mediatrix unit (e.g. power on/off).
Automatic update of the list with installation of new Mediatrix units.
Real-time graphical presentation of actual configuration.
Tracking of all configuration options of the Mediatrix units on the network.
Control of configuration parameters of all Mediatrix units within the same network.
Storage of backup configuration file of each Mediatrix unit.
Display of firmware release for any Mediatrix unit.
Field-upgrade of all Mediatrix units.
Controlled Implementation of new software.
Supports SNMP requests: GET, GET NEXT, GET TABLE, GET WALK, SET, TRAP.
SNMP abstraction layer: configuration can be changed without SNMP MIB knowledge.
The demo version of the Unit Manager Network is available on the Mediatrix Download Portal at: https://
support.mediatrix.com/DownloadPlus/Download.asp.
See the Unit Manager Network Administration Manual for more details on how to use it to configure any
Mediatrix 4104 unit on the network.
In order to maximize technical support resources, Mediatrix works through its partners to resolve technical
support issues. All end users requiring technical support are encouraged to contact their vendor directly.
1 Installation
This chapter describes the installation and initial provisioning of the Mediatrix 4104.
Requirements
Item Description
Safety Recommendations
Package Contents
Mediatrix 4104 3
Chapter 1 - Installation Overview
Overview
The Mediatrix 4104 is a standalone Internet telephony access device that connects to virtually any business
telephone system supporting standard analog lines.
This version of the Mediatrix 4104 uses the Session Initiation Protocol (SIP), which is a protocol for
transporting call setup, routing, authentication, and other feature messages to endpoints within the IP domain.
Placing a Call
You can place a call from a telephone or fax connected to a Mediatrix 4104. The unit automatically detects if
the call originates from a voice or fax transmission and acts accordingly.
When placing a call, the Mediatrix 4104 collects the DTMF digits dialed and sends a message to the Registrar
Server. The Registrar Server sends back a list of contacts where the dialed number could be located.
You can dial on a telephone/fax machine connected to the Mediatrix 4104 as you normally do.
4 Mediatrix 4104
Overview Reference Manual (SIP Version)
Management Choices
The Mediatrix 4104 offers various management options to configure the unit.
Table 3: Management Options
Web Interface The Mediatrix 4104 web interface offers the following options:
• Password-protected access via basic HTTP authentication, as
described in RFC 2617
• User-friendly GUI
Refer to “Chapter 2 - Web Interface – Introduction” on page 21 for more details.
SNMPv1/2/3 The Mediatrix 4104 SNMP feature offers the following options:
• Password-protected access
• Remote management
• Simultaneous management
Refer to “Chapter 7 - MIB Structure and SNMP” on page 123 for more details.
Auto-Update The Mediatrix 4104 auto-update options are as follows:
• Frequent polling
• Automatic software and configuration files downloads
• Configuration file encryption
Refer to “Chapter 13 - Software Download” on page 199 and “Chapter 12 -
Configuration File Download” on page 181 for more details.
Mediatrix 4104 5
Chapter 1 - Installation Panels
Panels
This section provides an overview of the front and rear panels of the Mediatrix 4104.
Front Indicators
Figure 1 shows the four visual indicators located on the front of the Mediatrix 4104.
Table 4 describes the LEDs on the front panel of the Mediatrix 4104.
Table 4: Front Panel Indicators
Indicator Description
Ready When lit, the Mediatrix 4104 is ready to initiate or receive a call. The unit does not
have to be registered to a server.
In Use When lit, at least one of the FXS lines is in use.
ETH Provides the state of the network connected to the ETH connector.
Power When lit, power is applied to the Mediatrix 4104.
See “LED Indicators” on page 12 for a detailed description of the LED patterns the Mediatrix 4104 may have
and the states they represent.
6 Mediatrix 4104
Panels Reference Manual (SIP Version)
Rear Connectors
The Mediatrix 4104 has several connections that must be properly set. Figure 2 shows the back panel of the
Mediatrix 4104.
Connection Description
Mediatrix 4104 7
Chapter 1 - Installation Choosing a Suitable Installation Site
FXS FXS
#4 #2
FXS FXS
#3 #1
Warning: The analog lines of the Mediatrix 4104 are not intended for connection to a telecommunication
network that uses outside cable.
Warning: To prevent fire or shock hazard do not expose the unit to rain or moisture.
The Mediatrix 4104 is suited for use in an office environment where it can be wall-mounted or free standing.
Location
Install the Mediatrix 4104 in a well-ventilated location where it will not be exposed to high temperature or
humidity. Do not install the Mediatrix 4104 in a location exposed to direct sunlight or near stoves or radiators.
Excessive heat could damage the internal components.
When deciding where to position the Mediatrix 4104, ensure that:
The Mediatrix 4104 is accessible and cables can be easily connected.
The cabling is away from the following:
• Sources of electrical noise such as radios, transmitters, and broadband amplifiers.
• Power lines and fluorescent lighting fixtures.
• Water or moisture that could enter the casing of the Mediatrix 4104.
The airflow is not restricted around the Mediatrix 4104 or through the vents in the side and back
of the unit. The unit requires a minimum of 25 mm (1 in.) clearance.
The operating temperature is between 0oC and 40oC.
The humidity is not over 85% and is non-condensing.
8 Mediatrix 4104
Choosing a Suitable Installation Site Reference Manual (SIP Version)
Wall-Mounting
The Mediatrix 4104 has two screw holes on its bottom surface, allowing a single unit to be wall-mounted.
Screw holes
Front
You can position the Mediatrix 4104 any way you want.
4. Mark the position of the screw holes on the wall. Drill the two holes and install two screws.
5. Place the screw holes of the Mediatrix 4104 over the screws installed in the previous step.
6. Proceed to “Hardware Connection” on page 10.
Condensation
When bringing the unit into a warm environment from the cold, condensation may result that might be harmful
to the unit. If this occurs, allow the unit to acclimatize for an hour before powering it on.
Cleaning
To clean the Mediatrix 4104, wipe with a soft dry cloth. Do not use volatile liquids such as benzine and thinner
that are harmful to the unit casing.
For resistant markings, wet a cloth with a mild detergent, wring well and then wipe off. Use a dry cloth to dry
the surface.
Mediatrix 4104 9
Chapter 1 - Installation Hardware Connection
Hardware Connection
This section describes how to set the connectors of the Mediatrix 4104.
See “Appendix C - Cabling Considerations” on page 355 for more details on the cables the Mediatrix 4104
uses.
Reserving an IP Address
Before connecting the Mediatrix 4104 to the network, Mediatrix strongly recommends that you reserve an IP
address in your DHCP server – if you are using one – for the unit you are about to connect. This way, you
know the IP address associated with a particular unit.
DHCP servers generally allocate a range of IP addresses for use on a network and reserve IP addresses for
specific devices using a unique identifier for each device. The Mediatrix 4104 unique identifier is its media
access control (MAC) address. You can locate the MAC address as follows:
It is printed on the label located on the bottom side of the unit.
It is located in the sysMgmtMIB under the sysMacAddress variable.
You can dial the following digits on a telephone connected to the Mediatrix 4104:
*#*1
The Mediatrix 4104 answers back with its MAC address. See “Special Vocal Features” on page 12
for more details.
4 2 1 3
Note: The Mediatrix 4104 telephone line interface has been designed to interface with a conventional
telephone line. Connections to certain PBX / Key systems supply a higher line voltage that could damage
the Mediatrix 4104.
2. Connect a 10/100 BaseT Ethernet RJ-45 cable into the ETH connector of the Mediatrix 4104;
connect the other end to a compatible Ethernet interface that supplies TCP/IP network access (e.g.,
router, switch, hub or computer).
Use a standard telecommunication cord with a minimum of 26 AWG wire size.
3. Connect a SCN line into the Bypass connector of the Mediatrix 4104 (optional).
Use a standard telecommunication cord with a minimum of 26 AWG wire size.
10 Mediatrix 4104
Starting the Mediatrix 4104 for the First Time Reference Manual (SIP Version)
4. Connect the power cord to the Mediatrix 4104 and then connect the other end to an electrical outlet.
Warning: The electrical outlet must be installed near the Mediatrix 4104 so that it is easily accessible.
The default MIB parameters are set so that the unit can be directly plugged into a network and provisioned
with a DHCP server. Mediatrix strongly recommends to set your DHCP server before installing the unit on the
network. See “Chapter 8 - IP Address and Network Configuration” on page 137 for more details.
If you are experiencing problems, or if you do not want to use a DHCP server, perform a Recovery Mode
procedure, as explained in “Recovery Mode” on page 17.
Mediatrix 4104 11
Chapter 1 - Installation LED Indicators
LED Indicators
A LED can be ON, OFF, BLINKING or controlled by hardware (HW). The blinking behaviour is described in
terms of rate (in Hertz – Hz) and duty cycle (in percentage). For instance, a LED that turns on every two
seconds and stays on for one second would be described as: blink 0.5 Hz 50%. The hardware (HW) behaviour
is not defined. It is usually the standard state for the ETH LED.
Ready LED
The Ready LED provides an “at-a-glance” view of the Mediatrix 4104 operational status. It is an aid for
installation and on-site support. This LED is:
ON when all elements of the ifAdminOpState column are “enabled”.
OFF when all elements of the ifAdminOpState column are “disabled”.
Blinking when at least one element of the ifAdminOp State column is “enabled” and at least one
element is “disabled”.
Patterns and meanings of the Ready LED are described in Table 9 on page 14.
Refer to the MIB Reference Manual for more details on the ifAdminOpState variable.
In Use LED
The In Use LED provides feedback of the activity on the line. If a line is ringing, off-hook, or displaying
information (ADSI), then this LED is ON. The In Use LED is ON when at least one element in the
ifAdminUsageState column is “busy”. Patterns and meanings of the In Use LED are described in Table 9 on
page 14.
Refer to the MIB Reference Manual for more details on the ifAdminState variable.
ETH LED
The ETH LED provides the Link and Heartbeat status of the network connected to the Ethernet connector. If
there is no link under HW control, the LED is OFF. When a link is established, but no activity is detected, the
LED is ON; it turns off for very short periods of time when activity is detected and blinks rapidly when the
Ethernet is loaded. Patterns and meanings of the ETH LED are described in Table 9 on page 14.
12 Mediatrix 4104
LED Indicators Reference Manual (SIP Version)
Power LED
The Power LED indicates whether or not the Mediatrix 4104 is operational at its most basic level. It does not
imply that the unit can be used, only that it is capable of being used. Healthy operation would be steady ON.
Patterns and meanings of the Power LED are shown in Table 9 on page 14.
LED Patterns
Table 7 describes the different states a Mediatrix unit can have and their associated LED patterns.
Table 7: States and LED Patterns
LEDs Pattern
State Description
Ready In Use ETH Power
Booting Follows a hardware start or a reset. See “Booting LED Pattern Description”
on page 14
Normal “Normal” state of the unit where calls can be See “NormalMode LED Pattern
Mode initiated. Each LED has a separate behaviour. Description” on page 14
AdminMode Calls are not permitted and maintenance actions See “AdminMode LED Pattern
can be performed. Description” on page 15
Recovery The IP addresses for local host, image server, Blink Off Misc.a Blink
Mode syslog server, etc., are temporarily set to known 1 Hz 1 Hz
values. Calls are not allowed. 75% 75%
Reset Triggered when the Reset / Default switch is Off Off Off Blink
Pending pressed and held for at least 2 seconds. 1 Hz
50%
Reboot Triggered when the Reset / Default switch is Off Off Off Off
Pending pressed in either the ResetPending or
RecoveryMode Pending states. The unit prepares
for a physical shutdown and restart.
Recovery Triggered when the Reset / Default switch is held Blink Blink Blink Blink
Mode at start-time or for at least 7 seconds. 1 Hz 1 Hz 1 Hz 1 Hz
Pending 50% 50% 50% 50%
Default Triggered when the Reset / Default switch is not On On On On
Settings released while in RecoveryModePending state.
Pending At run time, if the Reset / Default switch is
released within 5 seconds, the unit applies default
settings, otherwise the action is cancelled and the
unit goes back to the Operation Modes state or it
resets.
At start time, the unit stays in this state until the
Reset / Default switch is released. The unit then
applies the default settings and restarts.
Image A software image is downloaded into the unit and LEDs are blinking at 1 Hz 75%, one at a
DownloadIn written to persistent storage. time, from left to right.
Progress
Image Triggered after a failure of an image download Blink Blink Blink Blink
Download operation. After 4 seconds, the unit restarts. 2 Hz 2 Hz 2 Hz 2 Hz
Error 50% 50% 50% 50%
Mediatrix 4104 13
Chapter 1 - Installation LED Indicators
LEDs Pattern
State Description
Ready In Use ETH Power
InitFailed Triggered when bad initialization parameters are Off Off Blink Off
detected and the unit cannot start correctly. 4 Hz
Note: If the network configuration is dynamic, the 50%
unit stays in the Booting state and continues to
query the DHCP until it receives valid values. If
the configuration is static, the LED pattern
indicates that the unit must be reset to default
settings or put into recovery mode for
maintenance and correction of network values.
DiagFailed Triggered at start-time when the hardware or Off Off Off Blink
software diagnostic fails. This is a critical error 4 Hz
and the unit may require RMA. 50%
Bypassb Triggered when the IP network is down. Off On Off On
a. See the corresponding LED pattern in “NormalMode LED Pattern Description” on page 14.
b. If Bypass is triggered because power is removed from the Mediatrix 4104, all LEDs are Off.
14 Mediatrix 4104
LED Indicators Reference Manual (SIP Version)
Ready Blinking 1 Hz 75% Ready and Power LEDs blink off phase at 180 degrees.
In Use Steady Off All analog lines are not available.
Steady On Ethernet connection detected.
ETH
Steady Off Ethernet connection not detected.
(HW Ctrl)
Blinking (variable rate) Ethernet activity detected.
Power Blinking 1 Hz 75% Ready and Power LEDs blink off phase at 180 degrees.
At Start-Time
When pressing the Reset / Default switch at start-time, the state sequence goes as follows:
Mediatrix 4104 15
Chapter 1 - Installation Reset / Default Switch
At Run-Time
When pressing the Reset / Default switch at run-time, the state sequence goes as follows:
RecoveryMode Booting
Button Released
At Run-Time
The Reset / Default switch can be used at run-time – you can press the switch while the Mediatrix 4104 is
running without powering the unit off. Table 11 describes the actions you can perform in this case.
Table 11: Reset / Default Switch Interaction
2 to 5 seconds Restarts the No changes are made to Off Off Off Blink
Mediatrix 4104 the Mediatrix 4104
settings.
5 to 10 seconds Restarts the Sets the Mediatrix 4104 Blink Blink Blink Blinka
Mediatrix 4104 in IP address to its default
Recovery Mode value in the MIB and
restarts the unit.
10 to 15 secondsb Restarts the Deletes the persistent On On On On
Mediatrix 4104 in MIB values, creates a
Factory Reset new configuration file
with the default factory
values, and then restarts
the unit.
a. Synchronized blinking at 2 Hz (50% duty cycle).
b. You can disable the Factory reset procedure to avoid users deleting the existing configuration. See “Disabling the Factory Re-
set” on page 19 for more details.
16 Mediatrix 4104
Reset / Default Switch Reference Manual (SIP Version)
At Start-Time
The Reset / Default switch can be used at start-time – you power the unit off, and then depress the Reset /
Default switch and power the unit back on. In this case, the following explains the reset behaviour:
Pressing the Reset / Default switch at startup until all the LEDs start blinking restarts the
Mediatrix 4104 in “Recovery Mode”.
Pressing the Reset / Default switch at startup until all the LEDs stop blinking and remain ON
applies the “Factory Reset” procedure. This feature reverts the Mediatrix 4104 back to its
default factory settings.
See “LED Indicators” on page 12 for a detailed description of the LED patterns related to the Reset / Default
switch.
Recovery Mode
The recovery mode restarts the Mediatrix 4104 in a known, static, and minimal state. It is used to recover from
a basic configuration error that prevents you to reach the unit through the network. It may serve as a last resort
before the Factory reset command. You must perform it in a closed network and on only one Mediatrix 4104
at a time, because the default IP address is the same on every unit.
The recovery mode is not intended to address configuration and/or software problems. For those types of
problems, you must use the Factory reset.
Note: The procedure below assumes that you are performing it at run-time.
Mediatrix 4104 17
Chapter 1 - Installation Reset / Default Switch
• msTrapPort
• syslogHost
• syslogPort
The following variables of the mediatrixMgmt group are all set to static:
• imageConfigSource
• configFileFetchingConfigSource
• msConfigSource
• syslogConfigSource
• sntpConfigSource
All the persistent MIB values are kept.
In this mode, SIP is deactivated. Only SNMP or HTTP can be used to set the IP addresses listed
above and the protocol-specific IP addresses (all IP addresses located under the ipAddressConfig
folder in the MIB structure).
You can also download a software version, but you cannot download a configuration file.
6. When the Mediatrix 4104 has finished its provisioning sequence, perform the changes, and then
turn it off, plug it on the network, and turn it on again.
When restarting, the Mediatrix 4104 will not be in Recovery mode and will use the IP addresses
configuration set forth in the MIBs.
See “Changing a Parameter Value” on page 133 for more details.
Note: The recovery mode does not alter any persistent configuration data of the Mediatrix 4104.
Factory Reset
The Factory reset reverts the Mediatrix 4104 back to its default factory settings. It deletes the persistent MIB
values of the unit, including:
The entire mediatrixMIBs configuration.
The MIB-II setup.
The software download configuration files.
The SNMP configuration, including the SNMPv3 passwords and users.
The Factory reset creates a new configuration file with the default factory values. It should be performed with
the Mediatrix 4104 connected to a network with access to a DHCP server. If the unit cannot find a DHCP
server, it sends requests indefinitely.
You can disable the Factory reset to avoid users deleting the existing configuration. See “Disabling the Factory
Reset” on page 19 for more details.
Note: The Factory reset alters any persistent configuration data of the Mediatrix 4104.
18 Mediatrix 4104
Software Restart Reference Manual (SIP Version)
Software Restart
You can initiate a software restart of the Mediatrix 4104 by using MIB parameters.
In the Unit Manager Network Administration Manual, refer to chapter Performing Actions on Mediatrix Units,
section Restarting a Unit.
Restart Behaviour
This feature affects the behaviour of the Mediatrix 4104 when it restarts.
You can instruct the Mediatrix 4104 to check its TCP/IP stack before declaring the restart successful.
This could be useful when the unit is subjected to a broadcast storm (such as a TCP/IP flood) while it is
restarting. In this case, and when the TCP/IP stack check is enabled, the unit enters into the rescue mode and
cannot be contacted through SNMP. You thus need to restart the Mediatrix 4104 manually. However, when
the TCP/IP stack check is disabled, a broadcast storm during a restart will cause the unit to continuously restart
until the storm subsides.
Mediatrix 4104 19
Chapter 1 - Installation Verifying the Installation
There are two ways to verify that the Mediatrix 4104 is properly connected to the IP network and is working:
By contacting it with a SNMP Browser
By pinging it
These two procedures assume that you know the IP address of the Mediatrix 4104 you want to verify. If the
Mediatrix 4104 does not respond, do the following:
Verify that the LAN cable is securely connected to the Mediatrix 4104 and to the network
connector.
Be sure that you did not connect a crossover network cable.
Verify the state of the IP network to ensure it is not down (the ETH LED should be ON or
blinking).
20 Mediatrix 4104
C H A P T E R
The Mediatrix 4104 contains an embedded web server to set parameters by using the HTTP protocol.
Introduction
The Mediatrix 4104 uses Digest Authentication to grant access to web-based interface.
Mediatrix 4104 21
Chapter 2 - Web Interface – Introduction Using the Web Interface
IP Information Description
System Up Time The time (in hundredths of a second) since the network management portion of
the system was last re-initialized.
System Description A textual description of the Mediatrix 4104. It usually includes the full name and
version identification of its hardware type, software operating-system, and
networking software.
MIB Version MIB version currently loaded in the Mediatrix 4104.
MAC Address MAC address of the Mediatrix 4104.
Hardware version Version of the analog circuit board of the Mediatrix 4104.
Firmware version Software version of the Mediatrix 4104.
22 Mediatrix 4104
Using the Web Interface Reference Manual (SIP Version)
Menu Frame
The Menu frame is displayed at the top of the browser window. It contains management links that allow you
to display web pages in the Content frame.
Table 13: Menu Frame Links
Link Description
Info: Links to the Info sub-page of the Device Info web page, which displays, in
read-only format, the system parameters of the Mediatrix 4104.
Statistics: Links to the Statistics sub-page of the Device Info web page, which
displays, in read-only format, various communication statistics of the Mediatrix
Device Info
4104.
Monitoring: Links to the Monitoring sub-page of the Device Info web page, which
allows you to configure the syslog parameters of the Mediatrix 4104. See “Syslog
Monitoring” on page 25 for more details.
Admin: Links to the Admin sub-page of the Management web page, which allows
you to configure line administration parameters of the Mediatrix 4104. See “Admin
Page” on page 27 for more details.
Network Settings: Links to the Network Settings sub-page of the Management
web page, which allows you to configure network-related parameters of the
Mediatrix 4104, such as IP address source, IP address, etc. See “Network
Settings” on page 31 for more details.
Management Configuration File: Links to the Configuration File sub-page of the Management
web page, which allows you to configure the various configuration file download
parameters of the Mediatrix 4104. See “Configuration File Download” on page 37
for more details.
Firmware Download: Links to the Firmware Download sub-page of the
Management web page, which allows you to configure the various firmware
download parameters of the Mediatrix 4104. See “Firmware Download” on
page 49 for more details.
SIP: Links to the SIP sub-page of the SIP web page, which allows you to
configure the SIP server and SIP user agent parameters of the Mediatrix 4104.
See “SIP Servers Configuration” on page 61 for more details.
Interop: Links to the Interop sub-page of the SIP web page, which allows you to
SIP configure the various interoperability features of the Mediatrix 4104. See “SIP
Interop” on page 66 for more details.
Authentication: Links to the Authentication sub-page of the SIP web page, which
allows you to configure authentication parameters of the Mediatrix 4104. See “SIP
Authentication” on page 68 for more details.
Mediatrix 4104 23
Chapter 2 - Web Interface – Introduction Submitting Changes
Link Description
Digit Maps: Links to the Digit Maps sub-page of the Telephony web page, which
allows you to configure the various digit maps of the Mediatrix 4104. See “Digit
Maps” on page 71 for more details.
CODEC: Links to the CODEC sub-page of the Telephony web page, which allows
you to configure the voice and data codec-related parameters of the Mediatrix
4104. See “Voice & Fax Codecs” on page 76 for more details.
Call Forward: Links to the Call Forward sub-page of the Telephony web page,
which allows you to configure the call forward on busy, on no answer, and
Telephony
unconditional parameters of the Mediatrix 4104. See “Call Forward” on page 88
for more details.
Services: Links to the Services sub-page of the Telephony web page, which
allows you to configure the subscriber services of the Mediatrix 4104. See
“Services” on page 93 for more details.
Misc: Links to the Misc sub-page of the Telephony web page, which allows you to
configure advanced telephony attributes of the Mediatrix 4104. See
“Miscellaneous” on page 100 for more details.
QoS: Links to the QoS sub-page of the Advanced web page, which allows you to
configure the Quality of Service parameters of the Mediatrix 4104. See “Quality of
Service (QoS)” on page 113 for more details.
Emergency: Links to the Emergency sub-page of the Advanced web page, which
Advanced allows you to configure the Emergency Call parameters of the Mediatrix 4104.
See “Emergency Page” on page 116 for more details.
STUN: Links to the STUN sub-page of the Advanced page, which allows you to
configure the STUN client of the Mediatrix 4104. See “STUN Configuration” on
page 117 for more details.
Content Frame
The Content frame is displayed in the lower part of the browser window. It contains the various web pages that
allow you to manage the Mediatrix 4104.
Submitting Changes
When you perform changes in the web interface and click the Submit button, the Mediatrix 4104 validates the
changes. A message informs you that the Mediatrix 4104 must be restarted if one or more non-dynamic value
was changed. If at least one modified value is invalid, a message informs you that some values are invalid.
Most changes are not dynamic and require to restart the Mediatrix 4104.
The Reboot page then opens. You must click Reboot.
This restarts the Mediatrix 4104. If the unit is in use when you click Reboot, all calls are terminated.
24 Mediatrix 4104
Syslog Monitoring Reference Manual (SIP Version)
Syslog Monitoring
The Monitoring sub-page of the Device Info page allows you to set the Syslog daemon configuration of the
Mediatrix 4104. You can also set these parameters and supplemental information via SNMP, as described in
“Chapter 28 - Syslog Daemon” on page 319.
The Syslog daemon is a general purpose utility for monitoring applications and network devices with the TCP/
IP protocol. With this software, you can monitor useful messages coming from the Mediatrix 4104 unit. If no
Syslog daemon address is provided by a DHCP server or specified by the administrator, no messages are
sent.
For instance, if you want to download a new software into the Mediatrix 4104, you can monitor each step of
the software download phase. Furthermore, if the unit encounters an abnormal behaviour, you may see
accurate messages that will help you troubleshoot the problem.
3
4
5
2. Select the configuration source of the syslog information in the Syslog Configuration Source
choices.
Table 14: Syslog Configuration Sources
Source Description
Static You manually enter the value and it remains the same every time the Mediatrix 4104
restarts. Use the static configuration if you are not using a DHCP server or if you want
to bypass it.
DHCP The value is obtained at start-time by querying a DHCP server and using standard
DHCP fields or options. Using the DHCP configuration assumes that you have properly
set your DHCP server with the relevant information. See “Chapter 8 - IP Address and
Network Configuration” on page 137 for more details.
3. If the Syslog configuration source is Static, enter the Syslog server static IP address or domain
name in the Static Syslog Host field.
4. If the Syslog configuration source is Static, enter the Syslog server static IP port number in the
Static Syslog Port field.
Mediatrix 4104 25
Chapter 2 - Web Interface – Introduction Syslog Monitoring
5. Set the syslog severity level in the Syslog Max. Severity choices.
This indicates which syslog message is processed. Any syslog message with a severity value
greater than the selected value is ignored by the agent.
• Disabled
• Critical
• Error
• Warning
• Informational
• Debug
A higher level mask includes lower level masks, e.g., Warning includes Error and Critical.
6. Click Submit if you do not need to set other parameters.
Note: The current syslog information is displayed in the Syslog Info section.
26 Mediatrix 4104
C H A P T E R
The Management section of the web interface allows you to configure general parameters of the Mediatrix
4104, as well as its configuration file download and firmware download parameters.
Admin Page
The Admin sub-page of the Management page allows you to configure line administration parameters of the
Mediatrix 4104 grouped in four categories:
HTTP Server Username/Password
System Management
Group Port Management
Interface Management
The Change HTTP Server ADMINISTRATOR Username/Password section allows you to modify the default
password to access the web interface. The Mediatrix 4104 supports basic HTTP authentication, as described
in RFC 2617.
2
3
4
Mediatrix 4104 27
Chapter 3 - Web Interface – Management Admin Page
Issue: Factory Reset does not Reset the Default Password Value
The following describes three cases in which the factory reset may not properly reset the HTTP server
password. Each case defines the password you must use to access the web interface.
Case #1
You do not modify the password via the Web page and you upgrade to a new software version with a new
default password in the profile.
Item Description
Wanted Behaviour The password to use is the default password in the new profile.
Current Behaviour The password to use is the default password in the previous version of the profile.
Workaround Once using the new software version, use the httpServerResetToDefaultPwd variable
as described in “Default User Name and Password” on page 28.
Case #2
You modify the password via the web interface and you upgrade to a new software version with a new default
password in the profile.
Item Description
Wanted Behaviour The password to use is the password modified via the web interface in the older
software version.
Current Behaviour Same as the wanted behaviour.
Workaround None required.
28 Mediatrix 4104
Admin Page Reference Manual (SIP Version)
Case #3
You are performing a factory reset.
Item Description
Wanted Behaviour The password to use is the default password in the profile.
Current Behaviour The password to use is the same as the one used in the older software version.
Workaround Once using the new software version, use the httpServerResetToDefaultPwd variable
as described in “Default User Name and Password” on page 28.
System Management
The following are the system management parameters you can set. These parameters apply to the whole
Mediatrix 4104.
You can also set these parameters via SNMP, as described in “Chapter 7 - MIB Structure and SNMP” on
page 123.
2. Select the proper command to execute in the System Command drop-down menu.
This command controls the various commands that can be performed by the unit.
Table 19: System Commands
Command Description
Mediatrix 4104 29
Chapter 3 - Web Interface – Management Admin Page
Command Description
This command locks/unlocks all the lines of the Mediatrix 4104. This state is kept until the unit
restarts. It offers the following settings:
Table 20: Group Port Settings
Setting Description
Interface Management
You can set the administrative state of a line that will be kept until the Mediatrix 4104 restarts.
30 Mediatrix 4104
Network Settings Reference Manual (SIP Version)
This command temporary locks/unlocks the selected line of the Mediatrix 4104. This state is kept
until the unit restarts. It offers the following settings:
Table 21: Temporary Lock Settings
Setting Description
Network Settings
The Network Settings sub-page of the Management page allows you to configure network-related parameters
of the Mediatrix 4104 grouped in three categories:
Ethernet
Network Settings
SNTP
2. Set the Ethernet connection speed of the ETH connector in the Network Port Speed field.
The following values are available:
• Auto detect
• 10Mbs-HalfDuplex
Mediatrix 4104 31
Chapter 3 - Web Interface – Management Network Settings
• 100Mbs-HalfDuplex
• 10Mbs-FullDuplex
• 100Mbs-FullDuplex
A half-duplex connection refers to a transmission using two separate channels for transmission and
reception, while a full-duplex connection refers to a transmission using the same channel for both
transmission and reception.
If unknown, select Auto detect so that the Mediatrix 4104 can automatically detect the network
speed.
Caution: Whenever you force a connection speed / duplex mode, be sure that the other device and all
other intermediary nodes used in the communication between the two devices have the same configuration.
See “Speed and Duplex Detection Issues” on page 32 for more details.
32 Mediatrix 4104
Network Settings Reference Manual (SIP Version)
Network Settings
The Network Settings section allows you to set the IP information the Mediatrix 4104 needs to work properly.
This section is vital to the proper operation of the Mediatrix 4104. If a field of this group is not properly set, the
Mediatrix 4104 may not be able to restart and be contacted after it has restarted.
You can also set this parameter via SNMP, as described in “Chapter 8 - IP Address and Network
Configuration” on page 137.
Source Description
Static You manually enter the value and it remains the same every time the Mediatrix 4104
restarts. Use the static configuration if you are not using a DHCP server or if you want
to bypass it.
DHCP The value is obtained at start-time by querying a DHCP server and using standard
DHCP fields or options. Using the DHCP configuration assumes that you have properly
set your DHCP server with the relevant information. See “Chapter 8 - IP Address and
Network Configuration” on page 137 for more details.
Parameter Definition
IP Address Public IP address of the Mediatrix 4104. This address is used for
incoming signalling, media and management traffic.
Subnet Mask Subnet mask IP address used by the Mediatrix 4104.
Note: Mediatrix recommends not to set a subnet mask of
255.255.255.254 because this would only create a subnet with two
addresses. This only leaves one bit host addresses. Since a subnet must
have a network (all bits 0) and a broadcast address (all bits 1), this leaves
no room for hosts.
Default Router Default router IP address used by the Mediatrix 4104.
Primary DNS Primary Domain Name Server IP address used by the Mediatrix 4104.
Secondary DNS Secondary Domain Name Server IP address used by the Mediatrix 4104.
3. Enter the default SNMP agent port in the SNMP Port field.
This is the port number to use to reach the local host via the SNMP protocol.
Mediatrix 4104 33
Chapter 3 - Web Interface – Management Network Settings
Note: The current configuration file server information is displayed in the Current Configuration section.
SNTP Settings
Standards Supported RFC 1769 – Simple Network Time Protocol (SNTP)
The Simple Network Time Protocol (SNTP) enables the notion of time (date, month, time) into the Mediatrix
4104. It updates the internal clock of the unit, which is the client of a SNTP server. It is required when dealing
with features such as the caller ID.
SNTP is used to synchronize a SNTP client with a SNTP or NTP server by using UDP as transport.
You can also set these parameters via SNMP, as described in “Chapter 20 - SNTP Settings” on page 271.
2
3
4
5
2. Select the configuration source of the SNTP information in the SNTP Source choices.
Table 24: Network Settings Configuration Sources
Source Description
Static You manually enter the value and it remains the same every time the Mediatrix 4104
restarts. Use the static configuration if you are not using a DHCP server or if you want
to bypass it.
DHCP The value is obtained at start-time by querying a DHCP server and using standard
DHCP fields or options. Using the DHCP configuration assumes that you have properly
set your DHCP server with the relevant information. See “Chapter 8 - IP Address and
Network Configuration” on page 137 for more details.
Field Description
34 Mediatrix 4104
Network Settings Reference Manual (SIP Version)
Refer to the following sub-sections for explanations on each part of the string.
5. Set the synchronization information:
Table 26: SNTP Synchronization Information
Field Description
SNTP Synchronisation Period Time interval (in minutes) between requests made to the
SNTP server. The result is used to synchronize the unit
with the time server.
SNTP Synchronisation Period on Time interval (in minutes) between retries after an
Error unsuccessful attempt to reach the SNTP server.
STD / DST
Three or more characters for the standard (STD) or alternative daylight saving time (DST) time zone. Only STD
is mandatory. If DST is not supplied, the daylight saving time does not apply. Lower and upper case letters are
allowed. All characters are allowed except digits, leading colon (:), comma (,), minus (-), plus (+), and ASCII
NUL.
OFFSET
Difference between the GMT time and the local time. The offset has the format h[h][:m[m][:s[s]]]. If no offset is
supplied for DST, the alternative time is assumed to be one hour ahead of standard time. One or more digits
can be used; the value is always interpreted as a decimal number.
The hour value must be between 0 and 24. The minutes and seconds values, if present, must be between 0
and 59. If preceded by a minus sign (-), the time zone is east of the prime meridian, otherwise it is west, which
can be indicated by the preceding plus sign (+). For example, New York time is GMT 5.
START / END
Indicates when to change to and return from the daylight saving time. The START argument is the date when
the change from the standard to the daylight save time occurs; END is the date for changing back. If START
and END are not specified, the default is the US Daylight saving time start and end dates. The format for start
and end must be one of the following:
n where n is the number of days since the start of the year from 0 to 365. It must contain the
leap year day if the current year is a leap year. With this format, you are responsible to
determine all the leap year details.
Jn where n is the Julian day number of the year from 1 to 365. Leap days are not counted. That
is, in all years – including leap years – February 28 is day 59 and March 1 is day 60. It is
impossible to refer to the occasional February 29 explicitly. The TIME parameter has the same
format as OFFSET but there can be no leading minus (-) or plus (+) sign. If TIME is not
specified, the default is 02:00:00.
Mx[x].y.z where x is the month, y is a week count (in which the z day exists) and z is the day
of the week starting at 0 (Sunday). As an example:
M10.4.0
is the fourth Sunday of October. It does not matter if the Sunday is in the 4th or 5th week.
M10.5.0
is the last Sunday of October (5 indicates the last z day). It does not matter if the Sunday is in the
4th or 5th week.
M10.1.6
is the first week with a Saturday (thus the first Saturday). It does not matter if the Saturday is in the
first or second week.
Mediatrix 4104 35
Chapter 3 - Web Interface – Management Network Settings
The TIME parameter has the same format as OFFSET but there can be no leading minus (-) or plus
(+) sign. If TIME is not specified, the default is 02:00:00.
Example
The following is an example of a proper POSIX string:
Standard Offset Month, Week, and Day Month, Week, and Day
time zone to start the Daylight to stop the Daylight
Saving Time Saving Time
EST5DST4,M4.0.0/02:00:00,M10.5.0/02:00:00
36 Mediatrix 4104
Configuration File Download Reference Manual (SIP Version)
The configuration file download feature allows to update the Mediatrix 4104 configuration by transferring a
configuration file via TFTP or HTTP. The configuration file is transferred from the configuration file download
server and the Mediatrix 4104 is the session initiator. The advantage of having the Mediatrix 4104 as the
session initiator is to allow NAT traversal.
The Configuration File sub-page of the Management page allows you to set various configuration file
download parameters grouped in three categories:
General parameters
Encryption
Automatic Update
You can also set these parameters via SNMP, as described in “Chapter 12 - Configuration File Download” on
page 181.
Mediatrix 4104 37
Chapter 3 - Web Interface – Management Configuration File Download
2
3
4
2. Select the configuration source of the configuration download in the Configuration File Server
Source choices.
Table 28: Configuration File Information Sources
Source Description
Static You manually enter the value and it remains the same every time the Mediatrix 4104
restarts. Use the static configuration if you are not using a DHCP server or if you want
to bypass it.
DHCP The value is obtained at start-time by querying a DHCP server and using standard
DHCP fields or options. Using the DHCP configuration assumes that you have properly
set your DHCP server with the relevant information. See “Chapter 8 - IP Address and
Network Configuration” on page 137 for more details.
3. If the configuration file server configuration source is Static, enter the configuration file server static
IP address or domain name in the Configuration File Server Host field.
This is the current address of the PC that hosts the configuration files.
4. If the configuration file server configuration source is Static, enter the configuration file server static
IP port number in the Configuration File Server Port field.
The default port value complies to RFC 1340 on the well-known ports (assigned numbers). This
value applies to a TFTP server. It may be different for other servers. If you are using an HTTP server
to perform the configuration file download, you must change the port value to 80.
5. Proceed to “Setting up the Configuration File Download” on page 39.
38 Mediatrix 4104
Configuration File Download Reference Manual (SIP Version)
2
3
4
5
c:/root/download Config_File
c:/ root/download/Config_File
c:/root download/Config_File
Mediatrix 4104 39
Chapter 3 - Web Interface – Management Configuration File Download
40 Mediatrix 4104
Configuration File Download Reference Manual (SIP Version)
Informational The specific configuration update The configuration update with the specific
succeeded. configuration file has been successful.
Error The specific configuration update The configuration update with the specific
failed. configuration file experienced an error and
has not been completed.
Informational The configuration file “XXX” was A configuration file was successfully
successfully fetched. fetched.
Informational The unit configuration is not The parameter values defined in the
updated. The parameter values defined fetched configuration files are identical to
in the fetched configuration files the actual unit configuration.
are identical to the actual unit
configuration.
Informational The generic file \”%s\” parameter The generic configuration file parameter
values are not applied. They are values are either identical to the unit
either identical to the unit configuration or overwritten by the specific
configuration or overwritten by the configuration file.
specific file.
Warning None of the parameter values defined No parameter value from a fetched
in the configuration file \”%s\” was configuration file was successfully applied
successfully applied. (e.g., because of bad OIDs).
Informational Parameter values defined in the A fetched configuration file was
configuration file \”%s\” were successfully applied.
successfully applied.
Informational The unit is restarting to complete All necessary fetched configuration files
the configuration update. were successfully applied.
Mediatrix 4104 41
Chapter 3 - Web Interface – Management Configuration File Download
The Mediatrix 4104 will be able to decrypt the next encrypted generic or specific configuration file.
If you select Disable, the configuration file is not decrypted by the unit and the configuration update
fails.
2. Set the proper decryption password field with the password used to decrypt the configuration file.
Table 31: Decryption Passwords
The password is encoded in hexadecimal notation. You can thus use characters in the range 0-9,
A-F. All other characters are not supported.
Each character encodes 4 bits of the key. For instance, a 32-bit key requires 8 characters.
• If you enter too many bits, the key is truncated to the first 448 bits.
• If you do not enter enough bits, the key is padded with zeros.
For instance, a 32-bit key could look like the following: A36CB299.
This key must match the key used for the encryption of the relevant configuration file.
If the field is empty, the configuration file is not decrypted.
3. Click Submit if you do not need to set other parameters.
42 Mediatrix 4104
Configuration File Download Reference Manual (SIP Version)
Note: The configuration download via TFTP can only traverse NATs of types “Full Cone” or “Restricted
Cone”. If the NAT you are using is of type “Port Restricted Cone” or “Symmetric”, the file transfer will not
work.
Caution: When downloading via HTTP, the configuration file server’s port must be 80. You can see the
actual port assigned in the Status section of the Configuration File page.
If you are using a DHCP server and it did not provide the proper port, reconfigure it with the proper port or
use a static configuration. See “Configuration File Server Settings” on page 38 for more details.
2. Place the configuration files to download on the computer hosting the TFTP or HTTP server.
These files must be in a directory under the TFTP root path.
3. If not already done, set the transport protocol and configuration file path as described in “Setting up
the Configuration File Download” on page 39.
4. Initiate the configuration file download by setting the System Command drop-down menu of the
System – Admin Web Page to updateConfiguration.
The Mediatrix 4104 immediately downloads the configuration files. See “System Management” on
page 29 for more details on the system commands.
5. Click Submit.
NAT Variations
NAT treatment of UDP varies among implementations. The four treatments are:
• Full Cone: All requests from the same internal IP address and port are mapped to the same
external IP address and port. Furthermore, any external host can send a packet to the internal
host by sending a packet to the mapped external address.
• Restricted Cone: All requests from the same internal IP address and port are mapped to the
same external IP address and port. Unlike a full cone NAT, an external host (with IP address
X) can send a packet to the internal host only if the internal host had previously sent a packet
to IP address X.
• Port Restricted Cone: Similar to a restricted cone NAT, but the restriction includes port
numbers. Specifically, an external host can send a packet, with source IP address X and
source port P, to the internal host only if the internal host had previously sent a packet to IP
address X and port P.
• Symmetric: All requests from the same internal IP address and port, to a specific destination
IP address and port, are mapped to the same external IP address and port. If the same host
sends a packet with the same source address and port, but to a different destination, a
different mapping is used. Furthermore, only the external host that receives a packet can send
a UDP packet back to the internal host.
For more details on NAT treatments, refer to RFC 3489.
Mediatrix 4104 43
Chapter 3 - Web Interface – Management Configuration File Download
X To set the automatic update every time the Mediatrix 4104 restarts:
1. Set the configuration file server host and port as defined in “Configuration File Server Settings” on
page 38.
Caution: When downloading via HTTP, the configuration file server’s port must be 80. You can see the
actual port assigned in the Status section of the Configuration File page.
If you are using a DHCP server and it did not provide the proper port, reconfigure it with the proper port or
use a static configuration. See “Configuration File Server Settings” on page 38 for more details.
2. Place the configuration files to download on the computer hosting the HTTP or TFTP server.
These files must be in a directory under the root path.
3. If not already done, set the transport protocol and configuration file path as described in “Setting up
the Configuration File Download” on page 39.
4. In the Automatic Update section of the Configuration File page, select Enable in the Configuration
File Update On Restart field.
The automatic configuration update will be performed each time the Mediatrix 4104 restarts.
The unit configuration is only updated if at least one parameter value defined in the downloaded
configuration files is different from the actual unit configuration.
5. Click Submit if you do not need to set other parameters.
Caution: When downloading via HTTP, the configuration file server’s port must be 80. You can see the
actual port assigned in the Status section of the Configuration File page.
If you are using a DHCP server and it did not provide the proper port, reconfigure it with the proper port or
use a static configuration. See “Configuration File Server Settings” on page 38 for more details.
2. Place the configuration files to download on the computer hosting the HTTP or TFTP server.
These files must be in a directory under the root path.
44 Mediatrix 4104
Configuration File Download Reference Manual (SIP Version)
3. If not already done, set the transport protocol and configuration file path as described in “Setting up
the Configuration File Download” on page 39.
4. In the Automatic Update section of the Configuration File page, select Enable in the Configuration
File Periodic Update field.
4
5
6
7
5. Set the waiting period between each configuration update in the Periodic Update Period field.
The time unit for the period is specified in the Periodic Update Time Unit field (see Step 6). Available
values are from 1 to 48.
6. Define the time base for automatic configuration updates in the Periodic Update Time Unit field.
You have the following choices:
Table 32: Time Unit Parameters
Parameter Description
Minutes Updates the unit’s configuration every x minutes. You can specify the x
value in the Periodic Update Period field (see Step 5).
Hours Updates the unit’s configuration every x hours. You can specify the x
value in the Periodic Update Period field (see Step 5).
Days Updates the unit’s configuration every x days. You can specify the x
value in the Periodic Update Period field (see Step 5).
You can also define the time of day when to perform the update in the
Periodic Update Time of Day field (see Step 7).
7. If you have selected Days in Step 6, set the time of the day when to initiate a configuration update
in the Periodic Update Time of Day field.
The time of the day is based on the SNTP Timezone field of the Management - Network Settings
page (see “SNTP Settings” on page 34 for more details).
You must have a time server SNTP that is accessible and properly configured, or the automatic
configuration update feature may not work properly. It is assumed that you know how to configure
your SNTP server. If not, refer to your SNTP server’s documentation. You can also refer to “SNTP
Settings” on page 34 for more details on how to configure the Mediatrix 4104 for a SNTP server.
The configuration files are downloaded at the first occurrence of this value and thereafter at the
period defined by the Periodic Update Period field. Let’s say for instance the automatic unit
configuration update is set with the time of day at 14h00 and the update period at every 2 days.
• If the automatic update is enabled before 14h00, the first update will take place the
same day at 14h00, then the second update two days later at the same hour, and so
on.
• If the automatic update is enabled after 14h00, the first update will take place the day
after at 14h00, then the second download two days later at the same hour, and so on.
Available values are -1, and from 0 to 23.
Entering -1 means that the time of the day at which the Mediatrix 4104 first downloads the
configuration files is randomly selected.
8. Click Submit if you do not need to set other parameters.
Mediatrix 4104 45
Chapter 3 - Web Interface – Management Configuration File Download
Error Handling
The following configuration file fetching service error sources are divided in three types depending on the
transfer protocol: common errors (Table 35), TFTP errors (Table 36) and HTTP errors (Table 37). The error
cause and the unit behaviour are also described.
Table 33: Configuration File Fetching Error Handling
Invalid file content The file contains invalid Send a syslog warning message including the
characters. Allowed characters file location/name, the transfer server address
are ASCII codes 10 (LF), and the invalid character (ASCII code):
13(CR), and 32 to 126. The fetched configuration file “XXX”,
from server “XXX”, has an invalid
character “ASCII code XXX”.
No recorded settings applied.
Invalid transfer server The server address is not valid. Send a syslog warning message including the
address transfer server address:
No configuration file is fetched
because the server host “XXX” is
invalid.
Set sysAdminDownloadConfigFileStatus to fail.
File size too big Downloading a file with a size Send a syslog warning message including the
exceeding 512000 bytes. file location/name, the transfer server address,
the file size and the maximum allowed size:
The fetched configuration file “XXX”,
from server “XXX”, has a size “XXX
bytes” that exceeds the maximum
allowed size “XXX bytes”.
Set sysAdminDownloadConfigFileStatus to fail.
Invalid encryption The configuration file cannot be Send a syslog warning message including the
decrypted. A badly encrypted file location/name and the transfer server
file is detected if the header or address:
the padding is invalid. The fetched configuration file \”%s\”,
from server \”%s\”, can not be
decrypted.
46 Mediatrix 4104
Configuration File Download Reference Manual (SIP Version)
Mediatrix 4104 47
Chapter 3 - Web Interface – Management Configuration File Download
Session timeout No answer from the HTTP Send a syslog warning message including the
server. The time elapsed since file location/name with the HTTP server
the HTTP request was sent address:
exceeds 15 seconds. The configuration file “XXX” was not
fetched. The HTTP session with server
“XXX” timed out.
Set sysAdminDownloadConfigFileStatus to fail.
Session closed by The HTTP server closed the Send a syslog warning message including the
peer session. file location/name with the HTTP server
address:
The configuration file “XXX” HTTP
transfer session was closed by peer:
host “XXX”.
Set sysAdminDownloadConfigFileStatus to fail.
Transfer error Received an HTTP error (other Send a syslog warning message including the
than 401 and 404) from the file location/name with the HTTP server
HTTP server. address and port:
Error in the HTTP transfer of the
configuration file “XXX” from host
“XXX” and port number XXX.
Set sysAdminDownloadConfigFileStatus to fail.
48 Mediatrix 4104
Firmware Download Reference Manual (SIP Version)
Firmware Download
This chapter describes how to download from the web interface a firmware version available on the designated
firmware server into the Mediatrix 4104.
You have the choice to perform the firmware download by using the TFTP or protocol. You can also configure
the Mediatrix 4104 to automatically update its firmware version.
The Firmware Update sub-page of the Management page allows you to set various firmware download
parameters grouped in two categories:
General parameters
Automatic Update
You can also set these parameters via SNMP, as described in “Chapter 13 - Software Download” on page 199.
Before Downloading
To download a firmware, you may need to setup the following applications on your computer:
TFTP server with proper root path
MIB browser (with the current Mediatrix 4104 MIB tree)
You can use the MIB browser built in the Mediatrix’s Unit Manager Network. See “Unit Manager
Network – Element Management System” on page xxvi for more details.
Firmware upgrade zip file
SNTP server properly configured
HTTP server with proper root path
Syslog daemon (optional)
Mediatrix 4104 49
Chapter 3 - Web Interface – Management Firmware Download
2. Select the configuration source of the firmware file information in the Firmware Download Server
Source choices.
Table 34: Configuration File Information Sources
Source Description
Static You manually enter the value and it remains the same every time the Mediatrix 4104
restarts. Use the static configuration if you are not using a DHCP server or if you want
to bypass it.
DHCP The value is obtained at start-time by querying a DHCP server and using standard
DHCP fields or options. Using the DHCP configuration assumes that you have properly
set your DHCP server with the relevant information. See “Chapter 8 - IP Address and
Network Configuration” on page 137 for more details.
3. Set the transfer protocol to use in the Firmware Download Protocol field.
You have the choice between tftp and http.
Your HTTP server may activate some caching mechanism for the firmware download. This
mechanism caches the initial firmware download for later processing, thus preventing changes or
update of the original download by the user. This can cause problems if a user wants to modify the
firmware download and perform it again immediately. The result will still return the original download
and not the new one.
50 Mediatrix 4104
Firmware Download Reference Manual (SIP Version)
4. If your HTTPserver requires authentication when downloading the firmware, set the following fields:
• The user name in the Firmware Download User Name field.
• The password in the Firmware Download Password field.
The Mediatrix 4104 supports basic and digest HTTP authentication, as described in RFC 2617.
5. If the firmware download server configuration source is Static:
• enter the firmware download primary server static IP address or domain name in the
Firmware Download Primary Server Host field.
• enter the firmware download primary server static IP port number in the Firmware
Download Primary Server Port field.
• enter the firmware download secondary server static IP address or domain name in the
Firmware Download Secondary Server Host field.
• enter the firmware download secondary server static IP port number in the Firmware
Download Secondary Server Port field.
The default port value complies to RFC 1340 on the well-known ports (assigned numbers). This
value applies to a TFTP server. It may be different for other servers. If you are using an HTTP server
to perform the firmware download, you must change the port value to 80.
6. Proceed to “Setting up the Firmware Download” on page 51.
Mediatrix 4104 51
Chapter 3 - Web Interface – Management Firmware Download
Parameter Description
static Uses the directory specified in the Firmware Location field (see Step 2).
remoteFile The image location is defined in a file called “mediatrix4104targetimage.inf”. The
location of this file is defined in the imageSelectionFileLocation variable.
This is useful if you are using automatic updates with multiple units (see Step 3).
2. If you set the Firmware Location Provision Source parameter to Static (see Step 1), configure the
firmware download path in the Firmware Location field.
This is the location of the “setup.inf” file that contains the list of the files to download into the
Mediatrix 4104. The “setup.inf” file and all the other files must be in the same directory. In other
words, this is the path from the root TFTP/HTTP folder down to the files extracted from the zip file.
Note that the path must contain a maximum of 63 characters.
1
2
3
3. If you set the Firmware Location Provision Source parameter to remoteFile (see Step 1):
a. Create a text file and write the path and/or name of the directory that contains the files required
for download. Save this file as “mediatrix4104targetimage.inf” under the server root path.
Note: If you leave the file empty, the Mediatrix 4104 will look for the firmware download information in the
root directory of the image server.
b. Configure the path of the “mediatrix4104targetimage.inf” file in the Firmware Selection File
Location field.
Note that the selection file name is in lower case. Some web servers are case sensitive. The
path must contain a maximum of 63 characters.
This is useful if you are using automatic updates with multiple units. If you want the units to
download a new version, you only have to change the path once in the
“mediatrix4104targetimage.inf” file. If you were to use the Firmware Location field, you would
have to change the path in every unit.
4. Click Submit if you do not need to set other parameters.
Note: The current firmware server information is displayed in the Status section.
52 Mediatrix 4104
Firmware Download Reference Manual (SIP Version)
Example
Let’s consider the following example:
The directory that contains the files required for download is called: SIP_v5.0.1.1_MX-S5001-
01.
This directory is under C:/Root/Download.
Table 36: Path Configurations Example
c:/root/download SIP_v5.0.1.1_MX-S5001-01
c:/ root/download/SIP_v5.0.1.1_MX-S5001-01
c:/root download/SIP_v5.0.1.1_MX-S5001-01
Syslog Messages
If you are using a Syslog daemon, you will receive messages that inform you of the firmware update status.
The following are the syslog messages the Mediatrix 4104 sends:
Table 37: Firmware Update Syslog Messages
General Messages
Informational The software update succeeded. The firmware update has been successful.
Error The software update failed. The firmware update experienced an error and
has not been completed.
Error The software update failed (xxx). An error occurs when updating the software,
internal error code provided.
Warning Primary image server not This error occurs when an image download is
specified, cannot download file: initiated and no domain name or address is
xxx specified for the primary image server.
Mediatrix 4104 53
Chapter 3 - Web Interface – Management Firmware Download
Warning Secondary image server not When a request involving the primary server
specified, cannot download file: fails, the secondary server is tried.
xxx.
This error occurs when there is no address or
domain name specified for the secondary image
server.
Error Cannot resolve address of image A DNS request failed to resolve the domain
server: xxx. name of the image server (primary or
secondary).
Error Target image at location: xxx For periodic and automatic updates, the target
from host: xxx is invalid or image to download is first compared with the
corrupted. installed image. This error occurs when this
comparison failed because of corruption in the
target image files.
Informational Image download transfer When manual, periodic or “at restart” image
initiated. download is initiated.
Warning The file: xxx from host: xxx The selection file or “setup.inf” file received
exceeds the size limit. exceeds 10000 bytes.
Informational Target image at location: xxx For periodic and automatic updates, the target
from host xxx is identical to image to download is first compared with the
currently installed image. installed image. This message occurs when this
Transfer aborted. comparison determined that the target image is
identical to the installed image.
Error Image does not support hardware The software download failed because the
(error %d) software image is not compatible with the
hardware.
HTTP-Specific Messages
Warning HTTP image transfer of file: xxx The HTTP transfer was closed by the peer.
from host: xxx was closed by
peer.
Warning HTTP image transfer of file: xxx In the HTTP response, one of the following error
from host: xxx was closed due to occurred:
unsupported or malformed response
from the host.
• The protocol version is not 1.0 or
1.1.
• Some field or line is not properly
formatted.
• The trailing <crlf> is not present at
the end of the header.
• Unsupported kind of response.
Warning HTTP image transfer of file: xxx When receiving HTTP response #400 or #403.
from host: xxx was refused
because of a malformed or
incompatible request.
Warning HTTP image transfer of file: xxx When receiving HTTP response #500 or #501.
from host: xxx was refused
because of a server error.
Warning HTTP image transfer of file: xxx When receiving HTTP response #503.
from host: xxx was refused
because service is unavailable.
54 Mediatrix 4104
Firmware Download Reference Manual (SIP Version)
TFTP-Specific Messages
Warning Image transfer of file: xxx from Unexpected error, either internal or on a TFTP
host: xxx and port: xxx was or HTTP connection.
closed due to unexpected error
Warning Image transfer of file: xxx from When not receiving TFTP packets for 32
host: xxx port: xxx was closed seconds or not receiving a HTTP packet for 15
after timeout seconds.
Warning Image transfer. File: xxx not When receiving TFTP error “NOT FOUND” or
found on host: xxx HTTP response #404.
Warning Image transfer. Access to file: When receiving TFTP error “ACCESS” or HTTP
xxx on host: xxx is unauthorized response #401.
LED States
When the Mediatrix 4104 initiates a firmware download, the LEDs located on the front panel indicate the status
of the process.
Table 38: LED States in Firmware Download
Image downloading and writing Each LED blinks alternately at 1 Hz with 1/4 ON duty cycle.
Warning: Do not turn the Mediatrix 4104 off while in this state.
Image download failed All LEDs blink at the same time at 2 Hz with 50% ON duty cycle for 4
seconds.
See “LED Indicators” on page 12 for a detailed description of the LED patterns related to the firmware
download process.
Caution: When downloading via HTTP, the firmware download server’s port must be 80. You can see the
actual port assigned in the Status section of the Firmware Download page.
If you are using a DHCP server and it did not provide the proper port, reconfigure it with the proper port or
use a static configuration. See “Configuration File Server Settings” on page 38 for more details.
Mediatrix 4104 55
Chapter 3 - Web Interface – Management Firmware Download
6. Initiate the firmware download by setting the System Command drop-down menu of the System –
Admin Web Page to downloadSoftware.
7. Click Submit.
This starts the download process. See “System Management” on page 29 for more details on the
system commands.
Caution: Never shutdown the Mediatrix 4104 manually while in the download process, because the image
may be partially written and the Mediatrix 4104 is unable to restart.
The firmware download may take several minutes, depending on your Internet connection, network
conditions and servers conditions.
If Transparent Address Sharing is enabled during the firmware download, the PC connected to the
Mediatrix 4104 may experience momentary loss of Internet connectivity.
X To set the automatic update every time the Mediatrix 4104 restarts:
1. If not already done, setup the Image server used to download the firmware (see “Before
Downloading” on page 49).
2. Place the firmware to download on the computer hosting the TFTP or HTTP server.
The file must be in a directory under the TFTP root path.
3. If you are downloading via TFTP, be sure that UDP ports 60000 to 60512 inclusively are opened in
your firewall.
4. If not already done, configure the Image path as described in “Setting up the Configuration File
Download” on page 39.
5. If not already done, configure the image hosts and ports, as well as the transfer protocol, as defined
in “Firmware Servers Configuration” on page 50.
Caution: When downloading via HTTP, the firmware download server’s port must be 80. You can see the
actual port assigned in the Status section of the Firmware Download page.
If you are using a DHCP server and it did not provide the proper port, reconfigure it with the proper port or
use a static configuration. See “Configuration File Server Settings” on page 38 for more details.
56 Mediatrix 4104
Firmware Download Reference Manual (SIP Version)
6. In the Automatic Update section of the Firmware Download page, select Enable in the Firmware
Download On Restart field.
The automatic firmware download will be performed each time the Mediatrix 4104 restarts.
7. Click Submit if you do not need to set other parameters.
Caution: When downloading via HTTP, the firmware download server’s port must be 80. You can see the
actual port assigned in the Status section of the Firmware Download page.
If you are using a DHCP server and it did not provide the proper port, reconfigure it with the proper port or
use a static configuration. See “Configuration File Server Settings” on page 38 for more details.
6. In the Automatic Update section of the Firmware Download page, select Enable in the Firmware
Download Periodic Update field.
6
7
8
9
7. Set the waiting period between each firmware update in the Periodic Update Period field.
The time unit for the period is specified in the Periodic Update Time Unit field (see Step 6). Available
values are from 1 to 48.
Mediatrix 4104 57
Chapter 3 - Web Interface – Management Firmware Download
8. Define the time base for automatic firmware updates in the Periodic Update Time Unit field.
You have the following choices:
Table 39: Time Unit Parameters
Parameter Description
Minutes Updates the unit’s firmware every x minutes. You can specify the x
value in the Periodic Update Period field (see Step 5).
Hours Updates the unit’s firmware every x hours. You can specify the x value
in the Periodic Update Period field (see Step 5).
Days Updates the unit’s firmware every x days. You can specify the x value in
the Periodic Update Period field (see Step 5).
You can also define the time of day when to perform the update in the
Periodic Update Time of Day field (see Step 7).
9. If you have selected Days in Step 6, set the time of the day when to initiate a firmware update in
the Periodic Update Time of Day field.
The time of the day is based on the SNTP Timezone field of the Management - Network Settings
page (see “SNTP Settings” on page 34 for more details).
You must have a time server SNTP that is accessible and properly configured, or the automatic
firmware update feature may not work properly. It is assumed that you know how to configure your
SNTP server. If not, refer to your SNTP server’s documentation. You can also refer to “SNTP
Settings” on page 34 for more details on how to configure the Mediatrix 4104 for a SNTP server.
The firmware is downloaded at the first occurrence of this value and thereafter at the period defined
by the Periodic Update Period field. Let’s say for instance the automatic firmware update is set with
the time of day at 14h00 and the update period at every 2 days.
• If the automatic update is enabled before 14h00, the first update will take place the
same day at 14h00, then the second update two days later at the same hour, and so
on.
• If the automatic update is enabled after 14h00, the first update will take place the day
after at 14h00, then the second download two days later at the same hour, and so on.
Available values are -1, and from 0 to 23.
Entering -1 means that the time of the day at which the Mediatrix 4104 first downloads the firmware
is randomly selected.
10. Click Submit if you do not need to set other parameters.
58 Mediatrix 4104
Firmware Download Reference Manual (SIP Version)
In this case, the Mediatrix 4104 tries to contact the primary image server. As it is not available, the Mediatrix
4104 retries for two minutes. It contacts the secondary server after that period and starts the firmware
download.
Note: When using the Mediatrix 4104, Mediatrix recommends to disable the Spanning Tree Protocol on the
network to which the unit is connected.
Firmware Downgrade
It is possible to downgrade a Mediatrix 4104 from the current version (for instance, v5.0rx.x) to an older version
(for instance, v4.4rx.x).
Note: If you perform a default reset on the Mediatrix 4104, you must download the current version into the
unit before performing the firmware downgrade procedure.
Mediatrix 4104 59
Chapter 3 - Web Interface – Management Firmware Download
7. If the emergency firmware download still fails, the Mediatrix 4104 tries to initiate the firmware
download again by doubling the delay between each attempt up to a maximum of 16 minutes:
• first attempt: 1 minute delay
• second attempt: 2 minutes delay
• third attempt: 4 minutes delay
• fourth attempt: 8 minutes delay
• fifth attempt: 16 minutes delay
• sixth attempt: 16 minutes delay
• etc.
This procedure continues until the firmware download completes successfully. The firmware
download can fail if the firmware server cannot be reached or if the firmware directory is not found
on the firmware server.
60 Mediatrix 4104
C H A P T E R
The SIP page allows you to configure the various SIP-related parameters of the Mediatrix 4104:
General SIP configuration parameters
SIP Interop parameters
Security parameters
Standards Supported • RFC 3903 – Session Initiation Protocol (SIP) Extension for
Event State Publication
• RFC 3863 – Presence Information Data Format (PIDF)
The Configuration sub-page of the SIP page allows you to configure the SIP server and SIP user agent
parameters of the Mediatrix 4104.
SIP Servers
The Mediatrix 4104 uses the following types of servers:
Registrar server
Proxy server
Outbound Proxy server
Presence Compositor server
Registrar Server
The registrar server accepts REGISTER requests and places the information it receives in those requests into
the location service for the domain it handles.
Proxy Server
The proxy server is an intermediary program that acts as both a server and a client for the purpose of making
requests on behalf of other clients. A proxy server primarily plays the role of routing, which means its job is to
ensure that a request is passed on to another entity that can further process the request. Proxies are also
useful for enforcing policy and for firewall traversal. A proxy interprets, and, if necessary, rewrites parts of a
request message before forwarding it.
Mediatrix 4104 61
Chapter 4 - Web Interface – SIP Parameters SIP Servers Configuration
SIP Configuration
The Mediatrix 4104 must know the IP address and port number of the SIP servers. You can assign these
information to the Mediatrix 4104 through a DHCP server or manually enter them yourself.
You can also set these parameters via SNMP, as described in “Chapter 9 - SIP Servers” on page 157 and
“Chapter 18 - SIP Protocol Features” on page 243.
2
3
4
5
5
6
2. Select the configuration source of the SIP servers information in the SIP Server Source choices.
Table 40: SIP Servers Configuration Sources
Source Description
Static You manually enter the value and it remains the same every time the Mediatrix 4104
restarts. Use the static configuration if you are not using a DHCP server or if you want
to bypass it.
DHCP The value is obtained at start-time by querying a DHCP server and using standard
DHCP fields or options. Using the DHCP configuration assumes that you have properly
set your DHCP server with the relevant information. See “Chapter 8 - IP Address and
Network Configuration” on page 137 for more details.
3. Set the user agent port number in the SIP Port field.
If this field is set to 0, the default SIP port is used.
62 Mediatrix 4104
SIP Servers Configuration Reference Manual (SIP Version)
4. Define whether or not to override the default proxy home domain used by entering a domain in the
SIP Domain field.
This value replaces the home domain proxy host as defined in the Proxy Host field. It is used by the
address of record in the To and From headers.
5. If the SIP server configuration source is Static:
• enter the SIP registrar server static IP address or domain name in the Registrar Host
field.
• enter the SIP registrar server static IP port number in the Registrar Port field.
• enter the SIP Proxy server static IP address or domain name in the Proxy Host field.
• enter the SIP Proxy server static IP port number in the Proxy Port field.
• enter the SIP outbound proxy server static IP address or domain name in the Outbound
Proxy Host field.
Setting the address to 0.0.0.0 disables the outbound proxy.
• enter the SIP outbound proxy server static IP port number in the Outbound Proxy Port
field.
Note: If the port number corresponds to a domain name that is bound to a SRV record, the port must be
set to 0 for the unit to perform DNS requests of type SRV (as per RFC 3263). Otherwise, the unit will not use
DNS SRV requests, but will rather use only requests of type A because it does not need to be specified
which port to use.
• enter the SIP Presence Compositor server static IP address or domain name in the
Presence Compositor Host field.
• enter the SIP Presence Compositor server static IP port number in the Presence
Compositor Port field.
6. Specify whether a line should remain enabled or not when not registered in the Unregistered Port
Behavior field.
This is useful if you want your users to be able to make calls even if the line is not registered with
the SIP server. The following values are available:
Table 41: Unregistered Line Behaviour
Value Description
disable port When the line is not registered, it is disabled. The user cannot make or
receive calls. Picking up the handset yields a fast busy tone, and incoming
INVITEs receive a “403 Forbidden” response.
enable port When the line is not registered, it is still enabled. The user can receive and
initiate outgoing calls. Note that because the line is not registered to a
registrar, its public address is not available to the outside world; the line will
most likely be unreachable except through direct IP calling.
Mediatrix 4104 63
Chapter 4 - Web Interface – SIP Parameters SIP Servers Configuration
The user name uniquely identifies this endpoint in the domain, such as a telephone number. It is
used to create the Contact and From headers. The From header carries the permanent location (IP
address, home domain) where the endpoint is located. The Contact header carries the current
location (IP address) where the endpoint can be reached. Contact headers are used in two ways:
• First, contacts are registered to the registrar. This enables callers to be redirected to
the endpoint’s current location.
• Second, a contact header is sent along with any request the user agent sends (e.g.,
INVITE), and is used by the target user agent as a return address for later requests to
this endpoint.
2. Enter another name for each line in the Display Name column.
This is a friendly name for the user agent. It contains a descriptive version of the URI and is intended
to be displayed to a user interface.
3. Enter a second accepted user name for each line in the Other Accepted Username field.
This is a user name that the endpoint recognizes as its own, but does not register in contacts sent
to the registrar. The endpoint only registers the user name set in the User Name column.
You can use this column to add a variation on the user name. For instance, let’s say that the user
name is a telephone number, 555-1111. A variation could be to prefix the local area or country code,
such as 819-555-1111.
To include more than one user name, separate them with a “,” character, such as: user1, user2,
5552222, 18195552222.
4. Click Submit if you do not need to set other parameters.
64 Mediatrix 4104
SIP Servers Configuration Reference Manual (SIP Version)
SIP Registration
You can refresh the registration, i.e., commit the changes you have done to the registration. When refreshing
the registration, all enabled endpoints unregister themselves from the previous registrar and send a new
registration to the current registrar with the current parameters.
You can also set this parameter via SNMP, as described in “Registration Parameters” on page 252.
SIP Publication
You can refresh the publication, i.e., commit the changes you have done to the publication. When refreshing
the publications, all enabled endpoints unpublish themselves from the previous Presence Compositor and
send a new publication to the current Presence Compositor with the current parameters.
You can also set this parameter via SNMP, as described in “Publication Parameters” on page 254.
Mediatrix 4104 65
Chapter 4 - Web Interface – SIP Parameters SIP Interop
SIP Interop
The Interop sub-page of the SIP page allows you to configure the SIP penalty box and SIP transport
parameters of the Mediatrix 4104.
Note: An important fact is that it is not the destination itself that is placed in the penalty box, but the
combination of address, port and transport. When a host is in the penalty box, it is never used to try to
connect to a remote host unless it is the last choice for the Mediatrix 4104 and there are no more options to
try after this host.
Let’s say for instance that the Mediatrix 4104 supports both the UDP and TCP transports. It tries to reach
endpoint “B” for which the destination address does not specify a transport and there is no DNS SRV entry to
specify which transports to use in which order. It turns out that this endpoint “B” is also down. In this case, the
Mediatrix 4104 first tries to contact endpoint “B” via UDP. After a timeout period, UDP is placed in the penalty
box and the unit then tries to contact endpoint “B” via TCP. This fails as well and TCP is also placed in the
penalty box.
Now, let’s assume endpoint “B” comes back to life and the Mediatrix 4104 tries again to contact it before UDP
and TCP are released from the penalty box. First, the unit tries UDP, but it is currently in the penalty box and
there is another transport left to try. The Mediatrix 4104 skips over UDP and tries the next target, which is TCP.
Again, TCP is still in the penalty box, but this time, it is the last target the Mediatrix 4104 can try, so penalty
box or not, TCP is used all the same to try to contact endpoint “B”.
There is a problem if endpoint “B” only supports UDP (RFC 2543-based implementation). Endpoint “B” is up,
but the Mediatrix 4104 still cannot contact it: with UDP and TCP in the penalty box, the unit only tries to contact
endpoint “B” via its last choice, which is TCP.
The same scenario would not have any problem if the penalty box feature was disabled. Another option is to
disable TCP in the Mediatrix 4104, which makes UDP the only possible choice for the unit and forces to use
UDP even if it is in the penalty box.
You must fully understand the above problem before configuring this feature. Mixing endpoints that do not
support the same set of transports with this feature enabled can lead to the above problems, so it is suggested
to either properly configure SRV records for the hosts that can be reached or be sure that all hosts on the
network support the same transport set before enabling this feature.
66 Mediatrix 4104
SIP Interop Reference Manual (SIP Version)
2
3
2. In the Penalty Box section, enable the SIP penalty box feature by selecting Enable in the Penalty
Box Activation choices.
The penalty box is always “active”. This means that even if the feature is disabled, IP addresses are
marked as invalid, but they are still tried. This has the advantage that when the feature is enabled,
IP addresses that were already marked as invalid are instantly put into the penalty box.
3. Set the amount of time, in seconds, that a host spends in the penalty box in the Penalty Box Time
field.
Changing the value does not affect IP addresses that are already in the penalty box. It only affects
new entries in the penalty box.
4. Click Submit if you do not need to set other parameters.
You can globally set the transport type for all the lines of the Mediatrix 4104 to either UDP (User Datagram
Protocol) or TCP (Transmission Control Protocol). The Mediatrix 4104 will include its supported transports in
its registrations.
Please note that RFC 3261 states the implementations must be able to handle messages up to the maximum
datagram packet size. For UDP, this size is 65,535 bytes, including IP and UDP headers. However, the
maximum datagram packet size the Mediatrix 4104 supports for a SIP request or response is 5120 bytes
excluding the IP and UDP headers. This should be enough, as a packet is rarely bigger than 2500 bytes.
You can also set these parameters via SNMP, as described in “SIP Transport Type” on page 249.
Mediatrix 4104 67
Chapter 4 - Web Interface – SIP Parameters SIP Authentication
2. Set the priority order of the UDP and TCP transports in the proper Q Value field.
A qvalue parameter is added to each contact. The qvalue gives each transport a weight, indicating
the degree of preference for that transport. A higher value means higher preference.
The format of the qvalue string must follow the RFC 3261 ABNF (a floating point value between
0.000 and 1.000). If you specify an empty string, no qvalue is set in the contacts.
3. Click Submit if you do not need to set other parameters.
SIP Authentication
The Authentication sub-page of the SIP page allows you to configure the unit and user agent authentication
parameters of the Mediatrix 4104.
Authentication information allows you to add some level of security to the Mediatrix 4104 lines by setting user
names and passwords. You can add two types of authentication information:
user agent specific authentication
You can define up to five user names and five passwords for each user agent of the Mediatrix 4104.
A user agent can thus register with five different realms.
unit authentication
You can define up to five user names and five passwords for the Mediatrix 4104. These user names
and passwords apply to all lines of the unit.
When a realm requests authentication, the user agent specific authentication is tried first, and then the unit
authentication if required.
You can also set these parameters via SNMP, as described in “Authentication” on page 246.
2 3 4 5
6 7 8 9
68 Mediatrix 4104
SIP Authentication Reference Manual (SIP Version)
2. In the Unit Authentication section, select whether or not the current unit credentials are valid for any
realm in the corresponding Validate Realm drop-down menu.
Table 42: Realm Authentication Parameters
Parameter Description
Disable The current unit credentials are valid for any realm. The corresponding Realm field
is read-only and cannot be modified.
Enable The unit credentials are used only for a specific realm set in the corresponding
Realm field.
Parameter Description
Disable The current user agent credentials are valid for any realm. The corresponding
Realm field is read-only and cannot be modified.
Enable The user agent credentials are used only for a specific realm set in the
corresponding Realm field.
7. Enter up to five realms for each user agent in the Realm column.
When authentication information is required from users, the realm identifies who requested it.
8. Enter a string that uniquely identifies this user agent in the realm in the Username column.
9. Enter a user password in the Password column.
10. Click Submit if you do not need to set other parameters.
Mediatrix 4104 69
Chapter 4 - Web Interface – SIP Parameters SIP Authentication
70 Mediatrix 4104
C H A P T E R
The Telephony page allows you to configure the various telephony parameters of the Mediatrix 4104.
Digit Maps
Standards Supported RFC 2705 – Media Gateway Control Protocol (MGCP) Version 1.0,
section 3.4 (Formal syntax description of the protocol).
A digit map allows you to compare the number users just dialed to a string of arguments. If they match, users
can make the call. If not, users cannot make the call and get an error signal. It is thus essential to define very
precisely a digit map before actually implementing it, or your users may encounter calling problems.
Because the Mediatrix 4104 cannot predict how many digits it needs to accumulate before transmission, you
could use the digit map, for instance, to determine exactly when there are enough digits entered from the user
to place a call.
Syntax
The permitted digit map syntax is taken from the core MGCP specification, RFC 2705, section 3.4:
DigitMap = DigitString / '(' DigitStringList ')'
DigitStringList = DigitString 0*( '|' DigitString )
DigitString = 1*(DigitStringElement)
DigitStringElement = DigitPosition ['.']
DigitPosition = DigitMapLetter / DigitMapRange
DigitMapLetter = DIGIT / '#' / '*' / 'A' / 'B' / 'C' / 'D' / 'T'
DigitMapRange = 'x' / '[' 1*DigitLetter ']'
DigitLetter ::= *((DIGIT '-' DIGIT ) / DigitMapLetter)
Where “x” means “any digit” and “.” means “any number of”.
For instance, using the telephone on your desk, you can dial the following numbers:
Table 44: Number Examples
Number Description
0 Local operator
00 Long distance operator
xxxx Local extension number
8xxxxxxx Local number
#xxxxxxx Shortcut to local number at other corporate sites
91xxxxxxxxxx Long distance numbers
9011 + up to 15 digits International number
The solution to this problem is to load the Mediatrix 4104 with a digit map that corresponds to the dial plan.
Mediatrix 4104 71
Chapter 5 - Web Interface – Telephony Digit Maps
A Mediatrix 4104 that detects digits or timers applies the current dial string to the digit map, attempting a match
to each regular expression in the digit map in lexical order.
If the result is under-qualified (partially matches at least one entry in the digit map), waits for
more digits.
If the result matches, dials the number.
If the result is over-qualified (i.e., no further digits could possibly produce a match), sends a fast
busy signal.
Special Characters
Digit maps use specific characters and digits in a particular syntax. Those characters are:
Table 45: Digit Map Characters
Character Use
Note: Enclose the digit map in parenthesis when using the “|” option.
72 Mediatrix 4104
Digit Maps Reference Manual (SIP Version)
Note: When making the actual call and dialing the number, the Mediatrix 4104 automatically removes the
“T” found at the end of a dialed number, if there is one (after a match). This character is for indication
purposes only.
Example
Table 44 on page 71 outlined various call types one could make. All these possibilities could be covered in
one digit map:
(0T|00T|[1-7]xxx|8xxxxxxx|#xxxxxxx|91xxxxxxxxxx|9011x.T)
Mediatrix 4104 73
Chapter 5 - Web Interface – Telephony Digit Maps
General Parameters
The following are the general digit maps parameters you can set.
You can also set these parameters via SNMP, as described in “Chapter 21 - Digit Maps” on page 275.
2
3
4
2. In the General section, define the value of the “T” digit in the Digit Map Timeout Inter Digit field.
The “T” digit expresses a time lapse between the detection of two DTMFs. This value is expressed
in milliseconds (ms). Values range from 500 ms to 10000 ms.
3. Define the time between the start of the dial tone and the receiver off-hook tone, if no DTMF is
detected, in the Digit Map Timeout First Digit field.
This value is expressed in milliseconds (ms). Values range from 1000 ms to 180000 ms.
4. Define the total time the user has to dial the DTMF sequence in the Digit Map Timeout Completion
field.
The timer starts when the dial tone is played. When the timer expires, the receiver off-hook tone is
played. This value is expressed in milliseconds (ms). Values range from 1000 ms to 180000 ms.
5. Click Submit if you do not need to set other parameters.
74 Mediatrix 4104
Digit Maps Reference Manual (SIP Version)
2. Define the digit map string that is considered valid when dialed in the Digit Map column.
The string must use the syntax described in “Digit Maps” on page 71.
3. Define the amount of digits to remove from the beginning of the dialed number, after dialing, but
before initiating the call, in the Remove Prefix column.
For instance, when dialing “1-819-xxx-xxxx”, specifying a value of “4” means that the call is started
by using the number “xxx-xxxx”.
This rule is applied BEFORE applying both the Add Prefix (Step 4) and Remove Suffix (Step 5)
rules.
4. Define the string to insert at the beginning of the dialed number before initiating the call in the Add
Prefix column.
For instance, let’s say that you need to dial a special digit, “9”, for all local calls. Dialing “xxx-xxxx”
with a value of “9” would yield “9-xxx-xxxx” as the number with which to initiate the call.
This rule is applied AFTER applying both the Remove Prefix (Step 3) and Remove Suffix (Step 5)
rules.
5. Define the string to look for and remove, from the end of the dialed number, in the Remove Suffix
column.
This is helpful if one of the digit maps contains a terminating character that must not be dialed.
For instance, in a digit map such as “25#”, the “#” signals that the user has finished entering digits.
To remove the “#”, specify “#” in this field and the resulting number is “25”.
This rule is applied AFTER applying the Remove Prefix (Step 3) rule, but BEFORE applying Add
the Prefix (Step 4) rule.
6. Click Submit if you do not need to set other parameters.
Mediatrix 4104 75
Chapter 5 - Web Interface – Telephony Voice & Fax Codecs
2. Define the digit map string that is considered invalid when dialed in the Digit Map column.
The string must use the syntax described in “Digit Maps” on page 71. The string format is validated
upon entry. Invalid entries are refused.
3. Click Submit if you do not need to set other parameters.
The four lines of the Mediatrix 4104 can simultaneously use the same codec (for instance, G.711 PCMA), or
a mix of any of the supported codecs. Set and enable these codecs for each line.
Table 46: Codecs Comparison
76 Mediatrix 4104
Voice & Fax Codecs Reference Manual (SIP Version)
Feature Description
Packetization time Range of 10 ms to 100 ms with increment of 10 ms. See “G.711 Codec
Parameters” on page 82 for more details.
Voice Activity Detection (VAD) Can be enabled or disabled. See “G.711 Codec Parameters” on page 82
for more details.
Comfort noise Supports comfort noise as defined in draft-ietf-avt-rtp-cn-05.txt. See
“G.711 Codec Parameters” on page 82 for more details.
Analog Modem
The Mediatrix 4104 can send modem transmissions in clear channel (G.711). If configured adequately,
modems with higher rate capabilities (for instance, V.90) will automatically fall back in the transmission range
supported.
Quality of modem transmissions is dependent upon the system configuration, quality of the analog lines, as
well as the number of analog-to-digital and digital-to-analog conversions. Modem performance may therefore
be reduced below the optimum values stated above.
G.726
Specified in ITU-T Recommendation G.726: 40, 32, 24, 16 kbit/s adaptive differential pulse code modulation
(ADPCM). It describes the algorithm recommended for conversion of a single 64 kbit/s A-law or U-law PCM
channel encoded at 8000 samples/sec to and from a 40, 32, 24, or 16 kbit/s channel. The conversion is applied
to the PCM stream using an Adaptive Differential Pulse Code Modulation (ADPCM) transcoding technique.
Table 48: G.726 Features
Feature Description
Packetization time Range of 10 ms to 100 ms with increment of 10 ms. See “G.726 Codecs
Parameters” on page 84 for more details.
Voice Activity Detection (VAD) Can be enabled or disabled. See “G.726 Codecs Parameters” on
page 84 for more details.
Comfort noise Supports comfort noise as defined in draft-ietf-avt-rtp-cn-05.txt. See
“G.726 Codecs Parameters” on page 84 for more details.
Analog Modem
The Mediatrix 4104 can send modem transmissions in clear channel (G.726). If configured adequately,
modems with higher rate capabilities (for instance, V.90) will automatically fall back in the transmission range
supported.
Quality of modem transmissions is dependent upon the system configuration, quality of the analog lines, as
well as the number of analog-to-digital and digital-to-analog conversions. Modem performance may therefore
be reduced below the optimum values stated above.
Mediatrix 4104 77
Chapter 5 - Web Interface – Telephony Voice & Fax Codecs
G.723.1
Specified in ITU-T Recommendation G.723.1, dual-rate speech coder for multimedia communications
transmitting at 5.3 kbit/s and 6.3 kbit/s. This Recommendation specifies a coded representation that can be
used to compress the speech signal component of multi-media services at a very low bit rate. The audio is
encoded in 30 ms frames.
A G.723.1 frame can be one of three sizes: 24 octets (6.3 kb/s frame), 20 octets (5.3 kb/s frame), or 4 octets.
These 4-octet frames are called SID frames (Silence Insertion Descriptor) and are used to specify comfort
noise parameters.
Table 49: G.723.1 Features
Feature Description
Packetization time Range of 30 ms to 120 ms with increment of 30 ms. See “G.723 Codec
Parameters” on page 83 for more details.
Voice Activity Detection (VAD) The Mediatrix 4104 supports the annex A. Annex A is the built-in support
of VAD in G.723.1.
G.729
Specified in ITU-T Recommendation G.729, coding of speech at 8 kbit/s using conjugate structure-algebraic
code excited linear prediction (CS-ACELP). For all data rates, the sampling frequency (and RTP timestamp
clock rate) is 8000 Hz.
A voice activity detector (VAD) and comfort noise generator (CNG) algorithm in Annex B of G.729 is
recommended for digital simultaneous voice and data applications; they can be used in conjunction with G.729
or G.729 Annex A. A G.729 or G.729 Annex A frame contains 10 octets, while the G.729 Annex B comfort
noise frame occupies 2 octets.
The Mediatrix 4104 supports G.729A and G.729AB for encoding and G.729, G.729A and G.729AB for
decoding.
Table 50: G.729 Features
Feature Description
Packetization time Range of 10 ms to 100 ms with increment of 10 ms. See “G.729 Codec
Parameters” on page 83 for more details.
Voice Activity Detection (VAD) The Mediatrix 4104 supports the annex B. Annex B is the built-in support
of VAD in G.729. See “G.729 Codec Parameters” on page 83 for more
details.
78 Mediatrix 4104
Voice & Fax Codecs Reference Manual (SIP Version)
General Parameters
The following are the general codecs parameters you can set.
You can also set these parameters via SNMP, as described in “Chapter 15 - Voice Transmissions” on
page 221.
3
4
5
6
7
8
9
2. Select to which port you want to apply the changes in the drop down menu at the top of the window.
3. In the General section, choose the preferred codec you want to use in the Preferred Codec field.
This is the codec you want to favour during negotiation. You have the following choices:
• g711-PCMU
• g711-PCMA
• g723
• g729
• g726-16kbps
• g726-24kbps
• g726-32kbps
• g726-40kbps
The default value is pcmu.
4. Enable the jitter buffer protection by selecting Enable in the Adaptive Jitter Buffer choice.
The jitter buffer allows better protection against packet loss, but increases the voice delay. If the
network to which the Mediatrix 4104 is connected suffers from a high level of congestion, the jitter
buffer protection level should be higher. If the network to which the Mediatrix 4104 is connected
suffers from a low level of congestion, the jitter buffer protection level should be lower.
Mediatrix 4104 79
Chapter 5 - Web Interface – Telephony Voice & Fax Codecs
5. Define the target jitter buffer length in the Target Jitter Buffer field.
The adaptive jitter buffer attempts to hold packets to the target holding time. This is the minimum
delay the jitter buffer adds to the system. The target jitter buffer length is in ms and must be equal
to or smaller than the maximum jitter buffer.
Values range from 0 ms to 135 ms. The default value is 30 ms. You can change values by
increments of 1 ms, but Mediatrix recommends to use multiple of 5 ms.
It is best not to set target jitter values below the default value. Setting a target jitter buffer below 5 ms
could cause an error. Jitter buffer adaptation behaviour varies from one codec to another. See
“About Changing Jitter Buffer Values” on page 81 for more details.
6. Define the maximum jitter buffer length in the Maximum Jitter Buffer field.
This is the maximum jitter the adaptive jitter buffer can handle. The jitter buffer length is in ms and
must be equal to or greater than the target jitter buffer.
Values range from 0 ms to 135 ms. The default value is 125 ms. You can change values by
increments of 1 ms, but Mediatrix recommends to use multiple of 5 ms.
See “About Changing Jitter Buffer Values” on page 81 for more details.
7. Set the DTMF transport type in the DTMF Transport field.
Table 51: DTMF Transport Type Parameters
inBand The DTMFs are transmitted like the voice in the RTP
stream.
outOfBandUsingRtp The DTMFs are transmitted as per RFC 2833.
outOfBandUsingSignalingProtocol The DTMFs are transmitted as per draft-choudhuri-sip-info-
digit-00.txt.
Note: This feature and the Hook Flash processing feature
via signalling protocol are totally independent. Activating
one of these features has no effect on the other. See “Hook
Flash Processing” on page 302 for more details.
signalingProtocolDependent The signalling protocol has the control to select the DTMF
transport mode. The SDP body includes both RFC 2833
and draft-choudhuri-sip-info-digit-00.txt in that order of
preference.
Note: This parameter applies only when selecting the outOfBandUsingRtp DTMF transport mode.
DTMF out-of-band
Certain compression codecs such as G.723.1 and G.729 effectively distort voice because they lose
information from the incoming voice stream during the compression and decompression phases. For
normal speech this is insignificant and becomes unimportant. In the case of pure tones (such as DTMF)
this distortion means the receiver may no longer recognize the tones. The solution is to send this
information as a separate packet to the other endpoint, which then plays the DTMF sequence back by re-
generating the true tones. Such a mechanism is known as out-of-band DTMF. The Mediatrix 4104
receives and sends out-of-band DTMFs as per ITU Q.24. DTMFs supported are 0-9, A-D, *, #.
80 Mediatrix 4104
Voice & Fax Codecs Reference Manual (SIP Version)
9. Set the RTP Base Port field with the port number you want to use as RTP/RTCP base port.
The RTP/RTCP ports are allocated starting from the base port. The Mediatrix 4104 may use two or
four RTP/RTCP ports for each FXS interface:
• It uses two ports in case of a standard call.
• It uses four ports in other types of calls such as a conference call, a call transfer, etc.
The default RTP/RTCP base port is 5004. In the case of the base port defined on 5004:
• If there is currently no ongoing call and FXS connector 1 has an incoming or outgoing
call, it uses the RTP/RTCP ports 5004 and 5005.
• If there is currently a standard call on FXS connector 1 and FXS connector 2 has a
conference call, then FXS connector 2 uses the RTP/RTCP ports 5006, 5007, 5008,
and 5009, which are the next available ports.
10. Select whether the echo cancellation should be enabled or disabled in the Echo Cancellation
choice.
Table 52: Echo Cancellation Parameters
Parameter Description
disable The DSP does not use echo cancellation on the related port.
enable The DSP proceeds to cancel signals that are recognized as echo when
appropriate. This is the default value.
Turning off the echo cancellation feature may be useful to ensure the success of some modem
transmissions.
11. Click Submit if you do not need to set other parameters.
Mediatrix 4104 81
Chapter 5 - Web Interface – Telephony Voice & Fax Codecs
5
6
7
3. Set the minimum and maximum packetization time values for the G.711 u-Law codec in the
corresponding drop-down menu.
The packetization time (also called packetization period or ptime) is the duration, in ms, of the voice
packet.
• Minimum: Shortest packetization period allowed for the G.711 u-Law codec.
Authorized values start at 10 ms and come in discrete steps of 10 ms up to the one
specified by the corresponding Maximum drop-down menu.
• Maximum: Longest packetization period allowed for the G.711 u-Law codec.
Authorized values go up to 100 ms, in discrete steps of 10 ms, and start at the one
specified by the corresponding Minimum drop-down menu.
4. Enable the G.711 a-Law codec by selecting Enable in the G.711 a-Law field.
5. Set the minimum and maximum packetization time values for the G.711 a-Law codec in the
corresponding drop-down menu.
The packetization time (also called packetization period or ptime) is the duration, in ms, of the voice
packet.
• Minimum: Shortest packetization period allowed for the G.711 a-Law codec.
Authorized values start at 10 ms and come in discrete steps of 10 ms up to the one
specified by the corresponding Maximum drop-down menu.
• Maximum: Longest packetization period allowed for the G.711 a-Law codec.
Authorized values go up to 100 ms, in discrete steps of 10 ms, and start at the one
specified by the corresponding Minimum drop-down menu.
6. Enable the G.711 Voice Activity Detection (VAD) by selecting Enable in the G.711 VAD choice.
VAD defines how the Mediatrix 4104 sends information pertaining to silence. This allows the unit to
detect when the user talks, thus avoiding to send silent RTP packets. This saves on network
resources. However, VAD may affect packets that are not really silent (for instance, cut sounds that
are too low). VAD can thus slightly affect the voice quality.
7. Enable the G.711 Comfort Noise Generation (CNG) by selecting Enable in the G.711 Comfort
Noise Generation choice.
Comfort Noise (CN) defines how the Mediatrix 4104 processes silence periods information it
receives. During silence periods, the Mediatrix 4104 may receive CN packets containing information
about background noise. Those packets are used to generate local comfort noise.
8. Click Submit if you do not need to set other parameters.
82 Mediatrix 4104
Voice & Fax Codecs Reference Manual (SIP Version)
3. Set the minimum and maximum packetization time values for the G.729 codec in the corresponding
drop-down menu.
The packetization time (also called packetization period or ptime) is the duration, in ms, of the voice
packet.
• Minimum: Shortest packetization period allowed for the G.729 codec. Authorized
values start at 10 ms and come in discrete steps of 10 ms up to the one specified by
the corresponding Maximum drop-down menu.
• Maximum: Longest packetization period allowed for the G.729 codec. Authorized
values go up to 100 ms, in discrete steps of 10 ms, and start at the one specified by the
corresponding Minimum drop-down menu.
4. Enable the G.729 Voice Activity Detection (VAD) by selecting Enable in the G.729 VAD choice.
VAD defines how the Mediatrix 4104 sends information pertaining to silence. This allows the unit to
detect when the user talks, thus avoiding to send silent RTP packets. This saves on network
resources. However, VAD may affect packets that are not really silent (for instance, cut sounds that
are too low). VAD can thus slightly affect the voice quality.
G.729 has a built-in VAD in its Annex B version. It is recommended for digital simultaneous voice
and data applications and can be used in conjunction with G.729 or G.729 Annex A. A G.729 or
G.729 Annex A frame contains 10 octets, while the G.729 Annex B frame occupies 2 octets. The
CN packets are sent in accordance with annex B of G.729.
5. Click Submit if you do not need to set other parameters.
Caution: The Mediatrix 4104 cannot use G.723 and G.726 at the same time due to memory size limitation.
You must restart the Mediatrix 4104 when enabling or disabling these two codecs. If both G.723 and G.726
are enabled when you restart the Mediatrix 4104, G.723 is the codec used.
2
3
Mediatrix 4104 83
Chapter 5 - Web Interface – Telephony Voice & Fax Codecs
3. Set the minimum and maximum packetization time values for the G.723 codec in the corresponding
drop-down menu.
The packetization time (also called packetization period or ptime) is the duration, in ms, of the voice
packet.
• Minimum: Shortest packetization period allowed for the G.723 codec. Authorized
values start at 30 ms and come in discrete steps of 30 ms up to the one specified by
the corresponding Maximum drop-down menu.
• Maximum: Longest packetization period allowed for the G.723 codec. Authorized
values go up to 120 ms, in discrete steps of 30 ms, and start at the one specified by the
corresponding Minimum drop-down menu.
4. Click Submit if you do not need to set other parameters.
3. Set the G.726 actual RTP dynamic payload type used in an initial offer in the G.726 Payload Type
field.
The payload types available are as per RFC 3551. The values range from 96 to 127. The default
values are as follows:
• G.726 16 kbps: 97.
• G.726 24 kbps: 98.
• G.726 32 kbps: 99.
• G.726 40 kbps: 100.
Note: When selecting the dynamic payload type, make sure that the value is not already used by another
dynamic codec. If a value between 96 and 127 is refused, this means it is already used by another dynamic
codec.
Note: If you set the DTMF Transport field to outOfBandUsingSignalingProtocol (“General Parameters”
on page 79), you cannot configure a dynamic payload type to 111 because it is already used by the DTMF
out-of-band using signalling protocol.
4. Set the minimum and maximum packetization time values for the G.726 codec in the corresponding
drop-down menu.
The packetization time (also called packetization period or ptime) is the duration, in ms, of the voice
packet.
• Minimum: Shortest packetization period allowed for the G.726 codec. Authorized
values start at 10 ms and come in discrete steps of 10 ms up to the one specified by
the corresponding Maximum drop-down menu.
• Maximum: Longest packetization period allowed for the G.726 codec. Authorized
values go up to 100 ms, in discrete steps of 10 ms, and start at the one specified by the
corresponding Minimum drop-down menu.
84 Mediatrix 4104
Voice & Fax Codecs Reference Manual (SIP Version)
Fax Parameters
The Mediatrix 4104 handles G3 fax transmissions at speeds up to 14.4 kbps. Automatic fax mode detection
is standard on all lines. Real-Time Fax Over UDP with the T.38 protocol stack is also available.
The quality of T.38 fax transmissions depends upon the system configuration, type of call control system used,
type of Mediatrix units deployed, as well as the model of fax machines used. Should some of these conditions
be unsatisfactory, performance of T.38 fax transmissions may vary and be reduced below expectations.
A fax call works much like a regular voice call, with the following differences:
1. The fax codec may be re-negotiated by using a re-INVITE.
2. The goal of the re-INVITE is to allow both user agents to agree on a fax codec, which is either:
a. Clear channel (PCMU/PCMA or G.726) without Echo Cancellation nor Silence Suppression
(automatically disabled).
b. T.38.
3. Upon fax termination, if the call is not BYE, the previous voice codec is recovered with another re-
INVITE.
All lines of the Mediatrix 4104 can simultaneously use the same codec (for instance, T.38), or a mix of any of
the supported codecs. Set and enable these codecs for each line.
INVITE
[…] […]
m=audio 5004 RTP/AVP 18 0 13 m=audio 5006 RTP/AVP 18 0 13
a=rtpmap:18 G729/8000 a=rtpmap:18 G729/8000
a=rtpmap:0 PCMU/8000 a=rtpmap:0 PCMU/8000
200 OK
Ringing/Trying
ACK
User User
Agent RTP=PCMU (Echo Cancellation + Silence Suppression = disabled)
Agent
#1 #2
No re-INVITE!!
y There is no need for a re-INVITE since the far end already supports the
data codec (PCMU).
y When your SDP capabilities are inserted in a SIP packet, it implies that
you can receive any of these capabilities at any given time without notice.
y In this case, both ends should switch to clear channel automatically upon
detection of the fax transmission.
Fax is terminated
BYE
200 OK
Mediatrix 4104 85
Chapter 5 - Web Interface – Telephony Voice & Fax Codecs
T.38 Fax
Standards Supported • Based on draft-ietf-sipping-realtimefax-01.txt
• Recommendation ITU T.38 version 0
T.38 fax relay is a real-time fax transmission; that is, two fax machines communicating with each other as if
there were a direct phone line between the two. T.38 is called a fax relay, which means that instead of sending
inband fax signals, which implies a loss of signal quality, it sends those fax signals out-of-band in a T.38
payload, so that the remote end can reproduce the signal locally.
The Mediatrix 4104 can send faxes in T.38 mode over UDP or TCP. T.38 is used for fax if both units are T.38
capable; otherwise, transmission in clear channel over G.711 as defined is used (if G.711 µ-law and/or G.711
A-law are enabled). If no clear channel codecs are enabled and the other endpoint is not T.38 capable, the fax
transmission fails.
Caution: The Mediatrix 4104 opens the T.38 channel only after receiving the “200 OK” message from the
peer. This means that the Mediatrix 4104 cannot receive T.38 packets before receiving the “200 OK”. Based
on RFC 3264, the T.38 channel should be opened as soon as the unit sends the “INVITE” message. See
“Fax Issues” on page 333 for more details.
INVITE
[…] […]
m=audio 5004 RTP/AVP 0 18 8 m=audio 5006 RTP/AVP 0 18 8
a=rtpmap:0 PCMU/8000 a=rtpmap:0 PCMU/8000
a=rtpmap:18 G729/8000 a=rtpmap:18 G729/8000
a=rtpmap:8 PCMA/8000 a=rtpmap:8 PCMA/8000
200 OK
Ringing/Trying
ACK
Fax is terminated
INVITE
[…] […]
m=audio 5004 RTP/AVP 0 18 8 m=audio 5006 RTP/AVP 0 18 8
a=rtpmap:0 PCMU/8000 a=rtpmap:0 PCMU/8000
a=rtpmap:18 G729/8000 a=rtpmap:18 G729/8000
a=rtpmap:8 PCMA/8000 a=rtpmap:8 PCMA/8000
200 OK
Trying
ACK
BYE
200 OK
86 Mediatrix 4104
Voice & Fax Codecs Reference Manual (SIP Version)
2
3
3
5
3. Set the number of redundancy packets sent with the current packet in the T.38 Protection Level
field.
This is the standard redundancy offered by T.38. Please see step 4 for additional reliability options
for T.38. Available values range from 1 to 5.
4. For additional reliability, define the number of times T.38 packets are retransmitted in the T.38 Final
Frames Redundancy field.
This only applies to the T.38 packets where the PrimaryUDPTL contains the following T.38 data
type:
• HDLC_SIG_END,
• HDLC_FCS_OK_SIG_END,
• HDLC_FCS_BAD_SIG_END and
• T4_NON_ECM_SIG_END
5. Set the clear channel codec to use upon detecting a fax tone in the Preferred Clear Channel Codec
field.
This is used to decide which of the following codecs is preferred, even for voice transmissions:
• PCMU
• PCMA
• G.726 at 32 kbs
• G.726 at 40 kbs
Note: In clear channel, G.726 at 16 kbs and 24 kbs are not recommended for fax transmission.
Mediatrix 4104 87
Chapter 5 - Web Interface – Telephony Call Forward
Call Forward
The Call Forward sub-page of the Telephony page allows you to set the three types of Call Forward:
On Busy
On No Answer
Unconditional
You can also set these parameters via SNMP, as described in “Call Forward” on page 288.
On Busy
You can automatically forward the incoming calls of your users to a pre-determined target if they are already
on the line. The user does not have any feedback that a call was forwarded.
3
4
5
6
7
2. Select to which port you want to apply the changes in the drop down menu at the top of the window.
3. In the Call Forward on Busy section, enable the service by selecting Enable in the Allow Call
Forward digits choice.
If you select Disable, this will not disable the call forward, but will prevent the user from activating
or deactivating the service. The user will not be able to use the digits used to start and stop the
service.
4. Define the digits that users must dial to start the service in the Digits to enable field.
Define this field only if you want to let the user start the service with his or her handset. If you rather
want to have the control over the activation/deactivation of the service, proceed to Step 6.
For instance, you could decide to put “*72” as the sequence to activate the service. This sequence
must be unique and follow the syntax for digit maps (see “Digit Maps” on page 71). Dialing this digit
map does not have any effect unless the service’s status is “enabled”.
The activating sequence is set for all the lines of the Mediatrix 4104. You cannot have a different
sequence for each line.
5. Define the digits that users must dial to stop the service in the Digits to disable field.
Define this field only if you want to let the user stop the service with his or her handset. If you rather
want to have the control over the activation/deactivation of the service, proceed to Step 6.
For instance, you could decide to put “*73” as the sequence to deactivate the service. This
sequence must be unique and follow the syntax for digit maps (see “Digit Maps” on page 71).
Dialing this digit map does not have any effect unless the service’s status is “enabled”.
88 Mediatrix 4104
Call Forward Reference Manual (SIP Version)
The deactivating sequence is set for all the lines of the Mediatrix 4104. You cannot have a different
sequence for each line.
6. Set the activation status of the service in the Service Status field to Inactive or Active.
This feature starts the service (active) or stops the service (inactive).
If you want to let the user start or stop the service with his or her handset, you must enter a
sequence of digits in steps 4 and 5. The Service Status field is automatically updated to reflect the
activation status according to the user’s setting.
7. Define the address to which forward incoming calls in the Forwarding Address field.
Accepted formats are:
• telephone numbers (5551111)
• SIP URLs such as ”scheme:user@host”. For instance, “sip:[email protected]”.
This string is used literally, so cosmetic symbols (such as the dash in “555-xxxx”) should not be
present.
8. Click Submit if you do not need to set other parameters.
X To forward calls:
1. Take the receiver off-hook.
2. Wait for the dial tone.
3. Dial the sequence implemented to activate the call forward on busy service.
This sequence could be something like *72.
4. Wait for the transfer tone (three “beeps”) followed by the dial tone.
5. Dial the number to which you want to forward your calls. Dial any access code if required.
6. Wait for three “beeps” followed by a silent pause.
The call forward is established.
7. Hang up your telephone.
Mediatrix 4104 89
Chapter 5 - Web Interface – Telephony Call Forward
On No Answer
You can forward the incoming calls of your users to a pre-determined target if they do not answer their
telephone before a specific amount of time. The user does not have any feedback that a call was forwarded.
2
3
4
5
6
7
If you select Disable, this will not disable the call forward, but will prevent the user from activating
or deactivating the service. The user will not be able to use the digits used to start and stop the
service.
3. Define the digits that users must dial to start the service in the Digits to enable field.
Define this field only if you want to let the user start the service with his or her handset. If you rather
want to have the control over the activation/deactivation of the service, proceed to Step 6.
For instance, you could decide to put “*74” as the sequence to activate the service. This sequence
must be unique and follow the syntax for digit maps (see “Digit Maps” on page 71). Dialing this digit
map does not have any effect unless the service’s status is “enabled”.
The activating sequence is set for all the lines of the Mediatrix 4104. You cannot have a different
sequence for each line.
4. Define the digits that users must dial to stop the service in the Digits to disable field.
Define this field only if you want to let the user stop the service with his or her handset. If you rather
want to have the control over the activation/deactivation of the service, proceed to Step 6.
For instance, you could decide to put “*75” as the sequence to deactivate the service. This
sequence must be unique and follow the syntax for digit maps (see “Digit Maps” on page 71).
Dialing this digit map does not have any effect unless the service’s status is “enabled”.
The deactivating sequence is set for all the lines of the Mediatrix 4104. You cannot have a different
sequence for each line.
5. Define the time, in milliseconds, the telephone keeps ringing before the call forwarding activates in
the Timeout Value field.
6. Set the status of the service in the Service Status field to Inactive or Active.
This feature starts the service (active) or stops the service (inactive).
If you want to let the user start or stop the service with his or her handset, you must enter a
sequence of digits in steps 3 and 4. The Service Status field is automatically updated to reflect the
activation status according to the user’s setting.
7. Define the address to which forward incoming calls in the Forwarding Address field.
Accepted formats are:
• telephone numbers (5551111)
• SIP URLs such as ”scheme:user@host”. For instance, “sip:[email protected]”.
This string is used literally, so cosmetic symbols (such as the dash in “555-xxxx”) should not be
present.
8. Click Submit if you do not need to set other parameters.
90 Mediatrix 4104
Call Forward Reference Manual (SIP Version)
X To forward calls:
1. Take the receiver off-hook.
2. Wait for the dial tone.
3. Dial the sequence implemented to activate the call forward on no answer service.
This sequence could be something like *74.
4. Wait for the transfer tone (three “beeps”) followed by the dial tone.
5. Dial the number to which you want to forward your calls. Dial any access code if required.
6. Wait for three “beeps” followed by a silent pause.
The call forward is established.
7. Hang up your telephone.
Unconditional
The Call Forward Unconditional feature allows users to forward all of their calls to another extension or line.
2
3
4
5
6
If you select Disable, this will not disable the call forward, but will prevent the user from activating
or deactivating the service. The user will not be able to use the digits used to start and stop the
service.
3. Define the digits that users must dial to start the service in the Digits to enable field.
Define this field only if you want to let the user start the service with his or her handset. If you rather
want to have the control over the activation/deactivation of the service, proceed to Step 5.
For instance, you could decide to put “*74” as the sequence to activate the service. This sequence
must be unique and follow the syntax for digit maps (see “Digit Maps” on page 71). Dialing this digit
map does not have any effect unless the service’s status is “enabled”.
Mediatrix 4104 91
Chapter 5 - Web Interface – Telephony Call Forward
The activating sequence is set for all the lines of the Mediatrix 4104. You cannot have a different
sequence for each line.
4. Define the digits that users must dial to stop the service in the Digits to disable field.
Define this field only if you want to let the user stop the service with his or her handset. If you rather
want to have the control over the activation/deactivation of the service, proceed to Step 5.
For instance, you could decide to put “*75” as the sequence to deactivate the service. This
sequence must be unique and follow the syntax for digit maps (see “Digit Maps” on page 71).
Dialing this digit map does not have any effect unless the service’s status is “enabled”.
The deactivating sequence is set for all the lines of the Mediatrix 4104. You cannot have a different
sequence for each line.
5. Set the status of the service in the Service Status field to Inactive or Active.
This feature starts the service (active) or stops the service (inactive).
If you want to let the user start or stop the service with his or her handset, you must enter a
sequence of digits in steps 3 and 4. The Service Status field is automatically updated to reflect the
activation status according to the user’s setting.
6. Define the address to which forward incoming calls in the Forwarding Address field.
Accepted formats are:
• telephone numbers (5551111)
• SIP URLs such as ”scheme:user@host”. For instance, “sip:[email protected]”.
This string is used literally, so cosmetic symbols (such as the dash in “555-xxxx”) should not be
present.
7. Click Submit if you do not need to set other parameters.
X To forward calls:
1. Take the receiver off-hook.
2. Wait for the dial tone.
3. Dial the sequence implemented to activate the call forward unconditional service.
This sequence could be something like *70.
4. Wait for the transfer tone (three “beeps”) followed by the dial tone.
5. Dial the number to which you want to forward your calls. Dial any access code if required.
6. Wait for three “beeps” followed by a silent pause.
The call forward is established.
7. Hang up your telephone.
92 Mediatrix 4104
Services Reference Manual (SIP Version)
Services
The Services sub-page of the Telephony page allows you to set the following subscriber services:
Call Transfer
Call Waiting
Conference
Hold
Second call
Automatic call
You can also set these parameters via SNMP, as described in “Chapter 23 - Subscriber Services” on
page 285.
Call Transfer
The Call Transfer service offers two ways to transfer calls:
Blind Transfer
Attended Transfer
2. Select to which port you want to apply the changes in the drop down menu at the top of the window.
3. In the Call Transfer section, enable the Blind Transfer service by selecting Enable in the Blind
Transfer Activation choice.
The blind call transfer service is sometimes called Transfer without Consultation or Unattended
Transfer. It allows a user to transfer a call on hold to a still ringing (unanswered) call. The individual
at the other extension or telephone number does not need to answer to complete the transfer.
Mediatrix 4104 93
Chapter 5 - Web Interface – Telephony Services
The call hold and second call services must be enabled for this service to work. See “Call Hold” on
page 99 and “Second Call” on page 99.
4. Enable the Attended Transfer service by selecting Enable in the Attended Transfer Activation
choice.
The attended call transfer service is sometimes called Transfer with Consultation. It allows a user
to transfer a call on hold to an active call. The individual at the other extension or telephone number
must answer to complete the transfer.
The call hold and second call services must be enabled for this service to work. See “Call Hold” on
page 99 and “Second Call” on page 99.
5. Click Submit if you do not need to set other parameters.
Note: If the number to which you want to transfer the call is busy or does not answer, quickly perform a
Flash-Hook. The busy tone or ring tone is cancelled and you are back with the first call.
94 Mediatrix 4104
Services Reference Manual (SIP Version)
Call Waiting
The call waiting tone indicates to an already active call that a new call is waiting on the second line.
Your users can activate/deactivate the call waiting tone for their current call. This is especially useful when
transmitting faxes. The user that is about to send a fax can thus deactivate the call waiting tone to ensure that
the fax transmission will not be disrupted by an unwanted second call. When the fax transmission is completed
and the line is on-hook, the call waiting tone is automatically reactivated.
Furthermore, the Mediatrix 4104 supports receiving some Call Waiting control commands via the SIP INFO
method. See “Controlling the Call Waiting Tone via SIP INFO” on page 266 for more details.
2
3
This permanently activates the call waiting tone. When receiving new calls during an already active
call, a special tone is heard to indicate that a call is waiting on the second line. The user can then
answer that call by using the “flash” button. The user can switch between the two active calls by
using the “flash” button.
The call hold service must be enabled for this service to work. See “Call Hold” on page 99.
If the user is exclusively using faxes, select Disable to permanently disable the call waiting tone.
3. Define the digits that users must dial to disable the Call Waiting tone in the Cancel Digit Map field.
This allows a user who has call waiting enabled to disable that service on the next call only. If, for
any reason, the user wishes to undo the cancel, simply unhook and re-hook the telephone to reset
the service.
For instance, you could decide to put “*76” as the sequence to disable the call waiting tone. This
sequence must be unique and follow the syntax for digit maps (see “Digit Maps” on page 71).
Dialing this digit map does not have any effect unless the service’s status is “enabled”.
The deactivating sequence is set for all the lines of the Mediatrix 4104. You cannot have a different
sequence for each line.
4. Click Submit if you do not need to set other parameters.
Mediatrix 4104 95
Chapter 5 - Web Interface – Telephony Services
96 Mediatrix 4104
Services Reference Manual (SIP Version)
Conference
The Conference Call service allows a user to link two or more calls together to form a single conversation,
called a conference.
Only 3-way conferences are currently supported.
A participant of the conference can put the conference on hold and attempt other calls. This
participant may then rejoin the conference at a later time by unholding it. The participant who
initiated the conference cannot put it on hold.
You must enable the call hold and second call services for this service to work. See “Call Hold” on page 99
and “Second Call” on page 99.
The following is a conference call flow example:
INVITE (PCMU)
Trying200 OK
ACK
INVITE (UNHOLD-PCMU)
Trying/200 OK
ACK
3-way Conference Call Established
Requirements
For the conference call to occur successfully, all parties must meet the following requirements:
Support at least one of the PCM codecs (G.711 µ-law and G.711 A-law) enabled on the line
that is having the conference. See “Voice & Fax Codecs” on page 76 for more details.
Ability to dynamically change codec during a call.
The packetization period (ptime) should be the same for all the participants of the conference.
If this is not the case, then part of the conversation may be lost, resulting in a choppy voice. For
better results, Mediatrix recommends to set the packetization period of all participants of a 3-
way conference to 30 milliseconds. See “Voice & Fax Codecs” on page 76 for more information
on how to set the packetization period of the Mediatrix 4104.
Mediatrix 4104 97
Chapter 5 - Web Interface – Telephony Services
X “A” wants to terminate the call with “C” and get back to the call with “B” during the conference:
1. “A” performs a Flash-Hook.
The conference is terminated and the call with “C” is disconnected. “A” and “B” are still connected
and can go on with their conversation.
98 Mediatrix 4104
Services Reference Manual (SIP Version)
Call Hold
The Call Hold service allows the user to temporarily put an existing call on hold, usually by using the “flash”
button of the telephone. The user can resume the call in the same way.
You must enable this service for the following services to work properly:
Call Waiting
Second Call
Blind Transfer
Attended Transfer
Conference
Second Call
The Second Call service allows a user with an active call to put the call on hold, and then initiate a new call on
a second line. This service is most useful with the transfer and conference services.
The call hold service must be enabled for this service to work. See “Call Hold” on page 99.
Mediatrix 4104 99
Chapter 5 - Web Interface – Telephony Miscellaneous
Automatic Call
The automatic call feature allows you to define a telephone number that is automatically dialed when taking
the handset off hook.
When this service is enabled, the second line service is disabled but the call waiting feature is still functional.
The user can still accept incoming calls.
3
4
2. Select to which port you want to apply the changes in the drop down menu at the top of the window.
3. In the Automatic Call section, enable the service by selecting Enable in the Automatic Call
Activation choice.
4. Define the number to dial when the handset is taken off hook in the Automatic Call Target field.
Accepted formats are:
• telephone numbers (5551111)
• SIP URLs such as ”scheme:user@host”. For instance, “sip:[email protected]”.
This string is used literally, so cosmetic symbols (such as the dash in “555-xxxx”) should not be
present.
5. Click Submit if you do not need to set other parameters.
Miscellaneous
The Misc sub-page of the Telephony page allows you to set the following parameters:
Country
Custom Tone Configuration
Message Waiting Indicator
Country Selection
It is very important to set the country in which the Mediatrix 4104 is used because a number of parameter
values are set according to this choice. These parameters are:
Tones
Rings
Impedances
Line Attenuations
See “Appendix D - Country-Specific Parameters” on page 359 for more information on these country-specific
settings. You can also set these parameters via SNMP, as described in “Setting the Location (Country)” on
page 172.
2. In the Country section, select the country in which the Mediatrix 4104 is located in the Country
Selection field.
3. Click Submit if you do not need to set other parameters.
This parameter is set for all the lines of the Mediatrix 4104. You cannot have a different country for
each line.
Caller ID Selection
In countries that support more than one caller ID standard, this standard can be selected with the Country
Selection field. Be careful to properly select the option corresponding to your caller ID.
Table 53: Caller ID Mappings
British Telecom uk
Bellcore uk-bellcore
UK
CCA uk-cca
ETSI-FSK uk-etsi-fsk
Bellcore france
France ETSI-FSK france-etsi-fsk
ETSI-DTMF france-etsi-dtmf
Bellcore austria1
Austria1
ETSI-FSK austria-etsi-fsk
Bellcore austria2
Austria2
ETSI-FSK austria2-etsi-fsk
Pattern Definition
The general format of the pattern string is defined in the following ABNF:
Finally, the three main categories use the following parameters and tags:
The following table describes the various tags used in the syntax.
Table 54: Pattern Definition Syntax
Tag Description
tone-pattern String describing the pattern to use for the tone. An empty string means no
tone.
frequencies-section Description of the frequencies used by the tones used in states-
section. You can define up to four frequencies (f1 to f4). You must enter at
least one frequency if the tone-pattern is not empty. The frequencies to
use are defined in the state-description.
frequency-description Description of the frequency. This is described as “frequency:power”.
frequency Frequency value in Hz. The range is from 10 Hz to 4000 Hz.
power Power level of the frequency in dBm. The range is from -99 dBm to 3 dBm.
loop-counter-section Loop counters definition. The loop counter is used in state-
description.
loop-counter Value of the loop counter. The range is from 2 to 128.
states-section Description of the tone state. You can define up to eight states (s1 to s8).
You must enter at least one state if the tone-pattern is not empty.
state-description Description of the tone state.
on-state-description Description of a state playing a tone.
off-state-description Description of a state not playing a tone.
frequency-selection Frequency to play in the state. You can use from one to four frequencies.
The frequency must be defined in frequencies-section.
time The number of times, in ms, to perform the action of the state. The range is
from 10 ms to 56000 ms. The tone stays indefinitely in the state if no time is
specified.
loop-indicator Used to stop looping between states after a number of loops defined in
loop-counter-section. When the number of loops is reached, the next
state is s(n+1) for the state s(n) instead of the state defined in next-
state.
next-state The next tone state to use when the time has elapsed. This value is not
present if the time is not present.
Example Pattern
No tone ""
"f1=350:-17,f2=440:-17,l=3,s1=on:f1:f2:100:s2,s2=off:100:l:s1,s3=on:f1:f2"
frequency:power
b. In the North America stutter dial tone, two frequencies are used, 350 Hz and 440 Hz. Their
power level is -17 dBm. You can thus complete the frequencies-section category as
follows:
loop-counter = 1*2DIGIT
b. In the North America stutter dial tone, the pattern is repeated three times, thus:
loop-counter = 3
loop-counter-section = "l=" 3
b. There are three states in the North America stutter dial tone: 0.1 on, 0.1 off, and continuous.
The pattern that must be described is thus:
5. Let’s define the first state. Since the first state describes an on tone, off-state-description
is not required for this state.
a. You now have to complete the on-state-description parameter for the first state, which
is defined as:
b. frequency-selection is defined as the frequencies to play and has the following syntax:
You can use from one to four frequencies. The North America stutter dial tone has two
frequencies, thus:
":" 2*5DIGIT
It is the number of milliseconds to perform the action of the state. The on state is 100 ms, thus,
It is the next tone state to use when the time has elapsed. In this case, the next-state
parameter is the off state, which is designated as s2.
The on-state-description parameter is now:
6. Let’s define the second state. Since the first state describes an off tone, on-state-description
is not required for this state.
a. You now have to complete the off-state-description parameter for the first state.
The off-state-description parameter is defined as:
":" 2*5DIGIT
It is the number of milliseconds to perform the action of the state. The off state is 100 ms, thus,
loop-indicator = ":l"
It is used to stop looping between states. It indicates that the loop stops after three times. Once
the loop is completed, the pattern goes to the next state (which is state 3).
It is the next tone state to use when the time has elapsed. In this case, the next-state
parameter is the on state, which is designated as s1.
The off-state-description parameter is now:
7. Let’s define the third and last state. Since the third state describes an on tone, off-state-
description is not required for this state.
a. You now have to complete the on-state-description parameter for the first state.
The on-state-description parameter is defined as:
b. frequency-selection is defined as the frequencies to play and has the following syntax:
You can use from one to four frequencies. The North America stutter dial tone has two
frequencies, thus:
d. The time parameter is the number of milliseconds to perform the action of the state. Since the
third state is a continuous tone, the time parameter is not required, thus,
e. The loop-indicator parameter is used to stop looping between states. Since the third state
is a continuous tone and does not use loops, this parameter is not required.
The on-state-description parameter is now:
f. The next-state parameter is the next tone state to use when the time has elapsed. This
value is not present if the time parameter is not present. You have already discarded the time
parameter, so the next-state parameter is not required.
The on-state-description parameter is now:
g. You can now complete the third state-description parameter and the states-section
parameter:
becomes:
8. Now that you have the three main categories completed, you can finish the pattern:
If you remove all the brackets and quotation marks, which are not to be included, the pattern is:
Pattern = f1=350:-17,f2=440:-
17,l=3,s1=on:f1:f2:100:s2,s2=off:100:1:s1,s3=on:f1:f2
Pattern = f1=350:-17,f2=440:-
17,s1=on:f1:f2:100:s2,s2=off:100:s3,s3=on:f1:f2:100:s4,s4=off:100:s5,s5=on:f1
:f2:100:s6,s6=off:100:s7,s7=on:f1:f2
Note: The message waiting state does not affect the Second Line feature. When in an active call,
performing a flash-hook to get access to the second line plays the usual dial tone.
MWI Method #1
The Mediatrix 4104 sends SUBSCRIBE requests to the server for each line, unless there is no subscription
address defined. The Mediatrix 4104 then waits for NOTIFY requests containing the relevant message waiting
information.
You can also set these parameters via SNMP, as described in “Chapter 25 - Message Waiting Indicator” on
page 309.
2
3
4
5
6
7
3. Set the destination to call to retrieve messages in the Voice-Mail System Address field.
The user typically initiates a call to the voice messaging system, and then uses an auto-attendant
to get the messages. Available formats are:
• telephone numbers (5551111)
• SIP URLs such as “scheme:user@host”. For instance, “sip:[email protected]”.
This string is used literally, so cosmetic symbols (such as the dash in “555-xxxx”) should not be
present.
4. Set the notification mechanism server address to which the Mediatrix 4104 subscribes in the MWI
Subscription Address field.
This mechanism notifies the Mediatrix 4104 when new messages are available. The address is a
SIP URL such as “scheme:user@host”. For instance, “sip:[email protected]”.
5. Set the subscription refresh in the MWI Refresh field.
Available values are:
• noOp: No operation.
• refresh: Refresh message waiting subscriptions. All enabled endpoints unsubscribe
themselves from the service and re-subscribe by using the current provisioning.
This parameter is set for all the lines of the Mediatrix 4104. You cannot have a different behaviour
for each line.
6. Define the duration, in seconds, of dynamic subscription to a messaging service in the MWI
Expiration Time field.
This parameter is set for all the lines of the Mediatrix 4104. You cannot have a different behaviour
for each line.
7. Enable the MWI by selecting Active in the MWI Activation field.
The MWI subscription refresh is not supported when the caller ID is DTMF-based.
8. Click Submit if you do not need to set other parameters.
MWI Method #2
Analog voice
mail
Analog signal with
Destination Analog voice mail goes off-hook on one port
MWI = ON or
endpoint Dialing *72x. or *73x.
MWI = OFF
1 Where "x." is the extension number of
5 destination endpoint
4
SIP Notify with 2 SIP INVITE
Message-Waiting: Yes or
Mediatrix Unit Message-Waiting: No Mediatrix Unit
3
SIP Move Temp with contact
p-MxBlindMwiNotify = Yes
or
p-MxBlindMwiNotify = No IP Communication
Server v3.1
The Advanced page allows you to configure various system and network parameters of the Mediatrix 4104.
QoS (Quality of Service) features enable network managers to decide on packet priority queuing. The
Mediatrix 4104 supports the Differentiated Services (DS) field and 802.1q taggings. The Mediatrix 4104
supports the Real Time Control Protocol (RTCP), which is used to send packets to convey feedback on quality
of data delivery.
The Mediatrix 4104 does not support RSVP (Resource Reservation Protocol).
802.1q Configuration
The 802.1q standard recommends the use of the 802.1q VLAN tags for Ethernet frames traffic prioritization.
VLAN tags are 4-byte headers in which three bits are reserved for priority indication. The values of the priority
bits shall be provisioned.
The 802.1q standard comprises the 802.1p standard.
You can also set these parameters via SNMP, as described in “Chapter 27 - Quality of Service (QoS)” on
page 315.
VLANs
VLANs are created with standard Layer 2 Ethernet. A VLAN Identifier (VID) is associated with each
VLAN. VLANs offer the following benefits:
• VLANs are supported over all IEEE 802 LAN MAC protocols, and over shared media LANs as
well as point-to-point LANs.
• VLANs facilitate easy administration of logical groups of stations that can communicate as if
they were on the same LAN. They also facilitate easier administration of moves, adds, and
changes in members of these groups.
• Traffic between VLANs is restricted. Bridges forward unicast, multicast, and broadcast traffic
only on LAN segments that serve the VLAN to which the traffic belongs.
The VLAN field in the Ethernet file is located after both destination and source addresses:
0 1
0 1 2 3 4 5 6 7 8 9 0 1 2 3 4 5 6 7 (byte)
+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-
| Dest Addr | Src Addr | VLAN | Type/Length | ...
+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-
The VLAN field is separated as follows:
0 (bit) 1 2 3
0 1 2 3 4 5 6 7 8 9 0 1 2 3 4 5 6 7 8 9 0 1 2 3 4 5 6 7 8 9 0 1
+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
| 0x8100 | Pri |T| VID |
+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
For both signalling and media packets, the VLAN priority section is configurable independently.
3
4
5
6
7
8
9
10
2. Enable the VLAN tagging by selecting Enable in the VLAN Tagging Activation field.
All packets are tagged with the Virtual ID (VID) specified in the VLAN ID field.
Enable this option only on compatible LAN with equipment supporting the VLAN tagging. Otherwise,
the Mediatrix 4104 may be unreachable. In this case, use the Reset / Default button to access and
disable VLAN tagging – in the recovery mode, tagging is not permitted.
3. Set the 802.1Q Virtual LAN ID in the VLAN ID field.
This is the VID to be applied in the TCI field when tagging is enabled. The value 1 is the default Port
VID (PVID) for bridge port. The 4095 VID (0xFFF) is reserved and it must not be used in tag header.
4. Set the 802.1Q Virtual LAN default user priority in the VLAN Default Priority field.
This is the user priority to be applied in the TCI field when tagging is enabled. This value applies to
all protocols for which no priority filtering is enabled (e.g. ARP, ICMP).
• 7 = High priority
• 0 = Low priority
5. Enable the 802.1Q VLAN user priority tagging for VoIP signalling packet by selecting Enable in the
Signalling 802.1q Activation field.
This filter applies to any VoIP signalling protocol in use. Each signalling packet is tagged with the
user priority defined in the Signalling 802.1q User Priority field.
6. Set the IEEE 802.1Q VLAN user priority value for VoIP signalling packet in the Signalling 802.1q
User Priority field.
• 7 = High priority
• 0 = Low priority
7. Enable 802.1Q VLAN user priority tagging for VoIP packet by selecting Enable in the Voice 802.1q
Activation field.
This filter applies to any VoIP voice protocol in use (e.g. RTP). Each signalling packet is tagged with
the user priority defined in the Voice 802.1q User Priority field.
8. Set the 802.1Q VLAN user priority value for VoIP packet in the Voice 802.1q User Priority field.
• 7 = High priority
• 0 = Low priority
9. Enable 802.1Q VLAN user priority tagging for T.38 fax packet by selecting Enable in the T.38
802.1q Activation field.
Each signalling packet is tagged with the user priority defined in the T.38 802.1q User Priority field.
10. Set the 802.1Q VLAN user priority value for T38 fax packet in the T.38 802.1q User Priority field.
• 7 = High priority
• 0 = Low priority
11. Click Submit if you do not need to set other parameters.
DiffServ Configuration
Standards Supported RFC 2475 – An Architecture for Differentiated Services
Differentiated Services (DiffServ, or DS) is a protocol for specifying and controlling network traffic by class so
that certain types of traffic – for example, voice traffic, which requires a relatively uninterrupted flow of data,
might get precedence over other kinds of traffic.
DiffServ replaces the first bits in the ToS byte with a differentiated services code point (DSCP). It uses the
existing IPv4 Type of Service octet.
This default value would result in a value of “101” precedence bits, low delay, high throughput, and
normal reliability in the legacy IP networks (RFC 791, RFC 1812). Network managers of legacy IP
networks could use the above-mentioned values to define filters on their routers to take advantage
of priority queuing. The default value is based on the Expedited Forwarding PHB (RFC 2598)
recommendation.
Note: RFC 3168 now defines the state in which to set the two least significant bits in the TOS byte. On the
other hand, this RFC only applies to TCP transmissions and the bits are thus set to “0” in the Mediatrix 4104.
This has the following effects:
• The TOS values for UDP packets are the same as in the MIB.
• The TOS values for TCP packets are equal to the closest multiple of 4 value that is not greater than the
value in the MIB.
Emergency Page
The Emergency sub-page of the Misc page allows you to configure the Emergency Call parameters of the
Mediatrix 4104.
2
3
4
2. Enable the emergency call feature by selecting Enable in the Emergency Call Activation choices.
3. Set the number to reach for an urgent call in the Emergency Call Target field.
Accepted formats are:
• telephone numbers (5551111)
STUN Configuration
Standards Supported RFC 3489 – STUN - Simple Traversal of User Datagram Protocol (UDP)
Through Network Address Translators (NATs)
STUN (Simple Traversal of UDP through NATs) is a simple client / server protocol that uses UDP packets to
discover the configuration information of NATs and firewalls between a device and the public Internet:
NAT type
NAT binding public address
NAT binding time to live
NAT (Network Address Translator) is a device that translates the IP address used within a “private” network
to a different IP address known in another “public” network. See “NAT Traversal” on page 248 for more
details.
STUN supports a variety of existing NAT devices and does not require any additional hardware or software
upgrades on the NAT device.
The Mediatrix 4104 uses the STUN protocol to discover its NAT binding for the following three IP addresses/
ports (sockets):
Signalling protocol (SIP) IP address/port
RTP IP address/port
T.38 IP address/port
Due to a limitation of most routers, an RTP portal might be required in order for two units behind
the same NAT/firewall to be able to communicate with each other.
3
4
5
6
7
2. Enable the STUN client by selecting the Enable option in the STUN Activation choices.
3. Set the static STUN server IP address or Fully Qualified Domain Name (FQDN) in the STUN Server
Host field.
4. Set the static STUN server IP port number in the STUN Server Port field.
The default value is 3478.
5. Set the maximum amount of time, in milliseconds, the Mediatrix 4104 should wait for an answer to
a STUN query sent to a STUN server in the Query Timeout field.
Available values range from 500 ms to 10000 ms.
Caution is advised in setting long timeouts. In the advent of an unresponsive STUN server, the unit
may end up waiting a long time before it determines that a call cannot be made due to the STUN
server failure.
6. Set the amount of time, in seconds, the Mediatrix 4104 should keep a STUN query result in its
internal cache in the Query Cache duration field.
Keeping a query in a cache helps to reduce the amount of unnecessary STUN queries when an RTP
or T.38 socket is re-used within a short period of time. Available values range from 0 s to 3600 s.
When set to 0, the cache is disabled and the unit performs a STUN query each time a socket needs
to be used.
7. Define the interval, in seconds, at which the Mediatrix 4104 sends blank keepalive messages to
keep a firewall hole opened in the Keepalive Interval field.
Keepalive messages are used by both the signalling protocol socket and the RTP socket to keep
those connections opened through a firewall. Available values range from 0 s to 120 s.
When set to 0, no keepalive packet is sent.
1
2
2. Enter the public IP address of the NAT system in the NAT Custom Public Address variable.
This is the public IP address used as Contact address by outgoing SIP packets crossing a NAT
system.
3. Click Submit if you do not need to set other parameters.
This chapter describes how the Mediatrix 4104 uses the SNMP protocol for its configuration.
SNMP Overview
The Mediatrix 4104 uses the Simple Network Management Protocol (SNMP) for initial software configuration
provisioning and subsequent software configuration.
SNMP is a simple request-reply protocol for Internet network management services. It consists of network
management stations (in this document, they are referred to as a management server) communicating with
network elements. Management stations are normally workstations that display relevant facts about the
elements being monitored.
SNMP works over the IP (Internet Protocol) communication stack. SNMP network management consists of
three pieces:
The protocol between the manager and the element (SNMP). This details the format of the
packets exchanged. Although a wide variety of transport protocols could be used, UDP is
normally used with SNMP.
A set of common structures and an identification scheme used to reference the variables in the
MIB. This is called the Structure of Management Information (SMI).
A Management Information Base (MIB) that specifies what variables the network elements
maintain (the information that can be queried and set by the manager).
Definitions
SNMP Versions
The Mediatrix 4104 supports three versions of SNMP: SNMPv1, SNMPv2c and SNMPv3. SNMP defines a few
types of messages that are exchanged between the manager and agent.
SNMPv1 Messages
The following messages are specific to SNMPv1.
Table 56: SNMPv1 Message Types
Operator Description
SNMPv2c Messages
There are a few flavours of SNMPv2, SNMPv2c being the most common. The following message is specific
to SNMPv2.
Table 57: SNMPv2 Message Type
Operator Description
get-bulk Uses BULK Requests to query for a tree of information about a network entity. A
variable put in command line specifies which portion of the object identifier space will
be searched using BULK Requests. All variables in the subtree below the given
variable are queried as a single request and their values presented to the user.
SNMPv3 Messages
To correct the security deficiencies of SNMPv1/v2, SNMPv3 was defined with an overall SNMP architecture
and a set of security capabilities. SNMPv3 includes three important services: authentication, privacy, and
access control (Figure 64). To deliver these services in a flexible and efficient manner, SNMPv3 introduces
the concept of a principal, which is the entity on whose behalf services are provided or processing takes place.
Manager
Agent
Manager
DES Encryption
SNMPv3 messages may
be encrypted to ensure
privacy
SNMP Behaviour
When using SNMP, the following rules apply:
Mediatrix recommends to copy the SNMPv3 user attributes only twice.
The administrator may edit the SNMPv3 user attributes:
• Authentication algorithm (none, MD5, or SHA)
• Authentication password
• Encryption algorithm (NULL or DES)
• Encryption password
• All SNMPv3 passwords (encryption and authentication) must be at least 8 characters
long. You should use the Unit Manager Network product to perform SNMPv3 setup.
Whatever the MIB browser you use, the unit follows the SNMPv3 standard RFCs.
SNMP can be used in a non-secure or secure management mode.
Warning: The SNMPv3 method for changing the password or encryption key contains a flaw which may
result in setting the incorrect password. This problem can happen if you use an incorrect “oldpassword”
when changing your password. Always exercise great caution when changing your password or encryption
key. Note that you can use the factory reset to clear the SNMPv3 password. See “Factory Reset” on page 18
for more details. See also the Unit Manager Network Administration Manual.
Note: If you forget or lose a password, perform a Factory Reset to reset the unit to the non-secure
management mode. See “Factory Reset” on page 18 for more details.
Notes
When using SNMPv3 with encryption (DES), you may experience delays when accessing MIB
variables. This is normal because encrypting an IP packet takes in general longer than sending
it over IP. If you experience any timeout, add some seconds to the timeout period of your MIB
browser, and then try to reach the unit again.
Suppose that the Mediatrix 4104 accepts requests with authentication only. If you perform
requests by using encryption and authentication, assuming that the authentication password is
valid, the SNMP agent still responds as if the requests were only authenticated.
If you clone an SNMPv3 user, and then remove authentication or privacy for it, ensure that a
row in vacmGroupName matches its new constraints. If not, the unit is not accessible by using
the new clone parameters.
Caution: The SNMP Agent section contains the default Mediatrix parameters related to SNMP. Default
values enable SNMPv1, SNMPv2, and SNMPv3 and provide default Mediatrix credentials for SNMPv3.
The SNMP Agent section is located in the SnmpGenericTemplate.xml file located under Unit Manager
Network 3.2\UnitManager\DefaultCfgFile folder. The contents of the SnmpGenericTemplate.xml file may be
appended at the end of the generated XML file. See the Unit Manager Network documentation for more
details.
The SNMP agent section must not be separated by other comments or OIDs in the configuration file.
If you transfer a configuration file with an SNMP Agent section that constitutes a change from the SNMPv3
configuration currently in use, the new configuration is applied and the unit then restarts so that the changes
take effect.
A few notes:
Once an SNMPv3 configuration is in effect in the Mediatrix 4104, it is not possible to revert the
unit back to SNMPv1 or SNMPv2c by sending it a configuration file that does not include an
SNMP Agent configuration section.
If you perform a factory reset, all settings previously applied via the configuration file (including
the SNMPv3 configuration) are lost and the unit reinitializes by using the current profile.
<vacmViewTreeFamilyTable>
<a>
<vacmViewTreeFamilyViewName ValueType="OCTET_STRING" Value="PublicView"/>
<vacmViewTreeFamilySubtree ValueType="OID" Value="1"/>
<vacmViewTreeFamilyMask ValueType="OCTET_STRING" Value="€"/>
<vacmViewTreeFamilyType ValueType="UINT32" Value="1"/>
<vacmViewTreeFamilyStorageType ValueType="UINT32" Value="4"/>
<vacmViewTreeFamilyStatus ValueType="UINT32" Value="1"/>
</a>
<b>
<vacmViewTreeFamilyViewName ValueType="OCTET_STRING" Value="PrivateView"/>
<vacmViewTreeFamilySubtree ValueType="OID" Value="1"/>
<vacmViewTreeFamilyMask ValueType="OCTET_STRING" Value="€"/>
<vacmViewTreeFamilyType ValueType="UINT32" Value="1"/>
<vacmViewTreeFamilyStorageType ValueType="UINT32" Value="4"/>
<vacmViewTreeFamilyStatus ValueType="UINT32" Value="1"/>
</b>
</vacmViewTreeFamilyTable>
</vacmMIBViews>
<vacmSecurityToGroupTable>
<a>
<vacmSecurityModel ValueType="UINT32" Value="1"/>
<vacmSecurityName ValueType="OCTET_STRING" Value="PublicUser"/>
<vacmGroupName ValueType="OCTET_STRING" Value="Snmpv1RWPublicGrp"/>
<vacmSecurityToGroupStorageType ValueType="UINT32" Value="4"/>
<vacmSecurityToGroupStatus ValueType="UINT32" Value="1"/>
</a>
<b>
<vacmSecurityModel ValueType="UINT32" Value="1"/>
<vacmSecurityName ValueType="OCTET_STRING" Value="PrivateUser"/>
<vacmGroupName ValueType="OCTET_STRING" Value="Snmpv1RWPrivateGrp"/>
<vacmSecurityToGroupStorageType ValueType="UINT32" Value="4"/>
<vacmSecurityToGroupStatus ValueType="UINT32" Value="1"/>
</b>
<c>
<vacmSecurityModel ValueType="UINT32" Value="2"/>
<vacmSecurityName ValueType="OCTET_STRING" Value="PublicUser"/>
<vacmGroupName ValueType="OCTET_STRING" Value="Snmpv2cRWPublicGrp"/>
<vacmSecurityToGroupStorageType ValueType="UINT32" Value="4"/>
<vacmSecurityToGroupStatus ValueType="UINT32" Value="1"/>
</c>
<d>
<vacmSecurityModel ValueType="UINT32" Value="2"/>
<vacmSecurityName ValueType="OCTET_STRING" Value="PrivateUser"/>
<vacmGroupName ValueType="OCTET_STRING" Value="Snmpv2cRWPublicGrp"/>
<vacmSecurityToGroupStorageType ValueType="UINT32" Value="4"/>
<vacmSecurityToGroupStatus ValueType="UINT32" Value="1"/>
</d>
<e>
<vacmSecurityModel ValueType="UINT32" Value="3"/>
<vacmSecurityName ValueType="OCTET_STRING" Value="Md5DesUser"/>
<vacmGroupName ValueType="OCTET_STRING" Value="AuthPrivGrp"/>
<vacmSecurityToGroupStorageType ValueType="UINT32" Value="4"/>
<vacmSecurityToGroupStatus ValueType="UINT32" Value="1"/>
</e>
<f>
<vacmSecurityModel ValueType="UINT32" Value="3"/>
<vacmSecurityName ValueType="OCTET_STRING" Value="ShaDesUser"/>
<vacmGroupName ValueType="OCTET_STRING" Value="AuthPrivGrp"/>
<vacmSecurityToGroupStorageType ValueType="UINT32" Value="4"/>
<vacmSecurityToGroupStatus ValueType="UINT32" Value="1"/>
</f>
<g>
<vacmSecurityModel ValueType="UINT32" Value="3"/>
<vacmSecurityName ValueType="OCTET_STRING" Value="AuthNoPrivUser"/>
<vacmGroupName ValueType="OCTET_STRING" Value="AuthNoPrivGrp"/>
<vacmSecurityToGroupStorageType ValueType="UINT32" Value="4"/>
<vacmSecurityToGroupStatus ValueType="UINT32" Value="1"/>
</g>
<h>
<vacmSecurityModel ValueType="UINT32" Value="3"/>
<vacmSecurityName ValueType="OCTET_STRING" Value="NoAuthNoPrivUser"/>
<vacmGroupName ValueType="OCTET_STRING" Value="NoAuthNoPrivGrp"/>
<vacmSecurityToGroupStorageType ValueType="UINT32" Value="4"/>
<vacmSecurityToGroupStatus ValueType="UINT32" Value="1"/>
</h>
</vacmSecurityToGroupTable>
<vacmAccessTable>
<a>
<vacmAccessContextPrefix ValueType="OCTET_STRING" Value="AuthPrivGrp"/>
<vacmAccessSecurityModel ValueType="UINT32" Value="3"/>
<vacmAccessSecurityLevel ValueType="UINT32" Value="3"/>
X To enable SNMPv3:
1. Ensure that the Value parameters of the fields <vacmAccessReadViewName> and
<vacmAccessWriteViewName> are set to “PublicView” in the following groups:
• AuthPrivGrp
• AuthNoPrivGrp
• NoAuthNoPrivGrp
These fields are identified in Figure 65 on page 127 with the following icon:
Enable/Disable SNMPv3 .
X To disable SNMPv3:
1. Ensure that the fields <vacmAccessReadViewName> and <vacmAccessWriteViewName> are
empty in the following groups:
• AuthPrivGrp
• AuthNoPrivGrp
• NoAuthNoPrivGrp
These fields are identified in Figure 65 on page 127 with the following icon:
Enable/Disable SNMPv3 .
MIB Structure
The current MIB structure is defined in the SMI file, called MX-SMI.my. The SMI contains seven main groups.
Table 58: Structure of Management Information
Group Description
mediatrixProducts Each Mediatrix product has been assigned with its own sysObjectID value.
mediatrixAdmin Root of the modules used for the administration of the products.
mediatrixMgmt Root of the modules used to manage the products.
mediatrixConfig Root of the modules used to configure the products.
mediatrixIpTelephony Root of the modules used to configure the signalling protocols.
Signaling
mediatrixModules Provides a root in which modules can register their module entity. No MIB
variables actually appear under this node.
mediatrixExperimental The experimental sub-tree is the area where objects and events in MIBs under
development can be placed without fear of conflicting with other MIBs. When the
items rooted under an experimental sub-tree are ready for release, the sub-tree is
re-attached under a permanent branch.
Please note that Mediatrix’ configuration tool – the Unit Manager Network – does
not support MIBs that are located under the mediatrixExperimental branch of the
MIB structure. The Unit Manager Network does not have specific tasks to manage
variables in experimental MIBs.
Even though the Unit Manager Network can view experimental MIBs, SNMP
operations may not work properly on them.
All parameters in the MIBs have been configured by default upon start up. However, if you need to modify
some of these parameters (for example, parameters related to the country in which you are), use a MIB
browser.
Textual Conventions
Textual conventions are defined in a module to ensure that all variables throughout the MIB structure use the
same syntax and types. The type of each variable is defined in the Composed syntax line.
Table 59: Textual Conventions
Type Definition
Type Description
IP Addresses
The MIB structure contains many IP addresses that can be set or viewed. See “Chapter 8 - IP Address and
Network Configuration” on page 137 for more details.
Persistence
A variable may either be persistent or volatile.
Table 61: Storage Clauses
Clause Definition
Persistent Persistent parameters are saved into the unit’s memory and restored when it restarts.
All the variables with the Access = Read Write attribute are persistent, except the
variables representing commands (such as sysAdminCommand).
Volatile Volatile parameters are lost every time the unit restarts. This type of parameter includes
toggling parameters such as requesting a configuration file or a software download.
Statistics are also volatile parameters that are lost every time the unit restarts.
Note: When performing a SET operation on any MIB variable, Mediatrix recommends to wait at least 30
seconds before shutting down the unit. This gives time to the software to update configuration data in flash
memory.
Tables
There are two types of tables used in the MIB structure. They contain:
Generic variables that apply to each line of a unit. This avoids to repeat each set of variables
for each line it has.
The administrative commands and status related to a managed object.
Generic Variables
All tables used to set variables for one or more lines (such as the voiceIfTable) are based on the ifTable, or
interface table.
The ifTable lists the interfaces of a unit. In other words, it basically defines the lines that are used by the unit.
It contains an ifIndex, which defines the interfaces. It may also contain interfaces such as:
the LoopBack (lo) and Ethernet (eth0) interfaces.
the actual voice interfaces (lines) of the unit.
Table 62 gives an example of the ifTable.
Table 62: ifTable Example
1 LoopBack lo
2 Ethernet(0) eth0
3 Voice FXS (0)
4 Voice FXS (1)
5 Voice FXS (2)
... ... ...
26 Voice FXS (24)
Figure 66 shows a table built in the Unit Manager Network from the voiceifTable parameters.
groupAdmin Table
The groupAdmin table sends administrative commands at the highest instance in a hierarchy (such as the
gateway).
Table 63: groupAdmin Parameters
Parameter Description
ifAdmin Table
The ifAdmin table is similar to the groupAdmin table, except that it applies to interfaces.
Table 64: ifAdmin Parameters
Parameter Description
You can define whether the unit can be configured via SNMP or exclusively via its web interface.
1. In the snmpAgentMIB, define the SNMP service agent status in the snmpAgentEnable variable.
The SNMP service agent controls whether the Mediatrix 4104 may be accessed via SNMP or not.
• enable: SNMP connections are allowed.
• disable: SNMP connections are forbidden.
If you are exclusively using the web page to configure the Mediatrix 4104, you could disable the
SNMP service agent and forbid any SNMP connection to the unit.
If the SNMP agent is disabled and the unit enters into recovery mode, SNMP connections are
allowed during that time. Once the unit returns to its normal state, the SNMP service agent will revert
to the configuration you have set.
You can find out the version of the MIB currently in the Mediatrix 4104.
1. In the sysMgmtMIB, locate the sysMibVersion variable.
This variable displays the current version of the MIB.
The configuration data can be provisioned into the Mediatrix 4104 in two ways:
as a configuration file sent from the Management Server to the Mediatrix 4104 via TFTP
as a MIB sent from the Management Server to the Mediatrix 4104 via SNMP
Configuration File
The configuration file is the fastest way to deliver the necessary information. This may be important when
initializing a large number of units at the same time. The configuration file is mostly used for the initial
provisioning sequence (see “Initial Provisioning Sequence” on page 11 for more details).
For more information on how to use a configuration file for updating the Mediatrix 4104, see “Chapter 12 -
Configuration File Download” on page 181.
The Mediatrix 4104 must be provisioned with various IP addresses and network parameters to be fully
functional. This occurs each time the Mediatrix 4104 is started or when an IP address value is changed in the
MIB. The Mediatrix 4104 can use static network parameters as well as parameters provided by a DHCP server
or even a DNS.
This chapter assumes that you know how to set up and use a DHCP and DNS server. If not, ask your network
administrator to set up DHCP-related variables.
This chapter also refers to the MIB structure of the configuration variables. Refer to “Chapter 7 - MIB Structure
and SNMP” on page 123 for more details.
IP Addresses
The MIB structure contains IP addresses that can be set or viewed. These IP addresses are physically located
in their relevant MIB. For instance, the IP addresses for the Syslog daemon are located in the syslogMIB.
However, when viewing the MIB structure in a MIB browser such as the Mediatrix Unit Manager Network, the
IP addresses are grouped in two distinct folders for easy management.
Table 65: IP Addresses Folders
Folder Description
ipAddressStatus Lists all the IP addresses used by the unit, in read-only format.
ipAddressConfig Lists all the IP addresses you can set. Changes made in this folder are reflected in the
ipAddressStatus folder.
Decimal You can enter IP addresses in the widely-used (base 10) decimal format. 0..9
For instance, a decimal IP address would be 192.168.0.9.
IP addresses cannot contain decimal numbers higher than 255.
Hexadecimal You can enter IP addresses in (base 16) hexadecimal format. 0..9, A..F
Prepending “0x” to the value instructs the unit to interpret it as
hexadecimal. For instance, the decimal IP address 192.168.0.9
translates to 0xC0.0xA8.0x0.0x9 in hexadecimal format.
Octal You can enter IP addresses in (base 8) octal format. Prepending “0” to 0..7
the value instructs the unit to interpret it as octal. For instance, the
decimal IP address 192.168.0.9 translates to 0300.0250.00.011 in octal
format.
You can make combinations of the three bases in a single string, because each number in the string is
interpreted separately. For instance, 0300.0xA8.000.9 translates to the decimal IP address 192.168.0.9.
There may be some confusion between the three available IP address formats. In particular, it is important to
understand that prefixing “0” to the values makes them interpreted as octal values. For instance, the string
192.168.0.009 is not valid because 009 is interpreted in octal, and the digit “9” does not exist in that base.
Provisioning Source
The Mediatrix 4104 IP information may come from a variety of sources.
Table 67: IP Address Provisioning Sources
Source Description
Static You manually enter the value and it remains the same every time the
Mediatrix 4104 restarts. If you do not specify a value, a default static
value applies.
DHCP The value is obtained at start-time by querying a DHCP server and using
standard DHCP fields or options. See RFC 2131 section 2 and RFC
2132.
DHCP – Site specific options The value is obtained at start-time by querying a DHCP server and using
a non-standard option specific to the site where the Mediatrix 4104 is
used. See “Site Specific Options” on page 151 for more details.
DHCP – Vendor specific options The value is obtained at start-time by querying a DHCP server and using
a standard option that is reserved for storing vendor specific information.
See “Vendor Specific Options” on page 150 for more details.
DNS The value is obtained at start-time by querying a DNS server.
None The value is not provisioned. The application provides an acceptable
default.
Services
This section describes the services the Mediatrix 4104 uses and their settings. Most of these services require
that you define their IP address and, if required, port number. See “DHCP Server Configuration” on page 149
for more details.
Configuration variables of network parameters are defined in the MIB structure under the ipAddressConfig
folder. This folder is subdivided into groups, one for each service that requires a network parameter.
Configuration Source
The configuration your Mediatrix 4104 uses can either be:
dynamically assigned (network parameters assigned by a DHCP Server)
static (network parameters you manually defined in the MIB structure)
You can also set these parameters via the web interface, as described in “Network Settings” on page 31.
DHCP Configuration
Using DHCP-assigned IP addresses ensures that the Mediatrix 4104 receives the addresses that are stored
in the DHCP server. This assumes that you have previously set the DHCP server with the proper values. See
“DHCP Server Configuration” on page 149 for more details.
The Mediatrix 4104 can receive numerous information from the DHCP server, including the vendor or site
specific information. Note that the Mediatrix 4104 does not make a DHCP request in the following cases:
If all MIB variables xxSelectConfigSource are set to static at start-up.
If one of the MIB variables xxSelectConfigSource is set to dhcp after the initialization process.
Static Configuration
Using static IP addresses allows you to bypass the DHCP server or still be able to use the Mediatrix 4104 if
you are not running a DHCP server.
In this case, having one or more configuration source variable set to DHCP slows down the restart process. If
any information is set to come from the DHCP server (for example, SNTP address), the restarting unit waits
for a maximum period of two minutes if the DHCP server cannot be reached, even if most other settings are
set to “static”.
The reason for this delay is that the Mediatrix 4104 cannot function as configured if part of its configuration
(the DHCP information) is unavailable. To avoid this problem, you can set all configuration sources the
Mediatrix 4104 supports to “static”.
In the Unit Manager Network Administration Manual, refer to chapter Performing Actions on Mediatrix Units,
section Removing all DHCP Options.
Local Host
The ipAddressConfigLocalHost group allows you to set the IP information the Mediatrix 4104 needs to work
properly. This group is vital to the proper operation of the Mediatrix 4104. If a variable of this group is not
properly set, the Mediatrix 4104 may not be able to restart and be contacted after it has restarted.
In the Unit Manager Network Administration Manual, refer to chapter Administration Parameters, section IP
Configuration.
Note: Mediatrix recommends not to set a static subnet mask address of 255.255.255.254 because this
would only create a subnet with two addresses. This only leaves one bit host addresses. Since a subnet
must have a network (all bits 0) and a broadcast address (all bits 1), this leaves no room for hosts.
Note: If the localHostDnsOverrideEnable variable is enabled, the primary and secondary DNS addresses
are set with static values. See “Static DNS” on page 142 for more details.
In the table above, the only variables that allow an empty string are: localHostPrimaryDns,
localHostSecondaryDns and localHostDefaultRouter.
3. Restart the Mediatrix 4104 so that the changes may take effect.
SNMP Configuration
No DHCP value is available, you can define SNMP information with only static values.
Table 69: SNMP Source
In the Unit Manager Network Administration Manual, refer to chapter Working with SNMP, section Setting Unit
SNMP Preferences.
The Mediatrix 4104 uses the SNMP protocol for software configuration. Set the following SNMP-related
variable to properly use the protocol.
Table 70: SNMP Configuration Variables
Variable Description
localHostStaticSnmpPort Default SNMP agent port, which is the port number to use to reach the local
host via SNMP protocol. Restart the unit to update this parameter.
Default Value: 161
Note: If you change the SNMP agent port, change the port used in the
management server or MIB Browser. Not doing so will prevent you from
contacting the unit.
The Management Server could be the Mediatrix Unit Manager Network. See
“Unit Manager Network – Element Management System” on page xxvi for
more details.
You can query the SNMP information assigned by the DHCP server in the following variables (in the
ipAddressStatus folder):
localHostSnmpPort
msTrapPort
Static DNS
By default, the Mediatrix 4104 receives DNS IP addresses according to the configuration source you have
defined in the localHostSelectConfigSource variable. In general, these addresses are provided by an ISP
(Internet Service Provider) via DHCP.
However, you can set static values for the primary and secondary DNS IP addresses, even when the Mediatrix
4104 is set by DHCP. These static values can thus override DHCP provisioning
The Mediatrix 4104 may receive DNS addresses from two sources:
from an ISP via DHCP
from the static local host DNS IP addresses
Table 71 explains how DNS addresses are attributed to the Mediatrix 4104.
Table 71: DNS Addresses Possibilities
Image
The ipAddressConfigImage group provides the configuration necessary to download applications into the
Mediatrix 4104. This includes emergency downloads in case of repetitive failure to start the main application.
In the Unit Manager Network Administration Manual, refer to chapter Administration Parameters, section
Software and Emergency Download.
Management Server
The ipAddressConfigMs group provides the configuration necessary for contacting a SNMP management
server such as the Mediatrix Unit Manager Network.
In the Unit Manager Network Administration Manual, refer to chapter Administration Parameters, section Unit
Manager Server.
Note: If you change the value of the msStaticTrapPort variable, change the port used in the management
server. Not doing so will prevent you from viewing the received traps from the unit.
3. Restart the Mediatrix 4104 so that the changes may take effect.
Syslog
The ipAddressConfigSyslog group provides the configuration necessary for contacting a Syslog server.
In the Unit Manager Network Administration Manual, refer to chapter Administration Parameters, section
Syslog Daemon.
SIP Servers
The ipAddressConfigSipServer group provides the configuration necessary for contacting different SIP
servers.
In the Unit Manager Network Administration Manual, refer to chapter Signalling Protocols Parameters, section
SIP Configuration Window.
Note: Although the DHCP option #120 is reserved for SIP servers, no standard currently defines the
content and layout of this option.
Note: If, for a given server, the port is 0, then the host and port for this server are obtained through a DNS
SRV request. See “Chapter 10 - DNS SRV Configuration” on page 167 for more details.
SNTP
The ipAddressConfigSntp group provides the configuration necessary for contacting a NTP/SNTP server.
If you are using a NTP or SNTP server (see “Chapter 20 - SNTP Settings” on page 271 for more details), the
DHCP server already has options that can be set to provide time server addresses, and the order in which
clients use them to attempt to discover servers.
The Mediatrix 4104 uses Option 42 to specify the IP address corresponding to the server that provides NTP/
SNTP (RFC 1769).
In the Unit Manager Network Administration Manual, refer to chapter Administration Parameters, section
SNTP.
DHCP Configuration
The following sections describes paramaters that you can set on the Mediatrix 4104 to better interact with a
DHCP server.
X To configure how much time the Mediatrix 4104 waits for DHCP options:
1. In the sysConfigMIB, set the amount of time (in seconds) the Mediatrix 4104 will wait for DHCP
options in the sysConfigDhcpWaitDelay variable.
This variable is only effective when the variable sysConfigDhcpWait is set to disable. The default
value is 10 seconds.
2. Define the restart behaviour of a unit that needs to issue a DHCP request to receive some options
in the sysConfigDhcpWait variable.
This variable has no influence on the wait behaviour in effect when the unit is requesting an IP
address lease from the DHCP server.
Table 78: DHCP Wait Parameters
Parameter Description
enable The unit waits up to 130 seconds for DHCP options and then, in the absence of
a response, proceeds to restart without a valid address for the requested
servers. This is the default value.
disable The unit restarts, without valid server addresses, if a DHCP response has not
been received after the amount of time specified in the variable
sysConfigDhcpWaitDelay.
You can define whether the Mediatrix 4104 sets the Bootp BROADCAST flag in DHCP requests it issues.
This applies to the DHCP Discover requests the unit sends on startup. It does not apply to the DHCP Discover
requests sent when renewing the lease.
Parameter Description
noFlags The Bootp BROADCAST flag is not set in DHCP requests that the Mediatrix
4104 issues. The DHCP server may thus answer by using unicast delivery.
broadcastFlag The Bootp BROADCAST flag is set in DHCP requests that the Mediatrix 4104
issues.
DHCP servers generally allocate a range of IP addresses for use on a network and reserve IP addresses for
specific devices using a unique identifier for each device. The Mediatrix 4104 unique identifier is its media
access control (MAC) address.
Note: Mediatrix recommends to use a Windows 2000- or Unix-based DHCP server. If you run Windows NT
4.0 and use the built-in Microsoft DHCP Server, use the Site Specific instead of Vendor Specific information.
Note: If the localHostSelectConfigSource variable is set to static and any other xxSelectConfigSource
variable is set to dhcp, the Mediatrix 4104 makes its DHCP request that will be released immediately.
Network Configuration
Table 80 lists some of the network options to configure in the DHCP server:
Table 80: Network Configuration
This section briefly describes vendor and site specific DHCP options.
Most of the MIB variables described in “Services” on page 139 require that you define their IP address and, if
required, port number. When defining these variables, you can do so in two ways: via vendor specific options
or site specific options.
The default value is to use the vendor specific codes. In this case, the xxSiteSpecificCode MIB variables are
set to 0.
If you want to use site specific codes instead, change the value of the xxSiteSpecificCode MIB variables from
the default value (0) to the value you select in the DHCP server. See “Settings Example” on page 153 for an
example of vendor specific and site specific settings.
The vendor specific DHCP option is a standard DHCP option used to store information specific to the vendor
of the DHCP client. The vendor specific option code is 43. Because there are different information elements
that can be stored in this option, each element has been allocated a “sub-option” number. See Table 81 on
page 152 for the complete list.
Like all other options, the vendor specific information field (option 43) first contains a code (43), a length (in
byte) and some data that spans the number of bytes specified in the length.
The data is organized as a series of sub-options, each of them laid-out like a regular option (code, length,
data). The codes can be anything between 1 and 254, and the vendor, Mediatrix, chooses these codes. See
Table 81 on page 152 for actual codes.
The following figures show the general and encapsulated layout of the vendor specific information option.
Mediatrix units store one type of information in vendor specific options: IP addresses with optional port
number. The layout for storing IP addresses is explained in section “Entering IP Addresses” on page 152.
Vendor Class ID
When using the vendor specific option, first define a Vendor Class ID for the Mediatrix 4104 (not supported in
Windows NT servers). A Vendor Class ID can be used by DHCP clients to identify their vendor type and
configuration. When using this option, vendors can define their own specific identifier values to convey a
particular hardware or operating system configuration or other identifying information.
Where vendor classes are used, the DHCP server responds to identifying clients by using option code 43, the
reserved option type for returning vendor specific information to the client.
DHCP servers that do not interpret this option type are expected to ignore it when it is specified by clients.
Please refer to your DHCP server’s documentation to learn how to create a new vendor class.
Site specific options are non-standard DHCP options specific to the network where the Mediatrix 4104 is used.
You are responsible to allocate an option number (between 128 and 254) for each information element to be
stored.
Mediatrix units store one type of information in site specific options: IP addresses with optional port number.
The layout for storing IP addresses is explained in section “Entering IP Addresses” on page 152.
Figure 70 is an example of site specific option #146, containing address 192.168.0.1.
When using the site specific option, you can place the values in the site specific options of your choice in the
DHCP server. You must then enter the values in the proper MIB variables.
Please refer to your DHCP server’s documentation to learn how to create site specific information. See
“Entering IP Addresses” on page 152 for more details on the syntax to use.
Option Codes
This table lists all vendor specific sub-option codes.
Table 81: Sub-Option Codes
Code
Description
Decimal Hexadec.
Entering IP Addresses
In the DHCP server, IP addresses can be entered in decimal, hexadecimal or octal format. See “IP Addresses”
on page 137 for more details.
There are two formats of address string:
Long: Has a size of 6 bytes (12 hexadecimal characters) and includes the IP address and port.
Short: Has a size of 4 bytes (8 hexadecimal characters) and includes only the IP address. In
this case, the default port is used.
Numeric values are stored in network byte order (Big-Endian).
Table 82: Address String Formats
When entering IP addresses in the DHCP server, there is a difference between the vendor specific option and
the site specific option.
The vendor specific options must be encapsulated because more than one information can be stored in this
option:
[code][length][4-6 bytes address][another code][another length][another
address]...
The site specific options can have only one information per option:
[4-6 bytes address]
The DHCP server adds the proper code and length in the packet it sends out.
Example
The following example shows how to enter the Syslog (code 110) IP address 192.168.0.10 (with the default
port used) and the same address at port 2545 in hexadecimal format.
Vendor or
Site Specific
Code
Size IP Address
Vendor or
Site Specific
Code
Size IP Address Port
Settings Example
Let’s say for instance you want:
the Image server at 10.3.2.154 (static)
the Management Server via DHCP in the vendor specific options
the Syslog server via DHCP in the site specific option #250
The following are the corresponding MIB values:
imageSelectConfigSource = static
imageStaticPrimaryHost = 10.3.2.154
msSelectConfigSource = dhcp
msDhcpSiteSpecificCode = 0
syslogSelectConfigSource = dhcp
syslogDhcpSiteSpecificCode = 250
The following is the corresponding DHCP setup, assuming the Management server is located at 10.3.2.201
and the Syslog server is located at 10.3.2.200 (port 1024):
Option 43 (vendor specific option) contains the hexadecimal sequence
0xC80x40xA0x30x20xC9 inserted among other sequences.
Option 250 (site specific option) contains the hexadecimal sequence 0xA0x30x20xC80x400.
Error Handling
In the event of a network or server failure, this section describes the application behaviour and/or replacement
values to use.
Table 85: Replacement Values for Error Recovery
DNS Failures
If the DNS cannot be contacted, the Mediatrix 4104 performs the following steps:
1. The Mediatrix 4104 sends a first request to the primary DNS server.
2. If the DNS server cannot be contacted within two seconds, the Mediatrix 4104 sends a request to
the secondary DNS server.
3. If the secondary DNS server cannot be contacted, the Mediatrix 4104 uses the replacement value
from Table 85 for all variables that depend on the DNS.
You can set the speed of the Ethernet connection of the Mediatrix 4104.
You can also set these parameters via the web interface, as described in “Ethernet Connection Speed” on
page 31.
Caution: Whenever you force a connection speed / duplex mode, be sure that the other device and all
other intermediary nodes used in the communication between the two devices have the same configuration.
See “Speed and Duplex Detection Issues” on page 155 for more details.
9 SIP Servers
Registrar Server
The registrar server accepts REGISTER requests and places the information it receives in those requests into
the location service for the domain it handles.
In the Unit Manager Network Administration Manual, refer to chapter Signalling Protocols Parameters, section
SIP Configuration Window.
Configuration Source
The Mediatrix 4104 must know the IP address and port number of the Registrar server. You can assign these
information to the Mediatrix 4104 through a DHCP server or manually enter them yourself with the static
variables.
Note: When defining whether or not the Mediatrix 4104 must get its SIP server configuration through a
DHCP server, this is set for all the SIP servers. You cannot define a different configuration for each type of
server.
DHCP Configuration
Using the DHCP configuration assumes that you have properly set your DHCP server with the relevant
information. See “Chapter 8 - IP Address and Network Configuration” on page 137 for more details.
3. Set how you want to define the registrar server information in the DHCP server.
Table 86: Registrar Server DHCP Information
Static Configuration
Use the static configuration if you are not using a DHCP server or if you want to bypass it.
Variable Description
Proxy Server
The proxy server is an intermediary program that acts as both a server and a client for the purpose of making
requests on behalf of other clients. A proxy server primarily plays the role of routing, which means its job is to
ensure that a request is passed on to another entity that can further process the request. Proxies are also
useful for enforcing policy and for firewall traversal. A proxy interprets, and, if necessary, rewrites parts of a
request message before forwarding it.
In the Unit Manager Network Administration Manual, refer to chapter Signalling Protocols Parameters, section
SIP Configuration Window.
Configuration Source
The Mediatrix 4104 must know the IP address and port number of the proxy server. You can assign these
information to the Mediatrix 4104 through a DHCP server or manually enter them yourself with the static
variables.
Note: When defining whether or not the Mediatrix 4104 must get its SIP server configuration through a
DHCP server, this is set for all the SIP servers. You cannot define a different configuration for each type of
server.
DHCP Configuration
Using the DHCP configuration assumes that you have properly set your DHCP server with the relevant
information. See “Chapter 8 - IP Address and Network Configuration” on page 137 for more details.
Static Configuration
Use the static configuration if you are not using a DHCP server or if you want to bypass it.
Variable Description
An outbound proxy is an intermediary entity that acts as both a server and a client for the purpose of making
requests on behalf of other clients. The outbound proxy receives all outbound traffic and forwards it. Incoming
traffic may or may not go through the outbound proxy. The outbound proxy’s address is never used in the SIP
packets, it is only used as a physical network destination for the packets.
When the outbound proxy is enabled, the proxy is still used to create the To and the From headers, but the
packets are physically sent to the outbound proxy.
The outbound proxy is enabled if the IP address is valid (i.e., not 0.0.0.0). The default static value in the MIB
is 0.0.0.0.
Configuration Source
The Mediatrix 4104 must know the IP address and port number of the outbound proxy. You can assign these
information to the Mediatrix 4104 through a DHCP server or manually enter them yourself with the static
variables.
Note: When defining whether or not the Mediatrix 4104 must get its SIP server configuration through a
DHCP server, this is set for all the SIP servers. You cannot define a different configuration for each type of
server.
DHCP Configuration
Using the DHCP configuration assumes that you have properly set your DHCP server with the relevant
information. See “Chapter 8 - IP Address and Network Configuration” on page 137 for more details.
3. Set how you want to define the outbound proxy server information in the DHCP server.
Table 90: Outbound Proxy Server DHCP Information
Static Configuration
Use the static configuration if you are not using a DHCP server or if you want to bypass it.
Variable Description
You must specify the type of routing of the outbound proxy configured in sipOutboundProxyHost does.
Note: This feature is currently located under the mediatrixExperimental branch of the MIB structure. See
“MIB Structure” on page 131 for more details.
Value Description
looseRouter This is the most current method for SIP routing, as per RFC 3261, and
will become the standard behaviour once RFC 3261 compliance is
achieved. See “SIP Outbound Proxy (From RFC 3261)” on page 161 for
details.
strictRouter Pre-RFC 3261, RFC 2543 compatible SIP routing.
The initial route for all SIP requests contains the home domain proxy
address (the Request-URI). Requests are directed to the outbound
proxy.
In other words, the Request-URI is constructed as usual, using the
home domain proxy and the user name, but is used in the route set. The
Request-URI is filled by the outbound proxy address.
Loose Router
A proxy is said to be loose routing if it follows the procedures defined in the RFC 3261 specification
(section 6) for processing of the Route header field. These procedures separate the destination of the
request (present in the Request-URI) from the set of proxies that need to be visited along the way
(present in the Route header field). A proxy compliant to these mechanisms is also known as a loose
router.
The Presence Compositor server is a User Agent Server (UAS) that processes PUBLISH requests and is
responsible for compositing event state into a complete, composite event state of a resource for a presentity.
The presence Compositor is enabled if the IP address is valid (i.e., not 0.0.0.0). The default static value in the
MIB is 0.0.0.0.
Configuration Source
The Mediatrix 4104 must know the IP address and port number of the Presence Compositor server. You can
assign these information to the Mediatrix 4104 through a DHCP server or manually enter them yourself with
the static variables.
Note: When defining whether or not the Mediatrix 4104 must get its SIP server configuration through a
DHCP server, this is set for all the SIP servers. You cannot define a different configuration for each type of
server.
DHCP Configuration
Using the DHCP configuration assumes that you have properly set your DHCP server with the relevant
information. See “Chapter 8 - IP Address and Network Configuration” on page 137 for more details.
Static Configuration
Use the static configuration if you are not using a DHCP server or if you want to bypass it.
Variable Description
This chapter describes the configuration required for the Mediatrix 4104 to work with a DNS SRV.
Standards Supported • RFC 2782 – A DNS RR for specifying the location of services
(DNS SRV)
• RFC 3263 - Session Initiation Protocol (SIP): Locating SIP
Servers
Currently, one must either know the exact address of a server to contact it, or broadcast a question.
DNS SRV is an extension of the standard DNS server. SRV (Service Record) is a type of entry a network
administrator may put into the DNS answers. A DNS SRV is used to get one or more IP addresses of servers,
each one having its own weight and priority.
Each server received when using DNS SRV, depending on its weight and priority, can be used as a primary
or backup server or can be part of a load balancing system.
For instance, the client requests the SRV for SIP servers in some domain. The DNS server may return the A,
B, and C addresses, which are all SIP servers. Each address has a weight and the client must choose one of
those three addresses by using a random algorithm that considers the weight.
To use DNS SRV, an administrator must set a service records (SRV) into the DNS servers available on the
network.
DNS SRV implementation should imply a shared database between servers since a REGISTER and an
INVITE can be sent to any server, not necessarily the same one.
DNS SRV applies to both TCP and UDP transport types.
Priority vs Weight
A DNS SRV uses the priority and weight concepts to distribute the requests.
Table 95: Priority vs. Weight
Parameter Description
Priority A client must attempt to contact the target host with the lowest-numbered priority it can
reach.
Weight Specifies a relative weight for entries with the same priority. Larger weights should be
given a proportionately higher probability of being selected.
Agent Server #1
No Answer
Register (port#1)
Server #2
200 OK
Register (port#2)
Server #3
200 OK
If the address of a service corresponds to a domain name that is bound to a SRV record, the port this service
uses must be set to 0 for the unit to perform DNS requests of type SRV (as per RFC 3263). Otherwise, the
unit will not use DNS SRV requests, but will rather use only requests of type A because it does not need to be
specified which port to use. See “Chapter 9 - SIP Servers” on page 157 for more details.
Note: Any “SRV enabled” service must have a host name recognized by the DNS SRV server. “_sip._udp”
or “_sip._tcp” (depending on the transport type) is automatically added to the host name.
You can configure the Mediatrix 4104 to always use the same DNS SRV record for a SIP call ID. As a result,
a call or registration always uses the same destination until the destination is unreachable or the unit receives
a different DNS SRV result.
Parameter Description
11 Country-Specific Configuration
This chapter describes how to set the Mediatrix 4104 with the proper country settings.
Caller ID Information
The caller ID is a generic name for the service provided by telephone utilities that supply information such as
the telephone number or the name of the calling party to the called subscriber at the start of a call. In call
waiting, the caller ID service supplies information about a second incoming caller to a subscriber already busy
with a phone call. However, note that caller ID on call waiting is not supported by all caller ID-capable
telephone displays.
In typical caller ID systems, the coded calling number information is sent from the central exchange to the
called telephone. This information can be shown on a display of the subscriber telephone set. In this case, the
caller ID information is usually displayed before the subscriber decides to answer the incoming call. If the line
is connected to a computer, caller information can be used to search in databases and additional services can
be offered.
The following basic caller ID features are supported:
Date and Time
Calling Line Identity
Reason for Absence of Calling Line Identity
Calling Party Name
Reason for Absence of Calling Party Name
Visual Indicator (MWI)
Caller ID Generation
There are two methods used for sending caller ID information depending on the application and country-
specific requirements:
caller ID generation using DTMF signalling
caller ID generation using Frequency Shift Keying (FSK)
Both methods can be used on different lines at the same time.
DTMF Signalling
The data transmission using DTMF signalling is performed during or before ringing depending on the country
settings or line configuration. The Mediatrix 4104 provides the calling line identity according to the following
standards:
Europe: ETSI 300 659-1 January 2001 (Annex B) : Access and Terminals (AT); Analogue
access to the Public Switched Telephone Network (PSTN); Subscriber line protocol over the
local loop for display (and related) services; Part 1: On-hook data transmission.
Brazil: STD 220-250-713 Issue 01. November 1993: General specification “identification of the
calling party for SPC with DTMF”.
Note: For units in Brazil, set the analogScnGwInterDigitDialDelay and analogScnGwDtmfDuration value to
70 ms (in the analogScnGwMIB). This will ensure that the caller ID displays properly.
Denmark: TDK-TS 900 301-1 January 2003: Public Switched Telephone Network (PSTN)
Calling Line Identification presentation (CLIP) supplementary service Specification of the NTP.
FSK Generation
Different countries use different standards to send caller ID information. The Mediatrix 4104 is compatible with
the following widely used standards:
Bellcore GR-30-CORE
British Telecom (BT) SIN227, SIN242
UK Cable Communications Association (CCA) specification TW/P&E/312
ETSI 300 659-1
Note: The compatibility of the Mediatrix 4104 is not limited to the above caller ID standards.
Continuous phase binary FSK modulation is used for coding which is compatible with:
BELL 202
ITU-T V.23, the most common standard
ADSI
ADSI (Analog Display Service Interface) is a telecommunications protocol standard that enables alternate
voice and data capability over the existing analog telephone network. It is an extension to basic caller ID. To
use ADSI, you would need an ADSI capable device.
ADSI can display the basic caller ID parameters and the following additional parameters:
Call Type
First Called Line Identity
Number of Messages (MWI)
Type of Forwarded Call
Type of Calling User
Redirecting Number
Charge
Duration of the Call
Network Provider Identity
Note: Currently, very few ADSI-capable devices support these additional information.
It is very important to set variables according to the country in which the Mediatrix 4104 is used because a
number of parameter values are set according to this choice. These parameters are:
Tones
Rings
Impedances
Line Attenuations
See “Appendix D - Country-Specific Parameters” on page 359 for more information on these country-specific
settings.
In the Unit Manager Network Administration Manual, refer to chapter Ports Parameters, section Port
Configuration Window.t
You can also set these parameters via the web interface, as described in “Country Selection” on page 100.
3. Restart the Mediatrix 4104 so that the changes may take effect.
Caller ID Selection
In countries that support more than one caller ID standard, this standard can be selected with the
telephonyCountrySelection variable. Be careful to properly select the option corresponding to your caller ID.
Table 98: Caller ID Mappings
British Telecom uk
Bellcore uk-bellcore
UK
CCA uk-cca
ETSI-FSK uk-etsi-fsk
Bellcore france
France ETSI-FSK france-etsi-fsk
ETSI-DTMF france-etsi-dtmf
Bellcore austria1
Austria 1
ETSI-FSK austria-etsi-fsk
Austria 2 Bellcore austria2
ETSI-FSK austria2-etsi-fsk
You can override the pattern for a specific tone defined for the selected country (see “Appendix D - Country-
Specific Parameters” on page 359 for more details). You can define new patterns for the following tones:
Busy Preemption
Confirmation Reorder
Congestion Ringback
Dial Receiver Off Hook (ROH)
Intercept Special Information Tone (SIT)
Message Waiting Stutter
Pattern Definition
The general format of the pattern string is defined in the following ABNF:
Finally, the three main categories use the following parameters and tags:
The following table describes the various tags used in the syntax.
Table 99: Pattern Definition Syntax
Tag Description
tone-pattern String describing the pattern to use for the tone. An empty string means no
tone.
frequencies-section Description of the frequencies used by the tones used in states-
section. You can define up to four frequencies (f1 to f4). You must enter at
least one frequency if the tone-pattern is not empty. The frequencies to
use are defined in the state-description.
frequency-description Description of the frequency. This is described as “frequency:power”.
frequency Frequency value in Hz. The range is from 10 Hz to 4000 Hz.
power Power level of the frequency in dBm. The range is from -99 dBm to 3 dBm.
loop-counter-section Loop counters definition. The loop counter is used in state-
description.
loop-counter Value of the loop counter. The range is from 2 to 128.
states-section Description of the tone state. You can define up to eight states (s1 to s8).
You must enter at least one state if the tone-pattern is not empty.
state-description Description of the tone state.
on-state-description Description of a state playing a tone.
off-state-description Description of a state not playing a tone.
frequency-selection Frequency to play in the state. You can use from one to four frequencies.
The frequency must be defined in frequencies-section.
time The number of times, in ms, to perform the action of the state. The range is
from 10 ms to 56000 ms. The tone stays indefinitely in the state if no time is
specified.
loop-indicator Used to stop looping between states after a number of loops defined in
loop-counter-section. When the number of loops is reached, the next
state is s(n+1) for the state s(n) instead of the state defined in next-
state.
next-state The next tone state to use when the time has elapsed. This value is not
present if the time is not present.
The following table gives some examples of custom tones. Note that the quotation marks are not
part of the syntax and must not be included when entering the tone pattern.
Table 100: Pattern Examples
Example Pattern
No tone ""
"f1=350:-17,f2=440:-17,l=3,s1=on:f1:f2:100:s2,s2=off:100:l:s1,s3=on:f1:f2"
frequency:power
b. In the North America stutter dial tone, two frequencies are used, 350 Hz and 440 Hz. Their
power level is -17 dBm. You can thus complete the frequencies-section category as
follows:
loop-counter = 1*2DIGIT
b. In the North America stutter dial tone, the pattern is repeated three times, thus:
loop-counter = 3
loop-counter-section = "l=" 3
b. There are three states in the North America stutter dial tone: 0.1 on, 0.1 off, and continuous.
The pattern that must be described is thus:
5. Let’s define the first state. Since the first state describes an on tone, off-state-description
is not required for this state.
a. You now have to complete the on-state-description parameter for the first state, which
is defined as:
b. frequency-selection is defined as the frequencies to play and has the following syntax:
You can use from one to four frequencies. The North America stutter dial tone has two
frequencies, thus:
":" 2*5DIGIT
It is the number of milliseconds to perform the action of the state. The on state is 100 ms, thus,
It is the next tone state to use when the time has elapsed. In this case, the next-state
parameter is the off state, which is designated as s2.
The on-state-description parameter is now:
6. Let’s define the second state. Since the first state describes an off tone, on-state-description
is not required for this state.
a. You now have to complete the off-state-description parameter for the first state.
The off-state-description parameter is defined as:
":" 2*5DIGIT
It is the number of milliseconds to perform the action of the state. The off state is 100 ms, thus,
loop-indicator = ":l"
It is used to stop looping between states. It indicates that the loop stops after three times. Once
the loop is completed, the pattern goes to the next state (which is state 3).
It is the next tone state to use when the time has elapsed. In this case, the next-state
parameter is the on state, which is designated as s1.
The off-state-description parameter is now:
7. Let’s define the third and last state. Since the third state describes an on tone, off-state-
description is not required for this state.
a. You now have to complete the on-state-description parameter for the first state.
The on-state-description parameter is defined as:
b. frequency-selection is defined as the frequencies to play and has the following syntax:
You can use from one to four frequencies. The North America stutter dial tone has two
frequencies, thus:
d. The time parameter is the number of milliseconds to perform the action of the state. Since the
third state is a continuous tone, the time parameter is not required, thus,
e. The loop-indicator parameter is used to stop looping between states. Since the third state
is a continuous tone and does not use loops, this parameter is not required.
The on-state-description parameter is now:
f. The next-state parameter is the next tone state to use when the time has elapsed. This
value is not present if the time parameter is not present. You have already discarded the time
parameter, so the next-state parameter is not required.
The on-state-description parameter is now:
g. You can now complete the third state-description parameter and the states-section
parameter:
8. Now that you have the three main categories completed, you can finish the pattern:
If you remove all the brackets and quotation marks, which are not to be included, the pattern is:
Pattern = f1=350:-17,f2=440:-
17,l=3,s1=on:f1:f2:100:s2,s2=off:100:1:s1,s3=on:f1:f2
Pattern = f1=350:-17,f2=440:-
17,s1=on:f1:f2:100:s2,s2=off:100:s3,s3=on:f1:f2:100:s4,s4=off:100:s5,s5=on:f1
:f2:100:s6,s6=off:100:s7,s7=on:f1:f2
The configuration file download feature allows to update the Mediatrix 4104 configuration by transferring a
configuration file via TFTP or HTTP. The configuration file can either be transferred from the management
server or from the configuration file download server. The main difference is the session initiator, which is
respectively the management server and the Mediatrix 4104. The advantage of having the Mediatrix 4104 as
the session initiator is to allow NAT traversal.
You can also set these parameters via the web interface, as described in “Configuration File Download” on
page 37.
The service allows to download a unique file for each Mediatrix 4104, and/or a file shared among many units.
These configuration files may be encrypted or not.
You have the choice to perform the configuration file download by using the TFTP protocol or the HTTP
protocol. You can also configure the Mediatrix 4104 to automatically update its configuration.
To download a configuration file, you may need to setup the following applications on your computer:
TFTP server with proper root path
SNTP server properly configured
HTTP server with proper root path
Configuration source
Configuration file name and location
DHCP Configuration
Using the DHCP configuration assumes that you have properly set your DHCP server with the relevant
information. See “Chapter 8 - IP Address and Network Configuration” on page 137 for more details.
See “Vendor and Site Specific DHCP Options” on page 150 for more details.
Static Configuration
Use the static configuration if you are not using a DHCP server or if you want to bypass it.
Variable Description
The default port value complies to RFC 1340 on the well-known ports (assigned numbers). This
value applies to a TFTP server. It may be different for other servers. If you are using an HTTP server
to perform the configuration file download, you must change the port value to 80.
c:/root/download Config_File
c:/ root/download/Config_File
c:/root download/Config_File
Caution: The generic configuration file must be in XML format, no matter what its file extension.
If you leave the variable empty, the Mediatrix 4104 does not download the generic configuration file.
3. Set the configFileFetchingSpecificFileName variable with the name of the specific configuration file
to download.
Caution: The specific configuration file must be in XML format, no matter what its file extension.
MIB Variable
You can query the status of the last configuration file download in the sysAdminDownloadConfigFileStatus
variable:
idle: No configuration file download has been performed yet.
fail: The last configuration file download failed.
success: The last configuration file download succeeded.
inProgress: A configuration file download is in progress.
listening: The unit is listening and waiting for a configuration file to be sent by the management
server.
Syslog Messages
A lot of information is transmitted as system log (syslog) messages. The following are some of the syslog
messages sent by the unit:
Table 104: Configuration File Download Syslog Messages
Informational The specific configuration update The configuration update with the specific
succeeded. configuration file has been successful.
Error The specific configuration update The configuration update with the specific
failed. configuration file experienced an error and
has not been completed.
Informational The configuration file “XXX” was A configuration file was successfully
successfully fetched. fetched.
Informational The unit configuration is not The parameter values defined in the
updated. The parameter values defined fetched configuration files are identical to
in the fetched configuration files the actual unit configuration.
are identical to the actual unit
configuration.
Informational The generic file \”%s\” parameter The generic configuration file parameter
values are not applied. They are values are either identical to the unit
either identical to the unit configuration or overwritten by the specific
configuration or overwritten by the configuration file.
specific file.
Warning None of the parameter values defined No parameter value from a fetched
in the configuration file \”%s\” was configuration file was successfully applied
successfully applied. (e.g., because of bad OIDs).
Informational Parameter values defined in the A fetched configuration file was
configuration file \”%s\” were successfully applied.
successfully applied.
Informational The unit is restarting to complete All necessary fetched configuration files
the configuration update. were successfully applied.
Generic configFilePrivacyGenericSecret
Specific configFilePrivacySpecificSecret
The key is encoded in hexadecimal notation. You can thus use characters in the range 0-9, A-F. All
other characters are not supported.
Each character encodes 4 bits of the key. For instance, a 32-bit key requires 8 characters.
• If you enter too many bits, the key is truncated to the first 448 bits.
• If you do not enter enough bits, the key is padded with zeros.
For instance, a 32-bit key could look like the following: A36CB299.
This key must match the key used for the encryption of the relevant configuration file.
If the variable is empty, the configuration file is not decrypted.
2. Set the configFilePrivacyEnable variable to enable.
The Mediatrix 4104 will be able to decrypt the next encrypted generic or specific configuration file.
If this variable is set to disable, the configuration file is not decrypted by the unit and the
configuration update fails.
Note: The configuration download via TFTP can only traverse NATs of types “Full Cone” or “Restricted
Cone”. If the NAT you are using is of type “Port Restricted Cone” or “Symmetric”, the file transfer will not
work.
NAT Variations
NAT treatment of UDP varies among implementations. The four treatments are:
• Full Cone: All requests from the same internal IP address and port are mapped to the same
external IP address and port. Furthermore, any external host can send a packet to the internal
host by sending a packet to the mapped external address.
• Restricted Cone: All requests from the same internal IP address and port are mapped to the
same external IP address and port. Unlike a full cone NAT, an external host (with IP address
X) can send a packet to the internal host only if the internal host had previously sent a packet
to IP address X.
• Port Restricted Cone: Similar to a restricted cone NAT, but the restriction includes port
numbers. Specifically, an external host can send a packet, with source IP address X and
source port P, to the internal host only if the internal host had previously sent a packet to IP
address X and port P.
• Symmetric: All requests from the same internal IP address and port, to a specific destination
IP address and port, are mapped to the same external IP address and port. If the same host
sends a packet with the same source address and port, but to a different destination, a
different mapping is used. Furthermore, only the external host that receives a packet can send
a UDP packet back to the internal host.
For more details on NAT treatments, refer to RFC 3489.
Caution: When downloading via HTTP, the configuration file server’s port must be 80. You can query the
actual port assigned in the configFileFetchingPort read-only variable (in the ipAddressStatus folder).
If you are using a DHCP server and it did not provide the proper port, reconfigure it with the proper port or
use a static configuration. See “Configuration File Server Settings” on page 181 for more details.
2. Place the configuration files to download on the computer hosting the HTTP server.
These files must be in a directory under the root path.
3. If not already done, set the configuration file path as described in “Setting up the Configuration File
Download” on page 183.
4. In the configFileFetchingMIB, set the configFileTransferProtocol variable to http.
Your HTTP server may activate some caching mechanism for the file download. This mechanism
caches the initial file download for later processing, thus preventing changes or update of the
original file by the user. This can cause strange problems if a user wants to edit a configuration file
to modify values and upload it immediately. The result will still return the original file and not the new
one.
5. If your HTTP server requires authentication when downloading the configuration file, set the
following:
• The user name in the configFileTransferUsername variable.
• The password in the configFileTransferPassword variable.
6. In the groupAdminMIB, set the groupSetAdmin variable to ForceLock.
All activities in progress on the Mediatrix 4104 are terminated immediately and the unit enters the
maintenance mode (the value of the groupAdminState variable is “locked”). The configuration file
download may take place.
7. In the sysAdminMIB, initiate the configuration file download via HTTP by setting the
sysConfigCommand variable to updateConfiguration.
The Mediatrix 4104 immediately downloads the configuration files. It is the initiator of the HTTP
sessions.
X To set the automatic update every time the Mediatrix 4104 restarts:
1. Set the configuration file server host and port as defined in “Configuration File Server Settings” on
page 181.
Caution: When downloading via HTTP, the configuration file server’s port must be 80. You can query the
actual port assigned in the imagePrimaryPort and imageSecondaryPort read-only variables (in the
ipAddressStatus folder).
If you are using a DHCP server and it did not provide the proper port, reconfigure it with the proper port or
use a static configuration. See “Configuration File Server Settings” on page 181 for more details.
2. Place the configuration files to download on the computer hosting the HTTP or TFTP server.
These files must be in a directory under the root path.
3. If not already done, set the configuration file path as described in “Setting up the Configuration File
Download” on page 183.
4. In the configFileFetchingMIB, set the configFileTransferProtocol variable to either http or tftp.
If you are using the HTTP protocol to download the configuration, be aware that your HTTP server
may activate some caching mechanism for the file download. This mechanism caches the initial file
download for later processing, thus preventing changes or update of the original file by the user.
This can cause strange problems if a user wants to edit a configuration file to modify values and
upload it immediately. The result will still return the original file and not the new one.
5. If you are using the HTTP protocol to download the configuration and your HTTP server requires
authentication, set the following:
• The user name in the configFileTransferUsername variable.
• The password in the configFileTransferPassword variable.
The Mediatrix 4104 supports basic and digest HTTP authentication, as described in RFC 2617.
6. Set the configFileAutoUpdateOnRestartEnable variable to enable (in the
configFileAutomaticUpdate group).
7. In the sysConfigMIB, set the sysConfigDownloadConfigFile variable to
automaticInitiateFileDownload.
The automatic configuration update will be performed each time the Mediatrix 4104 restarts.
The unit configuration is only updated if at least one parameter value defined in the downloaded
configuration files is different from the actual unit configuration.
Caution: When downloading via HTTP, the configuration file server’s port must be 80. You can query the
actual port assigned in the imagePrimaryPort and imageSecondaryPort read-only variables (in the
ipAddressStatus folder).
If you are using a DHCP server and it did not provide the proper port, reconfigure it with the proper port or
use a static configuration. See “Configuration File Server Settings” on page 181 for more details.
2. Place the configuration files to download on the computer hosting the HTTP or TFTP server.
These files must be in a directory under the root path.
3. If not already done, set the configuration file path as described in “Setting up the Configuration File
Download” on page 183.
4. In the configFileFetchingMIB, set the configFileTransferProtocol variable to either http or tftp.
If you are using the HTTP protocol to download the configuration, be aware that your HTTP server
may activate some caching mechanism for the file download. This mechanism caches the initial file
download for later processing, thus preventing changes or update of the original file by the user.
This can cause strange problems if a user wants to edit a configuration file to modify values and
upload it immediately. The result will still return the original file and not the new one.
5. If you are using the HTTP protocol to download the configuration and your HTTP server requires
authentication, set the following:
• The user name in the configFileTransferUsername variable.
• The password in the configFileTransferPassword variable.
The Mediatrix 4104 supports basic and digest HTTP authentication, as described in RFC 2617.
6. Define the time base for automatic configuration updates in the configFileAutoUpdateTimeUnit
variable (in the configFileAutomaticUpdate group).
You have the following choices:
Table 106: Time Unit Parameters
Parameter Description
minutes Updates the unit’s configuration every x minutes. You can specify the x
value in the variable configFileAutoUpdatePeriod (see Step 7).
hours Updates the unit’s configuration every x hours. You can specify the x
value in the variable configFileAutoUpdatePeriod (see Step 7).
days Updates the unit’s configuration every x days. You can specify the x
value in the variable configFileAutoUpdatePeriod (see Step 7).
You can also define the time of day when to perform the update in the
configFileAutoUpdateTimeOfDay variable (see Step 8).
7. Set the waiting period between each configuration update in the configFileAutoUpdatePeriod
variable.
The time unit for the period is specified by the configFileAutoUpdateTimeUnit variable (see Step 6).
Available values are from 1 to 48.
8. If you have selected days in Step 6, set the time of the day when to initiate a configuration update
in the configFileAutoUpdateTimeOfDay variable.
The time of the day is based on the sntpTimeZoneString variable setting (see “Chapter 20 - SNTP
Settings” on page 271 for more details).
You must have a time server SNTP that is accessible and properly configured, or the automatic
configuration update feature may not work properly. It is assumed that you know how to configure
your SNTP server. If not, refer to your SNTP server’s documentation. You can also refer to “Chapter
20 - SNTP Settings” on page 271 for more details on how to configure the Mediatrix 4104 for a
SNTP server.
The configuration files are downloaded at the first occurrence of this value and thereafter at the
period defined by the configFileAutoUpdatePeriod variable. Let’s say for instance the automatic unit
configuration update is set with the time of day at 14h00 and the update period at every 2 days.
• If the automatic update is enabled before 14h00, the first update will take place the
same day at 14h00, then the second update two days later at the same hour, and so
on.
• If the automatic update is enabled after 14h00, the first update will take place the day
after at 14h00, then the second download two days later at the same hour, and so on.
Available values are -1, and from 0 to 23.
Setting the variable to -1 means that the time of the day at which the Mediatrix 4104 first downloads
the configuration files is randomly selected.
9. Set the configFileAutoUpdatePeriodicEnable variable to enable.
10. In the sysConfigMIB, set the sysConfigDownloadConfigFile variable to
automaticInitiateFileDownload.
The unit configuration is only updated if at least one parameter value defined in the downloaded
configuration files is different from the actual unit configuration.
If one of the telephones/faxes is off-hook, the Mediatrix 4104 will perform the update 5 minutes after
both ports are detected on-hook.
Error Handling
The following configuration file fetching service error sources are divided in three types depending on the
transfer protocol: common errors (Table 35), TFTP errors (Table 36) and HTTP errors (Table 37). The error
cause and the unit behaviour are also described.
Table 107: Configuration File Fetching Error Handling
Invalid file content The file contains invalid Send a syslog warning message including the
characters. Allowed characters file location/name, the transfer server address
are ASCII codes 10 (LF), and the invalid character (ASCII code):
13(CR), and 32 to 126. The fetched configuration file “XXX”,
from server “XXX”, has an invalid
character “ASCII code XXX”.
No recorded settings applied.
Invalid transfer server The server address is not valid. Send a syslog warning message including the
address transfer server address:
No configuration file is fetched
because the server host “XXX” is
invalid.
Set sysAdminDownloadConfigFileStatus to fail.
File size too big Downloading a file with a size Send a syslog warning message including the
exceeding 512000 bytes. file location/name, the transfer server address,
the file size and the maximum allowed size:
The fetched configuration file “XXX”,
from server “XXX”, has a size “XXX
bytes” that exceeds the maximum
allowed size “XXX bytes”.
Set sysAdminDownloadConfigFileStatus to fail.
Invalid encryption The configuration file cannot be Send a syslog warning message including the
decrypted. A badly encrypted file location/name and the transfer server
file is detected if the header or address:
the padding is invalid. The fetched configuration file \”%s\”,
from server \”%s\”, can not be
decrypted.
Management Server
You can set the Mediatrix 4104 so that it asks the management server to send it a configuration file.
Note: Downloading a configuration file from the management server can only be performed through the
TFTP protocol.
In the Unit Manager Network Administration Manual, refer to chapter Performing Actions on Mediatrix Units,
section Downloading a Configuration File.
Restarting
TFTP WRQ
TFTP ACK
TFTP Data
TFTP ACK
Management Server
TFTP ACK
Restarting
Error Handling
The following are possible error sources when updating the unit configuration using the management server.
The error cause and the unit behaviour are also described.
Table 108: Configuration File Error Handling with the Management Server
Empty file Committing an empty file. Send a syslog warning message including the
file name and the TFTP client address:
The configuration file “XXX” pushed to
the unit by the TFTP client “XXX” is
empty.
Invalid file content Committing a file that contains Send a syslog warning message including the
invalid characters. Allowed file name, the TFTP client address and the
characters are ASCII codes 10 invalid character (ASCII code):
(LF), 13(CR), and 32 to 126. The configuration file “XXX” pushed to
the unit by the TFTP client “XXX” has
an invalid character “ASCII code XXX”.
No recorded settings applied.
Invalid file format Committing a file with an invalid Send a syslog warning message including the
format. file name and the TFTP client address:
The configuration file “XXX” pushed to
the unit by the TFTP client “XXX” has
an invalid format.
No recorded settings applied.
Table 108: Configuration File Error Handling with the Management Server (Continued)
File size too big Downloading a file with a size Send a syslog warning message including the
exceeding 512000 bytes. file name, the TFTP client address, the file size
and the maximum allowed size:
The configuration file “XXX” from the
TFTP client “XXX” is not downloaded
because its size “XXX bytes” exceeds
the maximum allowed size “XXX bytes”.
Send error code 3 (disk full or allocation
exceeded) to the TFTP client.
Set sysAdminDownloadConfigFileStatus to fail
and send msTrapStatusConfigFile.
TFTP transfer error Received a TFTP error from the Send a syslog warning message including the
TFTP client. file name and the TFTP client address:
Error in the TFTP transfer of the
configuration file “XXX” from the TFTP
client “XXX”.
Set sysAdminDownloadConfigFileStatus to fail
and send msTrapStatusConfigFile.
TFTP transfer aborted The transfer was aborted while Send a syslog warning message including the
in progress by changing the file name and the TFTP client address:
value of sysConfigDownload The TFTP transfer of the configuration
ConfigMode or file “XXX” from the TFTP client “XXX”
sysConfigDownloadConfigFile. was aborted.
Set sysAdminDownloadConfigFileStatus to fail
and send msTrapStatusConfigFile.
File pulling not allowed A TFTP client is trying to read a Send a syslog informational message including
file from the unit. the file name and the TFTP client address:
The TFTP client “XXX” is trying to
pull the file “XXX” from the unit.
This is not allowed.
Send error code 2 (access violation) to the
TFTP client.
Syslog Messages
A syslog message is sent whenever it is impossible for the management server to download a configuration
file or when it is impossible to apply the new settings to the unit.
Table 109: Syslog Messages Using the Management Server
Warning The notification “XXX” could not A SNMP trap could not be sent to the
be sent to msHost “XXX” and management server. The syslog warning
msTrapPort XXX. message includes the SNMP trap number, the
management server address and port.
Informational Parameter values defined in the A downloaded configuration file was
configuration file were successfully committed.
successfully committed.
Restarting the unit...
Warning None of the parameter values No parameter value from the downloaded
defined in the configuration file configuration file was successfully applied (e.g.,
was successfully committed. because of bad OIDs).
The configuration file format uses XML (eXtensible Markup Language). The following is the accepted format:
Supported Characters
When creating and/or editing a configuration file, the following ASCII codes are supported:
10 LF, line feed 62 >, greater than 94 ^, caret
13 CR, carriage return 63 ?, question mark 95 _, underscore
32 space 64 @, commercial at 96 `, back quote
33 !, exclamation mark 65 A 97 a
34 ", double quote 66 B 98 b
35 #, hash 67 C 99 c
36 $, dollar 68 D 100 d
37 %, percent 69 E 101 e
38 &, ampersand 70 F 102 f
39 ', quote 71 G 103 g
40 (, open parenthesis 72 H 104 h
41 ), close parenthesis 73 I 105 i
42 *, asterisk 74 J 106 j
43 +, plus 75 K 107 k
44 ,, comma 76 L 108 l
45 -, minus 77 M 109 m
46 ., full stop 78 N 110 n
47 /, oblique stroke 79 O 111 o
48 0, zero 80 P 112 p
49 1 81 Q 113 q
50 2 82 R 114 r
51 3 83 S 115 s
52 4 84 T 116 t
53 5 85 U 117 u
54 6 86 V 118 v
55 7 87 W 119 w
56 8 88 X 120 x
57 9 89 Y 121 y
58 :, colon 90 Z 122 z
59 ;, semicolon 91 [, open square bracket 123 {, open curly bracket
60 <, less than 92 \, backslash 124 |, vertical bar
61 =, equals 93 ], close square bracket 125 }, close curly bracket
126 ~, tilde
13 Software Download
This chapter describes how to download a software version available on the designated software server into
the Mediatrix 4104.
You have the choice to perform the software download by using the TFTPor HTTP protocol. You can also
configure the Mediatrix 4104 to automatically update its software version.
You can also set these parameters via the web interface, as described in “Firmware Download” on page 49.
Before Downloading
To download a software, you may need to setup the following applications on your computer:
TFTP server with proper root path
MIB browser (with the current Mediatrix 4104 MIB tree)
You can use the MIB browser built in the Mediatrix’s Unit Manager Network. See “Unit Manager
Network – Element Management System” on page xxvi for more details.
Software upgrade zip file
SNTP server properly configured
HTTP server with proper root path
Syslog daemon (optional)
The Mediatrix 4104 must know the IP address and port number of its Primary and Secondary software servers.
These servers contain the files required for the software update. You can assign these information to the
Mediatrix 4104 through a DHCP server or manually enter them yourself in static variables.
In the Unit Manager Network Administration Manual, refer to chapter Administration Parameters, section
Software and Emergency Download.
DHCP Configuration
Using the DHCP configuration assumes that you have properly set your DHCP server with the relevant
information. See “Chapter 8 - IP Address and Network Configuration” on page 137 for more details.
See “Vendor and Site Specific DHCP Options” on page 150 for more details.
4. Set how you want to define the Secondary Image server information in the DHCP server.
Table 111: Secondary Image Server DHCP Information
See “Vendor and Site Specific DHCP Options” on page 150 for more details.
Static Configuration
Use the static configuration if you are not using a DHCP server or if you want to bypass it.
Variable Description
The default port value complies to RFC 1340 on the well-known ports (assigned numbers). This
value (69) applies to a TFTP server. It may be different for other servers. If you are using an HTTP
server, you must change the port value to 80.
Download Procedure
The following describes how to download a software version into the Mediatrix 4104.
Note: Configuration settings are not lost when upgrading the software to a newer version. However,
configuration settings may be lost if you upload an older firmware to the device. See “Software Downgrade”
on page 211 for more details.
You have the choice to perform the software download by using the TFTP or HTTP protocol. You can also
configure the Mediatrix 4104 to automatically update its software version.
In the Unit Manager Network Administration Manual, refer to chapter Administration Parameters, section
Software and Emergency Download.
Parameter Description
static Uses the directory specified in the imageLocation variable (see Step 2).
remoteFile The image location is defined in a file called “mediatrix4104targetimage.inf”. The
location of this file is defined in the imageSelectionFileLocation variable.
This is useful if you are using automatic updates with multiple units (see Step 3).
2. If you have set the imageLocationProvisionSource variable to static (see Step 1), configure the
path in the imageLocation variable.
This is the location of the “setup.inf” file that contains the list of the files to download into the
Mediatrix 4104. The “setup.inf” file and all the other files must be in the same directory. In other
words, this is the path from the root TFTP/HTTP folder down to the files extracted from the zip file.
Note that the path must contain a maximum of 63 characters.
3. If you have set the imageLocationProvisionSource variable to remoteFile (see Step 1):
a. Create a text file and write the path and/or name of the directory that contains the files required
for download. Save this file as “mediatrix4104targetimage.inf” under the server root path.
Note: If you leave the file empty, the Mediatrix 4104 will look for the software download information in the
root directory of the image server.
c:/root/download SIP_v5.0.1.1_MX-S5001-01
c:/ root/download/SIP_v5.0.1.1_MX-S5001-01
c:/root download/SIP_v5.0.1.1_MX-S5001-01
Syslog Messages
If you are using a Syslog daemon, you will receive messages that inform you of the software update status.
The following are the syslog messages the Mediatrix 4104 sends:
Table 115: Software Update Syslog Messages
General Messages
Informational The software update succeeded. The software update has been successful.
Error The software update failed. The software update experienced an error and
has not been completed.
Error The software update failed (xxx). An error occurs when updating the software,
internal error code provided.
Warning Primary image server not This error occurs when an image download is
specified, cannot download file: initiated and no domain name or address is
xxx specified for the primary image server.
Warning Secondary image server not When a request involving the primary server
specified, cannot download file: fails, the secondary server is tried.
xxx.
This error occurs when there is no address or
domain name specified for the secondary image
server.
Error Cannot resolve address of image A DNS request failed to resolve the domain
server: xxx. name of the image server (primary or
secondary).
Error Target image at location: xxx For periodic and automatic updates, the target
from host: xxx is invalid or image to download is first compared with the
corrupted. installed image. This error occurs when this
comparison failed because of corruption in the
target image files.
Informational Image download transfer When manual, periodic or “at restart” image
initiated. download is initiated.
Warning The file: xxx from host: xxx The selection file or “setup.inf” file received
exceeds the size limit. exceeds 10000 bytes.
Informational Target image at location: xxx For periodic and automatic updates, the target
from host xxx is identical to image to download is first compared with the
currently installed image. installed image. This message occurs when this
Transfer aborted. comparison determined that the target image is
identical to the installed image.
Error Image does not support hardware The software download failed because the
(error %d) software image is not compatible with the
hardware.
HTTP-Specific Messages
Warning HTTP image transfer of file: xxx The HTTP transfer was closed by the peer.
from host: xxx was closed by
peer.
Warning HTTP image transfer of file: xxx In the HTTP response, one of the following error
from host: xxx was closed due to occurred:
unsupported or malformed response
from the host.
• The protocol version is not 1.0 or
1.1.
• Some field or line is not properly
formatted.
• The trailing <crlf> is not present at
the end of the header.
• Unsupported kind of response.
Warning HTTP image transfer of file: xxx When receiving HTTP response #400 or #403.
from host: xxx was refused
because of a malformed or
incompatible request.
Warning HTTP image transfer of file: xxx When receiving HTTP response #500 or #501.
from host: xxx was refused
because of a server error.
Warning HTTP image transfer of file: xxx When receiving HTTP response #503.
from host: xxx was refused
because service is unavailable.
TFTP-Specific Messages
Warning Image transfer of file: xxx from Unexpected error, either internal or on a TFTP
host: xxx and port: xxx was or HTTP connection.
closed due to unexpected error
Warning Image transfer of file: xxx from When not receiving TFTP packets for 32
host: xxx port: xxx was closed seconds or not receiving a HTTP packet for 15
after timeout seconds.
Warning Image transfer. File: xxx not When receiving TFTP error “NOT FOUND” or
found on host: xxx HTTP response #404.
Warning Image transfer. Access to file: When receiving TFTP error “ACCESS” or HTTP
xxx on host: xxx is unauthorized response #401.
LED States
When the Mediatrix 4104 initiates a software download, the LEDs located on the front panel indicate the status
of the process.
Table 116: LED States in Software Download
Image downloading and writing Power, LAN, In Use and Ready LEDs blink alternately at 1 Hz with 1/4
ON duty cycle.
Warning: Do not turn the Mediatrix 4104 off while in this state.
Image download failed Power, LAN, In Use and Ready LEDs blink at the same time at 2 Hz with
50% ON duty cycle for 4 seconds.
See “LED Indicators” on page 12 for a detailed description of the LED patterns related to the software
download process.
MIB Variable
You can validate the result of the last software update by checking the state of the
sysAdminLastDownloadSoftware MIB variable.
In the Unit Manager Network Administration Manual, refer to chapter Performing Actions on Mediatrix Units,
section Downloading a Software Version.
Caution: Never shutdown the Mediatrix 4104 manually while in the download process, because the image
may be partially written and the Mediatrix 4104 is unable to restart.
The software download may take several minutes, depending on your Internet connection, network
conditions and servers conditions.
9. Update the MIB browser with the MIB version coming with the software version.
Caution: When downloading via HTTP, the image server’s port must be 80. You can query the actual port
assigned in the imagePrimaryPort and imageSecondaryPort read-only variables (in the ipAddressStatus
folder).
If you are using a DHCP server and it did not provide the proper port, reconfigure it with the proper port or
use a static configuration. See “Software Servers Configuration” on page 200 for more details.
Caution: Never shutdown the Mediatrix 4104 manually while in the download process, because the image
may be partially written and the Mediatrix 4104 is unable to restart.
The software download may take several minutes, depending on your Internet connection, network
conditions and servers conditions.
8. Update the MIB browser with the MIB version coming with the software version.
X To set the automatic update every time the Mediatrix 4104 restarts:
1. If not already done, setup the Image server used to download the software (see “Before
Downloading” on page 199).
2. If not already done, configure the Image path as described in “Setting up the Image Path” on
page 202.
3. If not already done, configure the image hosts and ports as defined in “Software Servers
Configuration” on page 200.
Caution: When downloading via HTTP, the image server’s port must be 80. You can query the actual port
assigned in the imagePrimaryPort and imageSecondaryPort read-only variables (in the ipAddressStatus
folder).
If you are using a DHCP server and it did not provide the proper port, reconfigure it with the proper port or
use a static configuration. See “Software Servers Configuration” on page 200 for more details.
Caution: When downloading via HTTP, the image server’s port must be 80. You can query the actual port
assigned in the imagePrimaryPort and imageSecondaryPort read-only variables (in the ipAddressStatus
folder).
If you are using a DHCP server and it did not provide the proper port, reconfigure it with the proper port or
use a static configuration. See “Software Servers Configuration” on page 200 for more details.
Parameter Description
minutes Updates the software every x minutes. You can specify the x value in
the variable imageAutoUpdatePeriod (see Step 7).
hours Updates the software every x hours. You can specify the x value in the
variable imageAutoUpdatePeriod (see Step 7).
days Updates the software every x days. You can specify the x value in the
variable imageAutoUpdatePeriod (see Step 7).
You can also define the time of day when to perform the update in the
imageAutoUpdateTimeOfDay variable (see Step 8).
7. Set the waiting period between each software update in the imageAutoUpdatePeriod variable.
The time unit for the period is specified by the imageAutoUpdateTimeUnit variable (see Step 6).
Available values are from 1 to 48.
8. If you have selected days in Step 6, set the time of the day when to initiate a software update in the
imageAutoUpdateTimeOfDay variable.
The time of the day is based on the sntpTimeZoneString variable setting (see “Chapter 20 - SNTP
Settings” on page 271 for more details).
You must have a time server SNTP that is accessible and properly configured, or the automatic
software update feature may not work properly. It is assumed that you know how to configure your
SNTP server. If not, refer to your SNTP server’s documentation. You can also refer to “Chapter 20
- SNTP Settings” on page 271 for more details on how to configure the Mediatrix 4104 for a SNTP
server.
The software is downloaded at the first occurrence of this value and thereafter at the period defined
by the imageAutoUpdatePeriod variable. Let’s say for instance the automatic software download is
set with the time of day at 14h00 and the update period at every 2 days.
• If the automatic download is enabled before 14h00, the first download will take place
the same day at 14h00, then the second download two days later at the same hour,
and so on.
• If the automatic download is enabled after 14h00, the first download will take place the
day after at 14h00, then the second download two days later at the same hour, and so
on.
Available values are -1, and from 0 to 23. Setting the variable to -1 means that the time of the day
at which the Mediatrix 4104 first initiates a software download is randomly selected.
9. Set the imageAutoUpdateEnable variable to enable.
If one of the telephones/faxes is off-hook, the Mediatrix 4104 will perform the download five minutes
after both ports are detected on-hook.
Note: When using the Mediatrix 4104, Mediatrix recommends to disable the Spanning Tree Protocol on the
network to which the unit is connected.
Software Downgrade
It is possible to downgrade a Mediatrix 4104 from the current version (for instance, v5.0rx.x) to an older version
(for instance, v4.4rx.x).
Note: If you perform a default reset on the Mediatrix 4104, you must download the current version into the
unit before performing the software downgrade procedure.
If the software download is suddenly interrupted, it may not be complete. Without any protection against this
situation, the Mediatrix 4104 is not functional.
A transfer may be interrupted for the following reasons:
An electrical shortage.
The user of the Mediatrix 4104 can accidentally power off the unit.
Depending on the moment when the software download has been interrupted, the emergency software
procedure (also called rescue application) can automatically start a new software download to repair the
software if it has been corrupted by the interruption. However, there is a small but critical time frame during
which unrecoverable errors could happen. This is why it is very important that the unit is not turned off during
software downloads.
7. If the emergency software download still fails, the Mediatrix 4104 tries to initiate the software
download again by doubling the delay between each attempt up to a maximum of 16 minutes:
• first attempt: 1 minute delay
• second attempt: 2 minutes delay
• third attempt: 4 minutes delay
• fourth attempt: 8 minutes delay
• fifth attempt: 16 minutes delay
• sixth attempt: 16 minutes delay
• etc.
This procedure continues until the software download completes successfully. The software
download can fail if the software server cannot be reached or if the software directory is not found
on the software server.
14 Line Configuration
This chapter describes the features available on the lines connected to the Mediatrix 4104.
For information on voice codecs, see “Chapter 15 - Voice Transmissions” on page 221.
For information on data codecs, see “Chapter 16 - Fax Transmission” on page 237.
You can independently set the administrative state of each analog line of your Mediatrix 4104. This state
determines how the Mediatrix 4104 processes calls.
For instance, you must properly unlock the four analog lines of the Mediatrix 4104 to properly make and
receive calls on all of them.
The administrative states may be applied in two ways:
Temporary: The administrative state is applied immediately, but it is not kept after the Mediatrix
4104 restarts.
Permanent: When the Mediatrix 4104 restarts, it reads a MIB variable to determine the
administrative state defined for each analog line.
In the Unit Manager Network Administration Manual, refer to chapter Ports Parameters, section Port
Configuration Window.
You can also set these parameters via the web interface, as described in “Interface Management” on page 30.
Setting Description
Setting Description
You can specify whether a line should remain enabled or not when not registered. This is useful if you want
your users to be able to make calls even if the line is not registered with the SIP server.
This feature is currently located under the mediatrixExperimental branch of the MIB structure. See “MIB
Structure” on page 131 for more details.
Value Description
disablePort When the line is not registered, it is disabled. The user cannot make or
receive calls. Picking up the handset yields a fast busy tone, and incoming
INVITEs receive a “403 Forbidden” response.
enablePort When the line is not registered, it is still enabled. The user can receive and
initiate outgoing calls. Note that because the line is not registered to a
registrar, its public address is not available to the outside world; the line will
most likely be unreachable except through direct IP calling.
The flash hook can be described as quickly depressing and releasing the plunger in or the actual handset-
cradle to create a signal indicating a change in the current telephone session. Services such as picking up a
call waiting, second call, call on hold, and conference are triggered by the use of the flash hook.
A flash hook is detected when the hook switch is pressed for a shorter time than would be required to be
interpreted as a hang-up.
Using the “flash” button that is present on many standard telephone handsets can also trigger a flash hook.
The Mediatrix 4104 allows you to set the minimum and maximum time within which pressing and releasing the
plunger is actually considered a flash hook.
Variable Description
2. Restart the Mediatrix 4104 so that the changes may take effect.
The source line selection feature defines a list of callers that have the right to use a specific FXS line to make
a call. This feature can be used to map an FXS line to a specific FXO line of a gateway such as the Mediatrix
1204. See “Examples of Source Line Selection Use” on page 216 for more details.
Loop Current
When one of its analog lines goes off-hook, the Mediatrix 4104 controls the line in a fixed loop current mode.
The value of the loop current can be modified through the MIB.
Note that the actual measured current may be different than the value you set, because it varies depending
on the DC impedance. This is illustrated in Figure 75 for a loop current of 32 mA.
40
30
Loop Current
20
(mA)
10
0
-60 -50 -40 -30 -20 -10 0
DC Impedance (Vdc)
This feature determines whether call clearing occurs as soon as the called user is the first to hang up a
received call or after a user-defined delay.
This feature allows to emulate the behaviour of some SCNs that delay the ending of a call when the callee
hangs up first.
When the feature is activated, hanging up on a received call will not terminate the call right away. Instead, the
connection will remain active for a user-defined amount of time. If the callee picks up the phone before the
expiration of that delay, he is still in communication with the caller (assuming the caller has not already hung
up).
Note: This feature is effective only when the user is the called party. When the user acts as the calling party,
the call ends as soon as the user hangs up. It is also effective only with a single active call. Callee hang-up
supervision has no effect when the callee hangs up with a call on hold, wants to perform a call transfer, or
if he is the initiator of a three-way conference call.
Line Reversal
Two options are available to determine how the line polarity is used to signal the beginning and end of a call.
They are used because of an inability by some customer's CPE to react to busy tone. When one of the options
is activated, it replaces the default behaviour of the Mediatrix 4104, which is to briefly remove power from the
line to signal that the remote party has hung up.
Parameter Description
You can instruct the Mediatrix 4104 to blank out the name portion of the received caller ID whenever
“anonymous” (case insensitive) is used to identify the originator of the call before the caller ID data is sent to
the telephone. If the variable is not activated, the anonymous string is passed on to the telephone and
displayed to identify the calling party.
15 Voice Transmissions
This chapter describes the various codecs the Mediatrix 4104 supports for transmitting audio signals.
You can also set some of these parameters via the web interface, as described in “Voice & Fax Codecs” on
page 76.
Codec Descriptions
The four lines of the Mediatrix 4104 can simultaneously use the same codec (for instance, G.711 PCMA), or
a mix of any of the supported codecs. Set and enable these codecs for each line.
Table 123: Codecs Comparison
Feature Description
Analog Modem
The Mediatrix 4104 can send modem transmissions in clear channel (G.711). If configured adequately,
modems with higher rate capabilities (for instance, V.90) will automatically fall back in the transmission range
supported.
Quality of modem transmissions is dependent upon the system configuration, quality of the analog lines, as
well as the number of analog-to-digital and digital-to-analog conversions. Modem performance may therefore
be reduced below the optimum values stated above.
G.726
Specified in ITU-T Recommendation G.726: 40, 32, 24, 16 kbit/s adaptive differential pulse code modulation
(ADPCM). It describes the algorithm recommended for conversion of a single 64 kbit/s A-law or U-law PCM
channel encoded at 8000 samples/sec to and from a 40, 32, 24, or 16 kbit/s channel. The conversion is applied
to the PCM stream using an Adaptive Differential Pulse Code Modulation (ADPCM) transcoding technique.
Table 125: G.726 Features
Feature Description
Analog Modem
The Mediatrix 4104 can send modem transmissions in clear channel (G.726). If configured adequately,
modems with higher rate capabilities (for instance, V.90) will automatically fall back in the transmission range
supported
Quality of modem transmissions is dependent upon the system configuration, quality of the analog lines, as
well as the number of analog-to-digital and digital-to-analog conversions. Modem performance may therefore
be reduced below the optimum values stated above.
G.723.1
Specified in ITU-T Recommendation G.723.1, dual-rate speech coder for multimedia communications
transmitting at 5.3 kbit/s and 6.3 kbit/s. This Recommendation specifies a coded representation that can be
used to compress the speech signal component of multi-media services at a very low bit rate. The audio is
encoded in 30 ms frames.
A G.723.1 frame can be one of three sizes: 24 octets (6.3 kb/s frame), 20 octets (5.3 kb/s frame), or 4 octets.
These 4-octet frames are called SID frames (Silence Insertion Descriptor) and are used to specify comfort
noise parameters.
Table 126: G.723.1 Features
Feature Description
G.729
Specified in ITU-T Recommendation G.729, coding of speech at 8 kbit/s using conjugate structure-algebraic
code excited linear prediction (CS-ACELP). For all data rates, the sampling frequency (and RTP timestamp
clock rate) is 8000 Hz.
A voice activity detector (VAD) and comfort noise generator (CNG) algorithm in Annex B of G.729 is
recommended for digital simultaneous voice and data applications; they can be used in conjunction with G.729
or G.729 Annex A. A G.729 or G.729 Annex A frame contains 10 octets, while the G.729 Annex B comfort
noise frame occupies 2 octets.
The Mediatrix 4104 supports G.729A and G.729AB for encoding and G.729, G.729A and G.729AB for
decoding.
Table 127: G.729 Features
Feature Description
Preferred Codec
The preferred codec is the codec you want to favour during negotiation.
In the Unit Manager Network Administration Manual, refer to chapter Ports Parameters, section Port
Configuration Window.
Enabling individual codecs allows you to define codecs that can be considered during negotiation. If codecs
are disabled, they are not considered.
2. If you have enabled one or more of the G.726 codecs, set the G.726 actual RTP dynamic payload
type used in an initial offer in one or more of the following variables:
• voiceIfCodecG72616kbpsPayloadType: The default value is 97.
• voiceIfCodecG72624kbpsPayloadType: The default value is 98.
• voiceIfCodecG72632kbpsPayloadType: The default value is 99.
• voiceIfCodecG72640kbpsPayloadType: The default value is 100.
The payload types available are as per RFC 3551. The values range from 96 to 127.
Note: When selecting the dynamic payload type, make sure that the value is not already used by another
dynamic codec. If a value between 96 and 127 is refused, this means it is already used by another dynamic
codec.
3. Restart the Mediatrix 4104 so that the changes may take effect.
Packetization Time
The packetization time (also called packetization period or ptime) is the duration, in ms, of the voice packet.
G.726
voiceIfCodecG72616kbpsMin Shortest packetization period allowed for the 10-100, with increments
PTime G.726-16kbps codec. Authorized values start of 10
at 10 ms and come in discrete steps of 10 ms
up to the one specified by the
voiceIfCodecG72616kbpsMaxPTime variable.
Default Value: 10
voiceIfCodecG72616kbpsMax Longest packetization period allowed for the 10-100, with increments
PTime G.726-16kbps codec. Authorized values go up of 10
to 100 ms, in discrete steps of 10 ms, and start
at the one specified by the
voiceIfCodecG72616kbpsMinPTime variable.
Default Value: 100
voiceIfCodecG72624kbpsMin Shortest packetization period allowed for the 10-100, with increments
PTime G.726-24kbps codec. Authorized values start of 10
at 10 ms and come in discrete steps of 10 ms
up to the one specified by the
voiceIfCodecG72624kbpsMaxPTime variable.
Default Value: 10
voiceIfCodecG72624kbpsMax Longest packetization period allowed for the 10-100, with increments
PTime G.726-24kbps codec. Authorized values go up of 10
to 100 ms, in discrete steps of 10 ms, and start
at the one specified by the
voiceIfCodecG72624kbpsMinPTime variable.
Default Value: 100
voiceIfCodecG72632kbpsMin Shortest packetization period allowed for the 10-100, with increments
PTime G.726-32kbps codec. Authorized values start of 10
at 10 ms and come in discrete steps of 10 ms
up to the one specified by the
voiceIfCodecG72632kbpsMaxPTime variable.
Default Value: 10
voiceIfCodecG72632kbpsMax Longest packetization period allowed for the 10-100, with increments
PTime G.726-32kbps codec. Authorized values go up of 10
to 100 ms, in discrete steps of 10 ms, and start
at the one specified by the
voiceIfCodecG72632kbpsMinPTime variable.
Default Value: 100
voiceIfCodecG72640kbpsMin Shortest packetization period allowed for the 10-100, with increments
PTime G.726-40kbps codec. Authorized values start of 10
at 10 ms and come in discrete steps of 10 ms
up to the one specified by the
voiceIfCodecG72640kbpsMaxPTime variable.
Default Value: 10
voiceIfCodecG72640kbpsMax Longest packetization period allowed for the 10-100, with increments
PTime G.726-40kbps codec. Authorized values go up of 10
to 100 ms, in discrete steps of 10 ms, and start
at the one specified by the
voiceIfCodecG72640kbpsMinPTime variable.
Default Value: 100
G.729
voiceIfCodecG729MinPTime Shortest packetization period allowed for the 10-100, with increments
G.729 codec. Authorized values start at 10 ms of 10
and come in discrete steps of 10 ms up to the
one specified by the
voiceIfCodecG729MaxPTime variable.
Default Value: 10
voiceIfCodecG729MaxPTime Longest packetization period allowed for the 10-100, with increments
G.729 codec. Authorized values go up to of 10
100 ms, in discrete steps of 10 ms, and start at
the one specified by the
voiceIfCodecG729MinPTime vartiable.
Default Value: 100
Note: The packetization time is not negotiated between endpoints, so a minimum and a maximum don't
make much sense. The selected value is the default RTP value (20 ms for G.711, G.726, and G.729.AB, 30
ms for G.723) if it is included in the range delimited by the minimum and maximum. Otherwise, it is the
minimum.
inBand The DTMFs are transmitted like the voice in the RTP
stream.
DTMF out-of-band
Certain compression codecs such as G.723.1 and G.729 effectively distort voice because they lose
information from the incoming voice stream during the compression and decompression phases. For
normal speech this is insignificant and becomes unimportant. In the case of pure tones (such as DTMF)
this distortion means the receiver may no longer recognize the tones. The solution is to send this
information as a separate packet to the other endpoint, which then plays the DTMF sequence back by re-
generating the true tones. Such a mechanism is known as out-of-band DTMF. The Mediatrix 4104
receives and sends out-of-band DTMFs as per ITU Q.24. DTMFs supported are 0-9, A-D, *, #.
outOfBandUsingRtp The DTMFs are transmitted as per RFC 2833 (see “DTMF
Payload Type” on page 229 for additional information).
outOfBandUsingSignalingProtocol The DTMFs are transmitted as per draft-choudhuri-sip-info-
digit-00.txt (see “DTMF Transport Using SIP INFO” on
page 228 and “DTMF Transport over the SIP Protocol” on
page 230 for more details).
Note: This feature and the Hook Flash processing feature
via signalling protocol are totally independent. Activating
one of these features has no effect on the other. See “Hook
Flash Processing” on page 302 for more details.
signalingProtocolDependent The signalling protocol has the control to select the DTMF
transport mode. The SDP body includes both RFC 2833
and draft-choudhuri-sip-info-digit-00.txt in that order of
preference.
You can use the SIP INFO method to collect and transport DTMFs. The collection process is regarded as
being an unsolicited one-character timer-less digit collection.
When the feature is enabled:
The Mediatrix 4104 sends a separate SIP INFO method every time a digit is entered during the
call.
The Mediatrix 4104 plays each DTMF sent in a separate message upon receiving a valid SIP
INFO message.
When selecting the outOfBandUsingRtp DTMF transport mode (see “DTMF Transport Type” on page 227 for
more details), you can determine the actual RTP dynamic payload type used for the “telephone-event” in an
initial offer. The payload types available are as per RFC 1890.
You can define which events will be relayed via RFC 2833. This could be very useful in a Remote Line
Extension scenario, as described in “Remote Line Extension” on page 305.
Parameter Description
enable Conformance is enforced and support for RFC 2833 implies the support of basic
telephony-events. When setting the variable voiceIfDtmfTransport to
outOfBandUsingRtp (“DTMF Transport Type” on page 227), or the variable
telephonyAttributesHookFlashProcessing to outOfBandUsingRtp (“Hook Flash
Processing” on page 302), the Mediatrix 4104 will advertise the support for events
0-15; it will assume support for events 0-15 when support for RFC 2833 is received
in an announcement.
disable This creates a deliberate deviance to RFC 2833 as support of basic events is not
automatic. The variables voiceIfDtmfTransport and
telephonyAttributesHookFlashProcessing then act independently to specify which
events will be relayed via RFC 2833. If Hook Flash relay is enabled by itself, support
of event 16 alone will be advertised; if both Hook Flash and DTMF relay are
activated, events 0-16 are supported.
You can select the method used to transport DTMFs out-of-band over the SIP protocol.
This feature is effective only if the voiceIfDtmfTransport variable is set to outOfBandUsingSignalingProtocol
(see “DTMF Transport Type” on page 227 for more details).
Method Description
3. Set the DTMF duration sent in the INFO message when using the infoDtmfRelay method to
transmit DTMFs in the sipInteropDtmfTransportDuration variable.
This value is expressed in milliseconds (ms). The default value is 100 ms.
4. In the analogScnGwMIB, set the DTMF duration when using the infoDtmfRelay method to receive
DTMFs in the analogScnGwDtmfDuration variable.
This is the duration, in milliseconds (ms), a DTMF is played when dialing the destination phone
number.
5. Set an inter-digit dial delay in the analogScnGwInterDigitDial Delay variable.
This is the delay, in milliseconds (ms), between two DTMFs when dialing the destination phone
number. This is useful when the Mediatrix 4104 receives DTMFs out-of-band faster than it can
signal them.
6. Restart the Mediatrix 4104 so that the changes may take effect.
The jitter buffer allows better protection against packet loss, but increases the voice delay. If the network to
which the Mediatrix 4104 is connected suffers from a high level of congestion, the jitter buffer protection level
should be higher. If the network to which the Mediatrix 4104 is connected suffers from a low level of
congestion, the jitter buffer protection level should be lower.
Note: You cannot disable the adaptative jitter buffer on the Mediatrix 4104. However, if you set the
voiceIfTargetJitterBufferLength and voiceIfMaxJitterBufferLength variables to the same value, you will have
a non-adaptative jitter buffer.
The Voice Activity Detection (VAD) defines how the Mediatrix 4104 sends information pertaining to silence.
This allows the unit to detect when the user talks, thus avoiding to send silent RTP packets. This saves on
network resources. However, the VAD may affect packets that are not really silent (for instance, cut sounds
that are too low). The VAD can thus slightly affect the voice quality.
In the Unit Manager Network Administration Manual, refer to chapter Ports Parameters, section Port
Configuration Window.
Setting Description
The difference between transparent and conservative is how “aggressive” the algorithm considers
something as an inactive voice and how “fast” it stops the voice stream. A setting of conservative is
a little bit more aggressive to react to silence compared to a setting of transparent.
The default value is conservative.
3. Restart the Mediatrix 4104 so that the changes may take effect.
G.729 VAD
G.729 has a built-in VAD in its Annex B version. It is recommended for digital simultaneous voice and data
applications and can be used in conjunction with G.729 or G.729 Annex A. A G.729 or G.729 Annex A frame
contains 10 octets, while the G.729 Annex B frame occupies 2 octets. The CN packets are sent in accordance
with annex B of G.729.
Setting Description
disable G.729 uses annex A only. The Mediatrix 4104 does not send G.729 Annex B
comfort noise frames.
enable G.729 annex A is used with annex B. The Mediatrix 4104 sends G.729 Annex
B comfort noise frames during silence periods.
Echo Cancellation
Echo cancellation eliminates the echo effect caused by signal reflections. An echo is a signal that has been
reflected or otherwise returned with enough magnitude and delay to be perceived. The echo cancellation is
usually an active process in which echo signals are measured and cancelled or eliminated by combining an
inverted signal with the echo signal.
You can disable the echo cancellation feature of the Mediatrix 4104, which may be useful to ensure the
success of some modem transmissions.
Parameter Description
disable The DSP does not use echo cancellation on the related port.
enable The DSP proceeds to cancel signals that are recognized as echo when
appropriate. This is the default value.
Comfort Noise
Standards Supported • RFC 3389: Real-time Transport Protocol (RTP) Payload for
Comfort Noise (CN)
Comfort Noise (CN) defines how the Mediatrix 4104 processes silence periods information it receives.
Note: Comfort noise only applies to the G.711 and G.726 codecs. G.723 and G.729 CNG is not
configurable because it is part of the codec.
During silence periods, the Mediatrix 4104 may receive CN packets containing information about background
noise. When enabling Comfort Noise Generation (CNG), those packets are used to generate local comfort
noise.
Setting Description
3. Restart the Mediatrix 4104 so that the changes may take effect.
User Gain
The user gain allows you to modify the input and output sound level of the Mediatrix 4104.
Caution: Use these settings with great care. Mediatrix recommends not to modify the user gain variables
unless absolutely necessary because default calibrations may not be valid anymore.
Modifying user gains may cause problems with DTMF detection and voice quality – using a high user gain
may cause sound saturation (the sound is distorted). Furthermore, some fax or modem tones may not be
recognized anymore. The user gains directly affect the fax communication quality and may even prevent a
fax to be sent.
You can compensate with the user gain if there is no available configuration for the country in which the
Mediatrix 4104 is located. Because the user gain is in dB, you can easily adjust the loss plan (e.g., if you need
an additional 1 dB for analog to digital, simply put 1 for user gain input).
In the Unit Manager Network Administration Manual, refer to chapter Ports Parameters, section Port
Configuration Window.
16 Fax Transmission
This chapter describes how to perform fax transmissions in clear channel and T.38 with the Mediatrix 4104.
You can also set some of these parameters via the web interface, as described in “Voice & Fax Codecs” on
page 76.
Introduction
The Mediatrix 4104 handles G3 fax transmissions at speeds up to 14.4 kbps. Automatic fax mode detection
is standard on all lines. Real-Time Fax Over UDP with the T.38 protocol stack is also available.
The quality of T.38 fax transmissions depends upon the system configuration, type of call control system used,
type of Mediatrix units deployed, as well as the model of fax machines used. Should some of these conditions
be unsatisfactory, performance of T.38 fax transmissions may vary and be reduced below expectations.
A fax call works much like a regular voice call, with the following differences:
1. The fax codec may be re-negotiated by using a re-INVITE.
2. The goal of the re-INVITE is to allow both user agents to agree on a fax codec, which is either:
a. Clear channel (PCMU/PCMA or G.726) without Echo Cancellation nor Silence Suppression
(automatically disabled).
b. T.38.
3. Upon fax termination, if the call is not BYE, the previous voice codec is recovered with another re-
INVITE.
All lines of the Mediatrix 4104 can simultaneously use the same codec (for instance, T.38), or a mix of any of
the supported codecs. Set and enable these codecs for each line.
You can enable the fax calling tone (CNG tone) detection.
The Mediatrix 4104 can send faxes in clear channel. The following is a clear channel fax call flow:
INVITE
[…] […]
m=audio 5004 RTP/AVP 18 0 13 m=audio 5006 RTP/AVP 18 0 13
a=rtpmap:18 G729/8000 a=rtpmap:18 G729/8000
a=rtpmap:0 PCMU/8000 a=rtpmap:0 PCMU/8000
200 OK
Ringing/Trying
ACK
User User
Agent RTP=PCMU (Echo Cancellation + Silence Suppression = disabled)
Agent
#1 #2
No re-INVITE!!
y There is no need for a re-INVITE since the far end already supports the
data codec (PCMU).
y When your SDP capabilities are inserted in a SIP packet, it implies that
you can receive any of these capabilities at any given time without notice.
y In this case, both ends should switch to clear channel automatically upon
detection of the fax transmission.
Fax is terminated
BYE
200 OK
Note: In clear channel, G.726 at 16 kbs and 24 kbs are not available for fax transmission.
Note: If you want to set the G.726 codec at 32 kbs or at 40 kbs as the preferred clear channel codec, you
must also select the corresponding G.726 codec as the preferred voice codec as described in “Preferred
Codec” on page 223. Otherwise, the Mediatrix 4104 will fail to switch to the G.726 codec for clear channel
faxes because G.726 is not negotiated.
It has an impact only if a codec other than PCMU, or PCMA or G.726 is chosen in the
voiceIfCodecPreferred variable (see “Preferred Codec” on page 223). For instance, if G.729 is the
preferred voice codec, then PCMU, and PCMA and G.726 are ordered following the
dataIfClearChannelCodecPreferred setting.
Clear channel faxes use the negotiated codec, regardless of the setting applied to
dataIfClearChannelCodecPreferred.
Mediatrix suggests to use pcma if you are located in Europe and pcmu anywhere else. However,
you should check first which codec is supported in your telephone network.
T.38 Fax
T.38 fax relay is a real-time fax transmission; that is, two fax machines communicating with each other as if
there were a direct phone line between the two. T.38 is called a fax relay, which means that instead of sending
inband fax signals, which implies a loss of signal quality, it sends those fax signals out-of-band in a T.38
payload, so that the remote end can reproduce the signal locally.
The Mediatrix 4104 can send faxes in T.38 mode over UDP or TCP. T.38 is used for fax if both units are T.38
capable; otherwise, transmission in clear channel over G.711 as defined is used (if G.711 µ-law and/or G.711
A-law are enabled). If no clear channel codecs are enabled and the other endpoint is not T.38 capable, the fax
transmission fails.
Caution: The Mediatrix 4104 opens the T.38 channel only after receiving the “200 OK” message from the
peer. This means that the Mediatrix 4104 cannot receive T.38 packets before receiving the “200 OK”. Based
on RFC 3264, the T.38 channel should be opened as soon as the unit sends the “INVITE” message. See
“Fax Issues” on page 333 for more details.
In the Unit Manager Network Administration Manual, refer to chapter Ports Parameters, section Port
Configuration Window.
INVITE
[…] […]
m=audio 5004 RTP/AVP 0 18 8 m=audio 5006 RTP/AVP 0 18 8
a=rtpmap:0 PCMU/8000 a=rtpmap:0 PCMU/8000
a=rtpmap:18 G729/8000 a=rtpmap:18 G729/8000
a=rtpmap:8 PCMA/8000 a=rtpmap:8 PCMA/8000
200 OK
Ringing/Trying
ACK
Fax is terminated
INVITE
[…] […]
m=audio 5004 RTP/AVP 0 18 8 m=audio 5006 RTP/AVP 0 18 8
a=rtpmap:0 PCMU/8000 a=rtpmap:0 PCMU/8000
a=rtpmap:18 G729/8000 a=rtpmap:18 G729/8000
a=rtpmap:8 PCMA/8000 a=rtpmap:8 PCMA/8000
200 OK
Trying
ACK
BYE
200 OK
T.38 No-Signal
You can set the Mediatrix 4104 to send no-signal packets during a T.38 fax transmission. The Mediatrix 4104
sends no-signal packets if no meaningful data have been sent for a user-specified period of time.
17 Bypass Configuration
The Mediatrix 4104 may have an optional RJ-11 connector used to connect to a standard SCN line, called
Bypass. It allows its users to maintain telephone services in the event of a power outage or network failure.
During normal operation, the SCN line connected to the Bypass connector is switched out of the circuit through
commuting relays. The Bypass connector can be activated by two different conditions:
When power is removed from the Mediatrix 4104.
When the IP network is down.
This is indicated by the In Use LED being steady ON (except when the power is removed). If one of these
conditions is met, a phone/fax used on FXS connector 1 is directly connected to the SCN Bypass line. FXS
connector 1 stays in Bypass connection until:
The error conditions have been cleared.
The device connected to it is on-hook and a delay has elapsed.
Standard Bypass
The following describes how to enable/disable the standard Bypass feature.
Value Description
disable The line with the bypass service is never redirected on the bypass line except
when there is a power failure.
enable When the line with the bypass service is unusable (ifAdminUsageState is idle-
unusable), it is redirected to the bypass line. When this line becomes usable
again (ifAdminUsageState is idle), the redirection is stopped within 10
seconds if the bypass line is unused or 10 seconds after the termination of
the call.
Note: The control of the bypass service is only possible when the unit is powered on. When power is off,
the bypass service is always enabled.
This chapter defines how to configure the SIP-specific features to properly use the SIP signalling programs
and information defined in Mediatrix’ SIP stack.
User Agents
A user agent is a logical entity that can act as both client and server for the duration of a dialog. Each line (also
known as endpoint) of the Mediatrix 4104 is a user agent.
You can set information for each user agent such as its telephone number and friendly name. This information
is used to dynamically create the To, From and Contact headers used in the request the user agent sends.
These headers make up the caller ID information that is displayed on telephones/faxes equipped with a proper
LCD display. See “Caller ID Information” on page 171 for more details.
Most of the variables related to the user agents are located in tables. You can display and define the
information for all lines. You can also use these tables to create/edit five user names and passwords per line.
This means that:
Rows 1-5 of the table are reserved for line 1.
Rows 6-10 of the table are reserved for line 2.
etc.
If you want to enter a user name for the second line, you must do so in the sixth row of the table. If you want
to enter a user name for the third line, you must do so in the eleventh row of the table, and so on.
Before changing a parameter value, build its corresponding table with your MIB browser’s table functionality.
Depending on the MIB browser you are using, the tables may not appear the same way.
In the Unit Manager Network Administration Manual, refer to chapter Signalling Protocols Parameters, section
SIP Configuration Window.
You can also set these parameters via the web interface, as described in “SIP User Agent” on page 64.
The User-Agent header field contains information about the user agent client originating the request. For
instance, the information of the User-Agent header could be something like the following:
User-Agent: Softphone Beta1.5
You can specify whether or not the Mediatrix 4104 sends this information when establishing a communication.
Session Timers
The session timer extension allows to detect the premature end of a call caused by a network problem or a
peer’s failure by resending an INVITE at every n seconds.
A successful response (200 OK) to this INVITE indicates that the peer is still alive and reachable. A timeout
to this INVITE may mean that there are problems in the signalling path or that the peer is no longer available.
In that case, the call is shut down by using normal SIP means.
You can select the version of the session timer draft that the Mediatrix 4104 uses. Session timer versions other
than those provisioned may not work because of backward compatibility issues between the versions.
This feature is currently located under the mediatrixExperimental branch of the MIB structure. See “MIB
Structure” on page 131 for more details.
The Mediatrix 4104 supports the following session timer versions:
Table 139: Session Timer Versions Supported
Version Description
sessionTimer04 The Mediatrix 4104 uses the session timer extension as described in the now expired
draft-ietf-sip-session-timer-04.txt. Its use is deprecated. You should use this setting for
backwards compatibility issues only.
sessionTimer08 The Mediatrix 4104 uses the session timer extension as described in the more recent
draft-ietf-sip-session-timer-08.txt. This draft version contains several enhancements over
the previous ones, including the use of the Min-SE header. Use this setting if you do not
need to interoperate with session timer v4-enabled parties.
Background Information
The following explains how the session timers are used.
Authentication
Authentication information allows you to add some level of security to the Mediatrix 4104 lines by setting user
names and passwords. You can add two types of authentication information:
line-specific authentication
unit authentication
When a realm requests authentication, the line-specific authentication is tried first, and then the unit
authentication if required.
You can also set these parameters via the web interface, as described in “SIP Authentication” on page 68.
Line-Specific Authentication
You can define up to five user names and five passwords for each line of the Mediatrix 4104. A line can thus
register with five different realms. Keep in mind that:
Rows 1-5 of the table where you define the user names and passwords are reserved for line 1.
Rows 6-10 of the table where you define the user names and passwords are reserved for line 2.
etc.
For instance, to enter a user name for the second line, you must do so in the sixth row of the table. To enter
a user name for the third line, you must do so in the eleventh row of the table, and so on.
Variable Description
sipUAAuthRealm When authentication informations are required from users, the realm
identifies who requested the information.
sipUAAuthUsername A string that uniquely identifies this endpoint in the realm, used for
authentication purposes. The user name always maps to a password.
sipUAAuthPassword User password.
sipUAAuthValidateReal When set to disable, the current user credentials are valid for any
m realm. When set to enable, the user credentials are used only for a
specific realm set in the sipUAAuthRealm variable.
Unit Authentication
You can define up to five user names and five passwords for the Mediatrix 4104. These user names and
passwords apply to all lines of the unit.
In the Unit Manager Network Administration Manual, refer to chapter Signalling Protocols Parameters, section
SIP Authentication.
Variable Description
sipUnitAuthRealm When authentication informations are required from users, the realm
identifies who requested the information.
sipUnitAuthUsername A string that uniquely identifies this endpoint in the realm, used for
authentication purposes. The user name always maps to a
password.
sipUnitAuthPassword User password.
sipUnitAuthValidateReal When set to disable, the current unit credentials are valid for any
m realm. When set to enable, the unit credentials are used only for a
specific realm set in the sipUnitAuthRealm variable.
Parameter Description
auth The SIP User Agent applies authentication only. This is the default value.
Parameter Description
auth-int The SIP User Agent applies authentication with integrity protection (see
RFC 2617).
2. Restart the Mediatrix 4104 so that the changes may take effect.
You can configure the Mediatrix 4104 so that it only accepts SIP messages coming from one of six trusted IP
addresses. All other SIP messages are ignored. This source address validation takes place at the IP level and
does not depend on the SIP header or body.
NAT Traversal
The Mediatrix 4104 may be used in a private domain that is not directly connected to the IP network. For
instance, this may be the case for ITSP (Internet Telephony Service Provider) clients that have a small private
network. This private network is connected to the public IP network through the NAT (Name Address
Translation) technology.
Currently only one Mediatrix unit can be deployed behind a standard NAT.
You can configure the Mediatrix 4104 with the public IP address of the NAT system, which allows to reach the
unit. SIP packets sent by the Mediatrix 4104 contain the NAT address configured as SIP contact. If the NAT
service is not activated, the real IP address of the Mediatrix 4104 is used.
This method is recommended when the public IP address of the NAT system is static or does not change
regularly since it would cause downtime until it is changed manually.
Note: If you want to do NAT traversal, you cannot use a PPPoE connection.
2. Enter the public IP address of the NAT system in the localHostStaticWanAddress variable.
This is the public IP address used as Contact address by outgoing SIP packets crossing a NAT
system.
You can globally set the transport type for all the lines of the Mediatrix 4104 to either UDP (User Datagram
Protocol) or TCP (Transmission Control Protocol). The Mediatrix 4104 will include its supported transports in
its registrations.
Please note that RFC 3261 states the implementations must be able to handle messages up to the maximum
datagram packet size. For UDP, this size is 65,535 bytes, including IP and UDP headers. However, the
maximum datagram packet size the Mediatrix 4104 supports for a SIP request or response is 5120 bytes
excluding the IP and UDP headers. This should be enough, as a packet is rarely bigger than 2500 bytes.
You can also set these parameters via the web interface, as described in “SIP Transport Type” on page 67.
This is especially useful for a system where there are no SRV records configured to use a
predefined transport order for receiving requests. When sending a request, the unit either follows
the SRV configuration, or, if not available, any transport parameter received from a redirection or
from a configured SIP URL. See “Chapter 10 - DNS SRV Configuration” on page 167 for more
details.
6. Restart the Mediatrix 4104 so that the changes may take effect.
Transport Parameter
You can define whether the Mediatrix 4104 must include its supported transport in all SIP messages that have
the Contact header, except for the REGISTER message. See “SIP Transport Type” on page 249 for details
on how to include transport parameters in the REGISTER message.
If enabled, then the Mediatrix 4104 will send SIP messages with the “transport” parameter in the Contact
header set to the currently supported transport type.
The penalty box feature is used to “quarantine” a given host which address times out. During that time, the
address is considered as “non-responding” for all requests.
This feature is most useful when using multiple servers and some of them are down. It ensures that users wait
a minimal period of time before trying a secondary host.
You can also set these parameters via the web interface, as described in “SIP Penalty Box” on page 66.
Note: It is not the destination itself that is placed in the penalty box, but the combination of address, port
and transport. When a host is in the penalty box, it is never used to try to connect to a remote host unless it
is the last choice for the Mediatrix 4104 and there are no more options to try after this host.
Let’s say for instance that the Mediatrix 4104 supports both the UDP and TCP transports. It tries to reach
endpoint “B” for which the destination address does not specify a transport and there is no DNS SRV entry to
specify which transports to use in which order. It turns out that this endpoint “B” is also down. In this case, the
Mediatrix 4104 first tries to contact endpoint “B” via UDP. After a timeout period, UDP is placed in the penalty
box and the unit then tries to contact endpoint “B” via TCP. This fails as well and TCP is also placed in the
penalty box.
Now, let’s assume endpoint “B” comes back to life and the Mediatrix 4104 tries again to contact it before UDP
and TCP are released from the penalty box. First, the unit tries UDP, but it is currently in the penalty box and
there is another transport left to try. The Mediatrix 4104 skips over UDP and tries the next target, which is TCP.
Again, TCP is still in the penalty box, but this time, it is the last target the Mediatrix 4104 can try, so penalty
box or not, TCP is used all the same to try to contact endpoint “B”.
There is a problem if endpoint “B” only supports UDP (RFC 2543-based implementation). Endpoint “B” is up,
but the Mediatrix 4104 still cannot contact it: with UDP and TCP in the penalty box, the unit only tries to contact
endpoint “B” via its last choice, which is TCP.
The same scenario would not have any problem if the penalty box feature was disabled. Another option is to
disable TCP in the Mediatrix 4104, which makes UDP the only possible choice for the unit and forces to use
UDP even if it is in the penalty box.
You must fully understand the above problem before configuring this feature. Mixing endpoints that do not
support the same set of transports with this feature enabled can lead to the above problems, so it is suggested
to either properly configure SRV records for the hosts that can be reached or be sure that all hosts on the
network support the same transport set before enabling this feature.
3. Enable the SIP penalty box feature by setting the sipPenaltyBoxEnable variable to enable.
The penalty box is always “active”. This means that even if the feature is disabled, IP addresses are
marked as invalid, but they are still tried. This has the advantage that when the feature is enabled,
IP addresses that were already marked as invalid are instantly put into the penalty box.
Registration Parameters
The following describes registration parameters and behaviours you can configure.
Refreshing Registration
You can refresh the registration, i.e., commit the changes you have done to the registration. When refreshing
the registration, all enabled endpoints unregister themselves from the previous registrar and send a new
registration to the current registrar with the current parameters.
Variables whose modification require a registration refresh are:
sipRegistrarStaticHost
sipRegistrarStaticPort
sipUAMainUsername
sipUADisplayName
sipServerSelectConfigSource
sipTransportRegistrationEnable
sipTransportEnable (if sipTransportRegistrationEnable is enabled)
sipTransportQValue (if sipTransportRegistrationEnable is enabled)
Note: Normally, the Mediatrix 4104 cannot make or receive calls until the REGISTER has completed
successfully. Because the timeout for a SIP transaction in UDP is 32 seconds, it is possible to have an
ongoing re-REGISTER transaction at the same moment that the registration itself expires. This could
happen if sipReRegistrationTime is set to a value lower than 32.
In that case, the user agent becomes unregistered, and will become registered again only when the re-
REGISTER request is answered with a positive response from the server. See “Unregistered Line
Behaviour” on page 214 for a workaround if the unit cannot make calls during that period.
Registration Expiration
The SIP protocol allows an entity to specify the “expires” parameter of a contact in a REGISTER request. The
server can return this “expires” parameter in the 200 OK response or select another “expires”. In the
REGISTER request, the “expires” is a suggestion the entity makes.
The “expires” parameter indicates how long, in seconds, the user agent would like the binding to be valid.
You can configure the “expires” parameter the Mediatrix 4104 sends.
RFC 3261 specifies that, when the “expires” parameter or the “Expires” header is missing or not properly
formatted for a contact of the 200 OK in response to a REGISTER request, the unit must use a default
registration expiration value of 3600 s.
You can configure the value of the default registration expiration.
Publication Parameters
The following describes publication parameters and behaviours you can configure.
Refreshing Publications
You can refresh the publications, i.e., commit the changes you have done to the publications. When refreshing
the publications, all enabled endpoints unpublish themselves from the previous Presence Compositor and
send a new publication to the current Presence Compositor with the current parameters.
Variables whose modification require a registration refresh are:
sipPresenceCompositorStaticHost
sipPresenceCompositorStaticPort
Publications Expiration
The SIP protocol allows an entity to specify the “expires” parameter of a contact in a PUBLISH request. The
server can return this “expires” parameter in the 200 OK response or select another “expires”. In the PUBLISH
request, the “expires” is a suggestion the entity makes.
The “expires” parameter indicates how long, in seconds, the user agent would like the binding to be valid.
You can configure the “expires” parameter the Mediatrix 4104 sends.
Interop Parameters
The interop parameters allow the Mediatrix 4104 to properly work, communicate, or connect with specific IP
devices.
You can select the version of the transfer draft that the Mediatrix 4104 uses. The provisioned version is used
for initiating transfers and receiving them. Transfer versions other than those provisioned do not work.
Table 143: Call Transfer Versions Supported
Version Description
transfer02 The Mediatrix 4104 executes transfers by using the methods described in the
now expired draft-ietf-sip-cc-transfer-02.txt. Its use is deprecated and you should
use this setting for backward compatibility issues only.
transfer05UsingRefer02 The Mediatrix 4104 executes transfers by using the methods described in the
more recent draft-ietf-sip-cc-transfer-05.txt. This draft version contains several
enhancements over the previous ones. Among others, it is possible to use the
Replaces header to provide a more seamless attended transfer to the user. This
method also uses draft-ietf-sip-refer-02.txt. Use this setting if you do not need to
interop with transfer02-enabled parties. See “Replaces Configuration Setting” on
page 256 for more details.
This feature is currently located under the mediatrixExperimental branch of the MIB structure. See “MIB
Structure” on page 131 for more details.
Configuration Description
Replaces Version
Standards Supported • sip-replaces-01 draft
• sip-replaces-03 draft
You can select the version of the ietf-sip-replaces draft to which the Mediatrix 4104 must conform. The
provisioned version affects the way blind transfers are executed.
This feature is currently located under the mediatrixExperimental branch of the MIB structure. See “MIB
Structure” on page 131 for more details.
Table 145: Replaces Versions Supported
Version Description
replaces01 The Transferor can use a REFER with Replaces when proceeding to initiate a blind transfer.
This results in the Transferee including a Replaces header in its INVITE to the Transfer
Target.
replaces03 When initiating a blind transfer, the Transferor first CANCELs its call with the Target and then
issues a REFER without Replaces to the Transferee.
Note: A side effect is that the phone will stop ringing and start again.
Transmission Timeout
Standards Supported • RFC 2543bis – SIP: Session Initiation Protocol
• RFC 3261 – SIP: Session Initiation Protocol
If a DNS SRV answer contains more than one entry, the Mediatrix 4104 will try these entries if the entry initially
selected does not work. You can configure the maximum time, in seconds, to spend waiting for answers to
messages, from a single source. Retransmissions still follow the algorithm proposed in RFC 2543bis, but the
total wait time can be overridden by using this feature.
For example, if you are using DNS SRV and more than one entry is present, this timeout is the time it takes
before trying the second entry.
This feature is currently located under the mediatrixExperimental branch of the MIB structure. See “MIB
Structure” on page 131 for more details.
Max-Forwards Header
Standards Supported RFC 3261 – SIP: Session Initiation Protocol
You can configure whether the Mediatrix 4104 inserts the Max-Forwards header into sent requests, as per
RFC 3261. Max-Forwards serves to limit the number of hops a request can make on the way to its destination.
It consists of an integer that is decremented by one at each hop. If the Max-Forwards value reaches 0 before
the request reaches its destination, it will be rejected with a “483 (Too Many Hops)” error response.
This feature is currently located under the mediatrixExperimental branch of the MIB structure. See “MIB
Structure” on page 131 for more details.
Referred-By Field
The SIP REFER method allows the referrer to provide information about the reference to the refer target by
using the referree as an intermediary. The mechanism for carrying the referrer's identity, expressed as a SIP
URI, is the Referred-By header.
You can configure the Referred-By field used in a SIP REFER request to decide whether it contains the
permanent URL provided by the SIP stack or the address of record used when the unit registered.
Parameter Description
The Mediatrix 4104 can provide the direction attribute and the meaning of the connection address “0.0.0.0”
sent in the SDP when an endpoint is put on hold.
See “Call Hold” on page 286 for more details on holding calls.
Parameter Description
inactive The stream is put on hold by marking it as inactive. This is the default
value. This setting should be used for backward compatibility issues.
sendonly The stream is put on hold by marking it as sendonly.
This method allows the Mediatrix 4104 to be in conformance with
RFC 3264.
Direction Attribute
Standards Supported • RFC 2543 – SIP: Session Initiation Protocol
• RFC 3264 – An Offer/Answer Model with Session Description
Protocol (SDP)
Parameter Description
Parameter Description
enable The Mediatrix 4104 always sends the direction attribute in the
SDP of the initial INVITE.
The initial handshake determines whether or not the peer
supports the direction attribute.
• If the direction attribute is present in the SDP
received from the peer, the Mediatrix 4104 sends
the direction attribute in the SDP for the remainder
of the session.
• If the direction attribute is not present in the SDP
received from the peer, the Mediatrix 4104 does not
send the direction attribute in the SDP for the
remainder of the session.
If present in the SDP, the direction attribute is preferred over
the connection address to transmit session modification
information.
This method is in conformance with RFC 3264.
Parameter Description
disable The local ring is not started on a “18x Provisional” response without SDP,
except for a “180 Ringing” message. This is the default value.
The 180 Ringing message is a provisional or informational response used
to indicate that the INVITE message has been received by the user agent
and that alerting is taking place.
Note: Using this default value means you are implementing a behaviour
that is different from previous versions of the Mediatrix 4104 application.
enable The local ring is started on any “18x Provisional” response without SDP.
SIP Credential
You can configure how the Mediatrix 4104 reuses the credential in different transactions of the same call or
registration. For instance, it may be required that a new SIP request does not reuse the credential negotiated
in the previous transaction of the same call or registration. For example, a re-INVITE will not reuse the
credential of the INVITE but will be challenged.
You can configure the method used to match incoming SIP packets with a branch. A branch could be
described as a link that allows to match a response to a request.
Method Description
rfc2543 Follows the method described in RFC 2543 (section 10.1.2). Responses are
mapped to requests by the matching To, From, Call-ID, and CSeq headers and
the branch parameter of the first Via header.
rfc3261 Follows the method described in RFC 3261 (section 8.1.1.7). A Via is inserted
into the request and the Via header field value must contain a branch parameter.
This parameter is used to identify the transaction created by that request. It is
used by both the client and the server.
The branch ID is used to facilitate its use as a transaction ID. It must always begin
with the characters “z9hG4bK”. If this is not the case, the Mediatrix 4104 uses the
branching method as described in RFC 3261, section 17.2.3.
X To configure the use of the Via branch behaviour for CANCEL requests:
1. In the sipInteropMIB, set the sipInteropIgnoreViaBranchIdInCancelEnable variable with the proper
behaviour.
Table 150: Via Branch Behaviour
Method Description
disable The transaction matching procedure behaves according to section 17.2.3 of RFC
3261. This is the default value.
enable The branch parameter is not used as a transaction matching criterion for
CANCEL requests with no To tag.
Method Description
send180Ringing The Mediatrix 4104 sends out a “180 Ringing” response without a body. In
this case, the ringback the caller hears is generated by his own unit upon
receiving the message. This is the default value.
send183WithSdp The Mediatrix 4104 returns a “183 Session Progress” packet with SDP
(needed if the endpoint is required to generate ringback on connection). In
this case, the RTP channel is opened earlier to allow the callee’s unit to
generate the ringback and send it to the caller.
URI-Parameters
You can specify whether or not the Mediatrix 4104 copies the uri-parameters from the Request-URI header to
the level of proxy authentication. Not copying the uri-parameters allows to reduce the SIP packet size but it
does not follow the recommendations of RFC 3261.
Parameter Description
disable Unknown INFO requests trigger a 415 Unsupported Media Type response.
enable Reception of unknown INFO requests is acknowledged with a 200 OK response.
Parameter Description
disable SIP requests sent to the outbound proxy contain a Route header, as per RFC
3261's recommendation. This is the default behaviour.
enable SIP requests are routed to the outbound proxy without inserting a Route header in
the SIP packet.
You can define the format used, in the SDP portion of SIP packets, to advertise the unit's T.38 capabilities.
Parameter Description
Parameter Description
disable No retries are performed following a failed registration attempt. Manual intervention
is required for the port to re-attempt registration.
enable A failure to register a port to the SIP Registrar triggers an automatic retry every 2
minutes.
This is the default value.
Parameter Description
disable The request URI is built using the home domain proxy host as defined in “Proxy
Server” on page 159.
enable The request URI is built using the SIP domain, if one is specified, for all SIP methods
with the exception of REGISTER and PUBLISH. The parameter maddr is also
added to the Request URI with the value of the home domain proxy host. See “User
Agents” on page 243 for information on how to set the SIP domain.
Parameter Description
disable Caller ID data is based on the value assigned to the From header of the incoming
SIP request. This is the default value.
enable The unit first attempts to get the caller ID information from the P-Asserted-Identity
header, if present. In case of failure, it falls back to the content of the From header.
Parameter Description
disable Keep using the initial payload type. This is the default value.
enable Use the RFC 2833 payload type found in the received answer
This variable only has an effect when the voiceIfDtmfTransport variable is set to outOfBandUsingRtp (see
“DTMF Transport Type” on page 227 for more details). The payload type is used symmetrically meaning that
it is used to send and receive the DTMF. Use the variable sipInteropAllowAsymmetricDtmfPayloadType to
allow asymmetric payload type (see “Asymmetric DTMF Payload Type” on page 265 for more details).
Parameter Description
disable Use the RFC 2833 payload type found in the received answer to receive DTMF.
This is the default value.
enable Keep using the initial payload type to receive DTMF.
The variable does not affect the behaviour when receiving an offer. It only has an effect when the
variable sipInteropUseDtmfPayloadTypeFoundInAnswer is set to enable (see “Using the Payload
Type Found in the Answer” on page 265 for more details).
Parameter Description
disable The application rejects the SIP INFO with the content type 'application/broadsoft'.
This is the default value.
enable SIP INFO with the content type 'application/broadsoft' is accepted and the call
waiting tone is started or stopped according to the body. The INFO method is also
included in the 'Allow' SIP header.
Parameter Description
disable The username parameter is not ignored when routing an incoming SIP call to a line.
The parameter is considered as part of the username. This is the default value.
enable The username parameter is ignored when routing an incoming SIP call to a line.
Offer/Answer Model
You can define whether or not the Mediatrix 4104 requires strict adherence to RFC 3264 from the peer when
negotiating capabilities for the establishment of a media session.
Parameter Description
UDP Checksum
19 STUN Configuration
This chapter describes how to configure the STUN client of the Mediatrix 4104.
What is STUN?
Standards Supported RFC 3489 – STUN - Simple Traversal of User Datagram Protocol (UDP)
Through Network Address Translators (NATs)
STUN (Simple Traversal of UDP through NATs) is a simple client / server protocol that uses UDP packets to
discover the configuration information of NATs and firewalls between a device and the public Internet:
NAT type
NAT binding public address
NAT binding time to live
NAT (Network Address Translator) is a device that translates the IP address used within a “private” network
to a different IP address known in another “public” network. See “NAT Traversal” on page 248 for more
details.
STUN supports a variety of existing NAT devices and does not require any additional hardware or software
upgrades on the NAT device.
The Mediatrix 4104 uses the STUN protocol to discover its NAT binding for the following three IP addresses/
ports (sockets):
Signalling protocol (SIP) IP address/port
RTP IP address/port
T.38 IP address/port
The following describes how to configure the Mediatrix 4104 STUN client via SNMP. You can also use the web
interface to configure the STUN parameters. See “STUN Configuration” on page 117 for more details.
20 SNTP Settings
The Simple Network Time Protocol (SNTP) enables the notion of time (date, month, time) into the Mediatrix
4104. It updates the internal clock of the unit, which is the client of a SNTP server. It is required when dealing
with features such as the caller ID.
SNTP is used to synchronize a SNTP client with a SNTP or NTP server by using UDP as transport.
You can also set these parameters via the web interface, as described in “SNTP Settings” on page 34.
You must enable the SNTP client of the Mediatrix 4104 to properly connect to a a SNTP or NTP server.
Variable Description
Configuration Source
The Mediatrix 4104 must know the IP address and port number of the SNTP server. You can assign these
information to the Mediatrix 4104 through a DHCP server or manually enter them yourself with the static
variables.
In the Unit Manager Network Administration Manual, refer to chapter Administration Parameters, section
SNTP.
DHCP Configuration
Using the DHCP configuration assumes that you have properly set your DHCP server with the relevant
information. See “Chapter 8 - IP Address and Network Configuration” on page 137 for more details.
Static Configuration
Use the static configuration if you are not using a DHCP server or if you want to bypass it.
Variable Description
When starting, the Mediatrix 4104 queries a NTP or SNTP server to receive time information. It receives the
information in Greenwich Mean Time (GMT) format (also known as Universal Time Coordinated - UTC), so it
needs to convert this GMT time into the proper time zone. To do this, the Mediatrix 4104 offers time zone
configuration with daylight saving settings.
STD / DST
Three or more characters for the standard (STD) or alternative daylight saving time (DST) time zone. Only STD
is mandatory. If DST is not supplied, the daylight saving time does not apply. Lower and upper case letters are
allowed. All characters are allowed except digits, leading colon (:), comma (,), minus (-), plus (+), and ASCII
NUL.
OFFSET
Difference between the GMT time and the local time. The offset has the format h[h][:m[m][:s[s]]]. If no offset is
supplied for DST, the alternative time is assumed to be one hour ahead of standard time. One or more digits
can be used; the value is always interpreted as a decimal number.
The hour value must be between 0 and 24. The minutes and seconds values, if present, must be between 0
and 59. If preceded by a minus sign (-), the time zone is east of the prime meridian, otherwise it is west, which
can be indicated by the preceding plus sign (+). For example, New York time is GMT 5.
START / END
Indicates when to change to and return from the daylight saving time. The START argument is the date when
the change from the standard to the daylight save time occurs; END is the date for changing back. If START
and END are not specified, the default is the US Daylight saving time start and end dates. The format for start
and end must be one of the following:
n where n is the number of days since the start of the year from 0 to 365. It must contain the
leap year day if the current year is a leap year. With this format, you are responsible to
determine all the leap year details.
Jn where n is the Julian day number of the year from 1 to 365. Leap days are not counted. That
is, in all years – including leap years – February 28 is day 59 and March 1 is day 60. It is
impossible to refer to the occasional February 29 explicitly. The TIME parameter has the same
format as OFFSET but there can be no leading minus (-) or plus (+) sign. If TIME is not
specified, the default is 02:00:00.
Mx[x].y.z where x is the month, y is a week count (in which the z day exists) and z is the day
of the week starting at 0 (Sunday). As an example:
M10.4.0
is the fourth Sunday of October. It does not matter if the Sunday is in the 4th or 5th week.
M10.5.0
is the last Sunday of October (5 indicates the last z day). It does not matter if the Sunday is in the
4th or 5th week.
M10.1.6
is the first week with a Saturday (thus the first Saturday). It does not matter if the Saturday is in the
first or second week.
The TIME parameter has the same format as OFFSET but there can be no leading minus (-) or plus
(+) sign. If TIME is not specified, the default is 02:00:00.
Example
The following is an example of a proper POSIX string:
Standard Offset Month, Week, and Day Month, Week, and Day
time zone to start the Daylight to stop the Daylight
Saving Time Saving Time
EST5DST4,M4.0.0/02:00:00,M10.5.0/02:00:00
21 Digit Maps
Standards Supported RFC 2705 – Media Gateway Control Protocol (MGCP) Version 1.0,
section 3.4 (Formal syntax description of the protocol).
In the Unit Manager Network Administration Manual, refer to chapter Dial Map Parameters.
You can also set these parameters via the web interface, as described in “Digit Maps” on page 71.
A digit map allows you to compare the number users just dialed to a string of arguments. If they match, users
can make the call. If not, users cannot make the call and get an error signal. It is thus essential to define very
precisely a digit map before actually implementing it, or your users may encounter calling problems.
Because the Mediatrix 4104 cannot predict how many digits it needs to accumulate before transmission, you
could use the digit map, for instance, to determine exactly when there are enough digits entered from the user
to place a call.
Syntax
The permitted digit map syntax is taken from the core MGCP specification, RFC 2705, section 3.4:
DigitMap = DigitString / '(' DigitStringList ')'
DigitStringList = DigitString 0*( '|' DigitString )
DigitString = 1*(DigitStringElement)
DigitStringElement = DigitPosition ['.']
DigitPosition = DigitMapLetter / DigitMapRange
DigitMapLetter = DIGIT / '#' / '*' / 'A' / 'B' / 'C' / 'D' / 'T'
DigitMapRange = 'x' / '[' 1*DigitLetter ']'
DigitLetter ::= *((DIGIT '-' DIGIT ) / DigitMapLetter)
Where “x” means “any digit” and “.” means “any number of”.
For instance, using the telephone on your desk, you can dial the following numbers:
Table 166: Number Examples
Number Description
0 Local operator
00 Long distance operator
xxxx Local extension number
8xxxxxxx Local number
#xxxxxxx Shortcut to local number at other corporate sites
91xxxxxxxxxx Long distance numbers
9011 + up to 15 digits International number
The solution to this problem is to load the Mediatrix 4104 with a digit map that corresponds to the dial plan.
A Mediatrix 4104 that detects digits or timers applies the current dial string to the digit map, attempting a match
to each regular expression in the digit map in lexical order.
If the result is under-qualified (partially matches at least one entry in the digit map), waits for
more digits.
If the result matches, dials the number.
If the result is over-qualified (i.e., no further digits could possibly produce a match), sends a fast
busy signal.
Special Characters
Digit maps use specific characters and digits in a particular syntax. Those characters are:
Table 167: Digit Map Characters
Character Use
Let’s say you are in an office and you want to call a co-worker’s 3-digits extension. You could build a digit map
that says “after the user has entered 3 digits, make the call”. The digit map could look as follows:
xxx
You could refine this digit map by including a range of digits. For instance, you know that all extensions in your
company either begin with 2, 3, or 4. The corresponding digit map could look as follows:
[2-4]xx
If the number you dial begins with anything other than 2, 3, or 4, the call is not placed and you get a busy signal.
Note: Enclose the digit map in parenthesis when using the “|” option.
Note: When making the actual call and dialing the number, the Mediatrix 4104 automatically removes the
“T” found at the end of a dialed number, if there is one (after a match). This character is for indication
purposes only.
Example
Table 166 on page 275 outlined various call types one could make. All these possibilities could be covered in
one digit map:
(0T|00T|[1-7]xxx|8xxxxxxx|#xxxxxxx|91xxxxxxxxxx|9011x.T)
The variables related to the digit maps are located in tables. You can create/edit ten digit maps for each
Mediatrix 4104. Before changing a parameter value, build its corresponding table with your MIB browser’s
table functionality. Depending on the MIB browser you are using, the tables may not appear the same way.
Digit map rules are checked sequentially. If a telephone number potentially matches two of the rules, the first
rule encountered is applied.
Each of these digit map rules has six specific variables to define for the digit map to work properly.
Variable Setting
digitMapAllowedEnable Enable
digitMapAllowedDigitMap (011x.#|001x.T)
digitMapPrefixedDigitRemovalCount 3
A valid telephone number must contain a country code, an area
code, and a number – the “011” part is not required.
Variable Setting
digitMapAllowedEnable Enable
digitMapAllowedDigitMap 1xxxxxxxxxx
digitMapPrefixedDigitRemovalCount 1
The first digit “1” in the digit map indicates a user wants to call
outside his or her own area code. It must be removed because it
does not need to be expressed to the SIP Server. The SIP Server
needs only to know the complete number of the called party
(CC+AC+directory number).
digitMapPrependedString 1 (country code)
A valid telephone number must contain a country code, an area
code, and a number. The country code is missing in this number
and must be added.
Note that in this scenario, the country code is the same as the code
used when the user wants to indicate a communication outside of
his or her own area code. It is still good practice to have this number
removed and to add the country code, even if these two numbers
are the same.
Variable Setting
digitMapAllowedEnable Enable
digitMapAllowedDigitMap 425xxxxxxx
digitMapPrependedString 1 (country code)
A valid telephone number must contain a country code, an area
code, and a number. The country code is missing in this number
and must be added.
Variable Setting
digitMapAllowedEnable Enable
digitMapAllowedDigitMap ([235-9]xxxxxx|45[1-9]xxxx|4[0-469]xxxxx)
digitMapPrependedString 1206 (country code and area code)
A valid telephone number must contain a country code, an area
code, and a number. The country code and area code are missing
in this number and must be added.
Variable Setting
digitMapAllowedEnable Enable
digitMapAllowedDigitMap [1-8]xx
Variable Setting
digitMapAllowedEnable Enable
digitMapAllowedDigitMap (9011x.#|9011x.T)
digitMapPrefixedDigitRemovalCount 4
A valid telephone number must contain a country code, an area
code, and a number – the “9011” part is not required.
Variable Setting
digitMapAllowedEnable Enable
digitMapAllowedDigitMap 91xxxxxxxxxx
digitMapPrefixedDigitRemovalCount 2
The first digit “9” in the digit map indicates a user wants to make an
external call, while the second digit “1” indicates a user wants to call
outside his or her own area code (in North America). The two digits
must be removed because they do not need to be expressed to the
SIP Server. The SIP Server needs only to know the complete
number of the called party (CC+AC+directory number).
Variable Setting
Variable Setting
digitMapAllowedEnable Enable
digitMapAllowedDigitMap 9[2-8]xxxxxx
digitMapPrefixedDigit RemovalCount 1
The first digit “9” in the digit map indicates a user wants to make an
external call. It has to be removed because it does not need to be
expressed to the SIP Server. The SIP Server needs only to know
the complete number of the called party (CC+AC+directory
number).
digitMapPrependedString 1819 (country code and area code)
A valid telephone number must contain a country code, an area
code, and a number. The country code and area code are missing
in this number and must be added.
22 Telephony Features
This chapter explains how to set the telephony variables of the Mediatrix 4104 to define the way the unit
handles calls.
Making Calls
Users with telephones or faxes connected to a Mediatrix 4104 dial as if they were on a standard telephony
system.
Note: You can dial one star numbers *xx (such as *69). These numbers are automatically inserted in the
Request-URL of the SIP INVITE request.
Note: A forced SCN call is only be possible if an analog gateway such as the Mediatrix 1204 is available
on the IP network.
Emergency Call
The Emergency Call service (also called urgent gateway) allows a “911”-style service. It allows a user to dial
a special digit map resulting in a message being sent to a specified urgent gateway, bypassing any other
intermediaries.
If enabled, whenever the user dials the specified digit map, a message is sent to the target address.
You can also set these parameters via the web interface, as described in “Emergency Call Configuration” on
page 116.
23 Subscriber Services
The Mediatrix 4104 offers subscriber services users can directly access on their telephone. However, you
must set these services before they can be used.
Most of the variables related to the subscriber services are located in tables. These tables display the
information for all lines. Before changing a parameter value, build its corresponding table with your MIB
browser’s table functionality.
In the Unit Manager Network Administration Manual, refer to chapter Subscriber Services Parameters, section
SIP Configuration Window.
You can also set these parameters via the web interface, as described in “Call Forward” on page 88 and
“Services” on page 93.
Parameter Description
Parameter Description
flashHookAndDigits The user must perform a flash hook and enter a specific digit to activate a
service. The digit dialed has a different behaviour depending on the
current call context:
• One call active and one waiting call:
Flash hook then dial the digit 2: Answer the waiting call.
• One call active and one call on hold:
Flash hook then dial the digit 1: Terminate the active call and
recover the call on hold.
Flash hook then dial the digit 2: Hold the active call and recover the
call on hold.
Flash hook then dial the digit 3: Enter the conference mode.
Flash hook then dial the digit 4: Transfer the call on hold to the
active call.
When hanging up in this context, the telephone rings to notify the
user there is still a call on hold.
• In conference mode:
Flash hook then dial the digit 2: Return to one active call and one
call on hold.
When hanging up in this context, all calls are finished.
Call Hold
The Call Hold service allows the user to temporarily put an existing call on hold, usually by using the “flash”
button of the telephone. The user can resume the call in the same way.
You must enable this service for the following services to work properly:
Call Waiting
Second Call
Blind Transfer
Attended Transfer
Conference
Second Call
The Second Call service allows a user with an active call to put the call on hold, and then initiate a new call on
a second line. This service is most useful with the transfer and conference services.
The call hold service must be enabled for this service to work. See “Call Hold” on page 286.
Call Forward
Unconditional
The Call Forward Unconditional feature allows users to forward all of their calls to another extension or line.
X To forward calls:
1. Take the receiver off-hook.
2. Wait for the dial tone.
3. Dial the sequence the system administrator has implemented to activate the call forward
unconditional service.
This sequence could be something like *70.
4. Wait for the transfer tone (three “beeps”) followed by the dial tone.
5. Dial the number to which you want to forward your calls. Dial any access code if required.
6. Wait for three “beeps” followed by a silent pause.
The call forward is established.
7. Hang up your telephone.
The calls are checked against the digit maps set up by the system administrator.
On Busy
You can automatically forward the incoming calls of your users to a pre-determined target if they are already
on the line. The user does not have any feedback that a call was forwarded.
X To forward calls:
1. Take the receiver off-hook.
2. Wait for the dial tone.
3. Dial the sequence the system administrator has implemented to activate the call forward on busy
service.
This sequence could be something like *72.
4. Wait for the transfer tone (three “beeps”) followed by the dial tone.
5. Dial the number to which you want to forward your calls. Dial any access code if required.
6. Wait for three “beeps” followed by a silent pause.
The call forward is established.
7. Hang up your telephone.
The calls are checked against the digit maps set up by the system administrator.
On No Answer
You can forward the incoming calls of your users to a pre-determined target if they do not answer their
telephone before a specific amount of time. The user does not have any feedback that a call was forwarded.
X To forward calls:
1. Take the receiver off-hook.
2. Wait for the dial tone.
3. Dial the sequence the system administrator has implemented to activate the call forward on no
answer service.
This sequence could be something like *74.
4. Wait for the transfer tone (three “beeps”) followed by the dial tone.
5. Dial the number to which you want to forward your calls. Dial any access code if required.
6. Wait for three “beeps” followed by a silent pause.
The call forward is established.
7. Hang up your telephone.
The calls are checked against the digit maps set up by the system administrator.
Call Waiting
The call waiting tone indicates to an already active call that a new call is waiting on the second line.
Your users can activate/deactivate the call waiting tone for their current call. This is especially useful when
transmitting faxes. The user that is about to send a fax can thus deactivate the call waiting tone to ensure that
the fax transmission will not be disrupted by an unwanted second call. When the fax transmission is completed
and the line is on-hook, the call waiting tone is automatically reactivated.
Furthermore, the Mediatrix 4104 supports receiving some Call Waiting control commands via the SIP INFO
method. See “Controlling the Call Waiting Tone via SIP INFO” on page 266 for more details.
X To terminate the active call and recover the call on hold with the flash hook and digit method:
1. Perform a Flash-Hook by pressing the “Flash” button on your analog telephone.
2. Dial the digit 1.
X To hold the active call and recover the call on hold with the flash hook and digit method:
1. Perform a Flash-Hook by pressing the “Flash” button on your analog telephone.
2. Dial the digit 2.
Call Transfer
Blind Transfer
The blind call transfer service is sometimes called Transfer without Consultation or Unattended Transfer. It
allows a user to transfer a call on hold to a still ringing (unanswered) call. The individual at the other extension
or telephone number does not need to answer to complete the transfer.
The call hold and second call services must be enabled for this service to work. See “Call Hold” on page 286
and “Second Call” on page 287.
X To transfer a call on hold with the flash hook and digit method:
1. Perform a Flash-Hook by pressing the “Flash” button on your analog telephone.
2. Dial the digit 4.
Attended Transfer
The attended call transfer service is sometimes called Transfer with Consultation. It allows a user to transfer
a call on hold to an active call. The individual at the other extension or telephone number must answer to
complete the transfer.
The call hold and second call services must be enabled for this service to work. See “Call Hold” on page 286
and “Second Call” on page 287.
Note: If the number to which you want to transfer the call is busy or does not answer, quickly perform a
Flash-Hook. The busy tone or ring tone is cancelled and you are back with the first call.
X To transfer a call on hold with the flash hook and digit method:
1. Perform a Flash-Hook by pressing the “Flash” button on your analog telephone.
2. Dial the digit 4.
Conference Call
The Conference Call service allows a user to link two or more calls together to form a single conversation,
called a conference.
Only 3-way conferences are currently supported.
A participant of the conference can put the conference on hold and attempt other calls. This
participant may then rejoin the conference at a later time by unholding it. The participant who
initiated the conference cannot put it on hold.
You must enable the call hold and second call services for this service to work. See “Call Hold” on page 286
and “Second Call” on page 287.
The following is a conference call flow example:
INVITE (PCMU)
Trying200 OK
ACK
INVITE (UNHOLD-PCMU)
Trying/200 OK
ACK
3-way Conference Call Established
Requirements
For the conference call to occur successfully, all parties must meet the following requirements:
Support at least one of the PCM codecs (G.711 µ-law and G.711 A-law) enabled on the line
that is having the conference. See “Enabling Individual Codecs” on page 224 for more details.
Ability to dynamically change codec during a call.
The packetization period (ptime) should be the same for all the participants of the conference.
If this is not the case, then part of the conversation may be lost, resulting in a choppy voice. For
better results, Mediatrix recommends to set the packetization period of all participants of a 3-
way conference to 30 milliseconds. See “Packetization Time” on page 225 for more information
on how to set the packetization period of the Mediatrix 4104.
X To initiate a three-way conference with the flash hook and digit method (“A” and “B” already
connected):
1. “A” performs a flash hook.
This puts “B” on hold and the second line is automatically connected. “A” hears a dial tone.
2. “A” dials “C’s” number.
The context is now one call active and one call on hold.
3. “A” performs a flash hook, and then dials the digit 3 to start the conference call.
The call on hold (“B”) is reactivated. “A” is now conferencing with “B” and “C”.
Note: Performing a flash hook and dialing the digit 2 will stop conference but keep one active call and one
call on hold.
X “A” wants to terminate the call with “C” and get back to the call with “B” during the conference:
1. “A” performs a Flash-Hook.
The conference is terminated and the call with “C” is disconnected. “A” and “B” are still connected
and can go on with their conversation.
24 Telephony Attributes
The telephony attributes are used to configure the characteristics of the telephony system being implemented.
Automatic Call
The automatic call feature allows you to define a telephone number that is automatically dialed when taking
the handset off hook.
In the Unit Manager Network Administration Manual, refer to chapter Telephony Attributes Parameters,
section Telephony Attributes Configuration Window.
When this service is enabled, the second line service is disabled but the call waiting feature is still functional.
The user can still accept incoming calls.
You can also set these parameters via the web interface, as described in “Automatic Call” on page 100.
In the Unit Manager Network Administration Manual, refer to chapter Telephony Attributes Parameters,
section Telephony Attributes Configuration Window.
Restriction Description
Because this variable is located in a table, you can define a different call direction for each line of
the Mediatrix 4104.
Hook flash processing allows hook flash signals to be transported over the IP network allowing to use
advanced telephony services. You can define how to process hook-flash detection. Users normally press the
“flash” button of the telephone during a call in progress to put this call on hold, transfer it, or even initiate a
conference call.
Setting Definition
Setting Definition
The IP address call service allows a user to dial an IP address without the help of a SIP server. Using this
method bypasses any server configuration of your unit.
The user can dial an IP address and enter an optional telephone number. Note that the optional telephone
number is matched by using the same digit maps as a normal call.
Dialing an IP Address
X To make an IP address call:
1. Dial “**” (IP address prefix).
2. Dial the numerical digits of the IP address and use the “*” for the “.” of the IP address.
3. Dial “#” to terminate the IP address.
4. Dial the telephone number of the specific line you want to reach.
For example, let’s say you want to reach the telephone connected to Line 2 of the Mediatrix 4104
with the IP address 192.168.0.23. The phone number assigned to Line 2 of this Mediatrix 4104 is
1234. You must then dial the following digits:
**192*168*0*23#1234
In this case, the Mediatrix 4104 sends an INVITE [email protected].
PIN Dialing
The PIN Dialing feature allows you to configure a PIN (Personal Identification Number) that would be dialed
“n” milliseconds after an outgoing call was established.
This feature could be used in the case where a user makes an automatic call to an IVR system, and after a
pre-defined delay, the Mediatrix 4104 sends the DTMF tones (PIN) to indicate where the call is coming from.
The PIN is transmitted by using the DTMF out-of-band by signalling protocol transport type. Both parties
involved must thus support the draft-choudhuri-sip-info-digit-00.txt draft. The PIN must be negotiated in the
call. See “DTMF Transport Type” on page 227 for more details on the DTMF out-of-band by signalling protocol
transport type.
Note: The draft-choudhuri-sip-info-digit-00.txt draft does not support the pause characters “,”, “;”, and “p”.
This is a proprietary support.
2. Set the delay prior to sending the PIN in the pinDialingDelay variable.
This value is expressed in milliseconds (ms). The default value is 1000 ms.
3. Enable the PIN dialing feature by setting the pinDialingEnable variable to enable.
The Remote Line Extension feature makes it possible to connect remote small offices with similar capabilities
as if they were located in the main or head office. Essential features such as integrated voicemail, unified
messaging, line extension dialing plans and many others can be offered to remote sites.
Mediatrix FXS access devices and Mediatrix 1204 FXO gateways extend PBX extensions to remote workers
located at SOHOs (Small Offices/Home Offices), using VoIP. PBX extensions are connected via Mediatrix
1204 FXO ports to the IP network, instead of being connected to individual stations. At the SOHO locations,
Mediatrix FXS units connect analog phones to the same IP network.
SOHO
IP
PBX Lines
SOHO
CO Trunks
SCN
PBX
Parameter Description
disable The Mediatrix 4104 picks up the SCN line and opens the audio channel
with the peer. This way, the user of a dedicated FXS/FXO combinaison will
feel “closer” to the SCN: as soon as the user takes the receiver off-hook,
he/she interacts with the SCN because the actions are not relayed via IP to
the FXO unit.
enable The Mediatrix 4104 picks up the SCN line and dials the telephone number
associated with the destination of the call before opening the audio channel
with the peer. This is the default value.
4. Define the Hook Flash Processing as per “Hook Flash Processing” on page 302.
Setting the telephonyAttributesHookFlashProcessing variable to outOfBandUsingRtp means the
following:
Table 180: Hook Flash Processing
The hook-flash event received via an RFC The hook-flash event is relayed as telephone-
2833 RTP packet is executed. event 16 via an RFC 2833 RTP packet.
5. Set the behaviour for the support of RFC 2833 in the voiceIfDtmfEnforceDefaultEvents variable for
both units.
Table 181: DTMF Enforce Default Events
Parameter Description
enable Conformance is enforced and support for RFC 2833 implies the support of basic
telephony-events. When setting the variable voiceIfDtmfTransport to
outOfBandUsingRtp (“DTMF Transport Type” on page 227), or the variable
telephonyAttributesHookFlashProcessing to outOfBandUsingRtp (“Hook Flash
Processing” on page 302), the unit will advertise the support for events 0-15; it will
assume support for events 0-15 when support for RFC 2833 is received in an
announcement.
disable This creates a deliberate deviance to RFC 2833 as support of basic events is not
automatic. The variables voiceIfDtmfTransport and
telephonyAttributesHookFlashProcessing then act independently to specify which
events will be relayed via RFC 2833. If Hook Flash relay is enabled by itself, support
of event 16 alone will be advertised; if both Hook Flash and DTMF relay are
activated, events 0-16 are supported.
6. If applicable, configure port mapping as per “Source Line Selection” on page 215.
You could map FXO ports to IP Phones or analog phones connected to FXS ports. This creates
transparent and user-friendly call scenarios, as IP endpoints can act as remote PBX extensions.
Thus the reach of a PBX can be extended beyond the physical location of the PBX. This is
especially an attractive option for SOHO users.
The delayed hot line feature is used to make an automatic call to a specified address on the two following
conditions:
When the user picks up the phone but does not dial any digit.
When the user starts dialing but does not complete a valid number before the timeout set in the
digitMapTimeoutCompletion variable expires. This is the delayed hotline extension feature.
This feature thus places an automatic call whenever the digitMapTimeoutFirstDigit timout expires. It could be
used as an alternative to the emergency number (for instance, the 911 number in North America).
Parameter Description
enable The destination specified in Step 2 is called upon expiration of the timeout.
disable A user beginning to dial a telephone number but failing to complete the operation
before expiration of the digitMapTimeoutCompletion timeout hears the Receiver Off-
Hook tone.
This chapter explains how to set the Mediatrix 4104 to use the Message Waiting Indicator service.
You can also set these parameters via the web interface, as described in “Message Waiting Indicator” on
page 109.
The Message Waiting Indicator (MWI) service alerts the user when new messages have been recorded on a
voice mailbox.
When the user receives a call and does not answer, the notification mechanism detects this situation and starts
the auto attendant. The caller can then leave a message.
After the message is recorded, the server sends a message to the Mediatrix 4104 listing how many new and
old messages are available. The Mediatrix 4104 alerts the user of the new message in two different ways:
The telephone’s LED blinks (if present).
A message waiting stutter dial tone replaces the normal dial tone when the user picks up the
first line.
Note: The message waiting state does not affect the Second Line feature. When in an active call,
performing a flash-hook to get access to the second line plays the usual dial tone.
MWI Method #1
Standards Supported • draft-ietf-sipping-mwi-01.txt (MWI draft)
• “Telecordia GR-1401-CORE (Issue 1, June 2000)”
specification (visual message indication (LED blinking)
• “GR-506-CORE (Issue 1, with Revision 1, November 1996)”
specification (message waiting indicator tone)
The Mediatrix 4104 sends SUBSCRIBE requests to the server for each line, unless there is no subscription
address defined. The Mediatrix 4104 then waits for NOTIFY requests containing the relevant message waiting
information.
2. Define the digits that users must dial to retrieve messages in the mwiFetchDigitMap variable.
Dialing these digits initiates a call to the voice messaging system. For instance, you could decide to
put “*50” as the sequence a user must dial to retrieve voice messages. This sequence must be
unique and follow the syntax for digit maps (see “Chapter 21 - Digit Maps” on page 275). Dialing
this digit map does not have any effect unless the service's status is “enabled”.
The activating sequence is set for all the lines of the Mediatrix 4104. You cannot have different
sequences for each line.
3. Set the destination to call to retrieve messages in the mwiConfigFetchAddress variable.
The user typically initiates a call to the voice messaging system, and then uses an auto-attendant
to get the messages. Available formats are:
• telephone numbers (5551111)
• SIP URLs such as “scheme:user@host”. For instance, “sip:[email protected]”.
This string is used literally, so cosmetic symbols (such as the dash in “555-xxxx”) should not be
present.
Because this variable is located in a table, you can define a different destination for each line of the
Mediatrix 4104.
4. Define the duration, in seconds, of dynamic subscription to a messaging service in the
mwiExpirationTime variable.
5. In the sipInteropMIB, define how Message Waiting Indicator notifications must be validated in the
sipInteropMwiMessageSummaryValidation variable.
Table 183: Message Waiting Indicator Notifications
Parameter Description
enable In order to have the Message Waiting Indicator activated, the SIP notification must
meet all of the following requirements:
Note that only Message Waiting notifications for an established subscription are affected. Message
Waiting notifications without subscription always behave as described in disable.
4. Enable the MWI by setting the mwiConfigActivation variable to enable.
Because this variable is located in a table, you can enable/disable the service on a per-line basis.
Note: The MWI subscription refresh is not supported when the caller ID is DTMF-based, so modifiying the
variable mwiConfigActivation will have no effect.
MWI Method #2
Standards Supported draft-mahy-sip-message-waiting-02.txt (expired) with proprietary
modifications
The Mediatrix 4104 offers the possibility to extend some key features to remote extensions located in Branch
or Home Offices across the SCN.
This service is available only when using the IP Communication Server v3.1 product as a SIP Redirect server.
For instance, a designated analog voice mail system at a main site can provide voice mail for the home or
branch office. The home office user is notified of the message waiting via a message waiting LED on the
telephone or a special tone when picking up the telephone.
Analog voice
mail
Analog signal with
Destination Analog voice mail goes off-hook on one port
MWI = ON or
endpoint Dialing *72x. or *73x.
MWI = OFF
1 Where "x." is the extension number of
5 destination endpoint
4
SIP Notify with 2 SIP INVITE
Message-Waiting: Yes or
Mediatrix Unit Message-Waiting: No Mediatrix Unit
3
SIP Move Temp with contact
p-MxBlindMwiNotify = Yes
or
p-MxBlindMwiNotify = No IP Communication
Server v3.1
26 Management Server
Configuration
The Management Server is a generic name for a module or software that is used to remotely set up Mediatrix
4104 units. For instance, the Management Server could be the Mediatrix’s Unit Manager Network product. See
“Unit Manager Network – Element Management System” on page xxvi for more details.
In the Unit Manager Network Administration Manual, refer to chapter Administration Parameters, section Unit
Manager Server.
You have the choice of setting up Mediatrix 4104 units directly with a SNMP browser or with the Management
Server. If you want to use the Management Server to setup the units, you shall tell these units how to reach
the Management Server.
Configuration Source
The Mediatrix 4104 must know the IP address and port number of the Management Server. You can assign
these information to the Mediatrix 4104 through a DHCP server or manually enter them yourself with the static
variables.
DHCP Configuration
Using the DHCP configuration assumes that you have properly set your DHCP server with the relevant
information. See “Chapter 8 - IP Address and Network Configuration” on page 137 for more details.
3. Set how you want to define the Management Server information in the DHCP server:
Table 184: Management Server DHCP Information
See “Vendor and Site Specific DHCP Options” on page 150 for more details.
Static Configuration
Use the static configuration if you are not using a DHCP server or if you want to bypass it.
Variable Description
QoS (Quality of Service) features enable network managers to decide on packet priority queuing. The
Mediatrix 4104 supports the Differentiated Services (DS) field and 802.1q taggings. There are three variables
– one variable for signalling (SIP) and one variable for each of voice and T.38 media.
The Mediatrix 4104 supports the Real Time Control Protocol (RTCP), which is used to send packets to convey
feedback on quality of data delivery.
The Mediatrix 4104 does not support RSVP (Resource Reservation Protocol).
Differentiated Services (DiffServ, or DS) is a protocol for specifying and controlling network traffic by class so
that certain types of traffic – for example, voice traffic, which requires a relatively uninterrupted flow of data,
might get precedence over other kinds of traffic.
DiffServ replaces the first bits in the ToS byte with a differentiated services code point (DSCP). It uses the
existing IPv4 Type of Service octet.
It is the network administrator’s responsibility to provision the Mediatrix 4104 with standard and correct values.
You can also set these parameters via the web interface, as described in “DiffServ Configuration” on
page 115.
• qosT38FaxDiffServ
These variables are 1 octet scalar ranging from 0 to 255. The DSCP default value should be
101110. This results in the DS field value of 10111000 (184d).
This default value would result in a value of “101” precedence bits, low delay, high throughput, and
normal reliability in the legacy IP networks (RFC 791, RFC 1812). Network managers of legacy IP
networks could use the above-mentioned values to define filters on their routers to take advantage
of priority queuing. The default value is based on the Expedited Forwarding PHB (RFC 2598)
recommendation.
Note: RFC 3168 now defines the state in which to set the two least significant bits in the TOS byte. On the
other hand, this RFC only applies to TCP transmissions and the bits are thus set to “0” in the Mediatrix 4104.
This has the following effects:
• The TOS values for UDP packets are the same as in the MIB.
• The TOS values for TCP packets are equal to the closest multiple of 4 value that is not greater than the
value in the MIB.
IEEE 802.1q
The 802.1q standard recommends the use of the 802.1q VLAN tags for Ethernet frames traffic prioritization.
VLAN tags are 4-byte headers in which three bits are reserved for priority indication. The values of the priority
bits shall be provisioned.
The 802.1q standard comprises the 802.1p standard.
It is the network administrator’s responsibility to provision the Mediatrix 4104 with standard and correct values.
You can also set these parameters via the web interface, as described in “802.1q Configuration” on page 113.
VLAN
VLANs
VLANs are created with standard Layer 2 Ethernet. A VLAN Identifier (VID) is associated with each
VLAN. VLANs offer the following benefits:
• VLANs are supported over all IEEE 802 LAN MAC protocols, and over shared media LANs as
well as point-to-point LANs.
• VLANs facilitate easy administration of logical groups of stations that can communicate as if
they were on the same LAN. They also facilitate easier administration of moves, adds, and
changes in members of these groups.
• Traffic between VLANs is restricted. Bridges forward unicast, multicast, and broadcast traffic
only on LAN segments that serve the VLAN to which the traffic belongs.
The VLAN field in the Ethernet file is located after both destination and source addresses:
0 1
0 1 2 3 4 5 6 7 8 9 0 1 2 3 4 5 6 7 (byte)
+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-
| Dest Addr | Src Addr | VLAN | Type/Length | ...
+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-
The VLAN field is separated as follows:
0 (bit) 1 2 3
0 1 2 3 4 5 6 7 8 9 0 1 2 3 4 5 6 7 8 9 0 1 2 3 4 5 6 7 8 9 0 1
+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
| 0x8100 | Pri |T| VID |
+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
For both signalling and media packets, the VLAN priority section is configurable independently.
28 Syslog Daemon
This chapter describes how to configure and use the Syslog daemon.
The Syslog daemon is a general purpose utility for monitoring applications and network devices with the TCP/
IP protocol. With this software, you can monitor useful messages coming from the Mediatrix 4104 unit. If no
Syslog daemon address is provided by a DHCP server or specified by the administrator, no messages are
sent.
For instance, if you want to download a new software into the Mediatrix 4104, you can monitor each step of
the software download phase. Furthermore, if the unit encounters an abnormal behaviour, you may see
accurate messages that will help you troubleshoot the problem.
In the Unit Manager Network Administration Manual, refer to chapter Administration Parameters, section
Syslog Daemon.
Configuration Source
The Mediatrix 4104 must know the IP address and port number of the Syslog server. You can assign these
information to the Mediatrix 4104 through a DHCP server or manually enter them yourself with the static
variables.
You can also set these parameters via the web interface, as described in “Syslog Monitoring” on page 25.
DHCP Configuration
Using the DHCP configuration assumes that you have properly set your DHCP server with the relevant
information. See “Chapter 8 - IP Address and Network Configuration” on page 137 for more details.
See “Vendor and Site Specific DHCP Options” on page 150 for more details.
Static Configuration
Use the static configuration if you are not using a DHCP server or if you want to bypass it.
Variable Description
Variable Description
Note: This applies only to syslog messages sent on the network and not the local syslog messages.
29 Statistics
The Mediatrix 4104 collects meaningful statistics that can be read via the RTP MIB.
RTP Statistics
RTP statistics are related to the transmission of information and include, but are not limited to:
Number of octets transmitted/received
Number of packets transmitted/received
Number of lost packets
Percentage of lost packets
Minimum, maximum and average Jitter interarrival time (time, in milliseconds, between the
arrival of packets)
Minimum, maximum and average latency time
These statistics are located under the rtpStats group of the rtpMIB. See the MIB Reference manual for more
details.
Statistics Buffers
Each statistics has three different buffers in which they are collected:
Table 189: Statistics Buffers
Statistic Description
Last connection These are the statistics of the last completed connection.
Current These are the statistics of the current connection. If using the Cumulated buffer, they
are added to the cumulated statistics buffer and then reset.
Cumulated These are the cumulated statistics of all the connections. Define a period of time and
maximum number of periods you want to keep. For instance, you could define to
keep the statistics for the last 24 periods of 1 hour.
X To reset statistics:
1. In the sysAdminMIB, set the sysAdminCommand variable to resetStats.
This resets all cumulated call statistics.
Statistics by Syslog
You can configure the Mediatrix 4104 to send the RTP and T.38 statistics by syslog message. You will thus
be able to see them by using your syslog daemon.
The RTP statistics are sent at the end of a call.
The T.38 statistics are sent at the end of a fax.
The syslog message level is “informational” and uses the module name “Statistics”. Table 190 lists the
different statistics fields to send.
Table 190: Statistics by Syslog
Example
The following is an example with sysConfigStatsNumberPeriods = 3 and sysConfigStatsPeriodLength = 1 (5
minutes).
5-minutes sections
Statistics
1 2 3 4 5 6
rtpStatsCurrentTotalOctetsTransmitted 50 30 60 40 100 50
This chapter describes the MTU (Maximum Transmission Unit) requirements of the Mediatrix 4104.
What is MTU?
The Maximum Transmission Unit (MTU) is a parameter that determines the largest packet than can be
transmitted by an IP interface (without it needing to be broken down into smaller units). Each interface used
by TCP/IP may have a different MTU value specified.
The MTU should be larger than or equal to the largest packet you wish to transmit unfragmented. Note that
this only prevents fragmentation locally. Some other link in the path may have a smaller MTU: the packet will
be fragmented at that point, although some routers may refuse packets larger than their MTU.
The Mediatrix 4104 MTU is 1500 bytes, which is the Ethernet typical value.
The implementation of the IEEE Standard 802.1q in the Mediatrix 4104 may have a minor problem because
of hardware limitations.
802.1q increases the Ethernet frame header by 4 bytes, adding a Virtual LAN ID and a user_priority. This is
useful to limit broadcasts that cross bridges, and it may also prioritize frames in the queuing algorithm of
switches. However, it also increases the maximum possible size of Ethernet frames from 1518 to 1522 bytes,
and this might not be handled adequately by every hardware.
A workaround is available for PCs running Windows to avoid sending 1522 bytes packets (note that this
happens only in special and rare cases). The workaround is to reduce the MTU of the interface (the one that
sends packets with 802.1q framing) by 4 bytes.
1. Use the registry editor (regedt32) and go to the key:
Windows 2000 and later:
HKEY_LOCAL_MACHINE\SYSTEM\CurrentControlSet\Services\Tcpip\Parameters\Interfaces\
<ethernet adapter>
Windows NT4 and 98:
\HKEY_LOCAL_MACHINE\SYSTEM\CurrentControlSet\Services\<ethernet
adapter>\Parameters\Tcpip
where <Ethernet adapter> can be found by using the command “ipconfig /all”.
2. Add (or modify) a value named MTU of type REG_DWORD. Set it to 1496 (instead of 1500), in
decimal. Restart the computer to have those changes in effect.
In Windows 2000 and later this value is under the following key:
• Key: Tcpip\Parameters\Interfaces\ID for Adapter2
31 Troubleshooting
You can experience some problems when connecting the Mediatrix 4104 to the network. The following section
examines some of these problems and possible solutions.
A Syslog message lists the problems the Mediatrix 4104 encounters. You can see this message with the
Syslog daemon.
This chapter covers the following types of issues:
General Operation Issues
Calling Issues
Fax Issues
Configuration Issues
Software Upgrade Issues
SNMP Management Software Issues
POSSIBLE CAUSE: If any information is set to come from the DHCP server (for example, SNTP address),
the restarting unit waits for a maximum period of two minutes if the DHCP server cannot be reached,
even if most other settings are set to “static”.
This delay is caused by the Mediatrix 4104 that cannot function as configured if part of its configuration
(the DHCP information) is unavailable.
The two minutes waiting period is an issue with switches that use the Spanning Tree Protocol. When
this protocol is enabled, the restarting Mediatrix 4104 may be denied from the network for a certain time
(about two minutes). The unit must not ignore transmission errors (i.e., timeouts) because these errors
might be caused by the Spanning Tree Protocol.
SOLUTION: Mediatrix recommends to set up all information to use a static value, or have a DHCP server
answer the requests. See “Static Configuration” on page 139 for more details.
DESCRIPTION: I changed the IP address of my unit, but I can’t reach the DHCP server anymore.
POSSIBLE CAUSE: A subnet mask is used to determine to which subnet an IP address belongs. An IP
address has two components, the network address and the host address. For example, let’s consider
the IP address 192.168.0.1. Assuming this is part of a Class B network, the first two numbers (192.168)
represent the Class B network address, and the second two numbers (0.1) identify a particular host on
this network.
Let’s say you have the following information:
• Mediatrix 4104 IP address: 192.168.0.1
• Subnet Mask: 255.255.0.0 (Class B)
• DHCP Server IP address: 192.168.0.20
If you happen to change the Mediatrix 4104 IP address to 192.169.0.1, for instance, the subnet mask
is still valid, but cannot reach your DHCP server anymore. Refer to subnet mask documentation for
more details.
DESCRIPTION: Unable to reach the Mediatrix 4104 after changing the Ethernet speed at run-time.
POSSIBLE CAUSE: Some hubs cannot adapt completely their port speed at run-time.
SOLUTION: Always restart the Mediatrix 4104 for the new setting to take effect. See “Ethernet
Connection Speed” on page 155 for more details.
DESCRIPTION: The Bypass feature does not activate if the SIP proxy times out when a call is initiated.
POSSIBLE CAUSE: In SIP, there is no direct correlation between the user agent and the proxy. The user
agent may be able to complete outgoing calls without the help of the server, and may also receive calls
as well. The problem is thus normal. The SIP proxy going down is rather a network setup problem.
SOLUTION: To avoid those types of failures, the network should use redundant servers when possible.
POSSIBLE CAUSE: You cannot disable the adaptative jitter buffer on the Mediatrix 4104.
SOLUTION: If you set the voiceIfTargetJitterBufferLength and voiceIfMaxJitterBufferLength variables to
the same value, you will have a non-adaptative jitter buffer. See “Adaptative Jitter Buffer” on page 231
for more details.
DESCRIPTION: When I set values such as the User Name and Display Name, the value is not accepted and is
reset to its default value once the Mediatrix 4104 restarts.
POSSIBLE CAUSE: When you enter values that contain non-standard English characters in entries that
accept strings of characters, this invalidates the value and resets it to its default value. However, this
may be visible only once the Mediatrix 4104 restarts.
SOLUTION: Make sure that your string of characters contain only characters that are part of the following
ASCII characters list:
10 LF, line feed 62 >, greater than 94 ^, caret
13 CR, carriage return 63 ?, question mark 95 _, underscore
32 space 64 @, commercial at 96 `, back quote
33 !, exclamation mark 65 A 97 a
34 ", double quote 66 B 98 b
35 #, hash 67 C 99 c
36 $, dollar 68 D 100 d
37 %, percent 69 E 101 e
38 &, ampersand 70 F 102 f
39 ', quote 71 G 103 g
40 (, open parenthesis 72 H 104 h
41 ), close parenthesis 73 I 105 i
42 *, asterisk 74 J 106 j
43 +, plus 75 K 107 k
44 ,, comma 76 L 108 l
45 -, minus 77 M 109 m
46 ., full stop 78 N 110 n
47 /, oblique stroke 79 O 111 o
48 0, zero 80 P 112 p
49 1 81 Q 113 q
50 2 82 R 114 r
51 3 83 S 115 s
52 4 84 T 116 t
53 5 85 U 117 u
54 6 86 V 118 v
55 7 87 W 119 w
56 8 88 X 120 x
57 9 89 Y 121 y
58 :, colon 90 Z 122 z
59 ;, semicolon 91 [, open square bracket 123 {, open curly bracket
60 <, less than 92 \, backslash 124 |, vertical bar
61 =, equals 93 ], close square bracket 125 }, close curly bracket
126 ~, tilde
DESCRIPTION: Mediatrix Technical Support personnel asked me to enable the PCM traces. How do I do it?
POSSIBLE CAUSE: PCM traces are an efficient tool to identify problems with:
• Echo in your network
• DTMF signals
• Caller ID signals
• Fax signals (or false Fax detection)
• Message Waiting Indicator signals
• Any other analog signal
SOLUTION: Do the following:
a. Enable the PCM traces by setting the mxDebugPcmCaptureEnable MIB variable to enable.
b. Set the destination IP address for the PCM traces in the mxDebugPcmCaptureIpAddress MIB
variable.
• This IP address does not have to be listening on ports 5001/2 - 6001/2, as it is easy to
filter out ICMP “port unreachable” messages afterwards.
• The PCM traces destination must be set so it can be recorded in an Ethereal capture
on your network, normally sent to the PC doing the capture.
Note: The PCM capture is performed only on the first port of the Mediatrix 4104.
For more details on the PCM traces, refer to Technical Bulletin 0618 - PCM Traces.
Calling Issues
POSSIBLE CAUSE: Configurable parameters of the Mediatrix 4104 are not set properly.
SOLUTION: Refer to this manual for a complete description of the configurable Mediatrix 4104
parameters.
POSSIBLE CAUSE: There may be calls that have not been properly terminated, which causes a “leak” in
the system.
SOLUTION: You can enable the SIP Context Snapshot time feature. This feature is used to find if there
are improperly terminated calls. This could help to debug the system.
a. In the syslogMIB, set the syslogMsgMaxSeverity variable to debug.
b. Configure and enable the syslog feature.
c. In the sipDebugMIB, set the time, in minutes, between snapshots in the
sipDebugContextSnapshotTime variable.
The list of contexts currently in use are periodically output as debug-level syslog messages.
Note that enabling this feature will also trigger an instant snapshot.
To disable the feature, set this variable to zero (0).
Note that this feature will generate more syslog traffic, about 20 messages at each x minutes.
Note: This feature is currently located under the mediatrixExperimental branch of the MIB structure. See
“MIB Structure” on page 131 for more details.
POSSIBLE CAUSE: It is possible that the unit is refreshing its registration and has entered a race condition
between the refresh and the SIP timeouts. Normally, the Mediatrix 4104 cannot make or receive calls
until the REGISTER request has completed successfully. Because the timeout for a SIP transaction in
UDP is 32 seconds, it is possible to have an ongoing re-REGISTER transaction at the same moment
that the registration itself expires. This could happen if the sipReRegistrationTime variable is set to a
value lower than 32. In that case, the user agent becomes unregistered, and will become registered
again only when the re-REGISTER request is answered with a positive response from the server.
SOLUTION: Set the sipUnregisteredPortBehavior variable to enablePort. This way, when an endpoint is
not registered, it is still enabled. The user can receive and initiate calls. See “Unregistered Line
Behaviour” on page 154 for more details. See also “Refreshing Registration” on page 252 for more
details on the re-registration feature.
DESCRIPTION: When making a 3-way conference, part of the conversation is lost, resulting in a choppy voice.
POSSIBLE CAUSE: The packetization period (ptime) is not the same for all the participants of the
conference, which causes the choppy voice issue.
SOLUTION: For better results, Mediatrix recommends to set the packetization period of all participants of
a 3-way conference to 30 milliseconds. See “Packetization Time” on page 225 for more information on
how to set the packetization period of the Mediatrix 4104.
DESCRIPTION: Unable to establish a call from the Mediatrix 4104 to a user agent such as an IP phone, a
gateway or another access device.
POSSIBLE CAUSE: When the Mediatrix 4104 – with its T.38 capability enabled – tries to establish a call
with a user agent that does not support T.38, this a user agent rejects the call instead of ignoring the
capability it does not support, i.e., T.38.
SOLUTION: Disable the T.38 capability in the Mediatrix 4104. See “T.38 Fax” on page 239 for more
details.
Fax Issues
The following gives information pertaining to faxes. This includes a list of fax models tested with the Mediatrix
4104 and some specific issues the unit may encounter.
POSSIBLE CAUSE: The analog transmission between the fax machine and the Mediatrix 4104 is flaky,
preventing the fax transmission to terminate properly. This problem is known to occur with some fax
machines and it can also occur with a few fax modems.
SOLUTION: Set the Input sound level to -6 dB. If this still does not solve the problem, try the +6 dB value.
See “User Gain” on page 235 for more details.
POSSIBLE CAUSE: To properly send faxes, both units must be configured with the same settings. If you
are attempting to send a fax and the transmission fails, there could be many reasons for this, but most
likely the fax codec settings are at fault. The following explains the logic behind fax transmissions.
When transmitting a fax, Unit A first verifies if Unit B supports the codec you have set in Unit A. If the
codec is supported, the fax should be transmitted properly.
If the fax codec is not supported by Unit B, Unit A tries to find a common preferred G.711 clear channel
codec between the two units. If Unit A finds one, it uses this common clear channel codec and the fax
should be transmitted properly. If there are no common clear channel codecs between the units, the fax
transmission fails.
SOLUTION: To avoid fax transmission problems, configure both units with the same T.38 and clear
channel settings and the fax should be sent properly.
POSSIBLE CAUSE: The Mediatrix 4104 opens the T.38 channel only after receiving the “200 OK”
message from the peer. This means that the Mediatrix 4104 cannot receive T.38 packets before
receiving the “200 OK”. Based on RFC 3264, the T.38 channel should be opened as soon as the unit
sends the “INVITE” message.
Information from RFC 3264 (An Offer/Answer Model with Session Description Protocol (SDP)) - section
5.1: Once the offerer has sent the offer, it must be prepared to receive media for any recvonly streams
described by that offer. It must be prepared to send and receive media for any sendrecv streams in the
offer, and send media for any sendonly streams in the offer (of course, it cannot actually send until the
peer provides an answer with the needed address and port information). In the case of RTP, even
though it may receive media before the answer arrives, it cannot send RTCP receiver reports until the
answer arrives.
SOLUTION: Be sure to reply to the “INVITE” message by a “200 OK” before sending any T.38 message
to the Mediatrix 4104.
Make Models
Make Models
DESCRIPTION: Fax in T.38 fails with particular fax machines and fax test sheet.
ISSUE: Faxes fail when using Brother 255 Model faxes while faxing specific test sheet. The following is
the test sheet used:
DESCRIPTION: Fax in T.38 may fail between a Mediatrix 1104 and a Mediatrix 1124 when using a Canon
Multipass C530 and Panasonic PX-5.
ISSUE: The specific fax combination of Canon MultiPass C530 and Panasonic PX-5 does not work with
the following settings:
• Originating fax: Canon Multipass C530, non-ECM, best encoding, V.17, 14400 bps.
• Terminating fax: Panasonic PX-5, best error correction, best encoding, V.29, 9600 bps.
DESCRIPTION: Fax from Brother to HP Laser Jet may fail more than 50% of the time.
ISSUE: Faxes from Brother models to Hewlett Packard LaserJet 3200 may fail half of the time when sent
from a Mediatrix 1102/2102 to a Mediatrix 1104 by way of two Mediatrix 1204s. The following settings
were tested:
a. Pair 1 tested:
• Brother 6650MC (Originating: TX 3 Pg ECM, best encoding, V.17, 14400 bps, best
resolution).
• Hewlett Packard LaserJet 3200 (Answering: RX 3 Pg, best ECM, best encoding, V.17,
9600 bps, best resolution).
b. Pair 2 tested:
• Brother Fax-580MC (Originating: TX 3 Pg ECM, best encoding, V.17, 14400 bps, best
resolution).
• Hewlett Packard LaserJet 3200 (Answering: RX 3 Pg, best ECM, best encoding, V.17,
9600 bps, best resolution).
c. Pair 3 tested:
• Brother Fax-190 (Originating: TX 3 Pg, non-ECM, best encoding, V.29, 9600 bps, best
resolution).
• Hewlett Packard LaserJet 3200 (Answering: RX 3 Pg, best ECM, best encoding, V.17,
9600 bps, best resolution).
DESCRIPTION: When using the Mediatrix 4104 with the Cyberguard SG530 broadband router, the router
blocks fax transmissions.
Configuration Issues
The following are issues you may encounter when changing the Mediatrix 4104 configuration.
DESCRIPTION: When the Mediatrix 4104 configuration is entirely static and I change the configuration source
of any server from static to DHCP, the service related to the server is not accessible.
POSSIBLE CAUSE: If none of the xxxConfigSource variables (in the ipAddressStatus folder) are set to
dhcp, then the Mediatrix 4104 does not send a DHCP REQUEST message. This is the case if:
• you set all xxxSelectConfigSource variables to something other than dhcp and you
restart the Mediatrix 4104, or
• you select the setConfigSourcesStatic option of the sysAdminCommand variable and
you restart the Mediatrix 4104.
Whenever the xxxSelectConfigSource variable of a specific server, e.g., syslog server, is set to dhcp,
then no IP address can be assigned to that server (this does not trigger a DHCP request).
The service is therefore not functional, the corresponding xxxHost variable is set to 0.0.0.0, and the
corresponding xxxPort variable is not accessible (the GET request result is ERROR), in the
ipAddressStatus folder.
Note: In the case of the SIP servers, the corresponding xxxPort variable is accessible.
SOLUTION: Restart the Mediatrix 4104 or set the proper xxxSelectConfigSource variable to static.
The following are issues you may encounter when performing a software upgrade operation.
DESCRIPTION: An error occurs when the Mediatrix 4104 attempts to communicate with the image server.
POSSIBLE CAUSE: The directory specified in the upgrade command does not exist or does not contain
the files required for the software download process.
SOLUTION:
• Check the directory name.
• Be sure that the directory contains files. If not, extract them from the zip file again. See
“Download Procedure” on page 202 for more details.
• Be sure that the software server is running and properly configured.
POSSIBLE CAUSE: The IP address of the software server is not the correct one.
SOLUTION:
• Check the given IP address.
• Check the IP port.
DESCRIPTION: An error occurs when the Mediatrix 4104 attempts to transfer the software upgrade.
POSSIBLE CAUSE: The Ethernet cable has become disconnected from the Mediatrix 4104 or the PC
running the file transfer.
SOLUTION: Reconnect the cable and start again.
POSSIBLE CAUSE: Power to the Mediatrix 4104 has been disrupted during the file transfer.
SOLUTION: Check the power connection to the Mediatrix 4104 and start again.
DESCRIPTION: When downgrading the Mediatrix 4104 to a previous version of the application software, the
unit does not restart, the ETH LED is blinking and all other LEDs are off.
POSSIBLE CAUSE: The default router IP address is set to 0.0.0.0, which is not supported by the version
to which you downgraded.
SOLUTION: Perform a recovery mode or a factory reset procedure after proceeding with the downgrade
operation.
• If you perform a recovery mode as per “Recovery Mode” on page 17, you must
manually change the default router IP address to a valid address other than 0.0.0.0,
then restart the Mediatrix 4104.
• If you perform a factory reset procedure as per “Factory Reset” on page 18, everything
should be working properly. However, this deletes any custom setting you may have
done in other variables as it reverts the Mediatrix 4104 back to its default factory
settings.
DESCRIPTION: The TFTP server does not recognize the download path and produces an error.
POSSIBLE CAUSE: You should use the “/” character when defining the path to indicate sub-directories,
i.e., c:/temp/download. However, some TFTP servers on the Windows operating system do not
recognize the “/” character and produce an error.
SOLUTION: Use the “\” character in the path definition.
The following are issues you may encounter when trying to contact the Mediatrix 4104 with a SNMP
management software.
DESCRIPTION: The SNMP network management software cannot access the Mediatrix 4104.
POSSIBLE CAUSE: The SNMP network management software does not have the proper Mediatrix 4104
information.
SOLUTION: Check that:
• The IP information for the Mediatrix 4104 is correctly configured.
• The Mediatrix 4104 was restarted after defining the IP information.
• The line through which you are trying to access the Mediatrix 4104 has been unlocked
or is not the correct line. If it is locked, check the connections and network cabling for
the connector.
Try to locate the Mediatrix 4104 IP address. If impossible, perform a recovery reset as indicated in
section “Reset / Default Switch” on page 16.
POSSIBLE CAUSE: The Mediatrix 4104 speaks the three most common SNMP protocols: SNMPv1,
SNMPv2c, and SNMPv3. If you try to access it by using any other protocol, it stays silent.
DESCRIPTION: When trying to set a variable, the Mediatrix 4104 does no respond, nor sends an error
message.
POSSIBLE CAUSE: In secure management mode, the Mediatrix 4104 does not accept SNMPv1 and
SNMPv2c SET requests. However, the MIB variables are viewable in any management mode (secure
and not secure).
DESCRIPTION: When entering a value such as “.23” in a MIB variable (for instance, sipTransportQValue), the
Mediatrix 4104 returns a “Wrong value” error message.
POSSIBLE CAUSE: The Mediatrix 4104 does not support a value such as “.23”.
SOLUTION: Enter a value such as “0.23” instead.
DESCRIPTION: When I try to set a variable with a MIB configuration tool such as Mediatrix Unit Manager
Network, nothing happens.
POSSIBLE CAUSE: The variable may be in a MIB that is located under the mediatrixExperimental branch
of the MIB structure.
Mediatrix configuration tool – the Unit Manager Network – does not support MIBs that are located under
the mediatrixExperimental branch of the MIB structure. The Unit Manager Network does not have
specific tasks to manage variables in experimental MIBs.
The mediatrixExperimental branch is the area where objects and events in MIBs under development
can be placed without fear of conflicting with other MIBs. When the items rooted under an experimental
sub-tree are ready for release, they will be under a permanent branch.
Even though the Unit Manager Network can view experimental MIBs, SNMP operations may not work
properly on them.
POSSIBLE CAUSE: It may take time to fill completely a table: from 1 to 5 seconds. This is normal, because
the unit is an embedded device with limited processing power.
DESCRIPTION: Is it possible for a hacker to change the content of SNMPv3 variables once the Mediatrix 4104
is in secure mode management?
POSSIBLE CAUSE: In secure management mode, the Mediatrix 4104 works in SNMPv1 read-only,
SNMPv2c read-only, and SNMPv3 read/write. SNMP requests using the first two protocols are read-
only, and tables used for setting up SNMPv3 users hide the passwords they carry. Because hackers do
not know what password to use in SNMPv3 requests, they cannot access the Mediatrix 4104 with read-
write permission.
This Appendix lists the various standards compliance of the Mediatrix 4104.
Standards Supported
Category Specification
Agency approvals • UL
• European Union, CE mark (Declaration of Conformity)
• Anatel
• FCC
Safety standards • UL60950-1 1st Edition
• CAN/CSA-C22.2 No. 60950-1-03
• IEC 60950-1 (1st Edition 2001 With all national deviations)
• Anatel Resolution 238:2000
Emissions • FCC Part 15:2004 Class B
• EN55022 (1998) Class B
• EN61000-3-2 (2000) Harmonic current emissions
• EN61000-3-3 (1995) Voltage fluctuations and flicker
• Resolution 442: 2006
Immunity EN55024:1998 including the following (with amendments A1 and A2):
• EN61000-4-2 (1995), ESD
• EN61000-4-3 (1996), Radiated RF
• EN61000-4-4 (1995), Burst Transients
• EN61000-4-5 (1995), Surge
• EN61000-4-6 (1996), Conducted RF
• EN61000-4-11 (1995), Voltage Dips and Interruptions
Telecom • FCC Part 68:Subpart D
• Industry Canada CS-03, issue 9, Part I, November 15, 2004
Note: The standards compliance of the Mediatrix 4104 are printed on a sticker located on the bottom of the
unit.
Disclaimers
Note: Any changes or modifications not expressly approved by Mediatrix could void the user’s authority to
operate the equipment.
Industry Canada
The Industry Canada Label identifies certified equipment. This certification means that the equipment meets
telecommunications network protective, operational and safety requirements as prescribed in the appropriate
Terminal Equipment Technical Requirements document(s). The Department does not guarantee the
equipment will operate to the user's satisfaction.
Before installing this equipment, users should ensure that it is permissible to be connected to the facilities of
the local telecommunications company. The equipment must also be installed using an acceptable method of
connection. The customer should be aware that compliance with the above conditions may not prevent
degradation of service in some situations.
Repairs to certified equipment should be coordinated by a representative designated by the supplier. Any
repairs or alterations made by the user to this equipment, or equipment malfunctions, may give the
telecommunications company cause to request the user to disconnect the equipment.
Users should ensure for their own protection that the electrical ground connections of the power utility,
telephone lines and internal metallic water pipe system, if present, are connected together. This precaution
may be particularly important in rural areas.
Warning: Users should not attempt to make such connections themselves, but should contact the
appropriate electric inspection authority, or electrician, as appropriate.
Note: The Ringer Equivalence Number (REN) for this terminal equipment is 0.0. The Ringer Equivalence
Number (REN) assigned to each terminal device provides an indication of the maximum number of terminals
allowed to be connected to a telephone interface. The termination on an interface may consist of any
combination of devices subject only to the requirement that the sum of the Ringer Equivalence Number of
all the devices does not exceed 5.
Note: This equipment meets the applicable Industry Canada Terminal Equipment Technical Specifications.
This is confirmed by the registration number. The abbreviation, IC, before the registration number signifies
that registration was performed based on a Declaration of Conformity indicating that Industry Canada
technical specifications were met. It does not imply that Industry Canada approved the equipment.
CE Marking
DECLARATION OF CONFORMITY
We Mediatrix Telecom, a Division of Media5 Corporation located at 4229 Garlock st. Sherbrooke,
Québec, Canada J1L 2C8 declare that for the hereinafter mentioned product the presumption of
conformity with the applicable essential requirements of DIRECTIVE 1999/5/EC OF THE
EUROPEAN PARLIAMENT (RTTE DIRECTIVE) is given.
Any unauthorized modification of the product voids this declaration.
For a copy of the original signed Declaration Of Conformity please contact Mediatrix at the above address.
The following information provides an explanation of the symbols which appear on the Mediatrix 4104 and in
the documentation for the product.
Warning: Means danger. You are in a situation that could cause bodily injury. Before you work on any
equipment, you must be aware of the hazards involved with electrical circuitry and familiar with standard
practices for preventing accidents.
Waarschuwing: Dit waarschuwingssymbool betekent gevaar. U overtreat in een situatie die lichamelijk
letsel kan veroorzaken. Voordat u aan enige apparatuur gaat werken, dient u zich bewust te zijn van de bij
elektrische schakelingen betrokken risico's en dient u op de hoogte te zijn van standaard maatregelen om
ongelukken te voorkomen.
Varoitus: Tämä varoitusmerkki merkitsee vaaraa. Olet tilanteessa, joka voi johtaa ruumiinvammaan. Ennen
kuin työskentelet minkään laitteiston parissa, ota selvää sähkökytkentöihin liittyvistä vaaroista ja
tavanomaisista onnettomuuksien ehkäisykeinoista.
Attention: Ce symbole d'avertissement indique un danger. Vous vous trouvez dans une situation pouvant
causer des blessures ou des dommages corporels. Avant de travailler sur un équipement, soyez conscient
des dangers posés par les circuits électriques et familiarisez-vous avec les procédures couramment utilisées
pour éviter les accidents.
Warnung: Dieses Warnsymbol bedeutet Gefahr. Sie befinden sich in einer Situation, die zu einer
Körperverletzung führen könnte. Bevor Sie mit der Arbeit an irgendeinem Gerät beginnen, seien Sie sich der
mit elektrischen Stromkreisen verbundenen Gefahren und der Standardpraktiken zur Vermeidung von
Unfällen bewußt.
Avvertenza: Questo simbolo di avvertenza indica un pericolo. La situazione potrebbe causare infortuni alle
persone. Prima di lavorare su qualsiasi apparecchiatura, occorre conoscere i pericoli relativi ai circuiti elettrici
ed essere al corrente delle pratiche standard per la prevenzione di incidenti.
Advarsel: Dette varselsymbolet betyr fare. Du befinner deg i en situasjon som kan føre til personskade. Før
du utfører arbeid på utstyr, må du vare oppmerksom på de faremomentene som elektriske kretser innebærer,
samt gjøre deg kjent med vanlig praksis når det gjelder å unngå ulykker.
Aviso: Este símbolo de aviso indica perigo. Encontra-se numa situação que lhe poderá causar danos físicos.
Antes de começar a trabalhar com qualquer equipamento, familiarize-se com os perigos relacionados com
circuitos eléctricos, e com quaisquer práticas comuns que possam prevenir possíveis acidentes.
¡Advertencia!: Este símbolo de aviso significa peligro. Existe riesgo para su integridad física. Antes de
manipular cualquier equipo, considerar los riesgos que entraña la corriente eléctrica y familiarizarse con los
procedimientos estándar de prevención de accidentes.
Varning!: Denna varningssymbol signalerar fara. Du befinner dig i en situation som kan leda till
personskada. Innan du utför arbete på någon utrustning måste du vara medveten om farorna med elkretsar
och känna till vanligt förfarande för att förebygga skador.
Safety Warnings
TN Power Warning
Warning: Ultimate disposal of this product should be handled according to all national laws and
regulations.
Warning: To reduce the risk of fire, use only No. 26 AWG or larger telecommunication line cord.
Safety Recommendations
Caution: When using this equipment, basic safety precautions should always be followed to reduce the
risk of fire, electric shock and injury to persons, including the following:
• Do not use this product near water, for example, near a bath tub, wash bowl, kitchen sink or laundry
tub, in a wet basement or near a swimming pool.
• Avoid using a telephone (other than a cordless type) during an electrical storm. There may be a remote
risk of electric shock from lightning.
• Do not use the telephone to report a gas leak in the vicinity of the leak.
The specifications and information regarding this product are subject to change without notice. Every effort is
made to ensure the accuracy of this document. Because of ongoing product improvements and revisions,
Mediatrix cannot guarantee its accuracy, nor can be responsible for errors or omissions. Please contact your
Mediatrix sales representative to obtain the latest version of the technical specifications.
The Mediatrix 4104 has been designed to support all major industry standards used today, as well as those
that will eventually be implemented at a later date. Because of this specific design characteristic, the Mediatrix
4104 can be integrated with existing telephone, fax and data equipment such as PCs and routers.
Table 194: Industry Standard Protocols
Parameter Description
Hardware Features
Display
Power LED
LAN activity LED
Activity/In-Use LED indication on FXS ports
Ready LED
Interfaces
4 x RJ-11 connectors, analog phone/fax (FXS) interface.
1 x RJ-11 connector, PSTN bypass.
1 x RJ-45 connector, 10/100 BaseT Ethernet access (autosense: up to 100 Mbits).
Power
Integrated universal power supply input that can accept 100 to 240 Vac, 50/60 Hz input.
Seamless switch over period if the client UPS detects a power loss and activates within 8 ms.
Casing / Installation
Casing: Desktop (Plastic ABS UL94 V0).
Installation: The Mediatrix 4104 is designed for the desktop or can be wall-mountable.
Parameter Description
Parameter Description
Audio Specifications
Software input and output level adjustable within the range of -30 dB to +20 dB.
Software-adjustable dynamic and static jitter buffer protection.
Programmable by country: Call progress tone generation including dial tone, busy tone,
ringback and error tones.
DSP-based echo control device.
Silence detection/suppression level software adjustable.
Parameter Description
Parameter Description
MTBF Value
The Mean Time Before Failure (MTBF) value of the Mediatrix 4104 is 250,000 hours at 25 degrees Celsius
ambient temperature. It has been defined using RelCalc v5.0, Bellcore method (LimitedStress - Method I,
Case 3), Desktop unit.
Power Consumption
Parameter Description
Operating Environment
Table 200: Operating Environment
Parameter Description
Parameter Description
Dimensions 22 cm x 17.6 cm x 4.9 cm - 8.7 in. x 6.9 in. x 1.9 in. (approx.)
Weight TBD
Warranty
All Mediatrix products carry Mediatrix Telecom, a Division of Media5 Corporation's standard three-year
hardware and software warranty. An extended warranty is available.
C Cabling Considerations
This Appendix describes the pin-to-pin connections for cables used with the Mediatrix 4104.
Warning: To reduce the risk of fire, use only No. 26 AWG or larger telecommunication line cord.
RJ-45 Cable
The RJ-45 connector is commonly used for network cabling and for telephony applications. It is used to wire
both ends identically so the signals pass straight through.
RJ-45 cabling is also known as Twisted-pair Ethernet (TPE), Unshielded twisted pair (UTP) and 10/100
Base-T.
7 8
5 6
3 4
1 2
Colour Coding
Pin # Function
EIA/TIA 568B
EIA/TIA 568A
AT&T 258A
The RJ-45 cable uses two pairs of wires: one pair for transmission and the second pair for reception. It is wired
so that pins 1 & 2 are on one twisted pair and pins 3 & 6 are on a second pair according to common wiring
standards which meet the EIA/TIA T568A and T568B requirements.
Pin 2 Pin 2
Pin 3 Pin 3
Pin 6 Pin 6
1 Transmit Data Plus The positive signal for the TD differential pair. This signal contains the serial
output data stream transmitted onto the network.
2 Transmit Data Minus The negative signal for the TD differential pair. This contains the same
output as pin 1.
3 Receive Data Plus The positive signal for the RD differential pair. This signal contains the serial
input data stream received from the network.
4 not connected
5 not connected
6 Receive data minus The negative signal for the RD differential pair. This signal contains the
same input as pin 3.
7 not connected
8 not connected
Crossover Cable
A RJ-45 crossover cable is used when only two systems are to be connected to each other, peer to peer, at
the Ethernet Cards by “crossing over” (reversing) their respective pin contacts. An example would be
connecting two computers together to create a network. The crossover eliminates the need for a hub when
connecting two computers. A crossover cable may also be required when connecting a hub to a hub, or a
transceiver to transceiver or repeater to repeater. When connecting a hub to a transceiver, a straight through
cable is always used.
Note: This is not an IEEE supported configuration and should be used for test purposes only.
A crossover cable is sometimes called a null modem. The coloured wires at either end are put into different
pin numbers, or crossed over.
2- TX- TX- -2
3- RC+ RC+ -3
6- RC- RC- -6
Wiring Conventions
For telephone connections, a cable requires one pair of wires. Each wire is identified by different colors. For
example, one wire might be red and the other, red with white stripes. Also, an RJ-11 connector must be
attached to both ends of the cable.
Each wire pair must be attached to the RJ-11 connectors in a specific orientation. The following figure
illustrates how the pins on the RJ-11 connector are numbered. Be sure to hold the connectors in the same
orientation when attaching the wires to the pins.
Pin # Function
1 Not used
2 Not used
3 Ring
4 Tip
5 Not used
6 Not used
The RJ-11 pair of wires is wired so that pins 3 and 4 are connected to the Ring and Tip, which meets the
following requirements:
EIA/TIA-IS 968
CS-03 Issue 8, Part III requirements.
Warning: The RJ-11 cable should comply with UL 1863 and CSA C22.2 No 233 standards.
D Country-Specific Parameters
The following parameters differ depending on the country in which you are.
Definitions
Term Description
Stutter Dial Tone Notifies the user that they have a voice mail message when the phone
does not or cannot have a message-waiting light.
Receiver Off Hook (ROH) Tone Indicates that the telephone is not hung up correctly.
Message Waiting Indicator Tone Indicates there is a message waiting somewhere for the owner of the
phone.
Network Congestion Tone Indicates that all switching paths are busy, all toll trunks are busy, or
there are equipment blockages.
Conventions
The following conventions apply to this Appendix.
Frequencies
Symbol “*” means modulated. For instance: 425 Hz * 25 means 425 Hz modulated at 25 Hz.
Symbol “+” means added. For instance: 425 Hz + 330 Hz means that both 425 Hz and 330 Hz
sines are played at the same time.
When a tone is composed of more than one frequency, if not otherwise specified, the given
electrical level applies to each frequency taken separately.
Impedance
Impedance is the apparent resistance, in an electric circuit, to the flow of an alternating current, analogous to
the actual electrical resistance to a direct current, being the ratio of electromotive force to the current.
When representing an impedance, the following applies:
Symbol “//” means parallel.
Symbol “+” means serial.
Input Impedance
Impedance of the Mediatrix 4104 at the Tip and Ring wires.
Line Attenuation
Values are given in dBr (deciBel relative):
A “+” for input means that the digital side is attenuated by x decibels relative to the analog side.
A “+” for output means that the analog side is amplified by x decibels relative to the digital side.
A “-” for input means that the digital side is amplified by x decibels relative to the analog side.
A “-” for output means that the analog side is attenuated by x decibels relative to the digital side.
On-Off Sequences
Values in bold are “on” cycles, where tones are audible. Values in normal style are “off” cycles, where tones
are not audible. When not otherwise specified, sequences repeat forever. A “x” symbol means that the
sequences between parenthesis is repeated x times. The next cycle(s) repeat forever, unless otherwise
specified. Values are in seconds.
For instance:
3*(0.1 – 0.1) then 0.6 – 1.0 - 0.2 – 0.2
means that the 0.1s on and 0.1s off sequence is repeated 3 times, afterwards the 0.6s on, 1.0s off, 0.2s on
and 0.2s off sequence repeats forever.
Distinctive Ring
The distinctive ring service allows you to have three different numbers with each their own ring. The numbers
ring through a single line coming into the business or residence and each number can be distinguished by the
pattern of the ring. These ring patterns are made up of various combinations of ring bursts.
This feature uses the "Alert-Info" header from the initial INVITE of a call to know if the call requires a distinctive
ringing.
The supported values of the "Alert-Info" are:
The Mediatrix 4104 plays the default ring of the country selected if the Alert-Info value is not present or the
value is not supported.
Note: Since the first pause of the distinctive ring is lower that 1 second, a splash ring followed by an Off of
1 second precedes the distinctive ring pattern.
Australia
Australia 1
The following parameters apply if you have selected Australia1 as location.
Table 207: Australia 1 Parameters
Receiver Off Hook (ROH) Tone 1400 Hz 0.1 – 0.1 -21 dBm
2067 Hz -21 dBm
2467 Hz -21 dBm
2600 Hz -21 dBm
Message Waiting Indicator Tone 425 Hz * 25 0.1 – 0.04, x72 -18 dBm
Australia 2
The following parameters apply if you have selected Australia2 as location.
Table 208: Australia 2 Parameters
Receiver Off Hook (ROH) Tone 1400 Hz 0.1 – 0.1 -21 dBm
2067 Hz -21 dBm
2467 Hz -21 dBm
2600 Hz -21 dBm
Message Waiting Indicator Tone 425 Hz * 25 0.1 – 0.04, x72 -18 dBm
Australia 3
The following parameters apply if you have selected Australia3 as location.
Table 209: Australia 3 Parameters
Receiver Off Hook (ROH) Tone 1400 Hz 0.1 – 0.1 -21 dBm
2067 Hz -21 dBm
2467 Hz -21 dBm
2600 Hz -21 dBm
Message Waiting Indicator Tone 425 Hz * 25 0.1 – 0.04, x72 -18 dBm
Austria
Austria 1
The following parameters apply if you have selected Austria1 as location.
Table 210: Austria Parameters
Receiver Off Hook (ROH) Tone 1400 Hz 0.1 – 0.1 -19 dBm
2060 Hz -19 dBm
2450 Hz -19 dBm
2600 Hz -19 dBm
Message Waiting Indicator Tone 450 Hz (0.1 – 0.1) x 10, CONTINUOUS -20 dBm
Network Congestion Tone 450 Hz (0.1 – 0.1) x10, CONTINUOUS -20 dBm
Austria 2
The following parameters apply if you have selected Austria2 as location.
Table 211: Austria 2 Parameters
Brazil
Receiver Off Hook (ROH) Tone 425 Hz 0.25 – 0.25 -10 dBm
Message Waiting Indicator Tone 425 Hz (0.1 – 0.1) x 10, CONTINUOUS -15 dBm
Chile
Chile 1
The following parameters apply if you have selected Chile1 as location.
Table 213: Chile 1 Parameters
Receiver Off Hook (ROH) Tone 425 Hz 0.25 – 0.25 -10 dBm
Message Waiting Indicator Tone 425 Hz (0.1 – 0.1) x 10 CONTINUOUS -10 dBm
Tbrl-Impedance 600 Ω
Chile 2
The following parameters apply if you have selected Chile2 as location.
Table 214: Chile 2 Parameters
Receiver Off Hook (ROH) Tone 425 Hz 0.25 – 0.25 -10 dBm
Message Waiting Indicator Tone 425 Hz (0.1 – 0.1) x 10 CONTINUOUS -10 dBm
Tbrl-Impedance 900 Ω
China
Receiver Off Hook (ROH) Tone 950 Hz 15.0 – 15.0 – 15.0 -25 dBm
950 Hz 15.0 – 15.0 – 15.0 -16 dBm
950 Hz 15.0 – 15.0 – 15.0 -8 dBm
950 Hz 15.0 – 15.0 – 15.0 – CONTINUOUS -6 dBm
Czech Republic
The following parameters apply if you have selected Czech Republic as location.
Table 216: Czech Republic Parameters
Stutter Dial Tone 425 Hz (0.165 – 0.165) x 3, 0.66 – 0.66 -12 dBm
Receiver Off Hook (ROH) Tone 1400 Hz 0.1 – 0.1 -19 dBm
2060 Hz -19 dBm
2450 Hz -19 dBm
2600 Hz -19 dBm
Message Waiting Indicator Tone 425 Hz (0.1 – 0.1) x 10, 0.33 – 0.33, 0.66 – 0.66 -12 dBm
Denmark
Receiver Off Hook (ROH) Tone 1400 Hz 0.1 – 0.1 -19 dBm
2060 Hz -19 dBm
2450 Hz
2600 Hz -19 dBm
-19 dBm
Message Waiting Indicator Tone 425 Hz (0.1 – 0.1) x 10, CONTINUOUS -15 dBm
France
Receiver Off Hook (ROH) Tone 1400 Hz 0.1 – 0.1 -19 dBm
2060 Hz -19 dBm
2450 Hz -19 dBm
2600 Hz -19 dBm
Germany
Germany 1
The following parameters apply if you have selected Germany 1 as location.
Table 219: Germany 1 Parameters
Receiver Off Hook (ROH) Tone 1400 Hz 0.1 – 0.1 -19 dBm
2060 Hz -19 dBm
2450 Hz -19 dBm
2600 Hz -19 dBm
Germany 2
The following parameters apply if you have selected Germany 2 as location.
Table 220: Germany 2 Parameters
Receiver Off Hook (ROH) Tone 1400 Hz 0.1 – 0.1 -19 dBm
2060 Hz -19 dBm
2450 Hz -19 dBm
2600 Hz -19 dBm
Germany 3
The following parameters apply if you have selected Germany 3 as location.
Table 221: Germany 3 Parameters
Dial Tone 425 Hz 0.2 – 0.2, 0.2 – 0.2, 0.2 – 0.8 -16 dBm
Receiver Off Hook (ROH) Tone 1400 Hz 0.1 – 0.1 -19 dBm
2060 Hz -19 dBm
2450 Hz -19 dBm
2600 Hz -19 dBm
Hong Kong
The following parameters apply if you have selected Hong Kong as location.
Table 222: Hong Kong Parameters
Ringback Tone 440 + 480 Hz 0.4 – 0.2, 0.4 –3.0 -13 dBm
Stutter Dial Tone 350 + 440 Hz (0.1 – 0.1) x 20, CONTINUOUS -16 dBm
Confirmation Tone 350 + 440 Hz 0.1 – 0.1, 0.3 – End -16 dBm
Receiver Off Hook (ROH) Tone 1400 Hz 0.1 – 0.1 -19 dBm
2060 Hz -19 dBm
2450 Hz -19 dBm
2600 Hz -19 dBm
Message Waiting Indicator Tone 350 + 440 Hz (0.2 – 0.2, 0.5 – 0.2) x 4, CONTINUOUS -16 dBm
Indonesia
Special Information Tone 950 Hz 0.33 – 0.03, 0.33 – 0.03, 0.33 – 1.0 -9 dBm
1400 Hz
1800 Hz
Receiver Off Hook (ROH) Tone 1400 Hz 0.1 – 0.1 -19 dBm
2060 Hz -19 dBm
2450 Hz -19 dBm
2600 Hz -19 dBm
Israel
Receiver Off Hook (ROH) Tone 1440 Hz 0.12 – 0.88 -20 dBm
2060 Hz -20 dBm
2452 Hz -20 dBm
2600 Hz -20 dBm
Message Waiting Indicator Tone 400 Hz (0.16 – 0.16) x 10, CONTINUOUS -15 dBm
Italy
Stutter Dial Tone 425 Hz (0.1 – 0.1) x 3, 0.2 – 0.2, 0.6 – 1.0 -13 dBm
Receiver Off Hook (ROH) Tone 1400 Hz 0.1 – 0.1 -19 dBm
2060 Hz -19 dBm
2450 Hz -19 dBm
2600 Hz -19 dBm
Message Waiting Indicator Tone 425 Hz (0.1 – 0.1) x 10, 0.2 – 0.2, 0.6 – 1.0 -13 dBm
Japan
Receiver Off Hook (ROH) Tone 1400 Hz 0.1 – 0.1 -19 dBm
2060 Hz -19 dBm
2450 Hz -19 dBm
2600 Hz -19 dBm
Message Waiting Indicator Tone 400 Hz (0.1 – 0.1) x 10, CONTINUOUS -13 dBm
Malaysia
Receiver Off Hook (ROH) Tone 1400 Hz 0.1 – 0.1 -19 dBm
2060 Hz -19 dBm
2450 Hz -19 dBm
2600 Hz -19 dBm
Message Waiting Indicator Tone 425 Hz (0.1 – 0.1) x 10, CONTINUOUS -14 dBm
Mexico
Receiver Off Hook (ROH) Tone 1400 Hz 0.1 – 0.1 -19 dBm
2060 Hz -19 dBm
2450 Hz -19 dBm
2600 Hz -19 dBm
Message Waiting Indicator Tone 425 Hz (0.1 – 0.1) x 10 CONTINUOUS -14 dBm
Netherlands
Receiver Off Hook (ROH) Tone 1400 Hz 0.1 – 0.1 -19 dBm
2060 Hz -19 dBm
2450 Hz -19 dBm
2600 Hz -19 dBm
Message Waiting Indicator Tone 425 Hz (0.1 – 0.1) x 10 CONTINUOUS -17 dBm
New Zealand
The following parameters apply if you have selected New Zealand as location.
Table 230: New Zealand Parameters
Ringback Tone 400 Hz + 450 Hz 0.4 – 0.2, 0.4 – 2.0 -19 dBm
Receiver Off Hook (ROH) Tone 1400 Hz 0.1 – 0.1 -19 dBm
2060 Hz -19 dBm
2450 Hz -19 dBm
2600 Hz -19 dBm
Message Waiting Indicator Tone 400 Hz (0.1 – 0.1) x12, CONTINUOUS -17 dBm
North America
The following parameters apply if you have selected North America as location.
North America 1
The following parameters apply if you have selected North America 1 as location.
Table 231: North America 1 Parameters
Receiver Off Hook (ROH) Tone 1400 Hz 0.1 – 0.1 -19 dBm
2060 Hz -19 dBm
2450 Hz -19 dBm
2600 Hz -19 dBm
Message Waiting Indicator Tone 350+440 Hz (0.1 – 0.1) x 10, CONTINUOUS -17 dBm
Tbrl-Impedancea 600 Ω
North America 2
The following parameters apply if you have selected North America 2 as location.
Table 232: North America 2 Parameters
Receiver Off Hook (ROH) Tone 1400 Hz 0.1 – 0.1 -19 dBm
2060 Hz -19 dBm
2450 Hz -19 dBm
2600 Hz -19 dBm
Message Waiting Indicator Tone 350+440 Hz (0.1 – 0.1) x 10, CONTINUOUS -17 dBm
a. TBRL-Impedance for “off-premise" or long loop ports (wire length longer than 2.5 km).
Russia
Receiver Off Hook (ROH) Tone 425 Hz 3 x (0.1 – 0.1), CONTINUOUS -10 dBm
Message Waiting Indicator Tone 425 Hz (0.1 – 0.1) x 10 CONTINUOUS -10 dBm
Spain
Receiver Off Hook (ROH) Tone 1400 Hz 0.1 – 0.1 -19 dBm
2060 Hz -19 dBm
2450 Hz -19 dBm
2600 Hz -19 dBm
Message Waiting Indicator Tone 425 Hz (0.1 – 0.1) x 10, CONTINUOUS -10 dBm
Network Congestion Tone 425 Hz 0.2 – 0.2, 0.2 – 0.2, 0.2 – 0.6 -13 dBm
Sweden
Receiver Off Hook (ROH) Tone 1400 Hz 0.1 – 0.1 -19 dBm
2060 Hz -19 dBm
2450 Hz -19 dBm
2600 Hz -19 dBm
Message Waiting Indicator Tone 425 Hz (0.1 – 0.1) x 10, CONTINUOUS -12.5 dBm
Switzerland
Receiver Off Hook (ROH) Tone 1400 Hz 0.1 – 0.1 -19 dBm
2060 Hz -19 dBm
2450 Hz -19 dBm
2600 Hz -19 dBm
Message Waiting Indicator Tone 425 Hz (0.1 – 0.1) x 10, CONTINUOUS -8 dBm
Thailand
Receiver Off Hook (ROH) Tone 1400 Hz 0.1 – 0.1 -19 dBm
2060 Hz -19 dBm
2450 Hz -19 dBm
2600 Hz -19 dBm
Message Waiting Indicator Tone 400 * 50 Hz (0.1 – 0.1) x 10, CONTINUOUS -16 dBm
UK
The following parameters apply if you have selected the United Kingdom as location.
Table 238: UK Parameters
Receiver Off Hook (ROH) Tone 1400 Hz 0.1 – 0.1 -19 dBm
2060 Hz -19 dBm
2450 Hz -19 dBm
2600 Hz -19 dBm
Message Waiting Indicator Tone 350+440 Hz (0.1 – 0.1) x 10, CONTINUOUS -22 dBm
Network Congestion Tone 400 Hz 0.4 – 0.35, 0.225 – 0.525 -19 dBm
E Glossary
10 BaseT
An Ethernet local area network that works on twisted pair wiring.
100 BaseT
A newer version of Ethernet that operates at 10 times the speed of a 10 BaseT Ethernet.
Access Device
Device capable of sending or receiving data over a data communications channel.
A-Law
The ITU-T companding standard used in the conversion between analog and digital signals in PCM (Pulse
Code Modulation) systems. A-law is used primarily in European telephone networks and contrasts with the
North American mu (µ)-law standard. See also mu (µ)-law.
Area Code
The preliminary digits that a user must dial to be connected to a particular outgoing trunk group or line. In North
America, an area code has three digits and is used with a NXX (office code) number. For instance, in the North
American telephone number 561-955-1212, the numbers are defined as follows:
Table 239: North American Numbering Plan
No. Description
561 Area Code, corresponding to a geographical zone in a non-LNP (Local Number Portability)
network.
955 NXX (office code), which corresponds to a specific area such as a city region.
1212 Unique number to reach a specific destination.
Outside North America, the area code may have any number of digits, depending on the national
telecommunication regulation of the country. In France, for instance, the numbering terminology is xZABPQ
12 34, where:
Table 240: France Numbering Plan
No. Description
In this context, the area code corresponds to the Z portion of the numbering plan. Because virtually every
country has a different dialing plan nomenclature, it is recommended to identify the equivalent of an area code
for the location of your communication unit.
Echo Cancellation
Technique that allows for the isolation and filtering of unwanted signals caused by echoes from the main
transmitted signal.
G.711
ITU-T recommendation for an algorithm designed to transmit and receive A-law PCM (Pulse Code Modulation)
voice at digital bit rates of 48 kbps, 56 kbps, and 64 kbps. It is used for digital telephone sets on digital PBX
and ISDN channels.
G.723.1
A codec that provides the greatest compression, 5.3 kbps or 6.3 kbps; typically specified for multimedia
applications such as H.323 videoconferencing.
G.726
Nn implementation of ITU-T G.726 standard for conversion linear or A-law or µ-law PCM to and from a 40, 32,
24 or 16 kbit/s channel.
G.729
A codec that provides near toll quality at a low delay which uses compression to 8 kbps (8:1 compression rate).
Gateway
A device linking two different types of networks that use different protocols (for example, between the packet
network and the Public Switched Telephone Network).
Impedance
Impedance is the apparent resistance, in an electric circuit, to the flow of an alternating current, analogous to
the actual electrical resistance to a direct current, being the ratio of electromotive force to the current.
Internet-Drafts
Internet-Drafts are working documents of the IETF, its areas, and its working groups. Note that other groups
may also distribute working documents as Internet-Drafts.
Jitter
A distortion caused by the variation of a signal from its references which can cause data transmission errors,
particularly at high speeds.
Layer 2
Layer 2 refers to the Data Link Layer of the commonly-referenced multilayered communication model, Open
Systems Interconnection (OSI). The Data Link Layer is concerned with moving data across the physical links
in the network.
The Data-Link Layer contains two sublayers that are described in the IEEE-802 LAN standards:
Media Access Control (MAC)
Logical Link Control (LLC)
Layer 3
Layer 3 refers to the Network layer of the commonly-referenced multilayered communication model, Open
Systems Interconnection (OSI). The Network Layer is concerned with knowing the address of the
neighbouring nodes in the network, selecting routes and quality of service, and recognizing and forwarding to
the transport layer incoming messages for local host domains.
Management Server
Includes a web-based provisioning client, provisioning server, and SNMP proxy server used to manage all
agents connected to the system. The Management Server provides Gateway provisioning, Monitoring, and
Numbering Plan.
Mu (µ)-Law
The PCM (Pulse Code Modulation) voice coding and companding standard used in Japan and North America.
See also A-Law.
Network
A group of computers, terminals, and other devices and the hardware and software that enable them to
exchange data and share resources over short or long distances. A network can consist of any combination
of local area networks (LAN) or wide area networks (WAN).
Off-hook
A line condition caused when a telephone handset is removed from its cradle.
On-hook
A line condition caused when a telephone handset is resting in its cradle.
Packet
Includes three principal elements: control information (such as destination, origin, length of packet), data to be
transmitted, and error detection. The structure of a packet depends on the protocol.
Port
Network access point, the identifier used to distinguish among multiple simultaneous connections to a host.
Protocol
A formal set of rules developed by international standards bodies, LAN equipment vendors, or groups
governing the format, control, and timing of network communications. A set of conventions dealing with
transmissions between two systems. Typically defines how to implement a group of services in one or two
layers of the OSI reference model. Protocols can describe low-level details of machine-to-machine interfaces
or high-level exchanges between allocation programs.
Proxy Server
An intermediary program that acts as both a server and a client for the purpose of making requests on behalf
of other clients. Requests are serviced internally or by passing them on, possibly after translation, to other
servers. A proxy interprets, and, if necessary, rewrites a request message before forwarding it.
Registrar Server
A server that accepts REGISTER requests. A registrar is typically co-located with a proxy or redirect server
and MAY offer location services.
Router
A specialized switching device which allows customers to link different geographically dispersed local area
networks and computer systems. This is achieved even though it encompasses different types of traffic under
different protocols, creating a single, more efficient, enterprise-wide network.
Server
A computer or device on a network that works in conjunction with a client to perform some operation.
Stack
A set of network protocol layers that work together. The OSI Reference Model that defines seven protocol
layers is often called a stack, as is the set of TCP/IP protocols that define communication over the Internet.
Subnet
An efficient means of splitting packets into two fields to separate packets for local destinations from packets
for remote destinations in TCP/IP networks.
T.38
An ITU-T Recommendation for Real-time fax over IP. T.38 addresses IP fax transmissions for IP-enabled fax
devices and fax gateways, defining the translation of T.30 fax signals and Internet Fax Protocols (IFP) packets.
Telephony
The science of translating sound into electrical signals, transmitting them, and then converting them back into
sound.
F List of Acronyms
dB Decibel
DHCP Dynamic Host Configuration Protocol
DNS Domain Name Server
DS Differentiated Services
DSCP Differentiated Services Code Point
DTMF Dual Tone Multi-Frequency
A
analogScnGwDialEnable .............................................................................................................................................. 305
analogScnGwDtmfDuration.................................................................................................................................. 171, 230
analogScnGwInterDigitDialDelay ........................................................................................................................ 171, 230
C
checkTcpIpStackForSuccessfulBoot ............................................................................................................................ 19
configFileAutoUpdateOnRestartEnable ..................................................................................................................... 189
configFileAutoUpdatePeriod ........................................................................................................................................ 190
configFileAutoUpdatePeriodicEnable ......................................................................................................................... 191
configFileAutoUpdateTimeOfDay ............................................................................................................................... 190
configFileAutoUpdateTimeUnit .................................................................................................................................... 190
configFileFetchingConfigSource ................................................................................................................................... 18
configFileFetchingDhcpSiteSpecificCode.......................................................................................................... 145, 182
configFileFetchingFileLocation .................................................................................................................................... 183
configFileFetchingFileName ........................................................................................................................................ 183
configFileFetchingHost ......................................................................................................................................... 145, 182
configFileFetchingPort .......................................................................................................................................... 145, 182
configFileFetchingSelectConfigSource .............................................................................................................. 145, 182
configFileFetchingSpecificFileName .......................................................................................................................... 184
configFileFetchingStaticHost ............................................................................................................................... 145, 182
configFileFetchingStaticPort ................................................................................................................................ 145, 182
configFilePrivacyEnable ............................................................................................................................................... 186
configFilePrivacyGenericSecret .................................................................................................................................. 186
configFilePrivacySpecificSecret .................................................................................................................................. 186
configFileTransferPassword ........................................................................................................................ 188, 189, 190
configFileTransferProtocol ................................................................................................................... 187, 188, 189, 190
configFileTransferUsername........................................................................................................................ 188, 189, 190
countryCustomizationToneOverride ........................................................................................................................... 175
countryCustomizationToneTone ................................................................................................................................. 175
D
dataIfClearChannelCodecPreferred ........................................................................................................................... 238
dataIfCngToneDetectionEnable .................................................................................................................................. 237
dataIfCodecT38Enable ................................................................................................................................................. 240
dataIfCodecT38ProtectionLevel .................................................................................................................................. 240
dataIfT38FinalFramesRedundancy ............................................................................................................................ 240
dataIfT38NoSignalEnable ............................................................................................................................................ 240
dataIfT38NoSignalTimeout .......................................................................................................................................... 240
digitMapAllowedDigitMap ............................................................................................................................................. 278
digitMapAllowedEnable................................................................................................................................................. 278
digitMapPrefixedDigitRemovalCount .......................................................................................................................... 278
digitMapPrependedString ............................................................................................................................................. 278
digitMapRefusedDigitMap ............................................................................................................................................ 278
digitMapRefusedEnable ................................................................................................................................................ 278
digitMapSuffixStringToRemove ................................................................................................................................... 278
digitMapTimeoutCompletion ........................................................................................................................................ 279
digitMapTimeoutFirstDigit ............................................................................................................................................. 279
digitMapTimeoutInterDigit ............................................................................................................................................ 279
E
emergencyCallUrgentGatewayDigitMap.................................................................................................................... 284
emergencyCallUrgentGatewayEnable ....................................................................................................................... 284
emergencyCallUrgentGatewayTargetAddress ......................................................................................................... 284
F
fxoWaitForCalleeToAnswerEnable ............................................................................................................................. 305
fxsBlankAnonymousCallerId ........................................................................................................................................ 219
fxsByPassEnable ........................................................................................................................................................... 241
fxsCalleeHangupDelay ................................................................................................................................................. 218
fxsCalleeHangupSupervision ....................................................................................................................................... 218
fxsFlashHookDetectionDelayMax ............................................................................................................................... 215
fxsFlashHookDetectionDelayMin ................................................................................................................................ 215
fxsLoopCurrent ............................................................................................................................................................... 217
fxsLoopCurrentDropEnable.......................................................................................................................................... 217
fxsPolarityAndDenialBehavior ..................................................................................................................................... 219
G
groupAdminState ........................................................................................................................................... 188, 206, 207
groupReset ........................................................................................................................................................................ 19
groupSetAdmin ................................................................................................................................. 19, 187, 188, 206, 207
H
httpServerDefaultPassword ........................................................................................................................................... 28
httpServerEnable ............................................................................................................................................................. 21
httpServerPort .................................................................................................................................................................. 21
httpServerResetToDefaultPwd ................................................................................................................................ 28, 29
httpServerUsername ....................................................................................................................................................... 28
I
IfAdminInitialAdminState............................................................................................................................................... 214
ifAdminSetAdmin............................................................................................................................................................ 213
imageAutoUpdateEnable...................................................................................................................................... 208, 210
imageAutoUpdateOnRestartEnable ........................................................................................................................... 208
imageAutoUpdatePeriod .............................................................................................................................................. 209
imageAutoUpdateTimeOfDay ...................................................................................................................................... 210
imageAutoUpdateTimeUnit .......................................................................................................................................... 209
imageConfigSource ......................................................................................................................................................... 18
imageDhcpPrimarySiteSpecificCode ................................................................................................................. 143, 200
imageDhcpSecondarySiteSpecificCode ............................................................................................................ 143, 200
imageLocation ........................................................................................................................................................ 202, 203
imageLocationProvisionSource ................................................................................................................................... 202
imagePrimaryHost ........................................................................................................................................... 17, 143, 200
imagePrimaryPort ............................................................................................................................................ 17, 143, 200
imageSecondaryHost ...................................................................................................................................... 17, 143, 200
imageSecondaryPort ....................................................................................................................................... 17, 143, 200
imageSelectConfigSource .................................................................................................................................... 143, 200
imageSelectionFileLocation ................................................................................................................................. 202, 203
imageStaticPrimaryHost ............................................................................................................................................... 201
imageStaticPrimaryPort ................................................................................................................................................ 201
imageStaticSecondaryHost .......................................................................................................................................... 201
imageStaticSecondaryPort ........................................................................................................................................... 201
imageTransferPassword ............................................................................................................................... 207, 208, 209
imageTransferProtocol .......................................................................................................................... 206, 207, 208, 209
imageTransferUsername .............................................................................................................................. 207, 208, 209
L
lineSelectionDigitMap .................................................................................................................................................... 215
lineSelectionEnable ....................................................................................................................................................... 215
localHostAddress ..................................................................................................................................................... 17, 140
localHostConfigSource ................................................................................................................................................... 17
localHostDefaultRouter ........................................................................................................................................... 17, 140
localHostDhcpServer..................................................................................................................................................... 140
localHostDnsOverrideEnable ....................................................................................................................................... 142
localHostPrimaryDns ............................................................................................................................................... 17, 140
localHostSecondaryDns ......................................................................................................................................... 17, 140
localHostSelectConfigSource ...................................................................................................................................... 140
LocalHostSnmpPort....................................................................................................................................................... 141
localHostSnmpPort .................................................................................................................................................. 17, 141
localHostStaticSnmpPort .............................................................................................................................................. 141
localHostStaticWanAddress ......................................................................................................................................... 249
localHostSubnetMask ............................................................................................................................................. 17, 140
localHostWanAddressSelectConfigSource ............................................................................................................... 249
M
msConfigSource ............................................................................................................................................................... 18
msDhcpSiteSpecificCode ..................................................................................................................................... 144, 314
msEnable......................................................................................................................................................................... 313
msHost ............................................................................................................................................................... 17, 144, 313
msSelectConfigSource ......................................................................................................................................... 144, 313
msStaticHost ........................................................................................................................................................... 144, 314
msStaticPort .................................................................................................................................................................... 144
msStaticTrapPort ................................................................................................................................................... 144, 314
msTrapConfigInformation ............................................................................................................................................. 194
msTrapPort ....................................................................................................................................................... 18, 144, 313
msTrapRetransmissionPeriod ..................................................................................................................................... 313
msTrapRetransmissionRetryCount............................................................................................................................. 313
mwiConfigActivation ...................................................................................................................................................... 310
mwiConfigFetchAddress ............................................................................................................................................... 310
mwiConfigUserSubscriptionAddress .......................................................................................................................... 309
mwiExpirationTime ........................................................................................................................................................ 310
mwiFetchDigitMap ......................................................................................................................................................... 310
mwiSubscriptionCmdRefresh ...................................................................................................................................... 310
mxDebugPcmCaptureEnable ...................................................................................................................................... 331
mxDebugPcmCaptureIpAddress................................................................................................................................. 331
P
pinDialingDelay .............................................................................................................................................................. 304
pinDialingEnable ............................................................................................................................................................ 304
pinDialingPin ................................................................................................................................................................... 304
Q
qosSignalingDiffServ ..................................................................................................................................................... 315
qosSignalingIeee8021qEnable .................................................................................................................................... 316
qosSignalingIeee8021qUserPriority ........................................................................................................................... 316
qosT38FaxDiffServ ........................................................................................................................................................ 316
qosT38FaxIeee8021qEnable ....................................................................................................................................... 316
qosT38FaxIeee8021qUserPriority .............................................................................................................................. 316
qosVlanIeee8021qDefaultUserPriority ....................................................................................................................... 317
qosVlanIeee8021qTaggingEnable .............................................................................................................................. 317
qosVlanIeee8021qVirtualLanID................................................................................................................................... 317
qosVoiceDiffServ............................................................................................................................................................ 315
qosVoiceIeee8021qEnable .......................................................................................................................................... 316
S
sipDebugContextSnapshotTime ................................................................................................................................. 332
sipDomain ....................................................................................................................................................................... 243
sipEnforceOfferAnswerModel ...................................................................................................................................... 267
sipHomeDomainProxyDhcpSiteSpecificCode .................................................................................................. 146, 159
sipHomeDomainProxyHost .................................................................................................................................. 146, 159
sipHomeDomainProxyPort ................................................................................................................................... 146, 159
sipHomeDomainProxyStaticHost ................................................................................................................................ 160
sipHomeDomainProxyStaticPort ......................................................................................................................... 160, 168
sipInteropAckUnsupportedInfoRequests ................................................................................................................... 262
sipInteropAllowAsymmetricDtmfPayloadType .......................................................................................................... 265
sipInteropAuthenticationQop........................................................................................................................................ 247
sipInteropBranchMatchingMethod .............................................................................................................................. 261
sipInteropCallWaitingToneControlViaSipInfo ............................................................................................................ 266
sipInteropDefaultPublicationExpiration ...................................................................................................................... 255
sipInteropDefaultRegistrationExpiration .................................................................................................................... 253
sipInteropDtmfTransportDuration ................................................................................................................................ 230
sipInteropDtmfTransportMethod ................................................................................................................................. 230
sipInteropIgnoreUsernameParam ............................................................................................................................... 266
sipInteropIgnoreViaBranchIdInCancelEnable ........................................................................................................... 261
sipInteropInternationalCodeMappingEnable ............................................................................................................. 263
sipInteropInternationalCodeMappingString ............................................................................................................... 263
sipInteropLocalRingOnProvisionalResponse ........................................................................................................... 260
sipInteropLockDnsSrvRecordPerCallEnable ............................................................................................................ 169
sipInteropMaxForwardsValue ...................................................................................................................................... 258
sipInteropMwiMessageSummaryValidation .............................................................................................................. 310
sipInteropOnHoldSdpStreamDirection ....................................................................................................................... 259
sipInteropProxyAuthenticationUriParametersEnable .............................................................................................. 262
sipInteropReferredByConfig ......................................................................................................................................... 258
sipInteropRegisterHomeDomainHostOverride ......................................................................................................... 244
sipInteropRemoveOutboundProxyRouteHeader ...................................................................................................... 263
sipInteropReplacesConfig ............................................................................................................................................ 256
sipInteropReplacesVersion .......................................................................................................................................... 257
sipInteropRetryFailedRegistration............................................................................................................................... 264
sipInteropReuseCredentialEnable ...................................................................................................................... 169, 260
sipInteropRingingResponseCode ............................................................................................................................... 262
sipInteropSdpDirectionAttributeEnable ...................................................................................................................... 259
sipInteropSendUAHeaderEnable ................................................................................................................................ 244
sipInteropSessionTimersVersion ................................................................................................................................ 245
sipInteropSymmetricUdpSourcePortEnable ............................................................................................................. 250
sipInteropTransferVersion ............................................................................................................................................ 256
sipInteropTransmissionTimeout .......................................................................................................................... 169, 257
sipInteropUseDtmfPayloadTypeFoundInAnswer ..................................................................................................... 265
sipInteropUseItuT38Format ......................................................................................................................................... 263
sipInteropUsePAssertedHeader .................................................................................................................................. 264
sipInteropUseSipDomainInRequestURI .................................................................................................................... 264
sipOutboundProxyConfig .............................................................................................................................................. 163
sipOutboundProxyDhcpSiteSpecificCode ......................................................................................................... 146, 162
sipOutboundProxyHost ......................................................................................................................................... 146, 161
sipOutboundProxyPort .......................................................................................................................................... 146, 161
sipOutboundProxyStaticHost ....................................................................................................................................... 162
sipOutboundProxyStaticPort ................................................................................................................................ 162, 168
sipPenaltyBoxEnable .................................................................................................................................................... 252
sipPenaltyBoxTime ................................................................................................................................................ 169, 251
sipPort .............................................................................................................................................................................. 243
sipPresenceCompositorDhcpSiteSpecificCode ....................................................................................................... 164
sipPresenceCompositorHost ............................................................................................................................... 147, 164
T
telephonyAttributesAutomaticCallEnable .................................................................................................................. 301
telephonyAttributesAutomaticCallTargetAddress .................................................................................................... 301
telephonyAttributesCallDirectionRestriction .............................................................................................................. 302
telephonyAttributesDelayedHotLineEnable............................................................................................................... 307
telephonyAttributesDelayedHotLineExtension ......................................................................................................... 307
telephonyAttributesDelayedHotLineTargetAddress ................................................................................................. 307
telephonyAttributesHookFlashProcessing ......................................................................................................... 302, 306
V
voiceIfAdaptativeJitterBufferEnable .................................................................................................................... 231, 330
voiceIfCodecG723Enable ............................................................................................................................................. 224
voiceIfCodecG723MaxPTime ...................................................................................................................................... 225
voiceIfCodecG723MinPTime ....................................................................................................................................... 225
voiceIfCodecG72616kbpsEnable ................................................................................................................................ 224
voiceIfCodecG72616kbpsMaxPTime ......................................................................................................................... 226
voiceIfCodecG72616kbpsMinPTime .......................................................................................................................... 226
voiceIfCodecG72616kbpsPayloadType ..................................................................................................................... 224
voiceIfCodecG72624kbpsEnable ................................................................................................................................ 224
voiceIfCodecG72624kbpsMaxPTime ......................................................................................................................... 226
voiceIfCodecG72624kbpsMinPTime .......................................................................................................................... 226
voiceIfCodecG72624kbpsPayloadType ..................................................................................................................... 224
voiceIfCodecG72632kbpsEnable ................................................................................................................................ 224
voiceIfCodecG72632kbpsMaxPTime ......................................................................................................................... 226
voiceIfCodecG72632kbpsMinPTime .......................................................................................................................... 226
voiceIfCodecG72632kbpsPayloadType ..................................................................................................................... 224
voiceIfCodecG72640kbpsEnable ................................................................................................................................ 224
voiceIfCodecG72640kbpsMaxPTime ......................................................................................................................... 226
voiceIfCodecG72640kbpsMinPTime .......................................................................................................................... 226
voiceIfCodecG72640kbpsPayloadType ..................................................................................................................... 224
voiceIfCodecG729Enable ............................................................................................................................................. 224
voiceIfCodecG729MaxPTime ...................................................................................................................................... 227
voiceIfCodecG729MinPTime ....................................................................................................................................... 227
voiceIfCodecPcmaEnable ............................................................................................................................................ 224
voiceIfCodecPcmaMaxPTime...................................................................................................................................... 225
voiceIfCodecPcmaMinPTime ....................................................................................................................................... 225
voiceIfCodecPcmuEnable ............................................................................................................................................ 224
voiceIfCodecPcmuMaxPTime...................................................................................................................................... 225
voiceIfCodecPcmuMinPTime ....................................................................................................................................... 225
voiceIfCodecPreferred .................................................................................................................................................. 223
voiceIfDtmfEnforceDefaultEvents ............................................................................................................................... 229
voiceIfDtmfPayloadType ............................................................................................................................................... 229
voiceIfDtmfTransport ..................................................................................................................... 224, 227, 228, 229, 230
voiceIfEchoCancellationEnable ................................................................................................................................... 233
voiceIfG711ComfortNoiseGenerationEnable ............................................................................................................ 234
voiceIfG711VoiceActivityDetectionEnable ................................................................................................................ 232
voiceIfG729VoiceActivityDetectionEnable ................................................................................................................ 233
voiceIfMaxJitterBufferLength ............................................................................................................................... 231, 330
voiceIfTargetJitterBufferLength ........................................................................................................................... 231, 330
voiceIfUserInputGainOffset .......................................................................................................................................... 235
voiceIfUserOutputGainOffset ....................................................................................................................................... 235
V
vendor specific information, DHCP setting 150
verifying the installation 20
viewing statistics and performances 323
VLAN, in QoS 317
vocal features, special 12
IP address 12
MAC address 12
voice activity detection 82, 232
volatile parameters, defined 133
W
wall-mounting the unit 9
web interface
automatic call 100
call forward 88
call hold 99
call transfer 93
call waiting 95
choosing suitable web browser 21
codecs 76
conference call 97
configuration file download 37
country 100
custom tone configuration 102
default router 33
digit map 71
DTMF transport type 80, 84
enabling 21
Ethernet connection speed 31
firmware download 49
group port management 30