Actions

SIP trunk node - configuration

From Zenitel Wiki

Revision as of 10:15, 6 January 2017 by Asle (talk) (SIP User)
SIP Trunking with AlphaCom XE

The AlphaCom XE uses the SIP protocol for easy interoperability with telephone systems. Via SIP Trunking the AlphaCom can be interfaced to:

  • Voice gateways (Analogue, GSM, ISDN)
  • SIP iPABX
  • Call Managers
  • Asterisk software PBX
  • Tetra radio systems
  • ....

This article describes how to configure a SIP Trunk in the AlphaCom XE. It is possible to define multiple SIP trunks.

Contents

AlphaWeb Configuration

Assign IP address to the AlphaCom XE Ethernet Port(s)

Log on to AlphaWeb. In System Configuration -> Interfaces, enter a valid IP address on the Ethernet port. Consult your network administrator to obtain the IP address.

Assign IP routing to the AlphaCom XE Ethernet Port(s)

In System Configuration -> Routes, create a Default gateway. This is required if the SIP device and AlphaCom are on two different networks.

Insert SIP Trunk licenses

In System Configuration -> License key, install the SIP Trunk License.

CiscoAlphaWebIPLicense.PNG


In case there are multiple SIP Trunk nodes connected to the AlphaCom, the SIP Trunk lines are a common pool of resources for all connected SIP Trunk nodes.

Firewall (filter) settings

In System Configuration -> Filters, enable the SIP and VoIP Audio on the desired Ethernet port (default enabled for Ethernet port 1).

CiscoAlphaWebIPFilters.PNG


AlphaPro Configuration

Create a SIP Trunk Node

From the AlphaPro main menu, use the ‘+’ button next to the ‘Select Exchange’ dropdown list to create a new exchange. The exchange type must be set to ‘SIP Node’.

Set the parameters as shown in the figure to the right.
The SIP Trunk line IP address must be identical to the IP address of the SIP gateway or iPBX.

Create a SIP Trunk


Hostname (optional)

If a hostname is required, check the Host Name checkbox, and enter the required destination hostname.

If hostname is required both for the "destination" domain and the "from" domain, enter “destination.domain;from.domain”, no spaces. (Requires AMC software 11.1.3.5 or newer).

Host name entered in AlphaPro


The link between the hostname and the IP address is defined in AlphaWeb, System Configuration - > Hostnames:

Host name defined in AlphaWeb


Define the AlphaCom to SIP routing

In Exchange & System > Net Routing use the Insert button to create a route between the AlphaCom and SIP device.

  • Set ACDP Link = SIP Link
  • Node number = The node number used for the SIP Trunk
  • Set Preferred codec to G711u and RTP Packet Size to 20 ms.
SIPTrunkRoute.PNG


Create access numbers

There are different methods for calling out on a SIP trunk:

  • Prefix number: Dial Prefix + Phone number. One can choose to send digit by digit (overlap dialing), or collect all digits in the AlphaCom and send the complete phone number with the INVITE message (enbloc dialing)
  • Integrated Prefix number: Dial Prefix + Phone number. The prefix will be included as a part of the called telephone number.
  • Global number: Dial the phone number without using prefix
  • SIP User: Dial the phone number without using prefix

It is possible to combine different methods in the same system.


Example: Calling from an AlphaCom station to a SIP user 571234:

AlphaCom station calling SIP user 571234


The different options calling out on a SIP trunk:

Dialing method Dial Directory No Feature Parameter 2 Comment
Prefix (overlap dialing): 0 + 571234 0 83 0 Digits are sent one by one from AlphaCom (SIP INFO / RFC4733)
Prefix (enbloc dialing): 0 + 571234 0 81 6 Collect up to six digits in AlphaCom, then send the complete number (*)
Integrated prefix (enbloc dialing): 57 + 1234 57 83 4 Collect up to four digits, then send prefix+number as one number (*)
Global number (enbloc dialing): 571234 571234 83 0 Send the complete number
SIP User (enbloc dialing): 571234 571234 9 NA Send the complete number


