TELES VoIP Box DSL Series User manual

VoIPBox DSL
VoIPBox BRI
Reference Manual
Software version 21.0

© Copyright 2015 TELES AG Informationstechnologien. All rights reserved.
TELES®, IntraSTAR®, Intra*®, CELLX®, and iSWITCH®are registered trademarks of TELES AG Informationstechnologien.
All other trademarks used are the property of their respective owners.
The supplied hardware/software systems are protected by copyright and can be used solely by their lawful owners.
All text and figures in this publication have been compiled with great attention to detail. Nonetheless, inaccuracies
and typographical errors cannot be entirely avoided. TELES AG Informationstechnologien provides this document 'as
is' without warranty of any kind, expressed or implied. TELES AG Informationstechnologien reserves the right to make
changes in product design or specifications without notice.
VoIPBox DSL / VoIPBox BRI
Reference Manual
TELES AG | HEADQUARTERS
Ernst-Reuter-Platz 8
10587 Berlin
GERMANY
Phone [phone]
Fax [phone]
E-mail [e-mail]
http www.teles.com
Software version: 21.0 Revised: May 20, 2015 009

Table of contents
VoIPBox BRI / VoIPBox DSL – version 21.0.009 Page 3
Table of contents
Preface ......................................................................................... 11
About this manual ...................................................................... 13
1 Safety and security precautions ...............................................15
1.1 Safety Measures.............................................................................16
1.2 Power Supply..................................................................................16
1.2.1 Technical Data ................................................................................17
1.2.2 Symbols ...........................................................................................17
1.2.3 Instructions for Use .......................................................................17
1.2.4 Safety Precautions .........................................................................18
1.3 Jacks .................................................................................................18
1.4 EMC Protection...............................................................................19
1.5 System Security ..............................................................................19
1.5.1 Servicing the VoIPBox ....................................................................20
1.5.2 Protecting the Operating System.................................................20
1.6 CDR Files..........................................................................................21
1.7 Network Security............................................................................21
2 Overview......................................................................................23
2.1 Features...........................................................................................24
2.2 Implementation scenarios ............................................................26

Table of contents
VoIPBox BRI / VoIPBox DSL – version 21.0.009 Page 4
3 VoIPBox installation ...................................................................28
3.1 Checklist ..........................................................................................29
3.2 Package Contents...........................................................................29
3.3 VoIPBox Hardware Description....................................................30
3.4 Installation Requirements.............................................................31
3.4.1 ISDN Wiring.....................................................................................31
3.4.2 Ethernet Wiring ..............................................................................32
3.4.3 DSL wiring (optional)......................................................................33
3.5 Preparing for Installation ..............................................................33
3.6 Hardware Connection ...................................................................35
3.7 LED Functionality............................................................................35
3.8 GATE Manager ................................................................................ 36
3.9 Transfer the config file with the GATE Manager to the PC........37
3.10 Activate the DSL connection .........................................................38
3.11 Activate PPPoE connection over an Eth interface ......................40
3.11.1 Changing the IP settings................................................................41
3.12 Changing the IP settings................................................................43
3.12.1 Change the IP settings on VoIPBox DSL ......................................43
3.12.2 Change the IP settings on VoIPBox BRI .......................................44

Table of contents
VoIPBox BRI / VoIPBox DSL – version 21.0.009 Page 5
3.13 Remote access security .................................................................44
3.13.1 Graphical User Interface ...............................................................45
3.13.2 Setting a Password for Remote Access .......................................47
3.13.3 Adjust the firewall settings............................................................48
3.14 Activate the VoIP interface............................................................49
4 Configuration files ...................................................................... 52
4.1 Configuration file ip.cfg .................................................................54
4.1.1 System section configuration .......................................................55
4.1.2 Ethernet interface configuration..................................................56
4.1.3 GUI settings.....................................................................................56
4.1.4 DSL configuration...........................................................................57
4.1.5 Firewall configuration....................................................................57
4.1.6 PPPoE Configuration......................................................................58
4.1.7 DHCP and DNSmasq settings .......................................................59
4.2 Configuration File pabx.cfg ...........................................................61
4.2.1 System Settings ..............................................................................61
4.2.1.1 VoIPBox DSL / VoIPBox BRI name ................................................61
4.2.1.2 Log Files...........................................................................................61
4.2.1.3 DNS and NTP settings....................................................................63
4.2.1.4 Controller settings..........................................................................66
4.2.1.5 Subscriber settings.........................................................................68
4.2.2 SMTP-Client Configuration............................................................69
4.2.3 Night Configuration .......................................................................71

