TELES CellX 3G-4 System Manual Download Page 48

Page: 48 / 64

Adapting the config files

Page 48

CELLX box 17.1/002

Adjust the following variables:

VoipPeerAddress

– domain name or address of the VoIP provider.

VoipUser

– your username for the provider.

VoipPwd

– your password for the provider.

VoipOwnDisplay

– name displayed to the B party.

VoipRegistrar

– name of the registrar profile defined for the VoIP provider.

VoipCompression=

Defines the values of compression codecs used for the connec-
tion. Order the codecs according to your preference. The follow-
ing values are defined: g711a, g711u, g729a, g729b, g72616,
g72624, g72632, g728, g723, g723L, gsm, ccd, gnx64

VoipSilenceSuppression=No

Silence suppression, CNG (comfort noise generation) and VAD
(voice activity detection) is inactive.

VoipSignalling=1

SIP with UDP is active. To activate SIP with TCP, enter 2.
The following settings are set in the

pabx.cfg

. Adjust them if

required:

SipPort=5060
VoipRtpPort=29000
VoipRtpPortSpacing=2

VoipDtmfTransport=3

Defines the transport of DTMF information. DTMF is taken from
audio stream and relayed to remote as per RFC2833, while rtp
data with silence is sent.

VoipRFC2833PayloadType=101

Defines the DTMF payload type as 101.

VoipUser=USERNAME

Sets the VoIP username given from the VoIP provider.

VoipPwd=PASSWORD

Sets the VoIP password given from the VoIP provider.

VoipRegistrar=Registrar_PeerA

Points to the registrar profile used with this VoIP profile.

VoipIPLogging=No

IP addresses will not be written to the CDR records. Set the value
to

Yes

if this feature is needed.

VoipMediaWaitForConnect=No

RTP data is transmitted immediately after negotiation for RTP.
Early media is activated; SDP is sent with 183 or 180.

VoipUseSTUN=No

Set the value to

Yes

if STUN is used.

In addition set these variables in the

pabx.cfg

StunServerAddress=<stun-server>:<port>
StunServerPollInterval=<interval>

Table 5.2

Explanation of the SIP profile in

Example 5.3

(continued)

Line in the example

Explanation

Summary of Contents for CellX 3G-4

Page 1: ...CELLX Box Systems Manual Software version 17 1 ...

Page 2: ...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 Systems Manual C E L L X B o x CELLX Box 17 1 TELE...

Page 3: ... medical devices 15 2 2 12 Environmental considerations 15 2 2 13 Protecting the operating system 15 2 2 14 CDR files 16 2 2 15 Network security 16 2 3 Physical description of the CELLX Box 17 3 CELLX Box installation 19 3 1 Checklist 20 3 2 Unpacking the shipment 20 3 3 Cabling 21 3 3 1 Analog wiring optional for FXS 21 3 3 2 Ethernet wiring 21 3 3 3 Antenna cabling 21 3 3 4 Power cabling 22 3 4 ...

Page 4: ... setting 45 5 3 VoIP configuration 46 5 3 1 VoIP settings for a public VoIP provider 47 5 3 1 1 VoIP profile for the provider 47 5 3 1 2 Registrar profile defined for the provider 49 5 3 1 3 Call routing for outgoing calls to the provider 50 5 3 2 VoIP settings for local SIP UA 51 5 3 2 1 VoIP profile for the local SIP UAs 51 5 3 2 2 Call routing for calls to and from the local SIP device 52 5 4 R...

Page 5: ... document uses the following typographic conventions Bold important information and items from the GUI and the menu Code file names variables and constants in config files or commands in body text Conventions on page 5 cross references can be accessed in the PDF by a single mouse click Safety Symbols The following symbols are used to indicate important information and to describe levels of possibl...

Page 6: ...f your CELLX Box Follow the easy instructions to set up your CELLX Box in a matter of minutes Chapter 4 Configuration describes how to connect the CELLX Box to the GATE Manager and provides an introduction to the configuration Before you begin you must be familiar with the hardware and the CELLX Box must be installed at the location and connected as described in Chapter 3 CELLX Box installation on...

Page 7: ...1 Overview ...