(*): In AlphaCom software 11.2.3.10 and later up to 32 digits can be collected. In software version 11.2.3.9 and earlier, the maximum number of digits was 16.


Prefix number (overlap dialing)

When overlap dialing is used (also called "two-stage dialing"), the SIP Device seizes one of the PSTN/PBX lines without performing any dialing, connects the AlphaCom station to the PSTN/PBX, and all further signaling (dialing and Call Progress Tones) is performed directly with the PBX without the SIP device's intervention. The digits are sent to the SIP device either as SIP INFO messages or as RFC4733, depending on the SDP negotiation.

The directory number must be programmed in the AlphaCom directory table with feature 83 and Node = SIP Trunk node number.

Prefix number is 0, calling SIP trunk node 100, using overlap dialing


Prefix number (enbloc dialing)

When enbloc dialing (also called "one-stage dialing") is used, the digit collection is done in the AlphaCom. The destination phone number is included in the INVITE message from the AlphaCom.

The directory number must be programmed in the AlphaCom directory table with Feature 81 and Node = SIP Trunk node number. In the "Parameter 2" field you must enter the maximum number of digits in a phone number.

When the prefix is dialed, the AlphaCom will wait for more digits. When the number of digits specified in the “Parameter 2" is collected, an INVITE message is sent to the SIP device. If fewer digits are entered, the AlphaCom will send the INVITE after a 3 seconds time out. You can also terminate the digit collection by pressing the M-key. The INVITE message will then be sent immediately.

Dialing examples ("0" is the prefix):

0 + 571234: Telephone number 571234 will be called
0 + 5712: After a 3 second timeout, telephone number 5712 will be called
0 + 5712 + M: Telephone number 5712 will be called
Prefix number is 0, SIP trunk node is 100, collect 6 digits, enbloc dialing


Integrated Prefix number

The directory number must be programmed in the AlphaCom directory table with Feature 83 and Node = SIP Trunk node number. In the field “Parameter 2" you must enter the maximum number of digits in a phone number.

When the prefix is dialed, the AlphaCom will wait for further digits. When the number of digits specified in the "Parameter 2" field is collected, a call setup message is sent to the SIP device. If fewer digits are entered, the AlphaCom will time out after 3 seconds, and the call setup message will be sent. You can also terminate the digit collection by pressing the M-key. The call setup message will then be sent immediately.

Dialing examples ("57" is the prefix):

57 + 123456: Telephone number 57123456 will be called
57 + 1234: After a 3 second timeout, telephone number 571234 will be called
57 + 1234 + M: Telephone number 571234 will be called
Integrated Prefix number is 57, SIP trunk node is 100, collect 6 digits, enbloc dialing


Global number

The directory number must be programmed in the AlphaCom directory table with Feature 83 and Node = SIP Trunk node number. The "Parameter 2" field must be "0".

When the global number is dialed, the AlphaCom will send an INVITE message to the SIP device containing the dialed number.

Directory number 571234 is defined as a global number, calling out on SIP trunk node 100



SIP User

The directory number is programmed in the AlphaCom Users & Stations table. Select a free physical number, and enter Directory Number, Display Text, and enable the flag SIP Station. In the field Related to Trunk, enter the node number of the SIP Trunk on which the call shall be sent.

When the SIP User number is dialed, the AlphaCom will send an INVITE message out on the SIP Trunk containing the dialed number.

Directory number 571234 is defined as a SIP User, calling out on SIP trunk node 100


