Follow

Installing the SIP.US FreePBX Module on ELASTIX

Elastix is a popular Asterisk-based distribution which by default contains a streamlined version of FreePBX.  Our SIP.US FreePBX Module has been tested to work with Elastix systems.  Follow the steps below to get the module installed on Elastix:

STEP ONE - You must make sure JSON is installed as part of your PHP installation.  THE MODULE WILL NOT WORK WITHOUT THIS.

Do this by opening an SSH session into the Elastix server and logging in as root.  Enter the following commands:

[root@demopbx ~]# yum install php-pecl-json

Setting up Install Process
Resolving Dependencies
--> Running transaction check
---> Package php-pecl-json.i386 0:1.2.1-4.el5 set to be updated
--> Finished Dependency Resolution

Dependencies Resolved

============================================================================================================================
Package Arch Version Repository Size
============================================================================================================================
Installing:
php-pecl-json i386 1.2.1-4.el5 epel 15 k

Transaction Summary
============================================================================================================================
Install 1 Package(s)
Upgrade 0 Package(s)

Total download size: 15 k
Is this ok [y/N]: y
Downloading Packages:
php-pecl-json-1.2.1-4.el5.i386.rpm | 15 kB 00:00
warning: rpmts_HdrFromFdno: Header V3 DSA signature: NOKEY, key ID 217521f6
epel/gpgkey | 1.7 kB 00:00
Importing GPG key 0x217521F6 "Fedora EPEL <epel@fedoraproject.org>" from /etc/pki/rpm-gpg/RPM-GPG-KEY-EPEL
Is this ok [y/N]: y
Running rpm_check_debug
Running Transaction Test
Finished Transaction Test
Transaction Test Succeeded
Running Transaction
Installing : php-pecl-json 1/1

Installed:
php-pecl-json.i386 0:1.2.1-4.el5

Complete!
[root@demopbx ~]# service httpd restart
Stopping httpd: [ OK ]
Starting httpd: [ OK ]

(YOU MUST RESTART HTTPD IN ORDER FOR THIS MODULE TO WORK PROPERLY!)

Go to the Elastix GUI in your Web Browser and login.  Then click on the PBX tab at the top.

You will see the 'Unembedded freePBX' link in the lower left.  Click on that.

 

Screen_Shot_2013-08-01_at_10.33.18_PM.jpg

If you see the following Security Warning, follow the instructions below --

Screen_Shot_2013-08-01_at_10.33.31_PM.jpg

Follow the instructions and click on the dropdown arrow next to the Reports tab, then click on Security

Screen_Shot_2013-08-01_at_10.33.55_PM.jpg

Click on Advanced Settings on the left, then TURN ON Enable direct access to FreePBX and be sure to set the FreePBX Web admin password:

Screen_Shot_2013-08-01_at_10.41.24_PM.jpg

You can now go back to the PBX tab and click on the 'Unembedded freePBX' link.  The standard FreePBX will open up with all options.

Click on the 'Module Admin' link on the setup tab, then click on Upload module:

Screen_Shot_2013-08-01_at_9.38.27_PM.jpg

Next, select the SIP.US FreePBX module .tgz file that you downloaded from the SIP.US website.  If you need to download again, click here: 

https://login.sip.us/sipus-2.1.3.tgz

SHA256 Checksum: b0352a6827c581ccd91039f4c71eb90572d753f6eaef4657e728c72fdb10186c

Screen_Shot_2013-08-01_at_9.38.54_PM.jpg

Next, click on the 'local module administration' link (yes, it is a link, just a bit hard to see... it is clickable..)

Screen_Shot_2013-08-01_at_9.39.13_PM.jpg

Scroll down to the Connectivity section of the page, click on the SIP.US link then select 'Install'.  Scroll back to the top and hit PROCESS.

Screen_Shot_2013-08-01_at_9.39.32_PM.jpg

Screen_Shot_2013-08-01_at_9.39.49_PM.jpg

Hit the Confirm button and then Apply Configuration Changes.

You will now see the SIP.US module underneath 'Connectivity Options' on the Left Navigation Bar:

Screen_Shot_2013-08-05_at_12.42.08_PM.jpg

Click on SIP.US and you will see the module home page:

Screen_Shot_2013-08-05_at_12.43.32_PM_2.jpgClick on 'Add SIP.US Account' on the right side and PASTE your secret key from the SIP.US website:

Screen_Shot_2013-08-05_at_5.42.20_PM.jpg 

Once the key is added, it will securely communicate with the SIP.US servers and pull all of your Trunk and DID information into FreePBX.  

Make sure to follow the on-screen instructions in the module, and then hit the SAVE button, followed by APPLY CONFIGURATION changes.

You should now see your trunks registered and outbound route properly configured in FreePBX!

NOTE: MAKE SURE TO MOVE THE SIPUS OUTBOUND ROUTE TO THE TOP OF THE OUTBOUND ROUTES LIST IN OUTBOUND ROUTES SECTION!

To manage your DIDs and associated Inbound Routes, simply click on the Trunk underneath 'Trunks and Telephone Numbers' in the upper right corner of the module.  From there, you can set the inbound routes, save, apply and they will be pushed into the Inbound Routes section of FreePBX.  In addition, if you make any modifications within the Inbound Routes section of FreePBX, they will also sync back to the SIP.US module.

*** REMEMBER - to get into the SIP.US Module in FreePBX, you will need to always click on Unembedded FreePBX on Elastix.  Quick TIP: Bookmark the URL directly to the unembedded FreePBX for easier access:

https://www.yourpbxip.com/admin/config.php

 

If you have any questions on how to use the module, please open a Support Ticket for further assistance.

Was this article helpful?
3 out of 3 found this helpful
Have more questions? Submit a request

Comments

Powered by Zendesk