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

ScopTEL – Advanced Training on QoS and VLANs

Ever wonder how to set up VLAN’s or set priority on the default VLAN for voice traffic?

Mechanisms like LLDP and CDP are not a necessity to set up voice priority or VLAN’s.

This document covers prerequisites for the ScopTEL advanced training and reseller exam.

QoS – VLAN – CODEC – Best Practices – MPLS – VoIP Protocols – MOS

Module 20 - ScopTEL - Quality of Service Training


Read More

How to recover Shared Storage (DRBD) from split brain

After split brain has been detected, one node will always have the resource in a StandAlone connection state. The other might either also be in the StandAlone state (if both nodes detected the split brain simultaneously), or in WFConnection (if the peer tore down the connection before the other node had a chance to detect split brain).


Shared Storage (DRBD) Status

Shared Storage (DRBD) Status


If you get degraded Shared Storage (DRBD) you have to manually resolve split brain situation. You will need to log into Master/Slave server using SSH and connect as root.


On Master (primary) server :

[note color=#ddd]drbdadm connect all [/note]


On Backup (secondary) server :

[note color=#ddd]drbdadm invalidate all
drbdadm connect all


Upon connection, your split brain victim immediately changes its connection state to SyncTarget, and has its modifications overwritten by the remaining primary node.

Read More

How to use the ScopTEL Version Switcher to move between ScopTEL releases and different releases of Asterisk

ScopTEL implements an Asterisk version switcher in our Packages Manager.

The version switcher easily toggles between Asterisk versions 1.4, 1.8 and 11

Each Asterisk version may have its place in the real world scenarios even though Asterisk 1.4 is discontinued.

Version 1.8 added great new features in Connected Party updates, CCNB, SRTP

Version 11 finally gives Asterisk T.38 gateway support.

Now you can choose which Asterisk version to deploy and quickly switch between versions to choose which version is best for you.

Module 4 - ScopTEL - Version Switcher for Telephony Server


Read More