Notes on using SIP User (feature 9) versus Global Number (feature 83):

  • Features: When a SIP User is related to a physical number in AlphaCom, it will get access to more station related features, such as Call Setup Priority, Call Forwarding, Call Restrictions, Event Handler
  • Registration: A SIP User related to a SIP trunk does not need to register towards AlphaCom. It will appear as registered in the "Stations" list in AlphaWeb
  • OPC: A SIP User is supported by the OPC Server. The SIP user will appear in the OPC Item tree, showing status information and allowing call operations. A Global Number (feature 83) will not appear in the OPC tree
  • Licencing: A SIP User related to a physical number requires a SIP Station license.

Optional settings

Enbloc dialing - Inter digit timeout

When using enbloc dialing, the AlphaCom will wait for 3 seconds (default) for more digits before the INVITE is sent on the SIP trunk. This timeout time is programmable from AlphaPro. Select Exchange & System > System > VoIP:

Inter digit timeout on enbloc dialing


Enbloc dialing is used by feature 81 and feature 83 when the field "Parameter 2" is set different from 0.

Overlap dialing - Dial delay

After having made a connection to a SIP gateway, further dialing can be delayed.

A delay might be needed especially if a phone call is made from a DAK key, a substation call button or via Call Forwarding, where the prefix + phone number is programmed on the DAK string, say: 0 P 571234. Some SIP gateways needs a delay after having been accessed in order to detect dial tone from the line and get ready.

In AlphaPro select Exchange & System > System > VoIP:

Enter the delay from accessing the SIP gateway to digits are to be transmitted



Timing issues when dialing from DAK keys or substation keys can also be resolved using the Play_DAK_Feature. The Play_DAK_Feature lets you define sequences of dialing, including pauses.

Short numbers

A Short Number is a directory number, normally 2- or 3-digit long, which when called will dial a complete phone number. Short Numbers must be programmed on User Numbers 553-600 in AlphaPro.

Note: Short Number swill work only when the SIP Gateway is configured to use 'one-stage' dialing.


Example:
The configuration example below shows how to create a Short Number 345, which will dial phone number 7654321.

  • In AlphaPro, open the Users & Stations window, and scroll down in the list box and select a User 553 or higher
  • Enter the short number ("Directory Number") and Display text
ShortNoPhone.PNG


  • Press the button Phone
    • Enter the telephone number
    • Set "Short number mode" = SIP
    • Set "Node" = the SIP trunk node
PhoneShortNo.PNG


Optional configuration

Incoming Calls - Force Private Ringing mode

Incoming calls from the SIP Trunk can be forced to be in private ringing mode, independent of the private/open switch of the intercom station.

Check the flag Incoming calls from SIP in private ringing mode in AlphaPro (Exchange & System > System > VoIP).

Calls from SIP trunk will be in Private Ringing mode


Incoming Calls - Selective dialing

An incoming call from a SIP trunk can be routed to a "Short Number". A dial tone will be heard, and the caller can dial any intercom number, or he can wait a preset time and get connected to a preprogrammed intercom number.

Configuration:

  • In AlphaPro, open the Users & Stations window, and scroll down in the list box and select a User 553 or higher
  • Enter the short number ("Directory Number") and Display text
  • Press the Phone button
  • Set Short Number Mode = Selective Dialing
  • Timeout: The call will be routed to a preset number if no dialing before this time
  • Telephone number: The intercom number to which the call will be routed to after timeout
Selective dialing: When a call from a SIP trunk is routed to number 657, a new dial tone is heard. If no digits are pressed within 4 sec., the call is routed to intercom number 109


Incoming Calls - Auto Attendant

The auto-attendant feature provides voice guided menus

The Auto-attendant feature provides voice guided menus for handling incoming calls:

  • Play a welcome message on incoming telephone calls
  • Press a digit to re-route the call
  • If no digits are pressed, the call will be automatically re-routed 5 seconds after the message has finnished playing

The default directory number for the auto-attendant feature is 9550. Incoming calls from the SIP trunk must be routed to this number.

To record a voice message:

  • From a SuperUser station dial 8180 + 9550. Press and hold the M-key while recording.
  • Example: ”Welcome to Procom Ltd, press 1 for switchboard, press 2 for Sales department, press 3 for Marketing department, or wait for an answer
  • Release M-key to listen to the message. Press M-key again to do a new recording, or
  • Press 8 to save

