How to Blacklist Phone Numbers on ScopTEL PBX

You need to block some phone numbers of callers and avoid unwanted calls or simple ban specific destinations such as premium-rate phone number on your ScopTEL  PBX ? The reason for blocking one or more telephone numbers are numerous and ScopTEL PBX offers simple solutions to block phone numbers with Blacklist. It is also possible to have a whitelist to allow only some phone numbers.

ScopTEL PBX lets you block (or whitelist) a phone number or multiple numbers from integrated CallerID Lookup management system.

This article will explain how to use an SQL table to store 1000’s of phone numbers and blacklist some destinations on Outgoing Lines.


Configure CallerID Lookup

The first step is to configure an External Source  from Lines -> CallerID Lookup. Simply set the Type to “External Source” and set the Table Name to “blacklist” then click on Save button.

Blacklist - Lines -> CallerID Lookup -> External Source (SQL)

Lines -> CallerID Lookup -> External Source (SQL)



Enable Call Restrictions (Blacklist)

On Lines -> Outgoing Lines, click on the Dial String tab and check the option “Restrict Disallowed Outgoing Numbers” then select the External Source (blacklist) you created.

Blacklist - Lines -> Outgoing Lines -> Call Restrictions

Lines -> Outgoing Lines -> Call Restrictions


Create SQL table

You must now create an SQL table that will store all phone numbers that you want to blacklist. Go on Tools -> Server and click on SQL Shell menu. You must copy the following content and click on Execute button  to create the SQL table .


