Page 10
Com.X Administrator Guide Page 10 5.3.1 Reviewing Call Detail Records ................... 176 5.3.2 Enabling logging to CSV ..................... 177 5.3.3 Accessing the CDR database ....................177 5.4 M ................177 ONITORING OF REMAINING CAPACITY ON THE UNIT 5.4.1 Deleting of call recordings ....................178 5.4.2 Changing the memory consumption threshold ..............
Page 11
Com.X Administrator Guide Page 11 6.13 T (TMS) ..................189 ELEPHONE ANAGEMENT YSTEMS 6.13.1 MAN 3000 ......................... 189 6.13.1.1 Installing MAN 3000 support ....................189 6.13.1.2 CDR format ..........................193 6.13.1.3 Defining outbound line numbers ....................195 6.13.1.4 Logging records from a specific date ..................195 6.13.2 Asterisk TMS systems ......................
Page 12
Com.X Administrator Guide Page 12 Table 3: Com.X Firewall default policies..............51 Table 4: Comma device configuration...............62 Table 5: Generic device configuration...............63 Table 6: Managed SIP device configuration..............63 Table 7: FXO port configuration................74 Table 8: FXS port configuration.................75 Table 9: BRI port configuration..................76 Table 10: PRI port configuration................77...
Page 13
Figure 7: System maintenance - backup..............22 Figure 8: The new backup is listed under the appropriate section......23 Figure 9: Backups can be scheduled to back up the Com.X settings automatically. 23 Figure 10: The schedule (if configured) is displayed on the title bar......23 Figure 11: Managing individual backup archives.
Page 14
Com.X Administrator Guide Page 14 Figure 20: Licenses submitted for authentication............28 Figure 21: Only system maintenance options available from the GUI of a system with no active licenses......................28 Figure 22: Select the Packages tab................29 Figure 23: Managed packages listed with version and status........29 Figure 24: Options available for managing packages..........29...
Page 15
Figure 58: The Com.X forwards and proxies the necessary traffic to the handsets so that they can sit safely behind a firewall and still be configured remotely....57 Figure 59: The GUI of the device is accessible through the Com.X GUI by selecting Connect........................58 Figure 60: Enabling lines on a handset..............59...
Page 16
Figure 85: 'sudo asterisk -rx "stop when convenient" ' stops the asterisk service, so that no calls are cut off, then 'sudo reboot' reboots the Com.X system....153 Figure 86: If an email address is listed in this field, voicemail recordings and notifications will be sent to the address.
Page 17
Figure 112: The Listen and whisper feature allows the operator to listen in on other calls, and talk to the local user on the call..............177 Figure 113: The landing page of the Com.X Gui.............178 Figure 114: Options available for configuring Nagios monitoring on a port or a service........................
Com.X range of products, release 1.4, including the Wanderbox, Com.X5, Com.X10 and Com.X20 products. It forms part of a suite of manuals and guides for the Com.X product range, which also includes the Com.X End User manual, the Com.X Installation guide and the Com.X Trouble-shooting guide.
2.1 Accessing the unit 2.1.1 Factory network configuration The Com.X units ship with 2 - 4 external ethernet ports labeled lan1, lan2 etc. (enumerated from eth0 in the Operating System). Com.X1 and Com.X10 models have an internal ethernet port (eth3), and certain Com.X5 models have an internal port for DSL applications (wan).
South Networks. Configuration management 2.1.5 GUI layout The Com.X GUI facilitates status monitoring and control of the unit and peripheral devices via a set of menus accessible from the menu bar. After any changes have been made to the configuration, these need to be reviewed and applied before they take effect.
Com.X Administrator Guide Page 21 Figure 3: GUI layout and configuration status 2.1.6 Configuration status The current configuration status, indicating pending tasks and status alerts, can be viewed from the configuration menu: When the status on the Status tab is SYNCHRONIZED, the configuration is up to date and synchronized with the underlying system configuration resources.
Com.X Administrator Guide Page 22 Figure 4: Review / apply task list Figure 5: Start menu options. 2.1.8 Changing the default administrator's password The password for the default administrative user (admin) can be changed by selecting the “Change Password” option from the Start menu. Enter the existing password, the new password and its confirmation and Accept to apply the change.
2.2 System Maintenance 2.2.1 Backup and Restore The Com.X configuration can be backed up to the unit's internal hard drive, or downloaded to another machine. Backups can be scheduled daily, weekly and monthly, and individual sections of the configuration can be configured for backup, each with its own schedule.
The following selection of backup sets are provided for backup: 2.2.1.1.1 Factory default configurations Com.X systems ship with a default factory configuration, which includes the default configuration of telephony ports in the system. This configuration is reflected on hardware the Hardware panel. Factory default configurations cannot be deleted from the GUI, but can be stored offline and may also be uploaded to the system.
Com.X Administrator Guide Page 25 Figure 9: Backups can be scheduled to back up the Com.X settings automatically. The schedule setting is reflected in the backup set's title bar. Figure 10: The schedule (if configured) is displayed on the title bar.
To restore from a data file saved at an external location, first upload the archive to the Com.X and then follow the procedure above. Select “Upload” from the options menu on the appropriate backup set in order to upload an archive.
Page 27
Com.X Administrator Guide Page 27 Figure 15: Submit the desired archive for upload. Then follow the procedure in 2.2.1.5 to restore the backup onto the system. Note: After a configuration has been restored, you will be required to apply the changes.
Figure 16: Updating the MAC address of a replacement unit Note: Updating of the MAC address is necessary only on iTA devices. Units that contain only MPX telephony devices (such as a Com.X 5 with no external iTA's ) will not require MAC addresses to be updated.
Page 29
Com.X Administrator Guide Page 29 Figure 17: Manage Licenses via the This will allow you to upload a license from your computer. Select they type of License you would like to add and then Browse your computer for the correct license file.
Com.X Administrator Guide Page 30 After uploading a license to the Com.X, allow a few seconds for the GUI to update and refresh. If the license is accepted the appropriate GUI functionality will be available. Note: It may be necessary to manually restart the GUI from the command line after adding a license: sudo /etc/init.d/commagui restart...
Figure 23: Managed packages listed with version and status. The State column provides information comparing the version of the installed package to the version of the latest package available on the Far South Networks repository. Figure 24: Options available for managing packages.
This will pull the latest packages from the Far South Networks repository and store them on the Com.X, however it will not install the updates until requested to do so. This allows updates to be retrieved immediately, but installed at a convenient time, when service can be interrupted.
Page 35
The subnet (IP and subnet mask in the form A.B.C.D/E.F.G.H) subnet for any additional local subnet. Traffic on this subnet will be treated as local by the Com.X for SIP purposes. Jitter Buffer When enabled, a SIP jitter buffer will be instantiated for each Enabled SIP call.
Page 36 Field Content network slips Gateway If enabled, all calls on all trunks via the Com.X will be recorded. recording Please see section 3.13.5 for a detailed discussion on gateway recording. Gateway If enabled, all calls on all trunks recorded will be encrypted recording using the Com.X system's unique hardware key.
Page 37
Server Note: the Com.X uses an open-source, synchronous DNS lookup library. As a result, the Com.X makes use of a DNS proxy to facilitate DNS lookups. If the primary DNS is configured to an IP address outside the LAN (i.e. outside of the...
Page 38 3.2.2 Ethernet Interface Configuration The Com.X GUI provides functionality to configure all ethernet interfaces, as well as provision of DHCP IP allocation for IP phones and booting of Comma iTA devices. The Com.X unit can serve both DHCP and Comma addresses simultaneously, provided the IP ranges do not overlap.
DHCP Router Address The address of the IP router / gateway to be used by the device requesting IP configuration, normally the same as the Com.X address on this interface. DHCP DNS Server The primary DNS address to be configured on the device requesting IP configuration, may be left blank.
Page 40
Com.X Administrator Guide Page 40 Figure 30: DHCP and Comma server configuration options. Apply the configuration. Note: When applying network configuration changes, the unit automatically restarts the affected network interface(s). NB. If the interface used for GUI access is reconfigured, GUI access may be affected.
Com.X Administrator Guide Page 42 3.2.3 Configuration of PPPoE Interfaces Figure 31: PPPoE interface configuration options. Field Content Name A suitable name for the virtual interface. Description A description of the interface, marking it as PPPoE. Automatic IP If enabled, the interface will attempt to dynamically receive an IP address via IPCP.
(X21-1) in the Interfaces list. The Com.X X.21 interface is always DTE on the physical layer (although it may act as protocol DCE in Frame Relay mode). Therefore, the clock and thus the data rate of the interface is provided by the DCE equipment connected to the X.21 interface,...
Page 44
Com.X Administrator Guide Page 44 Figure 33: X21 interface configuration The fields are described in the table below. Note that only PPP mode supports Automatic IP configuration. Field Contents Name (not editable) serial0 Description (not X21-1 editable) Serial Protocol IP/HDLC – Raw IP in HDLC encapsulation Cisco HDLC –...
Com.X Administrator Guide Page 45 Management Interface protocol selection. Valid values are: None ANSI DTE ANSI DCE CCITT DTE CCITT DCE Automatic IP (only valid for PPP mode) – obtain IP address automatically from the PPP peer Enabled Interface enabled/disabled at startup IP Address (except when Frame Relay or Automatic IP enabled) –...
Page 46
Com.X Administrator Guide Page 46 Figure 34: PVC interface shown in interface list PVCs are added by selecting Options → New PVC... The screenshot below shows the configuration of a new PVC. Figure 35: X21 PVC device configuration The fields are described in the table below.
Com.X Administrator Guide Page 47 PVC encapsulation IP/Frame Relay – Raw IP is encapsulated in the PVC frame Ethernet/Frame Relay – IP over Ethernet is encapsulated in the PVC frame DLCI Data Link Connection Identifier – number from 1 to 1023...
Page 48
Com.X Administrator Guide Page 48 Figure 37: VLAN Configuration Options Field Contents VLAN Physical The actual physical LAN interface through which this virtual port Interface connects to the rest of the virtual network. This could be any of the LAN ports, or the internal dsl router on certain Com.X5 models.
Page 49
Com.X Administrator Guide Page 49 Enabled By default the port is enabled. Disabling the port prevents all functionality and will delete any associated IP routes. Re- enabling the port will recreate associated IP routes. IP Address If the interface is not configured as a DHCP client, a static IP address can be configured in this field.
Com.X Administrator Guide Page 50 3.2.5.2 VPN Interface Figure 38: VPN interface configuration page. Field Contents Name vpns1 – VPN server interface vpncX – VPN client interfaces (X=1,2,3...) Description Describes the type of VPN interface, automatically configured to either VPN Server or VPN Client with a number index.
3.2.5.2.1 VPN Server By default a disabled VPN server port is configured on the Com.X. To configure, right-click the interface in the interfaces list and select edit. The VPN interface configuration as in Figure 38 will load. Configure interface IP settings appropriately, then select the VPN tab.
Com.X Administrator Guide Page 52 Defaults to 1194. Use LZO The VPN may be configured to use compression on all Compression packets. This will save network bandwidth but incur some performance penalty. Client and server configuration must match. Transport Select between TCP and UDP for VPN transport.
Com.X Administrator Guide Page 53 Figure 41: Certificates are available as standard .p12 or in tar or zip format, for particular handset devices. Select your desired certificate packaging and save the file to a location on your desktop/laptop computer. Note: Changes must be applied after the creation of a client before requesting configuration.
Page 54
Com.X Administrator Guide Page 54 Figure 42: Client VPN configuration. Field Contents Port Number Port number on associated VPN server. Defaults to 1194. Transport Protocol to be used for traffic on the VPN. Select between UDP and TCP. Remote Server...
Com.X Administrator Guide Page 55 the button below, and may be supplied separately (e.g. ca.crt, client.crt, client.key) or in a PKCS12 package (e.g. client.p12) CA/Certificate/key/PK Click on the “...” button to upload certificates from your local CS12 file system to your client device.
3.3.1 Zones The Com.X allows separation of its interfaces into different zones, each of which is authorized to access only portion s of the available network. The access provided to devices in each zone is configured through firewall policies (See section 3.3.2) Figure 45: Ports can be allocated a particular zone into which they fall.
Com.X The Com.X zone contains interfaces (physical and virtual) on the Com.X system itself. This includes the ports listed on the interfaces section of the Network page of the Com.X GUI. Interfaces placed in the LAN zone have access only to the internal network.
Com.X Administrator Guide Page 58 Accept Allow traffic between the two zones. Drop Ignore any packets travelling from the source zone to the destination zone. Reject Reject any packets sent from the source zone to the destination zone with a rejection message.
All Zones All Zones Reject Table 3: Com.X Firewall default policies. 3.3.2.2 Managing Policies Policies are evoked in preferential order based on their position in the list on the GUI. By right-clicking on a policy, it can be moved up and down, deleted and edited.
Com.X Administrator Guide Page 60 Figure 50: Editing an existing Firewall policy. Figure 51: Logging Options for firewall policies. 3.3.2.4 Creating a New Policy To create a new firewall policy, select Options, then new policy. Figure 52: Options for new rules and policies.
Com.X Administrator Guide Page 61 Figure 53: Configuring a new firewall policy. 3.3.3 Rules Rules are very specific exceptions to the configured policies. Rules allow the forwarding of ports. Rules allow for traffic to move from particular ports or addresses in a manner that would normally be prevented by the policies.
Page 62
Com.X Administrator Guide Page 62 Illustration 1: Port Forward rule wizard options. Field Description Source Zone Since this is the port forward rule wizard, the source zone is automatically configured to “Internet” and can not be edited. Source IP address...
The allocated zone of your destination device. As this is an inbound redirect rule, the zone is pre-configured to Com.X and can not be editted from the rule wizard. Destination start port The port to be accessed on the destination device.
Description An optional description for the firewall rule. 3.3.3.3 Inbound Access An inbound access route can be configured to allow access to the Com.X device from particular devices on the external internet. Figure 56: Inbound access rule wizard. Field...
An optional description for the firewall rule. 3.3.3.4 Ping A ping rule allows the Com.X device to receive and respond to pings sent from particular devices in the internet zone (i.e. not on the local network, but rather on the external internet).
Com.X Administrator Guide Page 66 3.3.3.5 Blacklist If required, particular ip addresses or ranges of ip addresses can be black listed by the administrator. This results in any traffic from the source being rejected. Figure 58: Blacklist rule configuration wizard.
The special traffic classes support the setting of Layer 3 class of service (DSCP) and Layer 2 class of service (CoS Priority) for traffic generated by the Com.X. DSCP is generally visible right through the network path, whilst CoS Priority is only used for the local network queuing priority and on VLAN if configured.
P0 is normal priority (unclassified traffic), P7 is highest. 3.4 Hardware Device configuration To list, detect and configure hardware devices (including the Com.X, external iTAs, IP phones and other network devices), select the Start button, then Configuration and open the Hardware panel.
Where available, the device IP address and current status are also listed. 3.4.2 Detecting and scanning for devices The Com.X unit can detect network devices present on all networks attached to it. By default, devices requesting either DHCP IP information, internal telephony devices and external Comma iTA devices are automatically added to the list of detected devices.
Page 71
Comma services. Timing Mode The timing source for the device. Options are: Local: Recover timing from the local Com.X clock (i.e. this device is a clock master) System: Recover timing from another clock master (i.e. this device is a clock slave) This is equivalent to the iTA “Network”...
Indicates whether the Com.X DHCP server should allocate an IP to the device on DHCP request. Once the DHCP lease on the IP expires, the Com.X DHCP server might issue a different IP to the device. To ensure a device is always allocated the same IP (static), disable Auto IP and enter the IP manually.
Each handset will have to be re-added to the hardware panel to allow configuration of any of the settings mentioned. Note: If the phone connects to a network with a DHCP server other than the Com.X present, the DHCP server should configure option 66 to refer to the Com.X when responding to phone DHCP requests.
Note: If a phone is featured on the hardware list, either as a managed SIP phone, or a generic device, the GUI of the phone can be accessed through the GUI of the Com.X. This is done by forwarding ports, ensuring that all hardware is available remotely, even if it is behind a firewall.
Com.X Administrator Guide Page 75 Note: If a Managed SIP Phone is receiving DHCP from a remote server(i.e. Not from the Com.X), that dhcp server should be configured to set option 66 to contain the location /etc/commagui/autoprovision on the Com.X server. Field...
Page 76
Select Options, and then Detected to see a list of detected phones. Select a Managed SIP Device. When configuring an auto-detected device the Com.X automatically detects and populates all fields with appropriate settings. The name of the device is defaulted to the Mac address of the unit, and this is the only field that should require (optional) editing.
Page 77
IP Address An auto-detected device will have received its IP address from a DHCP server on the Com.X, so this field will automatically be populated by the GUI. Network Mask The network mask of an auto-detected device will be automatically configured.
For larger installations, featuring several sip endpoints,spread sheet provisioning is a very powerfull tool. Various fields are configurable on the spreadsheet and will be automatically added to the configuration of the phones, once the Com.X detects them. 3.5.1.3.1 Adding hardware via spreadsheet To add hardware via spreadsheet, first prepare a spreadsheet containing your handsets, extension numbers and settings (voicemail, DNS, NAT etc).
Note: If a handset in the spreadsheet already exists on the Com.X (identified by MAC address) the handset will be updated with the settings from the spreadsheet.
Page 80
Com.X Administrator Guide Page 80 accept the handset configuration, then right-click and edit the hardware entry before the other interfaces become available for selection Figure 78: Select the VLAN interface as the attached network field The phone should then detect the changes to it's network settings and reboot itself, if this does not happen automatically, reset the handset to factory default settings from the GUI.
Factory defaulting phones as you install them deletes any extensions configured in a previous installation and ensures that the Com.X is able to configure all lines seamlessly.
A free extension configured on the system can be assigned to an available line on a SIP handset. Left-click the appropriate line in the port tree of the Extensions page of the Com.X GUI and (while holding left click) drag the line over the entry of the desired free extension and then release.
If there is an unused port(line) on the handset, you can configure it to register as an extension on a remote PBX, from the Com.X GUI. Navigate to the hardware page and select the port from the port tree. Right-click and select Edit.
Com.X Administrator Guide Page 84 system. SIP Server If Local Extension Port is disabled, this field can be edited to contain the IP address of the remote SIP server on which the extension is registering. SIP Server Port If Local Extension Port is disabled, this field can be edited to contain the port on which the extension should register on the remote system.
Com.X Administrator Guide Page 85 Figure 86: Extensions can be configured to support multiple Codecs. 3.5.7 Removing an association to an extension Two possibilities exist for removing extensions from device lines. 3.5.7.1 Unassigning Extensions To unassign an extension, right-click on the extension in the extensions list and select Unassign.
Page 86 3.5.8.1 Configuring Soft Keys The Com.X GUI offers a mechanism to provision the soft keys keys of compatible handsets. These keys can be set to transfer to, and monitor the status (through BLF) of : other extensions, conference extensions, queues, ring groups, parking lots and particular parking bays within parking lots.
The EXT keys are configured as per section 3.5.8.1. Note: Applying any changes to Managed SIP Devices from the Com.X GUI will cause the handset to reboot. The device will reboot,and then update configuration upon startup.
If enabled, the phone using this port is allowed to transfer calls. Immediate mode When enabled, ring tone is not provided when the phone goes off hook and the Com.X is required to take immediate action, such as dialing an emergency number. Please see section 3.12.11.7 for more detail on using FlexPath with his feature.
If multiple devices are attached to the BRI cable (point-to- multipoint) and another device is providing termination, the Com.X can be configured not to terminate. A BRI link should always be terminated by a device on at least one side of the BRI connection, or electrical reflection on the link could interfere with BRI signaling and result in loss of layer 1 link establishment, or CRC errors.
In analog phones, both the 2-wire to 4-wire converter (hybrid) and the handset can introduce echo. The Com.X impedance parameters are aligned with South African telecommunications standards. Non-compliant handsets with a large impedance mismatch are likely to introduce noticeable echo. The delay introduced by VoIP based systems can result in the returned echo becoming noticeable to the person who is speaking.
Page 92
Wiring problems, such as power cables crossing telephone cables, or insufficient earthing of the Com.X or iTAs may add noise to the audio path that may reduce performance of the algorithm. In diagnosing echo cancellation problems, establish good earth (~0.5 ohm or less, if...
It is important that Com.X and iTA devices are earthed in a “star” pattern to a single earthing point. Do not wire an iTA to a Com.X's earth stud or vice versa.
Echo cancellation is performed at the source device, where 'source' here indicates a network endpoint that introduces a signal into the PBX system. In the Com.X systems echo cancellation takes place on FXO, BRI and PRI ports/channels terminating traffic from the PSTN for routing in the system, as well as FXS ports originating calls via the PBX.
GUI, Monitor – Telephony – dahdi statistics should show slips and skips increasing on the span to the iTA. The Com.X can be instructed to buffer in the receive direction from the iTA in order to alleviate such network delays. This is done by enabling the “Network slip tolerant”...
Com.X Administrator Guide Page 96 3.7 Extension configuration 3.7.1 Extensions and Extension Ports The Com.X treats extensions and extension ports differently. Extensions represent dialable numbers (users) in the system, e.g. extension • 1000. Extension Ports represent hardware devices available for making and •...
Com.X Administrator Guide Page 97 Figure 90: Assigning extensions 3.7.3.1 Adding extensions from ports Single extensions or a group of extensions can be assigned to available extension ports by selecting the ports in the ports list and selecting Assign from the context menu.
Com.X Administrator Guide Page 98 •Same as Extension: The password for each newly created extension is the same as the extension number. Note: setting the extension password to the extension number is strongly discouraged and may lead to weak system security! •Random: A strong unique, random password of length 12 is generated , for each...
Page 100
Com.X Administrator Guide Page 100 Field Content Voicemail Enable this to enable voicemail for the extension. Note: Disabling voicemail will reset any call recording settings that may have been configured on the extension! The user pin used to access voicemail and features...
Com.X Administrator Guide Page 101 Field Content Use NAT When enabled, the system ignores the SIP and SDP headers' address and port and replies to the sender's address and port. Outboud CID Optional field to configure outbound caller identification Table 11: Advanced extension configuration 3.7.4.3 Campon Callback...
Page 102
Com.X Administrator Guide Page 102 Field Content Disable When checked, the follow-me configuration is ignored and the extension rings as usual. Note: when follow-me is disabled here, directed pick-up of the extension is no longer available. Initial Ring Time The number of seconds to ring the extension before processing the follow-me list.
Com.X Administrator Guide Page 103 Field Content external number 0115551234 Announcement An announcement to be played to the calling party before processing the follow-me list. Please see section 4.17 for more detail on system recordings. Play Music on If set to Ring, will play ring-tone to the calling party while Hold? processing the follow-me list.
-> Configuration -> Setup and then setting the External address. Configure this field to the dynamic DNS name or the FQDN that resolves to the external (public) address of the Com.X (i.e. the external address should be set to the same as will be programmed into the remote phone).
Com.X Administrator Guide Page 105 3.7.10 Configuring multiple extensions Multiple extensions can be configured simultaneously. When the list of extensions for configuration include both analogue and SIP extensions, only those fields that are not unique to any individual extension can be configured: When only SIP extensions are included in the list, only those fields not unique to any of the SIP extensions can be configured.
Com.X Administrator Guide Page 106 Field Content Name Unique identifier for this group. Analogue groups (FXO) may only be numbers from 1 – 62, and BRI groups may be any unique combination of alpha-numeric characters. Type The group type. Only trunks of this type may be included in the group.
Com.X Administrator Guide Page 107 Field Content Enable trunk When disabled, though part of an outbound route, the trunk group will not be attempted for outbound or inbound calls. Instead, outbound calls will fail-over to the next trunk or group in the outbound route.
Com.X Administrator Guide Page 108 3.8.2.6 Viewing group members Membership of trunks to their respective groups may be observed either by expanding individual devices listed under the Trunk Ports node, where group membership is denoted in parenthesis after trunks, or by selecting the desired group in the group list under the Trunk Groups node, where the devices and trunks included in the group are listed.
Page 109
An UNKNOWN peer will be created and the IP address of the peer will be associated with this trunk on registration. Note: When configuring a Com.X to Com.X SIP trunk, if the registering trunk is configured and applied on the registering Com.X before the SIP provider configuration is applied on the...
Page 111
When enabled, the system ignores the SIP and SDP headers' address and port and replies to the sender's address and port. This should be enabled when the Com.X is located behind a NAT router. Secure If this is setting is enabled, after registration with the SIP provider, all invites will require successful authentication as well as port number matching.
IP overhead without creating additional latency. If the Com.X is located behind a NAT/firewall on the network, configure the NAT/firewall to forward UDP port 4569 to the Com.X internal IP address.
Page 114
An UNKNOWN peer will be created and the IP address of the peer associated with this trunk on registration. Note: When configuring a Com.X to Com.X IAX trunk, if the registering trunk is configured and applied on the registering Com.X before the IAX provider configuration is applied on the...
Com.X Administrator Guide Page 115 When negotiating an IAX call, the codec with the highest priority (at the top of the list) will be attempted first, then the second and so on. Codecs may specify the integration time in milliseconds after the codec name in the form codec:integration time, e.g.
Page 116
Com.X Administrator Guide Page 116 Field Content Budget Mode Select whether the trunk has an associated budget will be skipped in outbound calling routes when the budget is reduced to zero. Budget trunking is enabled when this is set to Skip When Depleted.
3.10 Outbound route configuration A variety of trunk types can be combined and prioritized to form outbound routes, routing calls based on dial-patterns. The Com.X supports routing to trunk groups, as well as individual FXO trunks and BRI channels. 3.10.1 Viewing configures outbound routes The list of existing configured outbound routes can be accessed by selecting Start, followed by Configuration and the Outbound panel.
Com.X Administrator Guide Page 118 3.10.3 Configuring outbound routes Field Content Name A unique name for the route. If set, after a user has dialed a number that matches the dial pattern of this route, the user will be prompted to enter the pin code in order for the call to proceed.
3.11 Inbound route configuration Inbound routes allows incoming calls to be routed to a particular destination based on the incoming call's DID and CID number pair. The Com.X supports a rich set of destination types, greatly simplifying incoming call routing.
Com.X Administrator Guide Page 120 3.11.1 Viewing existing inbound routes This list of configured inbound routes can be viewed by selecting Start, followed by Configuration and the Inbound panel. For each configured inbound route, the DID and CID pair used to match the route, the route description, destination type and destination are displayed.
Com.X Administrator Guide Page 121 3.11.3 Configuring inbound routes Field Content Direct Inward Dialing allows a number of incoming numbers to be serviced across a limited number of physical connections from the telco to the PBX. This field may contain a pattern to be matched against an incoming number.
Com.X Administrator Guide Page 122 Table 20: Inbound route configuration 3.11.4 Configuring call destinations 3.11.4.1 Conferences To configure conferences, select Advanced from the main menu bar and Conferences. Once configured, the destinations will become available selections in the Inbound Routes destination menus.
To delete an inbound route, select Delete from the route's context menu. 3.12 FlexPath configuration The innovative Com.X FlexPath feature is extremely powerful and allows flexible routing, trunk to trunk routing, gateway and class of service capabilities. FlexPaths allow grouping of call sources into contexts (paths) which can be associated with outbound routes, inbound routing tables, transformations, destinations, etc.
Com.X Administrator Guide Page 124 A number of configuration parameters • One or more FlexPath Routes • Types of FlexPath Routes available are as follows: Include – the selected routing set is simply included (routing sets include • Inbound, Internal, other FlexPaths and Outbound routes) Match –...
Com.X Administrator Guide Page 125 3.12.2.3 Start Start routes are special cases of Match routes and match when no DID are available. These routes are used to assign DIDs to originating calls when no DID information is present. Start routes will only match if no DID are available. If it is possible that a DID will be present, include a Match rule as well.
Com.X Administrator Guide Page 126 Field Content Name Unique name for the FlexPath. Spaces are not allowed in the name. Description Custom description for the FlexPath. Account Code If configured, adds an account code to calls within a FlexPath which can be used to group calls for billing purposes.
Com.X Administrator Guide Page 127 Field Content Routing mode One of Include, Match or Start. Please see 3.12.2 for more detail on FlexPath route types Pattern The DID pattern that this route will match The CID pattern that this route will match...
Com.X Administrator Guide Page 128 applied with no break in service. Scenario Extension 301 is required to have access to internal and national dialing only. • Extension 302 is required to have access to internal, national and • international dialing.
Page 129
Com.X Administrator Guide Page 129 Two Inbound routes: Fixed incoming DID 8000 is routed to Company A's reception. This DID will be • assigned to BRI calls originating from Company A's BRI channels in a FlexPath Fixed incoming DID 9000 is routed to Company B's reception. This DID will •...
SIP trunks and PSTN trunks provided for call routing at the head office location. Configuration: Both the head office and the branch office are provided with Com.X units. Extensions: Head office extensions configured as 101 – 105 •...
Com.X Administrator Guide Page 131 3.12.11.5 Legacy PBX Remote extension gateway Scenario: A company has a head-office with 4 FXO trunks to the telco and 10 analogue extensions on a legacy PBX. The legacy PBX has a number of unused extension and trunk ports available.
Com.X extension also rings. This enables calls to be recorded on the legacy analogue extensions. Though dialed numbers cannot be recorded in CDR records for the legacy extensions (since the number is not collected by the Com.X solution but rather passed straight through to the legacy PBX), the duration of calls originating from legacy extensions can be recorded.
3.12.11.9 Assigning DIDs to BRI ports When DIDs are not provided over BRI channels, DIDs can be associated directly with BRI ports in the Com.X to facilitate call routing. Scenario: DIDs 9001 – 9004 need to be associated with 4 BRI ports.
3.12.11.11 FXO Trunk pick-up to test for trunk service When installing a Com.X, at times it might be useful to determine whether a specific trunk port has been service provisioned by a device connected to the port. For example, the installer might want to check whether a legacy PBX is providing dial- tone in the trunk, or a premi-cell is available.
(E.g. a Com.X with a 250GB hard drive can record ~400,000 minutes of voice in A-law WAV format and a Com.X with a 60GB SSD drive ~500,000 minutes of voice in GSM format or 100,000 minutes in A-law WAV).
3.13.4 Call recording conditions Due to privacy issues in countries that enforce these, the Com.X recording feature only records calls as follows: Outbound calls are recorded if the caller has recording enabled in the outbound direction or uses on-demand-recording on the call.
Com.X Administrator Guide Page 137 Gateway call recordings are stored in /var/spool/asterisk/monitor/ and are named with the prefix “gw-rec”. Note: Outbound calls from extensions will feature two recordings if gateway recording is enabled. One will be prefixed OUT<extension number> whilst the gateway recording will be prefixed ge-rec 3.13.5.1 Gateway Recording Encryption...
• 3.15 Securing the system It is of utmost importance to ensure that the Com.X system is secure. If a Com.X unit is public facing, large costs can be incurred if the VoIP configuration security is weak, or downtime and degraded performance may result from the Operating System being compromised.
Com.X Administrator Guide Page 139 3.15.1 General Ensure that access to the unit is restricted. Install the Com.X in a secure • server room or locked cabinet. This prevents unauthorized access to the unit using the serial port or USB keyboard, as well as physical damage to the unit or its power supply.
MAC addresses, IP addresses or networks. 3.16 Call behavior on No answer / Busy This section describes the Com.X behavior and call routing for incoming calls that go unanswered or encounter a busy extension. 3.16.1 Unattended transfer On unattended transfer, the person transferring the call is taken out of the loop, i.e.
Page 141
Com.X Administrator Guide Page 141 with a modification to the CID. The new CID presented to the transferring party will be prefixed by “Ret:” to indicate that the call is returning, as well as a the extension number of the destination extension to which the original call was transferred. The Ringback caller id will have the form : “Ret: [original intended destination extension]CID”...
Com.X Administrator Guide Page 143 Note: Users need to be informed as to what to expect. With ring-back enabled their phones should 'ring by itself' once available. If the hand-set it picked up, they should hear ringing while the initial calling party is being contacted.
Com.X Administrator Guide Page 144 4 Advanced configuration Access to a variety of advanced features is provided via the Advanced menu. Selecting a function from this menu opens a new window, which can be maximized with detailed configuration options for the feature. Once configured, select Submit at the bottom of the configuration page.
Page 145
Com.X Administrator Guide Page 145 Field Content Callback description A custom description for this callback. Callback number The number to call back. If this is left blank, the caller ID will be used to callback. Note: the device to be called back must support incoming calls directly(e.g.
Com.X Administrator Guide Page 146 4.3 Conferences This feature allows multiple users to join a conference with two-way audio on all devices. Conference features include join and leave announcements, passwords, conference administration, in-conference menus, etc. Field Content Conference number The number to dial to access the conference...
Page 147 4.4 Day / Night control A number of day / night modes can be programmed on the Com.X. Each has a feature index and can route calls according to its own set of rules. These allow configuration of day / night to support multiple receptionists, tea or lunch breaks, after hours, etc.
Com.X Administrator Guide Page 148 Field Content Feature code index The index of this day/night mode. The index is the day-night feature code (please see section 4.5 for more detail on feature codes), with the last digit of the feature code (e.g. 280) replaced by this day/night's index (e.g.283, 284, 288, etc.) Up...
Page 149
Com.X Administrator Guide Page 149 enable or disable the function, or revert to the default feature code associated with the function. Field Content Name The name of the function category or the individual function. Code The feature code currently associated with the function...
Com.X Administrator Guide Page 150 4.6 General Settings General settings apply system-wide on the Com.X platform. Users can typically override general settings with their own preferences, but some general settings override all user preferences. 4.6.1 Dial command options t: Allow the called user to transfer the call with the “in-call blind transfer” feature code (default ##).
Page 151
Call recording format Recordings will be saved on the Com.X hard drive in the format selected here. Options are: wav, law, alaw, GSM, SLN, G.729.
Page 154
Allow the system to automatically check the internet for FreePBX and Asterisk version updates. Updates of the FreePBX and Asterisk modules are managed by Far South Networks for the Comma and Com.X product ranges. This field should be left blank. Update email An email address to send notifications of available updates to.
Page 156
Com.X Administrator Guide Page 156 Field Content Change Name Changes the name used to identify this IVR from the default (Unnamed). This entry will be displayed in selection lists that support IVR. Announcement The audio message to be played to the user when this IVR is accessed.
Page 157
Com.X Administrator Guide Page 157 Field Content Invalid message If specified, this audio message is played when the user selection is invalid. Repeat loops The number of times the IVR should be played if the user does not provide an option before timeout, or if the option is invalid.
Warning: If you incorrectly configure the application entry above, applying might result in the apply freezing up. To fix this, restart the Com.X, correct the application entry, or remove the streaming music on hold category and apply.
If this is disabled, files are played in the order listed here. Table 33: Playback configuration 4.8.3 Adding a music category Music categories categorize the audio files available on the Com.X PBX server storage. Field Content Category name...
Com.X Administrator Guide Page 160 Field Content Category name A unique name for this streaming category. Application This is the "application=" line used to provide the streaming details to Asterisk. Please see information on the musiconhold.conf configuration for different audio and internet streaming source options.
Com.X Administrator Guide Page 161 Field Content Route name A unique name for this route. Route password An optional password. If present, users will be prompted to enter this password before call routing using this route is allowed. Note: this is a single password for the route.
Com.X Administrator Guide Page 162 Field Content Paging extension The extension to dial to activate the page Group description A custom description for this group Device list The list of devices and extensions to include in this paging group Force if busy...
Com.X Administrator Guide Page 163 4.12 Parking Lot Callers can be placed in a parking with a time out associated, after which the caller is transferred to the specified destination. This allows receptionist, for example, to place a caller on hold while waiting for their desired extension to become available. The caller in the parking lot would then, after the parked timeout, automatically ring reception again, by which time the desired extension might have freed up.
“Name”;number;speeddial If large phonebook databases (> 2000 entries) are to be uploaded, additional configuration is required. Please see the Com.X Troubleshooting guide for more detail large phonebook imports. Note: If the delimiter is something other than ';' the import will fail. Please see your operating system / application help for configuring ';' as the CSV export...
Page 165 4.15 Queues Queues are a powerful feature of the Com.X system, allowing callers to be placed on hold and transferred according to a number of strategies and based on priority. Callers waiting in the queue are provided with their position in the queue, projected waiting time and the option to use self-service menus to exit the queue and transfer to other destinations.
Page 166
Com.X Administrator Guide Page 166 Field Content Queue number The extension number of the queue. Any calls or transfers to this extension will be routed to the queue. Queue name A unique name for the queue. Queue password An optional password. If set, agents will need to log in with this password before they can service the queue.
Page 167
Com.X Administrator Guide Page 167 Leastrecent: Rings the agent who was least recently called by this queue. Fewestcalls: Rings the agent who has serviced the fewest calls from this queue. Random: Rings an agent at random. Rrmemory: Round robbin with memory. Rings each agent...
Com.X Administrator Guide Page 168 Frequency The frequency with which their position and estimated hold time is announced to the caller. Announce position If set to Yes, the annoucements will tell the caller their position in the queue. Announce hold...
Page 169
Com.X Administrator Guide Page 169 Field Content Ring group The number a caller will dial to ring extensions in this ring number group. Group description A descriptive title for this ring group. Ring strategy The strategy with which to ring extensions in this ring group.
Com.X Administrator Guide Page 170 and other features. Ignore CF settings When checked, agents who attempt to use call forward will be ignored. Skip busy agent If checked, agents on an occupied line will be skipped as if the line were returning an unavialble signal. This prevents calls form being presented to call waiting features.
Page 171 4.18 Time Conditions Time conditions check the current Com.X system time and compares it with the specified Time Group to determine whether there is a match. The call is then routed either to a day-night entry if this over-ride has been enabled, or to the match destination if the current time falls within the time block specified in the Time Group, or to the no match destination otherwise.
Com.X Administrator Guide Page 172 4.19 Time Groups Time groups allows the specification of blocks of time for use in call routing rules, such as time conditions. Please see 4.18 for more detail on Time Conditions. Field Content Name A name to identify this time group with. This will appear in selection lists that allow time groups.
A DISA destination allows for an outbound dial tone to be configured as a destination on the unit. This could be used to allow particular external callers to make outbound calls through the outbound routes on the Com.X. Field Content DISA Name An appropriate name for the DISA destination.
4.22 Listening in on calls / Spy feature The Com.X PBX allows a spy feature to be enabled that allows the listener to listen in on calls in progress. Input from the listener will not be audible to the callers on the call being listened in to.
Configuration details, Host system monitoring, Telephony status and events and GUI web server status. 5.1 GUI Status Page The status page of the Com.X GUI offers vast monitoring features, as well as displaying the configuration status of the Com.X. 5.1.1 Status Display The GUI offers a display to indicate the overall status of the system configuration and synchronization.
Table 47: Logging levels Logging takes place on the CLI as well as to /var/log/asterisk/messages. From the Com.X GUI, two levels of detail can be selected, namely “brief” or “verbose”. These may be accessed using Monitor -> Asterisk -> Set log level <Brief/Verbose>...
A results summary is displayed at the bottom of the list, where navigation of the list is also facilitated. CDR records are stored in a database on the Com.X and can be backed up. Please see 2.2.1.1.4 for more detail on backing up the CDR database.
Com.X Administrator Guide Page 178 The Com.X provides monitoring of the available space on the hard drive, SSD or SD card.Space on the device is consumed as new calls are recorded and the recordings are saved. The Com.X monitors the storage and sends a notification email (see section 3.1) once the space consumed in exceeds a particular threshold (default...
Page 179
Com.X Administrator Guide Page 179 Category Function Description Set log level brief Enable logging of notices, warnings and errors only Set log level verbose Enable logging of DTMF, verbose messages, notices, warnings and errors Configuration DHCP Configuration Dahdi system Dahdi span configuration (/etc/dahdi/system.conf)
Page 180
Com.X Administrator Guide Page 180 Category Function Description Reload mISDN Reloads the mISDN module. Service to BRI channels will be lost while reloading. Reload Dahdi Reloads the dahdi module. Service to analogue and PRI channels will be lost while reloading.
Page 181
Com.X Administrator Guide Page 181 Category Function Description might indicate network performance issues that could result in a decrease in call quality. Device discovery Displays the list of Comma devices visible to the Comma Manager on all networks, including their ethernet and IP configuration status.
Page 182 6 Advanced Administration 6.1 Console access Note: Any customisation or third party integration not explicitly endorsed and supported by Far South Networks will result in the software warranty becoming void. 6.1.1 Authentication Default username: comma Default password: farsouth It is advisable to change the authentication information from the default if the unit is accessible over the network via secure shell.
Figure 101: 'sudo asterisk -rx "stop when convenient" ' stops the asterisk service, so that no calls are cut off, then 'sudo reboot' reboots the Com.X system. 6.3 Configuring email services 6.3.1 Configuring voicemail to email...
6.3.2 Configuring sendmail for mail relay Note: Mail relay configuration is not backed up by the Com.X backup utility. The Com.X product range makes use of sendmail for outbound SMTP mail delivery. The sendmail server will attempt to directly resolve destination mail server addresses and contact these servers directly for mail delivery.
Com.X Administrator Guide Page 185 Figure 103: Sendmail configuration 6.3.3 Sending a test email You can send a test email by using the 'mail' command. The first parameter of the mail command is the destination email address. After entering a subject, enter the message body.
sudo asterisk rx "core show channels" | grep x "0 active calls" sleep 1 done 6.5 FreePBX access Though we strongly recommend using the Com.X GUI for all configuration tasks, occasional advanced configuration might be required that necessitate the use of FreePBX. To access the FreePBX configuration GUI, point your browser at: http://<ipofpbx>/freepbx...
6.7 Setting the system's date, time and timezone The Com.X unit tries to obtain date and time from an NTP server on the internet. Failing this, or in the case where the date / time discrepancy on a unit is large, the date and time can be configured as follows: 1.
Com.X Administrator Guide Page 188 6.8 Video call support (H.263 and H.263+) The Com.X platform may be configured to support video calls. Care should be taken to evaluate potential performance impacts of video codec translation on the platform in question.
6.13.1 MAN 3000 6.13.1.1 Installing MAN 3000 support The Com.X supports logging of call records to a MAN 3000 buffer across ethernet. To enable support for MAN 3000 on a Com.X unit, from the shell, install the MAN3000 support package: sudo aptitude install commaman3000 For Man3000 releases prior to 11.02:...
Page 191
Page 191 Figure 106: Man 3000 TCP/IP configuration Installing the PBX templates: Download the Far South Networks MAN3000 PBX format template from the Far South Networks website at http://farsouthnet.com/support/technical-notes/(right-click Save Target As, or Save Link As) Alternatively, download the formats directly (using a downloader such as wget) from: http://archive.farsouthnet.com/support/fsnInbound.PBX...
Page 194
Com.X Administrator Guide Page 194 Field Content Type / Line In the first column, a value of 'I' indicates that the record is for an incoming call. Any other value indicates the line number as defined in /etc/commagui/man3000.patterns for an outgoing call, or 9 in case the channel for the outgoing call was not pattern matched.
To configure the Com.X to start logging records again at some date in the past, modify the /var/lib/commaman3000/lastdate file located in the Com.X file system. This file can be created on a separate system or laptop and copied onto the Com.X as follows: scp lastdate comma@<ipofcom.x>:/var/lib/commaman3000/...
We strongly recommend installing third party TMS software on a separate machine, accessing the Com.X CDR files and database with read-only access. Third party TMS systems have access to Com.X CDR records via one of the following tools: After installation of the commaman3000 package, CDRs are served on the •...
6.15.1 Outcall Outcall supports only SIP extensions, but in addition to making outbound calls also pops up contact details for incoming calls. Outcall has been tested with the Com.X using Outlook 2000 and Outlook 2007. Download the Outcall installer from http://code.google.com/p/outcall/downloads/list...
Page 199
Add the extension to be used for the PC running outlook. This must be a SIP extension: Figure 111: Outcall extension configuration Log in via the ssh shell onto the Com.X and create an AMI user account as follows in /etc/asterisk/manager.d/outcall.conf [testuser] secret = fsntestuser...
Com.X Administrator Guide Page 200 In Outlook, select the contact to call and select the “Outcall” button. When a call is received by the Com.X, the calling contact, or a new contact window should appear in Outlook. Figure 112: Outlook contacts integration 6.15.2 asttapi...
Page 201
User Channel The extension channel (e.g. SIP/8263 or Zap/8) Line name The name of the line as displayed in Outlook (e.g. Far South Networks Com.X) Context from-internal (or the flexpath context for class of service configurations) Called ID The caller ID for the extension Table 52: asttapi configuration Apply the configuration.
Com.X systems are shipped with fail2ban installed and enabled. fail2ban provides a comprehensive and flexible mechanism for preventing unauthorized access to Com.X systems. The fail2ban application acts as a security monitor and firewall manager, detecting multiple failed attempts to access a service (such as ssh or SIP) from the same IP address and then blocks the address for a configured period of time.
From the operator panel, calls can be answered, transferred, originated, recorded and ended, using simple clicks of a mouse. The demo version of the Flash operator panel included as stock on Com.X products allows for up to 15 extensions, trunks, queues or parking lots. By default, the panel will show buttons for the first 15 such mechanisms configured, but not for any configured thereafter.
Com.X Administrator Guide Page 204 Figure 117: FOP access can be limited to the operator only, if required. 6.18.5 Accessing Flash operator panel The flash operator panel is accessed by selecting the “Operator Panel” icon on the launch page of the GUI.
Com.X Administrator Guide Page 205 6.18.6 Using FOP2 Once logged in to the Flash operator panel, the extension of the logged in user will be displayed on the top left button, with the extension number in bold. Operator extensions will be presented with more functionality options than regular users, controlled by black button icons listed above the extensions.
Com.X Administrator Guide Page 206 panel users. Figure 123: Dialling extension 2000 from extension 1000. Notice the blue outline around extension 2000. This first causes extension 1000 to ring, and upon a user answering, dials extension 2000 from extension 1000.
6.19 Nagios The Nagios application provides an expandable and highly customisable platform for monitoring of system services and network health. Com.X units are shipped with a Nagios Core suite preconfigured to monitor the state of selected services and interfaces on the system.
6.19.1 Hosts Nagios can be configured to monitor network and service status on mulitple hosts. The Nagios application on the Com.X system has the localhost defined as the only host, however more hosts can be defined and monitored, if required.
Com.X Administrator Guide Page 209 Service What is monitored? BRI mISDN Port Provides the status of each BRI mISDN port on the system. Status Including the link type (Point-to-point or point-to-mulitpoint), the network or terminal status of the port, as well as the status of the L1 and L2 links.
Com.X Administrator Guide Page 210 Figure 130: Options available for configuring Nagios monitoring on a port or a service. Select “Disable active checks of this service” . This will prevent the Nagios application from monitoring the service or port. Thereafter, select “Submit passive check result for this service” and set the check result to “OK”.
Need help?
Do you have a question about the Com.X and is the answer not in the manual?
Questions and answers