Table of contents
VoIPBox BRI / VoIPBox DSL – version 21.0.009 Page 6
4.3 Configuration File route.cfg ..........................................................73
4.3.1 Entries in the Sections [System] and [Night<num>] ..................73
4.3.1.1 Restrict.............................................................................................74
4.3.1.2 MapAll..............................................................................................76
4.3.1.3 Redirect ...........................................................................................78
4.3.2 VoIP Profiles....................................................................................80
4.3.3 Gatekeeper Profiles .......................................................................83
4.3.4 Registrar Profiles ............................................................................84
4.3.5 Radius Profiles................................................................................86
5 Additional VoIP parameters ......................................................88
5.1 Signaling parameters.....................................................................89
5.2 STUN server parameter.................................................................97
5.3 Set up the VoIPBox DSL / VoIPBox BRI as Registrar...................98
5.4 Routing parameters.....................................................................100
5.5 Quality parameters ......................................................................101
5.6 Call forwarding parameters........................................................106
5.7 Interworking parameter..............................................................107
5.8 Compression parameters ...........................................................108
5.9 Fax/modem parameters .............................................................109
5.9.1 Fax settings for T.38.....................................................................110
5.10 DTMF parameters ........................................................................111
5.11 Announcements ...........................................................................112

Table of contents
VoIPBox BRI / VoIPBox DSL – version 21.0.009 Page 7
6 Signaling and routing features ...............................................114
6.1 Digit collection (enblock/overlap receiving) ..............................115
6.2 Rejecting data calls and specified numbers..............................116
6.2.1 Blacklist routing............................................................................116
6.2.2 Whitelist routing...........................................................................117
6.2.3 Rejecting calls with ISDN bearer capability data ......................118
6.2.4 Specific routing of data calls via VoIP ........................................118
6.3 CLIP and CLIR................................................................................119
6.3.1 Routing CLIP and CLIR calls.........................................................119
6.3.2 Setting CLIR ...................................................................................120
6.3.3 Setting CLIP ...................................................................................121
6.4 Conversion of call numbers........................................................121
6.5 Overwriting OAD ..........................................................................122
6.6 Setting number type in OAD/DAD..............................................123
6.7 Setting the screening indicator...................................................125
6.8 Setting a default OAD ..................................................................127
6.9 Setting sending complete byte in setup....................................128
6.10 OAD screening..............................................................................129

Table of contents
VoIPBox BRI / VoIPBox DSL – version 21.0.009 Page 8
6.11 Miscellaneous routing methods.................................................131
6.11.1 Routing calls without a destination number.............................132
6.11.2 Routing calls based on existence of destination number.......132
6.11.3 Changing cause values ................................................................134
6.12 Call forwarding translation: ISDN to SIP....................................137
6.13 Call forking ....................................................................................139
7 System maintenance and software update ..........................141
7.1 Configuration errors ....................................................................142
7.2 Status and error messages .........................................................142
7.3 ipupdate - DynDNS client............................................................147
7.4 Trace ..............................................................................................149
7.4.1 ISDN trace output.........................................................................153
7.4.2 Call forwarding to SIP trace output............................................154
7.4.3 VoIP trace output .........................................................................155
7.4.3.1 Interface IP network.....................................................................156
7.4.3.2 RTP/RTCP output..........................................................................160
7.4.3.3 Internal protocol interface (to ISDN, POTS, mobile) ................165
7.4.3.4 H.245 messages ...........................................................................166
7.4.3.5 RAS (Registration, Admission, Status)........................................171
7.4.3.6 ENUM output................................................................................175
7.4.4 Remote output .............................................................................176
7.4.5 DTMF tone trace output ..............................................................177

Table of contents
VoIPBox BRI / VoIPBox DSL – version 21.0.009 Page 9
7.5 Software Update ..........................................................................178
7.5.1 Update the TELES software.........................................................178
7.5.2 Restore the original TELES configuration..................................179
7.5.3 The automatic start check...........................................................180
8 Online traffic monitor ..............................................................181
8.1 Calculating and resetting statistic values, resetting counters 182
8.1.1 Calculation and resetting of statistic values .............................182
8.1.2 Additional resetting of counters A-F ..........................................184
8.1.3 Resetting statistic counters.........................................................185
8.2 Generating and retrieving CDRs.................................................185
8.2.1 Call log ...........................................................................................187
8.2.2 Missed calls list.............................................................................190
8.3 Sending CDRs via e-mail..............................................................191
9 Troubleshooting........................................................................193
9.1 No connection to the system......................................................194
9.1.1 System does not start correctly..................................................195
9.1.2 Web interface is not accessible ..................................................196
9.1.3 IP address settings .......................................................................198
9.1.4 Firewall issues and NAT / PAT settings ......................................198
9.1.5 ISDN dial-in number missing or wrong .....................................199
9.1.6 ISDN port not loaded correctly / not active ..............................201

