Asterisk: The Definitive Guide (Definitive Guides)

Asterisk: The Definitive Guide (Definitive Guides)

Design a complete VoIP or analog PBX with Asterisk, even if you have no previous Asterisk experience and only basic telecommunications knowledge. This bestselling guide makes it easy, with a detailed roadmap to installing, configuring, and integrating this open source software into your existing phone system.Ideal for Linux administrators, developers, and power users, this book shows you how to write a basic dialplan step by step, and quickly brings you up to speed on the latest Asterisk features in version 1.8.Integrate Asterisk with analog, VoIP, and digital telephony systems Build a simple interactive dialplan, and dive into advanced concepts Use Asterisk’s voicemail options—including a standalone voicemail server Build a menuing system and add applications that act on caller input Incorporate a relational database with MySQL and Postgre SQL Connect to external services such as LDAP, calendars, XMPP, and Skype Use Automatic Call Distribution to build a call queuing system Learn how to use Asterisk’s security, call routing, and faxing features

Source: Amazon

Read More

Using Clickatell SMS Gateway with ScopTEL PBX

Before you can use the Clickatell SMS Gateway integration with ScopTEL PBX software, you first have to create a Clickatell HTTP API account:

 

Create a Clickatell account

Go to the Clickatell website and sign up for an SMS Gateway, Clickatell Central account. Signing up to Clickatell Central is free, as a bonus you get 10 free message credits. After you have used your free 10 credits, you can purchase additional credits from Clickatell at rates well below those provided by your mobile operator. 

Please make sure to register for the Central  HTTP API account, otherwise it will not work with ScopTEL PBX SMS Gateway integration.

 

Create a Clickatell HTTP API product

In Clickatell Central use the Manage My Products page to add a HTTP connection. This will generate an API ID that, together with your user name and password, you need to add the gateway to ScopTEL PBX Server.

Clickatell - Add Connections

Clickatell – Add Connections

 

Cickatell - Connection Informations

Cickatell – Connection Informations

 

Clickatell - New Connection Confirmation

Clickatell – New Connection Confirmation

 

 

Enable SMS support to ScopTEL PBX

In the ScopTEL PBX GUI, you must first enable the SMS Gateway module from Telephony -> Configuration -> Telephony Modules.

Configuration -> Telephony Modules -> Enable SMS Gateway

Configuration -> Telephony Modules -> Enable SMS Gateway

 

Add Clickatell SMS Gateway

On Telephony -> Interfaces -> SMS Gateway, click on Add SMS Gateway and  fill in the Clickatell username, password and HTTP API-ID in the gateway setup window.

Interface -> SMS Gateway -> Add Gateway

Interface -> SMS Gateway -> Add Gateway

 

 

Currently, you can use SMS Notification available from Server -> Monitoring and Telephony -> Configuration -> Monitoring or by clicking on the Send SMS button from Telephony -> Interfaces -> SMS Gateway by clicking on Send SMS button.

Alternatively, you can use this shell script to integrate it on your own custom script :   

[box color=#ddd title=”SMS Shell Command”]/var/www/scopserv/telephony/scripts/sendsms[/box]

 

That’s it! Now you are ready to send SMS from ScopTEL PBX software.

 

Read More

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)
) ENGINE=MyISAM DEFAULT CHARSET=latin1;

[/box]

 

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”]

01230126675
01230312624
01230871502
01236161496
01237627016
01234545454
01237741360
01232780766
01235100042

[/box]

 

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
SRC="/tmp/blacklist.txt"
# Destination File
DST="/tmp/blacklist.sql"
# Set SQL database name (default is scopserv) 
SQL="scopserv"

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

[/box]

 

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 http://www.sixxs.net

 

 

 

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 ipv6.google.com:

[note color=#ddd]ping6 ipv6.google.com[/note]

Traces path to a network host, enter:

[note color=#ddd]traceroute6 ipv6.google.com[/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)

ISDN BRI

Hybrid (Analog + Digital + BRI)

Prerequisites

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:

Wikipedia: http://en.wikipedia.org/wiki/Lightweight_Directory_Access_Protocol

OpenLDAP: http://www.openldap.org

 

Read More

Download ScopTEL PBX 2.6.0 and Asterisk 1.8.15.0 release candidate (RC)

[note color=#f00]The official release of Telephony 2.6.0 and Asterisk 1.8.16.0 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 (1.8.15.0RC1) from ScopServ Download website.

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

 

[note color=#ddd]rpm -Uvh http://download.scopserv.com/dist/packages/scopserv-telephony25/scopserv-telephony25-2.6.0-1.el5.RC.noarch.rpm[/note]

[note color=#ddd]rpm -Uvh http://download.scopserv.com/dist/packages/asterisk18/asterisk18-1.8.15.0-1.el5.RC1.i386.rpm[/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 1.8.15.0 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.

Bugfixes

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:

http://support.scopserv.com/releases/telephony/

 

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 http://download.scopserv.com/iso/

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