Alternatively a wav-file can be uploaded from the web interface AlphaWeb as described in the Audio Messaging article.

The Auto-attendant number 9550 is using the DAK table of physical station 500 for the "digit" actions. In the Users & Stations window in AlphaPro, select physical number 500 in the list box, and press the button DAK. In the DAK table enter the call destination for digit 1-9 (DAK 1-9), and digit 0 (DAK 10).

Auto-attendant digit routing: Digit 1 calls station 101, digit 2 calls station 123, digit 3 calls station 5432, and digit 0 repeats the voice menu


If the caller doesn't press any digits within 5 seconds, the call is automatically routed to the intercom number entered in the first entry in the Search Strings tab.

Incoming Calls - Ringing signal on Ringing Group

When an incoming call from a SIP trunk is routed to a Ringing Group, one can choose to have a different ringing signal in the receiving station(s) than the standard Private Ringing signal. This can be useful in order to differentiate external calls from internal calls.

In AlphaPro, Exchange & System > System > VoIP, check the flag Use UK style Ringing Tone on Ringing group calls from SIP, and select which tone to use for the ringing signal. If this flag is unchecked, one will get standard Private Ringing signal.

Enable and choose wanted frequency for UK ringing style


Incoming Calls - Group Calls

When activating a group call from SIP trunk, one can use the '*' key on the phone to open the speech path (simulates M-key on), and use the '#' key to close the speech path (simulates M-key off).

As an alternative, it is possible to open the speech path immediately when the group call number is dialed, without having to press any additional keys on the phone. There is a setting in AlphaPro per group call for this option.

In AlphaPro, Groups > Local Groups, select the group from the list box and enable "Automatic M-key only from SIP calls":

Enable use of group call from SIP trunk without having to press M-key or */#


Door Opening Feature

During a conversation between a door station and a telephone, the telephone operator can activate the Door Opening feature in the AlphaCom by pressing digit 6.

A SIP Trunk is automatically using Class of Service 15. This Class of Service group does not have the option for remote door opening enabled by default. In AlphaPro select the Class of Service button, select number 15 (Outside Telephones), press change and locate feature number 58 in the "Not Valid" list. Highlight Feature 58 and use the single arrow key to move it to the "valid" list.

Enable feature 58 (Door Opening) in Class of Service 15



The Door Opening feature is programmed in the Event Handler. When SIP trunk is involved, there are two separate events for the door opening feature, depending on who is the calling side.

Incoming call from the SIP Trunk to the AlphaCom door station:

The Standard door opening event is used:

Door Opening event when call is initated from the SIP Trunk


Outgoing call from the AlphaCom door station to an external telephone via the SIP Trunk:

When the phone presses digit 6, the event type Event Trigger Feature (15) is reported, with the digit 6 as sub event. The calling AlphaCom station is Event Owner, and called SIP phone number and node number is Related To. The RCO pulse time is specified as an additional parameter in the RCO action string, i.e. RCO 3 ON 20 means pulse RCO 3 for 2 seconds.

Door Opening event when call is initated from the door intercom station


Voice Switching in Noisy Environment

If the intercom station is located in a noisy environment, it might be difficult to switch the voice direction from the telephone towards the intercom station. However, there is a setting in the AlphaCom to overcome this problem. In AlphaPro, Exchange & System > System > VoIP, set the parameter Optimized voice duplex control when conversation with SIP trunk/stations

When this flag is set, the initial voice direction is forced to be from the intercom towards the telephone. When the phone operator starts to speak, the voice direction will switch towards the intercom station, regardless of the level of the audio signal from the intercom station. As soon as the phone operator stops speaking, the voice direction will switch back to the initial direction.

Voice Switching in Noisy Environment.jpg



Transmit DTMF signal from AlphaCom

