XiVO Solutions Logo
2021.15
  • Introduction
  • Getting Started
  • Installation & Upgrade Guide
  • Administrator’s Guide
  • IPBX Configuration Guide
    • Advanced Configuration
    • Boss Secretary Filter
    • Call Completion
    • Caller Number Normalization
    • Call Permissions
    • Call Logs
    • Conference Room
    • CTI Server
    • Customer info
    • Devices
    • Directories
    • Directed Pickup
    • Entities
    • Fax
    • Graphics
    • Groups
    • Group Pickup
    • Incall
    • Interconnections
      • Interconnect two XiVO directly
      • Interconnect XiVO with a known SIP Provider
      • Interconnect XiVO with any VoIP provider
      • Interconnect XiVO with a PBX via an ISDN link
        • Hardware
        • Configuration
      • Create an interconnection
      • Debug
      • Caller ID
      • Outgoing call caller ID
    • Interactive Voice Response
    • Monitoring
    • Music on Hold
    • Outgoing Calls
    • Paging
    • Parking
    • Phonebook
    • Provisioning
    • SCCP Configuration
    • Schedules
    • Sound Files
    • Switchboard
    • Unique Account
    • Users
    • User Labels
    • Voicemail
    • WebRTC
    • Web Services Access
  • Contact Center
  • XiVO Edge
  • Meeting Rooms
  • IVR Editor
  • User’s Guide
  • Devices
  • API and SDK
  • Contributing
  • Release Notes
XiVO Solutions
  • Docs »
  • IPBX Configuration Guide »
  • Interconnections »
  • Interconnect XiVO with a PBX via an ISDN link
  • Edit on GitLab

Interconnect XiVO with a PBX via an ISDN link¶

The goal of this architecture can be one of:

  • start a smooth migration between an old telephony system towards IP telephony with XiVO
  • bring new features to the PBX like voicemail, conference, IVR etc.

First, XiVO is to be integrated transparently between the operator and the PBX. Then users or features are to be migrated from the PBX to the XiVO.

Warning

It requires a special call routing configuration on both the XiVO and the PBX.

../../_images/xivo-pbx.png

Interconnect XiVO with a PBX

Hardware¶

General uses¶

You must have an ISDN card able to support both the provider and PBX ISDN links.

Example : If you have two provider links towards the PBX, XiVO should have a 4 spans card : two towards the provider, and two towards the PBX.

If you use two cards¶

If you use two cards, you have to :

  • Use a cable for clock synchronization between the cards
  • Configure the wheel to define the cards order in the system.

Please refer to the section Sync cable

Configuration¶

You have now to configure two files :

  1. /etc/dahdi/system.conf
  2. /etc/asterisk/dahdi-channels.conf

system.conf¶

You mainly need to configure the timing parameter on each span. As a general rule :

  • Provider span - XiVO will get the clock from the provider : the timing value is to be different from 0 (see /etc/dahdi/system.conf section)
  • PBX span - XiVO will provide the clock to the PBX : the timing value is to be set to 0 (see /etc/dahdi/system.conf section)

Below is an example with two provider links and two PBX links:

# Span 1: TE4/0/1 "TE4XXP (PCI) Card 0 Span 1" (MASTER)
span=1,1,0,ccs,hdb3         # Span towards Provider
bchan=1-15,17-31
dchan=16
echocanceller=mg2,1-15,17-31

# Span 2: TE4/0/2 "TE4XXP (PCI) Card 0 Span 2"
span=2,2,0,ccs,hdb3         # Span towards Provider
bchan=32-46,48-62
dchan=47
echocanceller=mg2,32-46,48-62

# Span 3: TE4/0/3 "TE4XXP (PCI) Card 0 Span 3"
span=3,0,0,ccs,hdb3         # Span towards PBX
bchan=63-77,79-93
dchan=78
echocanceller=mg2,63-77,79-93

# Span 4: TE4/0/4 "TE4XXP (PCI) Card 0 Span 4"
span=4,0,0,ccs,hdb3         # Span towards PBX
bchan=94-108,110-124
dchan=109
echocanceller=mg2,94-108,110-124

dahdi-channels.conf¶

In the file /etc/asterisk/dahdi-channels.conf you need to adjust, for each span :

  • group : the group number (e.g. 0 for provider links, 2 for PBX links),
  • context : the context (e.g. from-extern for provider links, from-pabx for PBX links)
  • signalling : pri_cpe for provider links, pri_net for PBX side