Table of contents
VoIPBox BRI / VoIPBox DSL – version 21.0.009 Page 10
9.2 No calls are possible ....................................................................202
9.2.1 Call does not arrive on the gateway ..........................................202
9.2.2 Call is rejected or not routed to the right destination.............206
9.3 Software update problems .........................................................209
Appendix A: Default config files ...............................................................212
A.1 pabx.cfg .........................................................................................213
A.2 ip.cfg ..............................................................................................216
A.3 route.cfg ........................................................................................218
List of examples ........................................................................220
List of tables ..............................................................................223
List of figures.............................................................................226

Preface
VoIPBox DSL / VoIPBox BRI – version 21.0.009 Page 11
Preface
In this guide
This guide is set up to guide you through the step-by-step in-
stallation of your VoIPBox DSL / VoIPBox BRI so that you can
follow it through from the front to the back.
This guide is written for a technician who is familiar with tele-
com, computer and internet technology.
Make sure you familiarize yourself thoroughly with the safety
and security precautions detailed in Chapter 1 Safety and se-
curity precautions →before you begin to install your gateway.
TELES is not liable for any damage or injury resulting from a
failure to follow these safety and security instructions!
Conventions
This document uses the following typographic conventions:
Bold – items from the GUI menu.
Code – file names, variables and constants in
configuration files or commands in body text.
"Conventions" on page 11 →– cross-references can be
accessed in the PDF files by a single mouse click.
Configuration data or extracts are written in single-
column tables with a gray background.
# configuration text

Preface
VoIPBox DSL / VoIPBox BRI – version 21.0.009 Page 12
Safety symbols
The following symbols are used to indicate important infor-
mation and to describe levels of possible danger.
Note
Useful information with no safety implications.
Attention
Information that must be adhered to as it is necessary to en-
sure that the system functions correctly and to avoid mate-
rial damage.
Warning
Danger. Could cause personal injury or damage to the sys-
tem.
Dangerous voltage
Could cause injury by high voltage and/or damage the sys-
tem.
Electrostatic discharge
Components at risk of discharge must be grounded before
being touched.
!
!
!

About this manual
VoIPBox DSL / VoIPBox BRI – version 21.0.009 Page 13
About this manual
Chapter 1 – Safety and security precautions
contains the safety and security precautions. In addition this
chapter describes important system informations to protect
the VoIPBox DSL / VoIPBox BRI.
Chapter 2 – Overview
gives you an overview of the VoIPBox DSL / VoIPBox BRI box.
Lists all types of box, the features offered and describes two
implementation scenarios.
Chapter 3 – VoIPBox installation
contains information on basic installation and configuration
of your VoIPBox. Follow the easy instructions to set up your
VoIPBox in a matter of minutes. Implementation of individual
scenarios require adjustments to the appropriate interfaces.
Tips for basic settings are described here. Links to relevant
chapters are provided for more specific configuration
changes.
Chapter 4 – Configuration files
describes the basic setup and the most commonly used
entries for the configuration files. Configuration of VoIPBoxes
is managed in the following three files: ip.cfg, pabc.cfg, and
route.cfg.
Chapter 5 – Additional VoIP parameters
contains additional configuration entries to fine-tune
communication with the VoIP peer.
Chapter 6 – Signaling and routing features
contains some special configuration examples for different
call routing and configuration cases.

About this manual
VoIPBox DSL / VoIPBox BRI – version 21.0.009 Page 14
Chapter 7 – System maintenance and software update
describes system messages that are saved in the protocol file,
as well as trace options.
Chapter 8 – Online traffic monitor
describes the contents of traffic monitoring, i.e. call statistics,
system statistics, and call detail records. It also explains
activation, resetting and analysis of the data.
Chapter 9 – Troubleshooting
discusses problems that you may encounter when operating
your VoIPBox and offers solutions. The reasons are listed that
may cause the different problems. Every reason is described
in detail, the symptoms are identified and suggestions are
made for solving the issue. If you cannot solve a problem
using these instructions, please contact your service partner.
Appendix Appendix A – Default config files
contains the config files available on the VoIPBox DSL /
VoIPBox BRI after delivery.

1 Safety and security
precautions

1 Safety and security precautions
VoIPBox DSL / VoIPBox BRI – version 21.0.009 Page 16
This chapter contains the safety and security precautions.
In addition this chapter describes important system infor-
mations to protect the VoIPBox DSL / VoIPBox BRI.
Please be sure and take time to read this section to ensure
your personal safety and proper operation of your gateway.
To avoid personal injury or damage to the system, please
follow all safety instructions before you begin working on
your gateway. VoIPBoxes are CE certified and fulfill all rele-
vant security requirements. The manufacturer assumes no
liability for consequential damages or for damages result-
ing from unauthorized changes.
1.1 Safety Measures
Danger of electric shock - the power supplies run on 230 V. Do
not open the VoIPBox or its power supply.
Make sure to install the VoIPBox near the power source and
that the power source is easily accessible.
Bear in mind that telephone and WAN lines are also energized
and can cause electric shocks.
Be sure to respect country-specific regulations, standards or
guidelines for accident prevention.
1.2 Power Supply
The included power supply is to be used exclusively for oper-
ation of your VoIPBox.
Make sure you read this chapter thoroughly and save the
instructions for future reference. Use only the power sup-
ply included in the package contents of your VoIPBox.
!

