XPhone Call Controller - XCC

The XPhone Call Controller (XCC) is a softswitch or media controller that is seamlessly integrated into the XPhone Connect environment. SIP gateways for Softphone Desktop, Softphone Mobile, AnyDevice, Meeting (audio conference) and TeamDesk are set up on this softswitch. The XPhone Call Controller is installed with the XPhone Connect Server or separately on a Linux satellite. It communicates with the PBX via SIP trunks and with XPhone Connect via TCP.

Hint

  • If you restart (or deactivate and reactivate) the XCC, all SIP gateways are reconfigured and initialized.

  • AnyDevice must not be used together with dynamic line allocation. An important feature of AnyDevice is the One Number, which does not exist during dynamic line allocation. Therefore, these performance features cancel each other out.

Telephony gateway data

Name:

Name of the XPhone Call Controller. The name is predefined and cannot be changed.

PBX type:

This system type is firmly allocated as XPhone Call Controller and cannot be changed.

Deactivated:

The XPhone Call Controller is deactivated during restarts and must be activated if required:

  • System settings > Telephony & Meetings > Telephony > SIP > XCC

    • Uncheck the Disabled checkbox.

XPhone Call Controller (XCC)

Here you can decide whether the local Windows XCC or a Linux based XCC on a satellite should be used. The following radio buttons are available for selection:

  • use local XCC from XPhone server

  • use outsourced XCC on a Linux satellite

Hint

Learn how to outsource the XPhone Call Controller to a Linux satellite: Configuration of an XCC Satellite

Attention

Please keep in mind that the SIP trunk for UM (e.g XCAPI) must be switched on separately, if UM is used together with the XPhone Connect Server. Conflicts might occur otherwise.

RTP communication

Here you can set the port range for Real-Time Transport Protocol (RTP) voice communication (default = 30,000 - 33,000). These are the source ports of the XCC. The ports of the phones/clients can be different (depending on the call partner).

Caution

  • This portrange must also be accessible from the Internet if you want to use Softphone Mobile or Softphone Desktop (with payload separation).

  • See Media data streams and signaling.

Attention

If you change the portrange you have to stop and restart the XCC (or disable and re-enable for Windows-based XCC).

Hole punching

Hole punching is a technique that can be used to establish a UDP connection between two computers, even if both are behind restrictive firewalls. This is a special case of tunnelling and can help establish a connection when port forwarding is not possible in the firewall on XCC side.

Usually, only those media candidates are pinged for an RTP connection that are within the list of the Private IP address ranges. Using Hole punching, the XCC now pings all media candidates offered by the client, so that incoming media connections are possible from the XCC’s side.

Hint

  • You should always try to make the XCC available from the Internet using port forwarding or network address translation.

  • Hole punching should not be the first choice, but the last.

Private IP address ranges

It is mandatory that you enter the private address range (trusted network) configured in the company here. This configuration recognises which communication participants are in the internal network (LAN, VPN). This ensures that for Softphone calls of all types, the audio-media connection remains within the company network.

Hint

Also the loopback address 127.0.0.1 belongs to it, if you use it in the SIP gateway under SIP connection XCC <-> XPhone Connect Server (AnyDevice/softphone).

Access control via IP address ranges (blacklist)

The networks listed here are not used for media communication. IP addresses from these areas are not taken into account when negotiating the possible RTP connection candidates. The networks that are not or should not be VoIP-capable (e.g., payload separation) should be listed here.

Adapter for WebRTC logging

Select the adapters to be used for audio communication (media negotiation). Problems are recorded here that have an effect on the establishment of the media, such as no audio or one-sided audio connections.

Advanced settings

Attention

Only change these settings when advised to do so by product support.

Click Add to create a parameter.

Name

Description

Value

CreateLineVerify

Lines are verified before creation; i.e. invalid phone numbers are filtered. Type: Numerical decimal or hexadecimal (starts with 0x) value

0: off
1: On (default)

Click Accept to accept the selected parameter and the values you have set for it, or click Cancel to discard your changes. You return to the Change XPhone Call Controller dialogue. You can add additional parameters or modify existing ones with Edit or delete parameters with Delete.

In the Change SIP trunk dialogue, click Save to save all settings. If you click Cancel, you will leave the setting dialogue and your changes will not be saved.

Parameter sets for lines (advanced settings)

The parameter records for lines are optional and only required in special cases. If desired or if your company structure requires this, additional parameters can be specified depending on the PBX.

Clicking on Add will first take you to the Create parameter set for lines dialogue. You must enter a unique name and, as an option, a description here. To enter the parameters now, click Add again, enter the required parameter and enter a value in the Add new advanced settings dialogue.

Hint

You can obtain parameters and values from product support. They will find out together with you, which parameters are useful for the corresponding circumstances and which values will result in a solution to the issue.

Click Apply to save the selected parameter with the set values or Cancel to discard the information. Return to the Create parameter sets for lines dialogue. You can add additional parameters or modify existing ones with Edit or delete parameters with Delete. Click Apply again to apply the selected parameters with the set values or Cancel to discard the information and return to the Change XPhone Call Controller dialogue.

In the Change XPhone Call Controller dialogue, click Save to save all settings. If you click Cancel, you will leave the setting dialogue and your changes will not be saved.

Have you found an mistake on this page?

Please send us a hint about this error by mail to doku@c4b.de. Thank you very much!