Page 8: ...nnels Built in SIM card server support for unlimited SIMs per channel with vGATE SIM Unit Individual timers for each SIM call Possible to configure individual mobile bands Radius accounting request contains SIM s IMSI to enable SIM specific billing Support for vGATE sub limits Number portability Mobile specific configuration parameters now definable per mobile network LAIN vGATE RoutingManager sup...

Page 9: ...lation Power feeding for FXO devices Dial tone and ring tone generation Calling Line Identification CLIR on FXS ports LCR engine Multiple VoIP provider logins Multiple PSTN routing methods Multilevel alternative routing Dynamic failover to mobile network Dynamic failover to VoIP General Ringtone generation Configurable ToS DivServ AOC generation 2nd separate Gigabit Ethernet interface Status indic...

Page 10: ... The CELLX Box is used if the primary VoIP connection fails in which case it routes outgoing calls automatically via mobile networks In this case the CELLX Box works as an mobile gate way that can augment landline connectivity with wireless connectivity to the mobile network In case of landline connectivity failure the CELLX Box provides a backup solution to maintain voice communications The CELLX...

Page 11: ...Calls from the office to staff cellular phones may even be free of charge Cellular calls outside the home network are usually subject to high outgoing roaming fees A CELLX Box callback solution may help to replace those fees with lower incoming roaming fees This will help to reduce your calling costs significantly Figure 1 3 The CELLX Box in a cost saving scenario local network mobile network PSTN...

Page 12: ...2 System security and hardware overview ...

Page 13: ...mpact this device should be transported in its original packaging only Condensation can occur if the device is brought from a cold environment into the room where it is to be operated The device must be absolutely dry prior to being operated Accord ingly an acclimatization period of at least two hours is required 2 2 2 Operating conditions The CELLX Box s location must support normal operation in ...

Page 14: ...n order to completely disconnect the equipment e g in emergencies Cables should not be connected or disconnected during thunderstorms 2 2 4 Antenna Input The antenna must be protected against destruction due to lightning The base of the antenna must be grounded 2 2 5 Damage For safety reasons if the CELLX Box exhibits visible damage or has been exposed to moisture then further operation should be ...

Page 15: ...ave exposure for the general population based on thorough scientific studies To meet the maximum permissible value for radio wave exposure a distance of 20 centime ters must be kept if running one mobile channel and an additional 20 centimeters for every further mobile channel 2 2 11 Personal medical devices Radio waves may affect the operation of cardiac pacemakers and other implanted equip ment ...

Page 16: ...sword protected Do not use obvious passwords anything from sesame to your mother in laws maiden name Bear in mind the password that is easiest to remember is also likely to be easiest to crack The firewall must support the following features Protection against IP spoofing Logging of all attempts to access the CELLX Box The firewall must be able to check the following information and only allow tru...

Page 17: ...stration admission status UDP 1719 default can be set H 225 signaling TCP 1720 default can be set GATE Manager TCP 4445 default can be set SIP signaling UDP TCP 5060 default can be set RTP UDP 29000 29120 default can be set Table 2 1 Default ports used for specific services continued Service Protocol Port ETH1 ETH2 FXS1 FXS2 FXS3 FXS4 Antenna USB 12V C X ELL SIM 1 SIM 2 SIM 3 SIM 4 Front view of t...

Page 18: ...anel 1 USB not active usable on front panel 1 power 12 V on front panel Jacks The jacks on the CELLX Box have fulfilled the requirements of the follow ing safety standards ETH jacks SELV FXS jacks TNV3 ISDN jacks SELV LED Please see Table 3 1 on page 22 Power supply Type DSA 42D 12 1 120350 Input voltage 100 240 V AC 50 60 Hz 1 2 A maximum Output voltage 12V 3 5 A 42 W Dimensions 118 L x 48 5 W x ...

Page 19: ...3 CELLX Box installation ...

Page 20: ...ing Your CELLX Box package contains the items listed here 1 CELLX Box 1 power supply 1 RJ 45 LAN cable with gray connectors 1 antenna with magnetic mount Check that there is no equipment damage Mounting the CELLX Box If desired you can mount the CELLX Box on the wall with two screws Figure 3 1 shows the drilling details Figure 3 1 Holes on the back of the CELLX Box Immediately report any visible t...