1 Safety and security precautions
VoIPBox DSL / VoIPBox BRI – version 21.0.009 Page 17
1.2.1 Technical Data
The following list includes technical information on the power
supply:
|Type: DSA-15P-12 EU 120150 for VoIPBox
|Input voltage: 110-230V~ +/-15% 50-60Hz; 0.5A
|Output voltage: 12V --- ; 1.25A
|Weight: 115g
|Tested and certified as per EN60950-1
1.2.2 Symbols
The symbols on the power supply have the following mean-
ings:
1.2.3 Instructions for Use
Plug the power supply directly into the outlet. The power sup-
ply provides safety-low voltage with limited capacity for your
VoIPBox.
Table 1.1 Power Supply Symbols
Symbol Meaning
Certified to conform with European norms.
Protective insulation provided.
For indoor use only.
Not for public disposal. Make sure you dispose of the power sup-
ply properly.
Indicates the output polarity of the power supply.
Use only the power supply included in the package con-
tents of your VoIPBox.
!

1 Safety and security precautions
VoIPBox DSL / VoIPBox BRI – version 21.0.009 Page 18
The devices are designed for constant use in dry, indoor loca-
tions. However, we recommend that you unplug them if you
do not intend to use them for an extended amount of time.
Make sure the power outlet is easily accessible at all times.
1.2.4 Safety Precautions
Make sure you follow these safety precautions:
|Electrical devices may not be used by individuals who are
not aware of the dangers of electricity and/or the
incorrect use thereof.
|Make sure you use only the correct input voltage.
|Make sure the installation site is sufficiently ventilated.
|Use the device only in dry, indoor locations, and protect
it from humidity.
|Do not subject the device to direct sunlight.
|Unplug the device if you do not intend to use it for an
extended amount of time.
|Hold the device by its housing when you unplug it. Wall
outlets can become mechanically overloaded; do not
pull on the cord.
|The room temperature may not exceed 35°C.
|Do not use the device if it is damaged or if there are signs
of misfunction. In this case, send it to TELES Service or
dispose of it properly (not with household waste).
1.3 Jacks
The jacks on the VoIPBox have fulfilled the requirements of
the SELV safety standard.

1 Safety and security precautions
VoIPBox DSL / VoIPBox BRI – version 21.0.009 Page 19
1.4 EMC Protection
1.5 System Security
This section describes all points crucial to the VoIPBox’s sys-
tem security.
The VoIPBox’s location must support normal operation ac-
cording to EN ETS 300 386. Be sure to select the location with
the following conditions in mind:
Use shielded cables.
Do not remove any housing components. They provide EMC
protection.
Location: Make sure you install the system in a clean, dry,
dust-free location. If possible, use an air-conditioned site.
The site must be free of strong electrical or magnetic
fields, which cause disrupted signals and, in extreme cas-
es, system failure.
Temperature:
The site must maintain a temperature between 0 and
35°C. Be sure to guard against temperature fluctuations.
Resulting condensation can cause short circuiting. The hu-
midity level may not exceed 80%.
To avoid overheating the system, make sure the site pro-
vides adequate ventilation.
!
!

1 Safety and security precautions
VoIPBox DSL / VoIPBox BRI – version 21.0.009 Page 20
1.5.1 Servicing the VoIPBox
Regular servicing ensures that your VoIPBox runs trouble-
free. Servicing also includes looking after the room in which
the system is set up. Ensure that the air-conditioning and its
filter system are regularly checked and that the premises are
cleaned on a regular basis.
1.5.2 Protecting the Operating System
Changing configuration data may lead to malfunctions and/or
misrouting, as well as possible consequential damage. Make
changes at your own risk. TELES is not liable for any possible
damage resulting from or in relation to such changes. Please
thoroughly check any changes you or a third party have made
to your configuration!
Download the log files and delete them from the VoIPBox on
a regular basis to ensure VoIPBox’s reliability. All files with the
extension *.log can be deleted. Do not delete or change any
files necessary for system operation. Use the GATE Manager
to check storage space and/or delete files. For more informa-
tion consult the GATE Manager Reference manual. To save files
before deleting them, use the Receive File option in GATE
Manager.
Power:
The site must contain a central emergency switch for the en-
tire power source.
The site’s fuses must be calculated to provide adequate sys-
tem security. The electrical facilities must comply with appli-
cable regulations.
The operating voltage and frequency may not exceed or fall
below what is stated on the label.