NOTE: If you are using Elastix, please refer to the special support note on installing the SIP.US FreePBX module on Elastix systems.
NOTE2: We can't guarantee that our module will work on very old versions of FreePBX. While we have done our best to test this, your mileage may vary. If it doesn't work, we recommend you upgrade FreePBX to at least version 2.9.
STEP ONE - You must make sure JSON is installed as part of your PHP installation.
Do this by opening an SSH session into the server and logging in as root. Enter the following commands:
[root@demopbx ~]# yum install php-pecl-json
Setting up Install Process
--> Running transaction check
---> Package php-pecl-json.i386 0:1.2.1-4.el5 set to be updated
--> Finished Dependency Resolution
Package Arch Version Repository Size
php-pecl-json i386 1.2.1-4.el5 epel 15 k
Install 1 Package(s)
Upgrade 0 Package(s)
Total download size: 15 k
Is this ok [y/N]: y
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 <email@example.com>" from /etc/pki/rpm-gpg/RPM-GPG-KEY-EPEL
Is this ok [y/N]: y
Running Transaction Test
Finished Transaction Test
Transaction Test Succeeded
Installing : php-pecl-json 1/1
[root@demopbx ~]# service httpd restart
Stopping httpd: [ OK ]
Starting httpd: [ OK ]
(YOU MUST RESTART HTTPD IN ORDER FOR THIS MODULE TO WORK PROPERLY!)
Go back to the FreePBX GUI --
Click on the 'Module Admin' link on the setup tab, then click on Upload module:
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:
SHA256 Checksum: b0352a6827c581ccd91039f4c71eb90572d753f6eaef4657e728c72fdb10186c
Next, click on the 'local module administration' link (yes, it is a link, just a bit hard to see... it is clickable..)
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.
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:
Click on SIP.US and you will see the module home page:
Click on 'Add SIP.US Account' on the right side and PASTE your secret key from the SIP.US website:
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.
You should now see your SIP.US trunk (or trunks if you have more than one) listed on the screen.
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!
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.
If you have any questions on how to use the module, please open a Support Ticket for further assistance.