Page 1
CELLX Box Systems Manual Software version 17.1...
Page 2
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.
Chapter 2 System security and hardware overview on page 12 before you begin to install your CELLX Box. TELES is not liable for any damage or injury resulting from a failure to follow these safety and security instruc- tions! In addition to this manual there is a parameter manual summarizing the configuration param- eters used in the config files.
Page 6
Organization Organization This guide is organized into the following chapters. “Overview”: describes the general features of the CELLX Box and the Chapter 1 main features for VoIP, telephony, and mobile. “System security and hardware overview”: starts with the safety and Chapter 2 security precautions.
Overview This chapter describes the general features of the CELLX Box and the main features for VoIP, telephony, and mobile. The CELLX Box is a media converter that facilitates the connection of voice over IP (VoIP) with mobile networks. The connection to telephone equipment using FXS is optional. It converts line-based transmission on mobile side to packet-based transmission in the IP network and vice versa.
Overview 1.2.1 CELLX Box last mile The CELLX Box provides voice via the mobile network, which offers a reliable alternative to traditional landline connections for voice connections. In rural areas with no landline avail- able, all you need for immediate communication is an CELLX Box and mobile network cover- age.
Overview 1.2.3 CELLX Box cost saving model The CELLX Box also has an effective call routing engine. It turns expensive fixed–to–cellular calls into cheaper cellular–to–cellular calls. 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.
System security and hardware overview This chapter starts with the safety and security precautions. Make sure that every- one who works with the CELLX Box is aware of these precautions. The CELLX Box described at the end of this chapter. Safety and security precautions Please be sure and take time to read this section to ensure your personal safety and proper operation of your CELLX Box.
The operating voltage and frequency may not exceed or fall below what is stated on the label of the power supply. Antenna: TELES contains no provision or protective device against power surges or lightning strikes. The installation of the antenna must fulfill all necessary safety requirements. Employ the ser- vices of a professional antenna installer.
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 damage resulting from, or in relation to, such changes. Please thoroughly check any changes you or a third party have made to your configuration! Make sure the flash disk contains enough storage space.
System security and hardware overview 2.2.14 CDR files Call Detail Records are intended for analysis of the CELLX Box’s activity only. They are not de- signed to be used for billing purposes, as the times they record are not always exact. Inaccuracies in the generation of CDRs may occur for active connections if traffic is flowing on the system while modifications in configuration or routing files are activated.
System security and hardware overview Default ports used for specific services (continued) Table 2.1 Service Protocol Port SNMP 161 (default, can be set) H.225 registration, admission, 1719 (default, can be set) status H.225 signaling 1720 (default, can be set) GATE Manager 4445 (default, can be set) SIP signaling UDP / TCP...
Page 18
System security and hardware overview Table 2.2 summarizes the technical data of the CELLX Box. Table 2.2 Technical data of the CELLX Box Feature Description Dimensions and weight Height: 56 mm (2.20 in.) Width: 243 mm (9.57 in.) Depth: 166 mm (6.54 in.) Weight: 0.7 kg (1.54 lbs.) Interfaces 2 Gigabit Ethernet: on rear panel...
CELLX Box installation This chapter contains information on hardware installation of your CELLX Box. Fol- low the easy instructions to set up your CELLX Box in a matter of minutes. Checklist The following checklist provides step-by-step installation instructions. 1. Check the package contents 2.
CELLX Box installation Cabling Before you carry out any assembly or servicing tasks, please read the safety instructions given Chapter 2.1 on page Danger of electric shock - the power supply runs on 230 V. Use only the original power supply. Do not use the power supply if it is damaged.
CELLX Box installation 3.3.4 Power cabling Plug the power supply directly into the outlet. Make sure the power outlet is easily accessible at all times. After successful connection, the CELLX Box boots – a running light indicates the initialization process. During the boot procedure, LED1 blinks. If the software is up LED 1 is on. Unplug the device if you do not intend to use it for an extended period of time.
There are two applications available for CELLX Box remote maintenance: Teles Quickstart Teles GATE Manager Quickstart’s purpose is to initially assign an IP address to your CELLX Box. All other configu- ration and maintenance tasks are performed with the GATE Manager application.
Page 25
Configuration Quickstart is a Windows application that helps you to configure the IP settings of your CELLX Box quickly and conveniently without changing any network settings on your computer. 1. Launch Quickstart. 2. If Quickstart detects more than one network interface on your computer, you will be prompted to select the LAN interface from a drop-down menu.
Configuration 5. The IP settings window appears. Select the Ethernet Controller eth1/emac0 and enter the appro- priate network settings and click Finish to continue. To find out your local IP settings with Windows command ipconfig: Open an CLI (Windows-key + r). Type , and press Enter.
Configuration 5. The Edit System dialog box will appear. Enter a meaningful name for your CELLX Box to distinguish it from any others you plan to use. Enter the CELLX Box's IP address. Click OK. 6. Click the green Connect button to connect to your CELLX Box. Now you can run the maintenance tasks described in Chapter 6 "Maintenance"...
Page 28
Configuration After that, the routing between the interfaces must be configured. local network mobile network CELLX PSTN VoIP Figure 4.1 General scenario for CELLX Box deployment As shown in Figure 4.1 you need to know the following: the local IP network the CELLX Box is integrated into: a fixed IP address, net mask and a default gateway (already done as described in Chapter 4.3 on page 24).
Changing configuration data may lead to malfunctions and/or misrouting, as well as possible consequential damage. All changes are made at your own risk. TELES is not liable for any pos- sible damage out of or in relation with such changes. Therefore please thoroughly check any changes you or a third party made to your configuration.
Configuration 4. Transfer the new configuration file to the CELLX Box and activate the new configura- tion. Changes in the ip.cfg and pabx.cfg require a restart of the CELLX Box. The configuration files are divided into sections. These sections always begin with a line entry in square brackets.
Page 31
Configuration Example 4.2 shows a pabx.cfg file for the last mile scenario. Example 4.2 pabx.cfg for the last mile scenario [System] PABXName=CELLX_GSM-4_FXS-4 ; (1) NameServer=8.8.8.8 ; (2) NtpServer=pool.ntp.org Timezone=CET-1CEST-2,M3.5.0/02:00:00,M10.5.0/03:00:00 ; Central European Time ActionLog=/boot/protocol.log weekly 1200 3 TraceLog=/boot/trace.log daily 900 7 MsgLog=/boot/msg.log weekly 1200 3 Failedlog=/boot/failed.log daily 1200 7 Log=/boot/cdr.log daily 1200 7 ;...
192.168.1.90. The default gateway is the CELLX Box on the eth1 interface and the DNS /etc/resolv.conf settings from the file will be assigned as name server to the hosts. Example 4.5 ip.cdf with DHCP setup [dnsmasq] bogus-priv filterwin2k user=root interface=eth1 domain=teles dhcp-range=192.168,1.10,192.168.1.90,12h cache-size=150 resolv-file=/etc/resolv.conf CELLX box 17.1/002 Page 32...
[dnsmasq] bogus-priv filterwin2k user=root interface=eth1 domain=teles dhcp-range=192.168.1.50,192.168.1.90,12h cache-size=150 resolv-file=/etc/resolv.conf The firewall blocks all incoming traffic on eth2. The exception on eth2 is icmp (for Ping re- quests) and TCP traffic on port 4445 (for the GATE Manager) from the same subnet (172.20.0.0/16).
Configuration Restrict MapAll Redirect The routing is done with three variables: , and . The variables will Restrict be evaluated in this order. That means the CELLX Box first analyzes all expressions of a section, then all MapAll expressions and then all Redirect expressions.
Configuration with “CO” is sent to controller by removing the prefix and adding the controller to the number. In addition, individually dialed digits will be converted to block dialing with the syn- |…<<20 The last line from Example 4.7 sends all calls from mobile controller 20 to FXS controller 10. Example 4.7 Restrict Restrict10=CO...
Configuration (20) All mobile calls with the prefix 01555 are transmitted to the mobile controllers . All in- ternational calls are sent to the VoIP provider ( ) with the profile name . All national calls are sent to the controller with the number .
Configuration In the following example all international calls (beginning with ) are sent to VoIP controller PeerA with the provider profile . If the provider is busy, the redirect command activates the second target mapping with the placeholder and the call is automatically sent to another PeerB VoIP provider e.g.
Page 38
Configuration route.cfg for the last mile scenario for CELLX Box with FXS ports (continued) Example 4.10 ; SIP profile for IP phone or softphone (8) [Voip:Phone1] VoipDirection=IO VoipPeerAddress= VoipIpMask=0x00000000 VoipSignalling=1 VoipOwnUser=user VoipOwnPwd=pwd VoipAuth=proxy VoipExpires=600 VoipMaxChan=2 VoipCompression=g711a g711u g729a g729b VoipTxM=4 4 2 2 ;...
Configuration 4.6.5 Configuration files for VoIP scenarios These files are designed for the failover and cost saving model scenarios using VoIP connec- ip.cfg tions. Possible changes of the are not shown in this chapter. If you want to use either of these VoIP scenarios with the CELLX Box, rename the config files route.cfg pabx.cfg and and adjust them to suit your needs.
Page 40
Configuration The route.cfg shown in Example 4.12 contains far more entries than Example 4.10 on page 37. The content is described below. Example 4.12 voip_route.cfg for routing in failover and other VoIP scenarios [System] ;--------------- (1) Restrict20=@FILE 05 Restrict20=@FILE 06 ;...
Page 41
Configuration voip_route.cfg for routing in failover and other VoIP scenarios (continued) Example 4.12 [Voip:sp201] VoipDirection=IO VoipOwnUser=201 VoipOwnPwd=201pass VoipExpires=3600 VoipAuth=www VoipSignalling=1 VoipCompression=g711u g729 VoipTxM=2 VoipSilenceSuppression=no VoipDtmfTransport=3 VoipRFC2833PayloadType=101 [Voip:PeerA] ; (10) VoipDirection=IO VoipPeerAddress=1.2.3.4;; Replace with IP address supplied by your provider VoipIpMask=0xffffffff ;...
Page 42
Configuration This mapping receive VoIP calls redirected and send them out to mobile. This is an example of a VoIP profile for local 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.
Adapting the config files This chapter describes some frequent configuration scenarios. Editing the config files To edit configuration files, connect to the CELLX Box using the GATE Manager, as described Chapter 4.4 Connecting to the CELLX Box with GATE Manager on page Change to Directory view by selecting Directory in the menu in the left pane.
Adapting the config files 5.2.1 Setting the password for the GATE Manager The CELLX Box comes with no password set for GATE Manager access. If you do not define a password, access to the system via GATE Manager takes place without one, and FTP access tcs-ag takes place with the default password RemotePassword=<password>...
Adapting the config files Table 5.1 iptable options used in Example 5.2 Option Description -s <source IP> This policy is only true for packets from the given source IP address. This option is not used in the example but if the source is known use this op- tion for more security.
Adapting the config files 5.3.1 VoIP settings for a public VoIP provider If a public VoIP provider is used for incoming and outgoing calls the following configuration is needed: a) the CELLX Box must be reachable for incoming SIP and RTP IP traffic. This configuration depends on the network configuration and the VoIP provider.
Page 48
Adapting the config files (continued) Table 5.2 Explanation of the SIP profile in Example 5.3 Line in the example Explanation 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...
Adapting the config files 5.3.1.2 Registrar profile defined for the provider The registrar profile is needed to register your CELLX Box, so that your SIP provider will find you and send calls to your CELLX Box. Example 5.4 shows a registrar profile configured in the route.cfg Example 5.4 A registrar profile Registrar_PeerA...
Adapting the config files 5.3.1.3 Call routing for outgoing calls to the provider The call routing in the route.cfg tells the CELLX Box which calls are sent to the VoIP provid- MapAll er. The call routing is configured with the parameter (see Table 4.6 on page 35).
Adapting the config files 5.3.2 VoIP settings for local SIP UA The configuration of local SIP user agents (UA, such as softphones or SIP phones) is nearly the same than the configuration for the VoIP provider. If a local SIP device is used for incoming and outgoing calls to the FXS or mobile ports the following configuration is needed: a) The CELLX Box works as registrar for the SIP devices, so a VoIP profile is needed.
Adapting the config files 5.3.2.2 Call routing for calls to and from the local SIP device Call routing sends the calls from the ports of the CELLX Box to the local SIP UAs and from the local SIP UAs to the devices on the ports of the CELLX Box. Please see Example 5.7.
Adapting the config files It is also possible to activate a rerouting from one VoIP provider to the next. If the first VoIP provider is not available the calls will be routed to the next VoIP provider. You need two VoIP providers in this case, configured as described in Chapter 5.3.1 on page 47.
Adapting the config files Callback initiated by SMS Callback offers the possibility of cost saving and central billing. Figure 5.1 shows how SMS callback can be used. 100 (FXS1) SMS: CAL#100 CELLX 101 (FXS2) mobile 222333444 222444555 102 (FXS3) 103 (FXS4) Figure 5.1 SMS callback example Figure 5.1...
Adapting the config files route.cfg In the set the entries shown in Example 5.12. Example 5.12 Settings in the route.cfg for SMS callback ; … ; send the incoming SMS to the msg.log file Restrict20=@File 05 ; … ; send SMS with CAL#number to intiate callback to sender and open a leg to number MapAllCB=20 MapAllDLA=$place MapAllplace100=10...
Page 56
Adapting the config files The settings in Example 5.13 are explained in Table 5.6. Adjust the IP address of the SmtpS- MailUserOut erver. Set the username and password for the SMTP server if needed ( MailPwdOut ). Set the MailRcpt and the MailFrom variable.
Maintenance This chapter describes the CDR and trace maintenance tasks. Call detail records (CDR) The CELLX Box writes call detail records of all connections to the system memory. The path /boot/cdr.log pabx.cfg to the file ( ) is set in the (see Example 4.2 on page 31).
Maintenance Table 6.1 Entries of the cdr.log file informations separated by commas Column Description Cell ID (if mobile call) RSSI (if mobile call) The service indicator listed in the call log and missed calls list describes the type of connection as a four digit hexadecimal number.
Maintenance The CDR entry in Example 6.2 includes IP addresses for signaling and voice data, audio codec and frame size. 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 6.1.2 CDRs for callback and two stage calls In the case of CDR entries for two-stage dialing/callback calls, the beginning and ending times for the first call leg is always used as the call time.
Maintenance 6.1.4 Missed calls list All incoming calls that are not connected can be recorded in a list to facilitate return calls ( boot/failed.log ). Each line represents an incoming call that was not accepted, with the information separated by commas, as listed in Table 6.4.
10. Select the required file. Open the context menu with a right mouse click, select %Pro- Download From System. Save the file to your PC, The default directory is gramFiles%\teles\GATEManager\Data\<group>\<CELLX Box> CELLX box 17.1/002 Page 62...
Page 63
Maintenance 11. Send the trace to customer service. CELLX box 17.1/002 Page 63...
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...