Elastix - VoIP.ms Wiki

Elastix

From VoIP.ms Wiki

Jump to: navigation, search

Elastix is an open source unified communications server software that brings together: IP PBX, Email, IM and Faxing. The Elastix functionality is based on open source projects including Asterisk, HylaFAX, Openfire and Postfix. Those packages offer the PBX, fax, instant messaging and email functions, respectively. Elastix runs on CentOS operating system, and in this article we will review the basic settings of the Elastix PBX for SIP and IAX2.

Contents

Important Security Information

We are aware of an important and critical exploit related to all Elastix versions using a2billing. This exploit is mentioned in the Elastix bug tracker and it is important for all users to take the necessary steps to prevent this. Please visit this link for more information about this subject: http://bugs.elastix.org/view.php?id=2169&nbn=1

SIP Trunk

In order to connect your PBX system to our service you will have to create a Trunk. To do so, once you access to your PBX through the IP address, select the PBX tab from the main menu bar at the top and then select the PBX configuration option from the second menu bar. After that, select the Trunks option on the left and there you will be able to create a SIP trunk.

From there, you will be able to configure the following options:

Trunk Name: Descriptive name of the trunk, in the case of the SIP trunks you can use the name that you prefer (voipms for example).

Outbound Caller ID: The 10 digit valid caller ID number that you will pass with this trunk for Outbound calls.

Trunk Name: The Name of the trunk that you will configure, in the case of the SIP trunks you can use the name that you prefer (voipms for example).

User Context and User Details: Leave these fields blank.

Peer Details: In this field use the following information:

canreinvite=nonat
nat=yes
context=from-trunk
host=atlanta.voip.ms (use one of the multiple VoIP.ms servers)
secret=***** (password associated with the Main or Sub-account)
type=peer
username=100000 (Replace with your 6 digit Main SIP Account User ID or Sub Account username, i.e. 123456 or 123456_sub)
disallow=all
allow=ulaw 
; allow=g729 (uncomment if you purchased g.729 from Digium)
fromuser=100000 (Replace with your 6 digit Main SIP Account User ID or Sub Account username, i.e. 123456 or 123456_sub)
trustrpid=yes
sendrpid=yes
insecure=invite
qualify=yes

Register String: On this field, set the following information:

youraccountnumber:yourpassword@theserveryouselectedvoip.ms:5060  (i.e. 100000:mypassword@atlanta.voip.ms:5060)

ElastixSIPT02.jpg

Once you have configured the Trunk, click the Submit Changes button at the end of the page in order to save the settings, and then click the Apply Configuration Changes Here option in red at the top of the page in order to apply the configurations to the PBX system.

IAX2 Trunk

If you want to create an IAX2 Trunk, you will have to select the PBX tab from the main menu bar at the top of your PBX options, and then select the PBX configuration option from the second menu bar. Then select the Trunks option on the left and there you will be able to create a IAX2 trunk.

You will then be able to configure the following options:

Trunk Name: Descriptive name of the trunk, in the case of the IAX2 trunks the name of the trunk must be set as voipms in lowercase.

Outbound Caller ID: The 10 digits valid caller ID number that you will pass with this trunk with Outbound calls.

Trunk Name: The Name of the trunk that you will configure, in the case of the IAX2 trunks the name of the trunk must be set as voipms in lowercase.

User Context and User Details: Leave these fields blank.

Peer Details: In this field use the following information:

type=friend
username=100000 (Replace with your 6 digit Main SIP Account User ID or Sub Account username, i.e. 123456 or 123456_sub)
secret=***** (password associated with the Main or Sub-account)
context=from-trunk
host=atlanta.voip.ms (use one of the multiple VoIP.ms servers)
disallow=all
allow=ulaw
insecure=port,invite
requirecalltoken=no
qualify=yes

Register String: On this field, set the following information:

youraccountnumber:yourpassword@theserveryouselectedvoip.ms:4569  (i.e. 100000:mypassword@atlanta.voip.ms:4569)

ElastixIAX01.jpg