Outgoing calls to SIP trunk

The DTMF signals ‘*’ and ‘#’ will be transmitted to the line when DAK 1 (*) and DAK 2 (#) is pressed during an outgoing telephone conversation. No programming is required.

Incoming calls from SIP trunk

By default digits dialed on an intercom station will be handled locally in the AlphaCom, and not transmitted out on the SIP trunk.

To be able to send DTMF signals to the SIP trunk, one have to set the station in a certain mode by the data command $TRUNK_SIG. The mode can be set either:

  • Manually by pressing as DAK key during the call, or
  • Automatically when a call is received from the SIP trunk

Manually by pressing a DAK key:

Enable DTMF transmission by first pressing DAK key 3


Automatically when receiving a call from the SIP trunk:

Enable DTMF transmission when receiving calls from SIP Trunk node 100


In this example the SIP Trunk node is 100, you need to change this according to the node number used.

Note that the data command $TRUNK_SIG requires AMC software 11.5.x.x or newer.

Call Transfer

Incoming calls from SIP Trunk

An incoming call to station A can be transferred to station B:

  • Dial 2 (puts call on-hold)
  • Dial B's number
  • Dial 3 (transfers the call)

Outgoing calls to SIP Trunk

An outgoing phone call from station A can be transferred to station B:

  • Press DAK 4, or DAK 9 on an analog ASLT station (turns off transparent mode)
  • Dial 2 (puts call on-hold)
  • Dial B's number
  • Dial 3 (transfers the call)

For more details, see: Transparent Mode DAK-Key Configuration


Failover to redundant SIP server

At failover, calls are automatically routed to secondary SIP server

Failover is switching to a redundant or standby SIP server upon the failure of the primary SIP server. The failover is automatic and operates without warning. The switchover time is less than 5 seconds from a failure of the primary SIP server.

The AlphaCom uses a "heartbeat" message (SIP OPTIONS) to check if the SIP servers are online. As long as the primary SIP server is online, calls will be routed to this server. If the primary SIP server goes off-line, calls will be routed to the secondary server. As soon as the primary server comes back online, calls will be routed to this server again.

Software requirement:

  • AMC 11.5.3.1 or later
  • AlphaPro 11.6.3.9 or later

Enable "Heartbeat"

The monitoring of the communication between the AlphaCom and the SIP server must be enabled per SIP trunk. When enabled, the AlphaCom sends a SIP message OPTIONS to the SIP server every 5 seconds, and expects a response in due time, else the link is reported down.

The monitoring is enabled from AlphaPro. Open Exchange & System > NetRouting, select the route to the SIP node, and press Change. Enable the flag "Monitor SIP Trunk":

Enabling monitoring of SIP trunk node 100


Configure the Failover routing

Two SIP Trunk nodes must be created in AlphaPro in the "standard" way.

The Failover Routing is defined in the NetRouting Window in AlphaPro. The configuration is best illustrated by an example:

Let's say that you have already created two SIP Trunk nodes:

  • SIP Trunk node 100 goes to SIP Server 1
  • SIP Trunk node 101 goes to SIP Server 2

In the NetRouting you create the routing from AlphaCom to SIP server 1, and define the SIP server 2 in the "Alternative Route" field:

Defining Primary (node 100) and Secondary (node 101) SIP server in AlphaPro


Now calls that normally goes to SIP Server 1, will automatically be routed to SIP Server 2 if SIP Server 1 is off-line.

Optionally it is also possible to define the SIP Server 2 as the primary server and Server 1 as the secondary server:

Defining SIP trunk node 101 as Primary SIP trunk, and SIP trunk node 100 as Secondary SIP trunk


In this case calls that normally goes to SIP Server 2, will be routed to SIP Server 1 if SIP Server 2 is off-line.

Failover routing if all voice channels are busy

A call can be routed to the secondary SIP trunk if all available voice channels to the primary SIP trunk is in use.