[box title=”SQL Query” color=#ddd]

CREATE TABLE blacklist (
   phone_number varchar(100),
   calleridnum varchar(100),
   calleridname varchar(100)



Blacklist - Tools -> Server -> SQL Shell

Tools -> Server -> SQL Shell

Import Data

We now need to fill the blacklist SQL table in the ScopServ database. In this example, we will use a simple text file that contain a single phone number per line.  Create a file named /tmp/blacklist.txt and define all telephone number to block.

[box title=”Sample Data” color=”#DDDDDD”]




The following simple shell script allow read the text file, create SQL INSERT query and execute it on MySQL scopserv database. If you aren’t using default MySQL setting, you will have to manually adapt the script.

[box title=”Import Shell Command” color=”#DDDDDD”]

# Specify Source file
# Destination File
# Set SQL database name (default is scopserv) 

awk '{ print "INSERT INTO blacklist SET phone_number="" $1 "";" }' $SRC > $DST
cat $DST | grep -v '""' | mysql $SQL



Read More

Configuring SIP for IPv6 support in ScopTEL PBX and Asterisk

IPv6 and SIP with ScopTEL PBX

Even though IPv4 has been fully occupied, many people still not realized that they need to start implementing IPv6 for their services. In this post, I am going to show how to implement IPv6 connectivity to SIP service which run on Asterisk.

Please note that we assuming that you already have enable IPv6 support on Network Configuration available on the ScopTEL PBX Web Management. If not, please refer to this article that explain how to enable IPv6 support on ScopTEL PBX.

We now support IPv6 out of box since Telephony module version 2.6.2.


Enable IPv6 support for SIP channels

Enabling IPv6 support in ScopTEL PBX is incredibly simple. In the GUI, click on Telephony -> Configuration -> Channels -> SIP Channels and set the Bind Address (UDP/TCP/TLS) to :: (all addresses), click on Save then click on Commit to update Telephony configuration files.

Configuration -> Channels -> SIP Channel (IPv6)

Configuration -> Channels -> SIP Channel (IPv6)


The Telephony service (Asterisk) will now route SIP traffic over IPv6 for any Extensions and VoIP Accounts that have either a valid DNS record (AAAA) for their hostname, or if you specify an IPv6 address on the Extensions and VoIP Accounts.

Phones can register using IPv4 or IPv6; the PBX will translate traffic between IPv4 and IPv6  addresses and even send RTP streams between IPv4 and IPv6 addresses. This makes it much easier to upgrade the network even when some devices do not support IPv6 yet.


Known VoIP phones that support IPv6

Following is the list of some VoIP phones that are IPv6-ready. These are not the only SIP phones on the market that support IPv6; many Softphone (client) do and even more will also support it via a firmware update. These phones are those which, in addition to IPv6, also offer other great features and performance.

  • The IPv6 support is available for all models of the Snom 3xx and Snom 8xx series, including Snom 300, 320, 360, 370 and 820.
  • Yealink SIP-T2x series IP phones are also compatible with IPv6-standard


Read More

Setting up IPv6 using SixXS Tunnel Broker on ScopTEL PBX

Using IPv6 on ScopTEL PBX

Even if your ISP isn’t handing out IPv6 addresses, doesn’t mean you can’t take advantage of IPv6 support. By utilizing a free tunnel broker, you can run an IPv6 enabled server on your existing IPv4 Internet connection and provide IPv6 connectivity to the rest of your network.

IPv6 is becoming a reality and ScopServ International now provides IPv6 support for ScopTEL PBX. In the following article we will explain how to configure your ScopTEL IP PBX server to use the new and improved IPv6 version of the IP protocol using an 6-in-4 tunnel to encapsulate IPv6 traffic over explicitly-configured IPv4 links.

How do I configure IPv6 networking under ScopTEL PBX ? We now support IPv6 out of box since Network Management module version 2.2.0.  All you have to do is follow instructions on this page.


SixXS IPv6 Tunnel Broker

SixXS IPv6 Tunnel

SixXS IPv6 Tunnel

SixXS (Six Access) is a free, non-profit, non-cost  IPv6 Tunnel Broker service for Local Internet Registries (LIR’s) and end-users.

tunnel broker is a service which provides a network tunnel. These tunnels can provide encapsulated connectivity over existing infrastructure to another infrastructure.

For more information about SixXS, please check




Requesting a Tunnel

You need a SixXS account and at least a tunnel and these can be freely requested from the SixXS website. You can  Sign up with a RIPE/ARIN/etc handle or by using the direct sign-up.

Once your account is verified, you will receive a confirmation by Email and you will need to login at the SixXS Home to request a tunnel.


IPv6 Tools

AICCU (Automatic IPv6 Connectivity Client Utility) is a popular cross-platform utility for automatically configuring an IPv6 tunnel. This client automatically gives one IPv6 connectivity without having to manually configure interfaces etc. We offer all required packages in ScopServ repositories.

This tool is now automatically installed with latest version of ScopTEL PBX packages.

If your server isn’t up-to-date, you must log into your server using WebGUI and click on Server -> Packages Manager -> Update Now. Alternatively, using an SSH  root access and type:


[note color=#ddd]scopserv_yum update[/note]


Configure IPv6 Tunnel on ScopTEL PBX

You must log into the ScopTEL PBX GUI, go on Network -> Configuration then enable the IPv6 support. On the IPv6 Tunnel, select SixXS and specify your username and password then click on Save.

Network Configuration -> IPv6 support

Network Configuration -> IPv6 support

Now you can Commit all configurations changes and enable the AICCU service from the ScopTEL PBX GUI from Network -> General -> Service Status.

Enable AICCU service

Enable AICCU service

Apply the changes and Commit the new configuration then Restart network service.

Test your IPv6 connection

Verify your configuration by pinging IPv6 enabled site such as

[note color=#ddd]ping6[/note]

Traces path to a network host, enter:

[note color=#ddd]traceroute6[/note]

Print default IPv6 routing table, enter:

[note color=#ddd]route -n -A inet6[/note]


What next ?

In this article, we explain how to configure the ScopTEL PBX Telephony module to route SIP traffic over IPv6 for any Extensions and VoIP Accounts.


Read More

Installing and Configuring a Sangoma Card on ScopTEL PBX

ScopServ Integration

Full integration and support for Sangoma cards is included in ScopTEL PBX and includes a quick and easy way to configure all Sangoma cards directly from the ScopTEL PBX Web management interface.


Sangoma Digital/Analog Cards

Sangoma makes a series of PCI and PCI Express cards that can be installed in any server and allow the user to use a PRI line, a T1/E1/J1 line, regular telephone lines (connected to FXO Ports), or to connect standard analog phones (connected to FXS Ports). A PRI Line and T1/E1/J1 line are Digital lines that are usually supplied by either a local telephone company or a provider of business telephone and data services. The most common Sangoma cards used in ScopTEL PBX installations are the A100 (Digital), A200/A400 (Analog),  and A500 (ISDN) series.


Supported Cards

The following cards are supported by ScopTEL PBX :

Analog (FXO/FXS)

Digital (T1/E1/J1)


Hybrid (Analog + Digital + BRI)


ScopTEL PBX users do not need to install Wanpipe (Sangoma) drivers because the latest version of all Wanpipe kernel modules and Wanpipe tools are automatically installed with every installation. We always provide latest Wanpipe version on ScopServ RPM repository.

  • Install one or more Sangoma cards on the server
  • Enable Digital and/or Analog interfaces on Telephony -> Configuration -> Telephony Modules (see image below)

Configuration -> Telephony Modules

Configuration -> Telephony Modules



Detect installed card(s)

If you have install Sangoma card(s)  in your server, you can open the ScopTEL PBX GUI in your favorite web browser and click on Telephony -> Interfaces menu to configure cards.

Click on the Detect Cards link to open the Wizard window.

Telephony -> Interface -> Detect Card

Telephony -> Interface -> Detect Card


You must follow the instructions displayed in the card detection Wizard. The process is very simple!

Detect Card -> Introduction

Detect Card -> Introduction


You will be asked to specify the default values used by the  Detect Card Wizard to configure the Digital interface type  (T1/E1) and  Supervision Disconnection mode used by Analog interfaces. Please note that you can change the settings later without having to re-execute the Wizard.

Detect Card -> Options

Detect Card -> Options


After detection is complete, you will be able to see the new cards that have been added to your system. You can then customize the settings for each port (PRI / BRI / FXO / FXS) according to your needs from the Telephony -> Interface menu  for Digital and Analog Interfaces.

Interface -> Analog Interfaces

Interface -> Analog Interfaces


You can now configure your Incoming and Outgoing Lines or Extensions.


Read More

Setting up an LDAP Directory Server on ScopTEL PBX

What is LDAP ?

LDAP (Lightweight Directory Access Protocol) as its name states it, is a protocol to get access to Directory Service. A well known LDAP is Active Directory that is specific to Windows Server. But for Linux, it is called OpenLDAP.

In order to use LDAP with ScopTEL PBX software, you must configure an LDAP directory server. This server stores the LDAP entries and makes them accessible to supported phones and other applications that need the information.


[note color=#ddd]This new functionality is offered in the latest version of Server Management 2.2.0.[/note]


ScopTEL integrated LDAP Manager

The LDAP manager integrated in ScopTEL PBX  was designed to make LDAP Server management as easy as possible for the user. It abstracts from the technical details of LDAP and allows persons without technical background to manage a local LDAP server.

  • Management of basic options like DN, Authentication and caching.
  • Manage Schema and dependencies
  • Authentication (User/Password)
  • Access Control (ACL)


Configure LDAP Directory Server

Configuring the OpenLDAP server on ScopTEL PBX is very simple:

  • – Log into ScopTEL GUI and go on Server -> LDAP Server
  • – Click on Edit and set basic options like Top-Level DN and Authentication.
  • – Click on Save. The OpenLDAP service configurations will automatically be reloaded.

LDAP Server Configuration

LDAP Server Configuration

Adding Initial Entries via ldapadd and LDIF file

Next we will add some initial entries to the LDAP server. I suggest creating an LDIF file and loading the contents into the database using the ldapadd utility. You must create an LDIF file (ex. server.ldif) . This the content of my initial LDIF file. Remember to replace all information in bold with your own.


[note color=#ddd]dn: dc=scopserv,dc=local
objectClass: dcObject
objectClass: organization
dc: scopserv
o: Top Level[/note]

Once this has been written to a file
server.ldif you may import it using the the ldapadd utility. First make sure your OpenLDAP server has been started. Next change directories to the directory containing the ldap file you just created and run the ldapadd utility. 

[note color=#ddd]ldapadd -x -W -D 'cn=manager,dc=scopserv,dc=local' -f server.ldif -c[/note]

You will be prompted for the rootpw (Bind Password). Enter the password and the utility should dump you to a command prompt if no errors are encountered.


Add entries to Directory

To add person entries to the directory, go on Organizer -> Address Book and click on New Contact. You can select in which directory (Shared and Personal Directory) you want to include the new entry.


Organizer -> Addressbook

Organizer -> Addressbook


Configure Phone Provisioning

The following phones allow to use an LDAP server for Company Directory and CallerID Lookup :

  • AudioCodes
  • Bria (softphone)
  • Polycom (A license from Polycom is required to use this feature)
  • Sipura (SPA30x and SPA50x)
  • Snom

You can enable internal LDAP support on ScopTEL PBX Phone Provisioning from Telephony -> Provisioning -> LDAP.


Phone Provisioning -> Internal LDAP Server

Phone Provisioning -> Internal LDAP Server

Browse LDAP Directory

On ScopTEL PBX, we include a tool that allow to browse data from any LDAP Directory. You must click on Tools -> Server -> LDAP Explorer and browse across entries.


Tools -> LDAP Explorer

Tools -> LDAP Explorer



External Links:




Read More

Download ScopTEL PBX 2.6.0 and Asterisk release candidate (RC)

[note color=#f00]The official release of Telephony 2.6.0 and Asterisk are available on our repository since August 15, 2012.[/note]


You can now download and test the first release candidate of ScopTEL PBX  :: Telephony (2.6.0-RC1)  and Asterisk ( from ScopServ Download website.

You can install it manually from SSH using the following command :


[note color=#ddd]rpm -Uvh[/note]

[note color=#ddd]rpm -Uvh[/note]

If you are testing the release candidate and think you’ve found a bug, please post to the ScopServ Helpdesk.

Looking forward to your testing and feedback. The next and final Release Candidate of Telephony module (2.6.0RC2) is planned in about one (1) week and stable version should be ready by August 15, 2012.

Read More

ScopTEL PBX :: What’s new in Telephony version 2.6.0

We’re proud to announce the next major release of ScopTEL PBX !

The new version of Telephony 2.6.0 will officially be available on our repositories starting of August 15, 2012.

This article explains the new features in ScopTEL PBX :: Telephony 2.6.0. It doesn’t attempt to provide a complete specification of all new features, but instead tries to give a convenient overview.


New features

Something new is always popping up somewhere on your ScopTEL PBX and this new version 2.6.0 includes many new and improved features, including better way to edit multiple extensions (Mass Operation), new option to control volume, a new wizard to configure VoIP Account, to name just a few of the changes.

Mass Operations

In order to ease and speed-up the configuration of your Telephony server, we added a new system for executing Mass Operations (batch). Currently only available on Extensions -> Phones, this new system allow to do Mass Edit for  Phone Options, CallerID, DTMF, Codecs, SIP Alert and Call Recording/Monitor in a matter of seconds.

VoIP Provider Wizard

A new  configuration wizard for VoIP Accounts  was added and lets you select a telephony service provider among a predefined list.  It is also possible to automatically create Incoming and Outgoing Lines associated with the account. The new Wizard is available from Interface -> VoIP Account -> VoIP Provider Wizard.

Volume Gain Controls

For each extensions (phone) and wherever it is possible to specify an extension as a destination, such as in an IVR or Personal IVR, we added the ability to set (increase or decrease) the Volume Gain (RX/TX) that will be used on the current channel.  From Incoming and Outgoing Lines, it also possible to enable DTMF volume control that will check the channel for ‘*’ and ‘#’. If one of those keys is pressed, the volume will be increased or reduced, respectively.

Encryption (SIP/IAX2)

You can now enable/disable SIP SRTP support (need Asterisk 1.8) on each Extensions and VoIP Accounts. It also possible to enable IAX2 encryption on Interface -> VoIP Account to encrypt the channel control data and voice data with AES128.

Call Recording (BLF)

It now possible to define a BLF (hints) key to check if Call Recording is enabled, paused or disabled on a specific extension. This key can also be used to manually pause-and-resume call recording by the caller/agent when sensitive or private information is being disclosed during a call. This new feature require Asterisk that will also be available by August 15.

Call Screening

You can now activate  Call Screening options on Outgoing Lines and Voicemail Offsite Notification. This new option will prompt the called extension/external number before deciding how or whether to answer or reject it.


The update also provides a few bug fixes:

  • An issue on Scheduled Tasks that ignore the specified month is now fixed.
  • If an extension is defined to use a template, we no more overwrite the template when a user edit his extension from Web-GUI.
  • The VLAN ID is now properly set on the Yealink Phone Provisioning configuration file.
  • We now correctly update Polycom Phone Directory when variable macros are used on Provisioning (APS).
  • and various minor fixes …


For a full list of changes in this release, please see the ChangeLog:


Read More

How to install ScopTEL CentOS 5 version on a PC using our DVD ISO boot disk

In order to start using our ScopTEL IPPBX software you first need to download a copy of our DVD ISO boot disk from

Once you have downloaded the el5 ISO and burnt the image to a blank DVD you can follow along with our detailed instructions (including screen shots) to install our ScopTEL software using the DVD ISO boot disk.

[note]To log into ScopTEL PBX WebGUI, go to http://ip.address.of.the.server:5555/

The default GUI user/password are admin/admin

The default SSH console user/password are root/scopserv[/note]

Module 1 - ScopTEL - CentOS5 DVD ISO Boot Disk Installation
Read More

Using ScopTEL PBX and Polycom Enhanced Feature Keys / EFK to monitor and control Call Recording

This post explains the possibility using Polycom Enhanced Feature Keys / EFK and Softkey to monitor and control Call Recording with ScopTEL PBX.

What we want to achieve is to show the status of the Call Recording (eg. if the current call is recorded) directly on the phone LCD and have the ability to stop and start the recording.


[note color=#ddd]NOTE:  This capability require ScopTEL PBX  Telephony 2.6.0 and Asterisk and applies to the Polycom SoundPoint IP  320, 330, 430, 501, 550, 560, 601, and 650 phones using Firmware 3.0.0 and greater.[/note]


Activate Feature Code

Once logged as administrator into the ScopTEL GUI, you must go on Telephony -> Configuration -> Feature Code and set the code for Call Recording (Mute/UnMute) feature code, the default value is set to #999. Now you must Save Configuration.


Configuration -> Features Code -> Miscellaneous

Configuration -> Features Code -> Miscellaneous


Configure Phone Provisioning


Click on Telephony -> Provisioning and add a new phone or edit an existing one.  You must define a Soft Key, set the type as Feature and select Call Recording (Mute/UnMute) on the list of features. This will automatically configure a BLF key that will be turn on the indicator if call is recorded and turn off when no recording.


[note color=#eee]With other phone vendors, you can  manually define the Softkey contact as monitor-TENANT-EXTEN (ex. monitor-default-250) to subscribe to this hint/BLF on the ScopTEL PBX (Asterisk). Please note that the following macros are also available in Softkey contact: ${TENANT}, ${EXTEN} and ${USER}.[/note]


Provisioning -> Soft Key

Provisioning -> Soft Key


The next step is to define an EFK button that will start/stop the recording on the current call. Click on EFK tab and set the key type to Feature and set it to Call Recording (Start/Stop). This key is a shortcut for the feature code and will automatically send the DTMF and invoke the feature code during the call.


Provisioning -> Enhanced Function Key (EFK)

Provisioning -> Enhanced Function Key (EFK)



Alternatively, it possible to use the Call Recording (Mute/UnMute) feature as a Softkey (Speed Dial) by specifying !automonmute in the destination field.  Please note that you cannot control when the softkey is visible (Idle, Active, Hold, etc) like with EFK.


Use EKF as a Softkey

Use EKF as a Softkey


Apply Configuration

Finally, you must click on Commit in order to generate provisioning files and reboot your phone.


Polycom IP601 Active Call

Polycom IP601 Active Call



Read More

How to fix DAHDI/WANPIPE drivers issues on ScopTEL PBX

If you have updated your ScopTEL PBX server  to use a new CentOS kernel, it can sometimes happen that DAHDI/WANPIPE drivers need to be recompiled manually.

If you’ve been getting issues with Digital/Analog interfaces and drivers refuse to start, here’s how to fix it.

To fix the problem, we’ll need to remove current installed drivers. So open an SSH connection to the server and execute the following commands:

service asterisk stop

service dahdi stop

rpm -e dahdi wanpipe dkms-dahdi dkms-wanpipe  –nodeps

Now that drivers are cleaned, you must reinstall drivers, this step will always download the latest version available on ScopServ RPM repositories.

You must execute this command from SSH to reinstall packages:

scopserv_yum install dkms-dahdi dkms-wanpipe -y

Finally, from the ScopTEL GUI, you must Commit configuration on the Telephony module.

Then it is recommended in SSH to do:

service dahdi start

service asterisk start

As you can see, the procedure for reinstalling  the DAHDI and Wanpipe drivers on your ScopTEL PBX is relatively simple.

Read More