Once you have configured the Trunk, click the Submit Changes button at the end of the page in order to save the settings, and then click the Apply Configuration Changes Here option in red at the top of the page in order to apply the configurations to the PBX system.

Outbound Routes

Once you have created the Trunk and registered your PBX system to our service, you will have to create the Outbound Routes in order to be able to place calls. To do so, select the Outbound Routes option on the menu on the left and then click on Add Route

There, you will be able to configure the following options:

Route Name: The name that you will use to identify this outbound route ("local", "international" for example)

Route Caller ID: The 10 digits valid caller ID number that you will pass when you use this specific Outbound route.

This Caller ID will override all the caller ID, except:
*Extension Caller ID (Unless you check the Override Extension when you create the Outbound route).
*Extension Emergency Caller ID (If the Extension and the Outbound route has the Emergency option enabled).
*Trunk Caller ID (In case that you have selected the Force Trunk Caller ID option at Caller ID option in the Trunk settings).

Route Password: In case that you want to ask for a password before the calls connect to the destination.

Route Position: The priority of this route in relation to the other Outbound routes that you have configured.

Dial Patterns: These are a unique set of digits that will activate this Outbound Route and will send the Calls through the Designated Trunk.

In the case of the Dial Patterns the Elastix PBX has an option called Dial patterns wizards this will allow you to add the 
Match Patterns that you will use with this Outbound Route, for this, you just have to select from the drop down menu, the destinations 
that you would like to call with this Outbound route  (Local numbers with 10 or 7 digits, Toll-free numbers, International numbers,
Emergency numbers, Information numbers, etc) and it will automatically add the Match Pattern for those calls.
Additionally we recommend to add a Match Pattern for 4XXX, in order to be able to call to our Echo Test (4443)

Trunk Sequence for Matched Routes: This is the Trunk that your Outbound Route will use to place the calls.

Elastix Outbound Route.jpg

Once you have configured the Outbound Route, click the Submit Changes button at the end of the page in order to save the settings, and then click the Apply Configuration Changes Here option in red at the top of the page in order to apply the configurations to the PBX system.

Inbound Routes

The Inbound Routes is the way that your PBX system will handle the Incoming calls. In order to create these Routes you will have to select the Inbound Routes option from the menu of the left of your PBX configuration options and then click on Add Incoming Route.

There, you will be able to configure the following options:

Description: Name of the Inbound Route.

DID Number: DID number that will receive the call. Set your voip.ms DID number with only 10 digits (Without dots, commas, spaces or the 1 in front of the number).

Set Destination: The destination where this route will send the Incoming calls in your PBX system (An Extension, a Recording, an IVR, a Call Queue, etc).

Elastix Inbound Route02.jpg

Once you have configured the Inbound Route, click the Submit Changes button at the end of the page in order to save the settings, and then click the Apply Configuration Changes Here option in red at the top of the page in order to apply the configurations to the PBX system.

Extensions

The Extensions that you will be able to create in your Elastix PBX system options are used to register your devices to your PBX, we recommend to create an extension per device. In order to create an extension you will have to select the Extensions option on the menu of the left of your PBX configuration options and then select the Device Type that you want to register to your PBX and then click on Submit

These are the basic options that you will have to configure in order to register your device to your PBX System:

User Extension: This is the extension number that you will dial to reach this user via internal extension, also, this is the information that you will use as user name to register your device.

Display Name: This is the Caller ID Name this extension will pass.

Outbound Caller ID: The 10 digits valid caller ID number that you will pass with this Extension for the Outbound calls.

This Caller ID will Override any information set at the caller ID options in the Trunk settings or at the Outbound Route options, 
unless you configure them to force their caller ID instead of using the one in the Extension.

Secret: The password this extension will use. You will have to put this password in the exact same way on your device in order to register it properly to your PBX system.

Elastix Extensions.jpg

Once you have configured the Extension, click the Submit Changes button at the end of the page in order to save the settings, and then click the Apply Configuration Changes Here option in red at the top of the page in order to apply the configurations to the PBX system.

Personal tools
Namespaces
Variants
Actions
VoIP.ms Wiki
Configuration
Guides (English)
Guides (Français)
Guías (Español)
Toolbox