Page 21: ...arios or for mainte nance work on the CELLX Box Use the three meter cable with gray connectors to connect the CELLX Box s Ethernet port ETH1 to an Ethernet switch in your network After successful connection the LEDs on the Ethernet switch blinks 3 3 3 Antenna cabling Place the antenna near a window or another place with good reception of the mobile signal Screw on the antenna to the SMA connector ...

Page 22: ...ox has the status LEDs described in Table 3 1 After the successful start LED 1 is on showing that the system of the CELLX Box is started LED 2 5 are on showing that calls using the mobile modules are possible LED 6 blinks after a pick up of a connected telephone Table 3 1 CELLX Box LEDs LED Description 1 power CELLX Box processor power Off power off On power on Blinking starting 2 5 mobile state S...

Page 23: ...4 Configuration ...

Page 24: ...tract Extract the files then run the installer found in each 4 2 Skills needed for a configuration setup Be well versed in telecommunication technology know the basic concepts of mobile FXS VoIP and IP technology Know the basics of Windows OS handle files install software download files Handle a text editor e g notpad Be familiar with configuring a device with the help of config files Before you c...

Page 25: ...puter you will be prompted to select the LAN interface from a drop down menu Select the interface that is in the same physical network as your CELLX Box 3 If a Windows Security Alert message appears asking if Quickstart is to be blocked click Unblock 4 Quickstart automatically starts scanning your network within the same Ethernet broadcast domain As soon as your CELLX Box has been detected you can...

Page 26: ...t can take up to five minutes for the CELLX Box to reboot and apply your settings 4 4 Connecting to the CELLX Box with GATE Manager 1 After you have assigned an IP address to your CELLX Box assign the CELLX Box to the GATE Manager 2 Start the GATE Manager application and connect to your CELLX Box 3 Select the Default group or right click in the window on the left and select New Group Enter a group...

Page 27: ...rios Let s have a look at a typical deployment scenario for the CELLX Box shown in Figure 4 1 There are four clouds The CELLX Box is connected to three of them 1 the local and the telephone network with a PBX and two telephones local network 2 the mobile network connected with the public PSTN network and 3 the VoIP network connected with the public PSTN network There are three types of hardware in...

Page 28: ...h interface is used for which equipment what are the telephone numbers internal and external used for this equipment the VoIP configuration You need a contract with a VoIP provider who provides public telephone numbers a SIP proxy and a registrar They are needed so that incoming calls from public PSTN network can reach the CELLX Box and from there your telephone equipment Your CELLX Box must be ac...

Page 29: ...teway and needs a fixed IP configuration Use an IP address that is outside the DHCP address range Interface definition for FXS1 FXS4 if present Addr 10 13 Telephone numbers used for the FXS interfaces 100 101 102 and 103 This address is needed to send VoIP calls to the FXS ports The telephone number 100 is assigned to controller 10 101 to controller 11 and so on Interface definition for VoIP SIP U...

Page 30: ...riable in the expression is PABXName the value is CELLX 4S_FXS 4 the rest 1 of the line after the semicolon is a comment 4 6 1 The pabx cfg config file The pabx cfg file contains the definition of the controller which is needed for routing and the location of the log files needed for maintenance Only some small changes are needed in this file change the remote password and if necessary DNS and NTP...

Page 31: ...T ROUTER ANA 0 16 800 250 1500 80 12800 1 1 500 10500 10000 0 1000 NODE 0002 Subscriber03 TRANSPARENT ROUTER ANA 0 16 800 250 1500 80 12800 1 1 500 10500 10000 0 1000 NODE 0003 Subscriber04 TRANSPARENT ROUTER GSM 0000 00000 000000 1 1 1 SIM4 IMSI BAND 6 TRACE fecc ALARM NODE 0004 Subscriber05 TRANSPARENT ROUTER GSM 0000 00000 000000 1 1 1 SIM4 IMSI BAND 6 TRACE fecc ALARM NODE 0005 Subscriber06 TR...

Page 32: ... eth1 All DHCP re quests will be answered and the CELLX Box assign an IP address form the range 192 168 1 10 until 192 168 1 90 The default gateway is the CELLX Box on the eth1 interface and the DNS settings from the file etc resolv conf will be assigned as name server to the hosts Example 4 3 ip cfg with default gateway and IP address set System DefaultGW 192 168 1 1 eth1 IpAddress 192 168 1 2 ne...