Warning

most of the PBX uses overlap dialing for some destination (digits are sent one by one instead of by block). In this case, the overlapdial parameter has to be activated on the PBX spans:

overlapdial = incoming

Below an example of /etc/asterisk/dahdi-channels.conf:

; Span 1: TE4/0/1 "TE4XXP (PCI) Card 0 Span 1" (MASTER)
group=0,11
context=from-extern
switchtype = euroisdn
signalling = pri_cpe
channel => 1-15,17-31

; Span 2: TE4/0/2 "TE4XXP (PCI) Card 0 Span 2"
group=0,12
context=from-extern
switchtype = euroisdn
signalling = pri_cpe
channel => 32-46,48-62

; PBX link #1
; Span 3: TE4/0/3 "TE2XXP (PCI) Card 0 Span 3"
group=2,13
context=from-pabx     ; special context for PBX incoming calls
overlapdial=incoming  ; overlapdial activation
switchtype = euroisdn
signalling = pri_net  ; behave as the NET termination
channel => 63-77,79-93

; PBX link #2
; Span 4: TE4/0/4 "T4XXP (PCI) Card 0 Span 4"
group=2,14
context=from-pabx     ; special context for PBX incoming calls
overlapdial=incoming  ; overlapdial activation
switchtype = euroisdn
signalling = pri_net  ; behave as the NET termination
channel => 94-108,110-124

Passthru function¶

Route PBX incoming calls¶

We first need to create a route for calls coming from the PBX

# Create a file named pbx.conf in the directory /etc/asterisk/extensions_extra.d/, # Add the following lines in the file:

[from-pabx]
exten = _X.,1,NoOp(### Call from PBX ${CARLLERID(num)} towards ${EXTEN} ###)
exten = _X.,n,Goto(default,${EXTEN},1)

This dialplan routes incoming calls from the PBX in the default context of XiVO. It enables call from the PBX : * towards a SIP phone (in default context) * towards outgoing destniation (via the to-extern context included in default context)

Create the to-pabx context¶

In the webi, create a context named to-pabx:

  • Name : to-pabx
  • Display Name : TO PBX
  • Context type : Outcall
  • Include sub-contexts : No context inclusion

This context will permit to route incoming calls from the XiVO to the PBX.

../../_images/context-to-extern.png

Route incoming calls to PBX¶

In our example, incoming calls on spans 1 and 2 (spans pluged to the provider) are routed by from-extern context. We are going to create a default route to redirect incoming calls to the PBX.

Create an incoming call as below :

  • DID : XXXX (according to the number of digits sent by the provider)
  • Context : Incoming calls
  • Destination : Customized
  • Command : Goto(to-pabx,${XIVO_DSTNUM},1)
../../_images/incoming_call.png

Create the interconnections¶

You have to create two interconnections :

  • provider side : dahdi/g0
  • PBX side : dahdi/g2

In the menu Services ‣ IPBX ‣ Trunk management ‣ Customized page :

  • Name : t2-operateur
  • Interface : dahdi/g0
  • Context : to-extern
../../_images/interco1.png

The second interconnection :

  • Name : t2-pabx
  • Interface : dahdi/g2
  • Context : to-pabx
../../_images/interco2.png

Create outgoing calls¶

You must create two rules of outgoing calls in the menu Services ‣ IPBX ‣ Call management ‣ Outgoing calls page :

  1. Redirect calls to the PBX :
  • Name : fsc-pabx
  • Extension : XXXX
  • Context : to-pabx
  • Trunks : choose the t2-pabx interconnection
  1. Create a rule “fsc-operateur”:
  • Name : fsc-operateur
  • Extension = X.
  • Context : to-extern
  • Trunks : choose the “t2-operateur” interconnection
Next Previous

© Copyright 2016-2019, Avencall Revision 27e7ac29.

Creative Commons License This work is licensed under a Creative Commons Attribution-ShareAlike 4.0 Unported License .
Read the Docs v: 2021.15
Versions
latest
2022.10
2022.05
2021.15
2021.07
2020.18
2020.07
2019.12
2019.05
2018.16
2018.05
2017.11
2017.03
2016.04.00
2016.02.00
xivo-16.08
xivo-16.04
xivo-16.03
x15.12
Downloads
pdf
html
epub
On Read the Docs
Project Home
Builds

Free document hosting provided by Read the Docs.