This can be useful e.g. if one want to expand the traffic capacity by adding one more SIP gateway (e.g. AudioCodes MP114). When all channels on the first gateway is in use, the call can automatically be routed to the second gateway.

One have to define the maximum VoIP channels that is available for the primary SIP Trunk: Select Exchange & System -> NetRouting in AlphaPro. Press the Change button, and select the Advanced Settings tab. In the field Max Trunks, enter the number of voice channels this trunk have access to.

Defining 2 VoIP channels for SIP trunk 100


In the example above there will be maximum two voice calls via SIP Trunk node 100. A third call will be routed to trunk node 101.


Notification of failover

The event 29 - AlphaNet Link is triggered when the communication with a SIP server goes up or down. The "Sub Event" is the SIP Trunk node number.

Example: The following event will report to the System Log and operate RCO 5 when the SIP Server on SIP Trunk node 100 goes up or down:

Event 29, Sub Event = node number, can be used to notify failover


About VoIP Audio Channels

Call capacity

The overall maximum call capacity on SIP trunk calls are as follows:

  • Maximum outgoing conversations: 16
  • Maximum incoming conversations: 32

The actual number of simultaneous calls are limited by the SIP license installed.

SIP trunk calls are using resources from a common pool of VoIP channels, which is also used by other VoIP services, such as AlphaNet calls and MultiModule calls. In addition to the limit set by the SIP license, the maximum number of simultaneous SIP trunk calls will also depend on other VoIP traffic currently active in the system.

When the call is to/from analog ASLT stations, the number of simultaneous calls in handsfree mode (loudspeaking) is limited by the number of speech channels available. There is one speech channel per ASLT board.

When the call is to/from analog ASLT or ATLB stations, the number of simultaneous handset (lowspeaking) calls is 10, limited by the number LEC resources.

Reserving VoIP channels for a SIP trunk

The SIP Trunk lines are a common pool of resources for all connected SIP Trunk nodes. The VoIP channels used by SIP Trunk(s) are assigned dynamically. However, it is possible to reserve one or several of the VoIP channels for a specific SIP trunk. In this way one can make sure that there will always be VoIP channels available to this trunk.

The VoIP channels have virtual physical numbers in the AlphaCom, starting from 605 to 634. To reserve a VoIP channel for a SIP Trunk, select Exchange & System -> NetAudio in AlphaPro. Press Insert, and select the SIP trunk from the list of nodes. Now enter the physical number of the VoIP channel, i.e. a number between 605 to 634. It is good practice to start with 605 and go upwards.

Two VoIP channels are reserved for SIP Trunk node 100


The SIP trunk with reserved VoIP channels will still have access to the other free VoIP channels available according to the SIP Trunk license.

Limiting the number of VoIP channels used by a SIP Trunk

The SIP Trunk license sets the overall limit on how many simultaneous calls that can be made on SIP trunks. In addition to this, it is possible to set further limits on how many VoIP channels a specific SIP Trunk should be able to use. This could be useful if there are multiple SIP trunks, and one might want to set restrictions on how many VoIP channels one particular trunk can use.

To set the maximum VoIP channels that should be available for a SIP Trunk, select Exchange & System -> NetRouting in AlphaPro. Press the Change button, and select the Advanced Settings tab. In the field Max Trunks, enter the number of VoIP channels this trunk should have access to.

Maximum three simultaneous calls can be made via SIP Trunk node 100


Priority mechanism for dedicated stations

When "Max Trunks" are specified, and a call is made and there are no more free VoIP channels, you will get a busy tone. It is possible to Camp On, and wait for the SIP trunk to become free.

Stations with Call Setup Priority = Alarm will get a forced connection to the SIP trunk.

Related articles

  • %tin : The %tin macro can be used in the Event Handler. It returns the current number of trunk channels used towards a specific trunk
  • Play_DAK_Feature: Define sequences of dialing, including pauses

Troubleshooting