Page 33: ...W 192 168 1 1 eth1 IpAddress 192 168 1 224 netmask 255 255 0 0 eth2 IpAddress 172 20 27 224 netmask 255 255 255 0 iptables iptables t nat A POSTROUTING o eth2 s 192 168 1 0 24 j MASQUERADE iptables P INPUT j DROP iptables P FORWARD j DROP iptables P OUTPUT ACCEPT iptables A INPUT s 172 20 16 p tcp dport 4445 i eth2 j ACCEPT iptables A INPUT s 172 20 16 p icmp i eth2 j ACCEPT iptables N block iptab...

Page 34: ...he prefix or port number that is to be put in front of the DAD and an optional service indicator In the route cfg the list of Restrict parameters is searched from bottom to top for a matching controller plus optional trunk number OAD Because the search is done bottom up place the more specific Restrict entries below the more general ones Once a match has been found the DAD is prefixed with the con...

Page 35: ... MapAll123456 10123456 means that 123456 is cut off the number and 10123456 is added to it The called number is 1012345678 with 10 being the port MapAll123456 10 means that 123456 is cut off and 10 added The called number is 1078 with 10 being the port Mappings are searched from top to bottom Place the more specific entries above the more general ones Example 4 7 Restrict Restrict10 CO MapAllCO 20...

Page 36: ... 00 MapAll0 90 Table 4 7 route cfg redirect parameters Redirect type num redirect sin time Parameter Description No Digits Optional type Possible types are 2 call forwarding no answer 3 call forwarding when busy 5 call forwarding on no answer or busy 1 num Defines the number for which calls will be redirected 59 redirect Defines the placeholder used in the two target routing entry and the number t...

Page 37: ...essage log Restrict21 FILE 05 save SMS to message log Restrict21 FILE 06 save USSD to message log Restrict22 FILE 05 save SMS to message log Restrict22 FILE 06 save USSD to message log Restrict23 FILE 05 save SMS to message log Restrict23 FILE 06 save USSD to message log inter digit collect timer is set to 3 seconds 2 DTMFWaitDial 3 Restrict10 120 15 sets the internal number for FXS ports Restrict...

Page 38: ... The CELLX Box uses this timer to convert DTMF dialing to block dialing needs for calls to mobile and VoIP 3 Add the prefix fxs0 to the first FXS port fxs1 to the second FXS port fxs2 to the third FXS port and fxs3 to the fourth FXS port 4 Sends all calls from the mobile modules to the FXS modules Exactly from mobile module 20 to the FXS module 10 and so on 5 This mapping allows connections from a...

Page 39: ...ontroller04 20 GSM 2 Controller05 20 GSM Controller06 20 GSM Controller07 20 GSM Controller08 40 VOIP Subscriber00 TRANSPARENT ROUTER ANA 0 16 800 250 1500 80 12800 1 1 500 10500 10000 0 1000 Subscriber01 TRANSPARENT ROUTER ANA 0 16 800 250 1500 80 12800 1 1 500 10500 10000 0 1000 Subscriber02 TRANSPARENT ROUTER ANA 0 16 800 250 1500 80 12800 1 1 500 10500 10000 0 1000 Subscriber03 TRANSPARENT ROU...

Page 40: ...t 07 20 TOFXS04 MapAllTOFXS04 13 extension 200 201 are the voip phones 4 MapAll200 40sp200 200 11 MapAll201 40sp201 201 11 Extension 101 102 103 and 104 are the analog ports 5 MapAll100 10 MapAll101 11 MapAll102 12 MapAll103 13 EMERGENCY 6 MapAll911 40PeerA 911 Send all other calls to VoIP Provider 7 MapAll 40PeerA 24 Redirect340PeerA A MapAllA 40PeerB fallback to a second VoIP Peer Redirect340Pee...

Page 41: ...pression g729a g711u VoipSilenceSuppression No VoipSignalling 1 VoipDtmfTransport 3 VoipRFC2833PayloadType 101 VoipUser USERNAME Replace with username supplied by your provider VoipPwd PASSWORD Replace with password supplied by your provider VoipRegistrar Registrar_PeerB VoipIPLogging No VoipMediaWaitForConnect No Registrar Registrar_PeerA 11 RegId 1 2 3 4 Replace with IP address supplied by your ...

Page 42: ...ocal devices Adjust password username and the compression codec list to suit your needs 10 This is an example of an external VoIP profile Adjust Peer IP password username and the compressions list to the values given by the SIP provider 11 This is an example of an registrar profile Adjust IP address password and username to the values given by the SIP provider ...

Page 43: ...5 Adapting the config files ...

Page 44: ...re standard text files and can be edited with a text editor such as Notepad When you have completed the changes save the file and close the editor To send the new file back to your CELLX Box right click in the GATE Manager window and select Upload to System Then select the changed version of the configuration file you want to send back to the CELLX Box If you upload a new version of the route cfg ...

Page 45: ... Manager After the file has been transferred reboot the CELLX Box The system can than be accessed only with the correct password Don t forget to memorize it 5 2 2 Adjusting the firewall setting If the CELLX Box is running in a DMZ Demilitarized zone computing the firewall must be activated in the ip cfg see Chapter 2 2 15 on page 16 The firewall used on CELLX Box is iptables The documentation is f...

Page 46: ... p protocol This policy is only true for the given IP protocol UDP TCP dport portnum This policy is only true for the given protocol number Sometimes the defini tion in etc protocols will be used instead This option can only be used together with the p option j ACCEPT Defines the action that is carried out if the packet matches the rule Table 5 1 iptable options used in Example 5 2 Option Descript...

Page 47: ...ed in Table 5 2 Example 5 3 A SIP profile for PeerA Voip PeerA VoipDirection IO VoipPeerAddress 1 2 3 4 Replace with IP address supplied by your provider VoipIpMask 0xffffffff VoipCompression g729a g711u VoipSilenceSuppression No VoipSignalling 1 VoipDtmfTransport 3 VoipRFC2833PayloadType 101 VoipUser USERNAME Replace with username supplied by your provider VoipPwd PASSWORD Replace with password s...

Page 48: ...uired SipPort 5060 VoipRtpPort 29000 VoipRtpPortSpacing 2 VoipDtmfTransport 3 Defines the transport of DTMF information DTMF is taken from audio stream and relayed to remote as per RFC2833 while rtp data with silence is sent VoipRFC2833PayloadType 101 Defines the DTMF payload type as 101 VoipUser USERNAME Sets the VoIP username given from the VoIP provider VoipPwd PASSWORD Sets the VoIP password g...

Page 49: ...RNAME Replace with username supplied by your provider RegPwd PASSWORD Replace with password supplied by your provider RegExpires 180 RegPing 20 RegOwnId user ip_address_or_name Table 5 3 Explanation of the registrar profile in Example 5 4 Line in the example Explanation RegId Enter the host name or IP address of your SIP provider Following the IP ad dress insert the optional port number used e g 1...

Page 50: ...To sent incoming VoIP calls to the FXS ports use the following call routing MapAll number0 10 MapAll number1 11 MapAll number2 12 MapAll number3 13 Replace the number0 3 with the telephone numbers assigned to your FXS ports by the VoIP carrier 10 11 12 and 13 are the FXS ports of the CELLX Box Example 5 5 Call routing for VoIP calls on the CELLX Box routing of incoming calls from the analog device...

Page 51: ...r for the local SIP UA So you need a VoIP profile for every SIP UA as shown in Example 5 6 The important parameters are as follows Voip sp200 the name of the profile here sp200 This name is used in the mapping The value is random For the next UA change this value VoipOwnUser the username here 200 This name must be set in the SIP UA configuration The value is random VoipOwnPwd the password here 200...

Page 52: ... other calls from the SIP UAs will be sent out to the mobile controller 5 4 Rerouting or failover If a port is not available e g in the failover scenario see Chapter 1 2 2 on page 10 the calls may be sent to an alternative route This alternative routing is configured by the redirect pa rameter see Table 4 7 on page 36 Example 5 8 shows the rerouting for calls to the public VoIP profile PeerA over ...

Page 53: ...lar to the rerouting described in the previous section If it is possible to reach a destination over different ports or numbers create a route on the cheapest way first The next way is reachable with a rerouting Example 5 10 sends the calls from FXS to the destination 541867530 directly to the mobile ports not with the default routing in the next line to VoIP like all other normal traffic The firs...

Page 54: ...le 04 has the num ber 222444555 The mobile phone with the number 222333444 sends a text message SMS to 222444555 requesting a callback from the telephone on FXS1 with the number 100 The text of the mes sage is CAL 100 The SMS is received by the mobile module 04 and a call is initiated to 222333444 and 100 from there Check that the path to the message log file msg log is set in the pabx cfg as show...

Page 55: ...00 10 MapAllplace101 11 MapAllplace102 12 MapAllplace103 13 Table 5 5 Explanation of the routing in Example 5 12 Configuration Explanation Restrict20 File 05 This entry is already set in the route cfg It writes the incoming SMS to the file defined by MsgLog in the pabx cfg MapAllCB 20 The callback is done on CMDA port 20 MapAllDLA place A jump to the call routing is initialized place is used as th...

Page 56: ...ilRcpt cellx yourcompany com Completes the e mail recipient information for the mail to SMS scenario This feature is not needed here MailFrom cellx yourcompany com The confirmation mails will be sent from this e mail address in the format OAD celly yourcompany com OAD is the number of the mobile module MaxMailsToHost 1 Defines the maximum number of e mail messages which can be sent as SMS messages...

Page 57: ...6 Maintenance ...

Page 58: ...Example 6 1 Sample cdr log file C1 25 11 09 10 16 20 25 11 09 10 16 27 9 111 0102 7 1f 0 3663 10 C1 25 11 09 10 35 16 25 11 09 10 35 26 9 111 0102 10 1f 0 3 38922 14 C1 25 11 09 10 38 30 25 11 09 10 38 41 9 111 0102 11 90 0 3 38922 14 Table 6 1 Entries of the cdr log file informations separated by commas Column Description 0 Version 1 Start time format DD MM YY hh mm ss 2 End time format DD MM YY ...

Page 59: ...ignaling and voice data audio codec and frame size the entry VoipIpLogging Yes must be included in the VoIP profile If the entry also contains the mobile controller s IMSI it will appear before the IP addresses 14 Cell ID if mobile call 15 RSSI if mobile call Table 6 1 Entries of the cdr log file informations separated by commas Column Description Table 6 2 Defined values for service indicators Se...

Page 60: ...sted in Table 6 3 Example 6 2 Sample cdr log file with VoIP information C1 24 11 09 16 52 20 24 11 09 16 52 22 401419 9777 172 20 25 103 172 20 25 103 G711a 20 0101 2 10 0 11 Example 6 3 Sample cdr log file for callback and two stage calls C1 24 11 09 17 15 29 24 11 09 17 15 57 0002 01 CB 0008 01 DLA 172 20 25 103 172 20 25 103 G711a 20 0102 28 3 90 0 Table 6 3 Specific cause values Cause Value De...

Page 61: ...ically set internal chan nel number 3 Destination The following format applies node number automatically set internal channel number 4 IMSI 5 IP logging signaling RTP 6 Audio codec used 7 Frame size 8 Service indicator 9 Cause values 10 Call duration if the call does not result in an Alerting the entry will be 1 11 Number of call attempts 12 Cell ID 13 RSSI Example 6 4 Sample failed log F1 24 11 0...

Page 62: ...nfiguration dialog box for Online Trace opens The default settings are cor rect in many cases 6 Confirm with OK the trace starts 7 Repeat the steps that led to these error 8 Stop the trace with Commands Trace Stop Offline Trace 9 Select Directory in the menu The trace files are listed in the rights pane The file name is traceYYMMDD log Where YY is the year MM the month DD the day and a number 10 S...

Page 63: ...6 Maintenance Page 63 CELLX box 17 1 002 11 Send the trace to customer service 1 2 3 ...

Page 64: ...TELES COMMUNICATIONS CORP 2400 Skyfarm Drive Hillsborough CA 94010 United States Phone 1 646 225 65 98 E Mail cellx teles com Internet http www teles com cellx index html ...

Search results

Summary of Contents for CellX 3G-4

Reviews:

Brands by name

Popular brands

TELES CellX 3G-4, System Manual

Search results

Summary of Contents for CellX 3G-4

Reviews:

Brands by name

Popular brands