8 port pri card quick installation guide

8 Port PRI Card- Quick Installation Guide

www.allo.com Version 2.0 1



Copy Right

Copyright 2014 Allo. All rights reserved.

No part of this publication may be copied, distributed, transmitted, transcribed, stored in a

retrieval system, or translated into any human or computer language without the prior written

permission of Allo.com. This document has been prepared for use by professional and properly

trained personnel, and the customer assumes full responsibility when using it.

Proprietary Rights

The information in this document is Confidential to Allo and is legally privileged. The information

and this document are intended solely for the addressee. Use of this document by anyone else for

any other purpose is unauthorized. If you are not the intended recipient, any disclosure, copying

or distribution of this information is prohibited and unlawful.

Disclaimer

Information in this document is subject to change without notice and should not be construed as

a commitment on the part of allo.com. And does not assume any responsibility or make any

warranty against errors. It may appear in this document and disclaims any implied warranty of

merchantability or fitness for a particular purpose.



About this manual

This manual describes the Allo product application and explains how to work and use it major

features. It serves as a means to describe the user interface and how to use it to accomplish

common tasks. This manual also describes the underlying assumptions and users make the

underlying data model.

Document Conventions

In this manual, certain words are represented in different fonts, typefaces, sizes, and weights. This

highlighting is systematic; different words are represented in the same style to indicate their

inclusion in a specific category. Additionally, this document has different strategies to draw User

attention to certain pieces of information. In order of how critical the information is to your

system, these items are marked as a note, tip, important, caution, or warning.

Icon Purpose

Note

Tip/Best Practice

Important

Caution

Warning

o Bold indicates the name of the menu items, options, dialog boxes, windows and functions.

o The color blue with underline is used to indicate cross-references and hyperlinks.

o Numbered Paragraphs - Numbered paragraphs are used to indicate tasks that need to be

carried out. Text in paragraphs without numbering represents ordinary information.

o The Courier font indicates a command sequence, file type, URL, Folder/File name

e.g. www.allo.com

Support Information

Every effort has been made to ensure the accuracy of the document. If you have comments,

questions, or ideas regarding the document contact online support: http://support.allo.com



Table of Contents About this manual .................................................................................................................... 3

Document Conventions ............................................................................................................ 3

Support Information................................................................................................................. 3

1. Introduction ............................................................................................................................. 5

2. Overview .................................................................................................................................. 5

2.1 Hardware Echo Cancellation .............................................................................................. 5

2.2 Identifying Ports ................................................................................................................. 6

2.3 Y-adopter Dongle ............................................................................................................... 7

2.4 Dongle Split End ................................................................................................................. 8

2.5 Slot Compatibility ............................................................................................................... 9

3. Software Configuration ............................................................................................................ 9

3.1 T1/E1 Selection ................................................................................................................... 9

3.2 E1/T1 mode settings .......................................................................................................... 9

5.1 Installation of Pre requisite packages: ............................................................................. 11

5.1.1 Installation of LibPRI package .................................................................................... 11

5.2 Installation of Dahdi Driver .............................................................................................. 12

5.3 Installation of Asterisk ...................................................................................................... 13

5.4 Enable/Disable Hardware Echo Canceller ........................................................................ 14

6. Software Configurations ........................................................................................................ 15

7. Appendix- PIN Assignments ................................................................................................... 17



1. Introduction The Allo 2aCP8e/2aCP8eL series cards are T1/E1 PRI Cards designed for voice applications. The

Cards series are as follows.

Model No Product Description

2aCP8e 8 Port PRI PCIe card

2aCP8eL 8 Port PRI PCIe card with Line Echo Cancellation

2. Overview

The Allo 2aCP8e (8 ports PRI Card) series supports industry standard protocols including

Channel Associated Signaling (CAS), SS7 Signaling, PRI switch Compatibility and Interoperable

with Asterisk, FreeSwitch, and Elastix etc.

The 2aCP8eL Series cards are ideal for connecting phones to a channel bank, T1/E1 switches,

or connecting to a legacy PBX. The Y-adapter dongle allows twice the amount of spans to fit

in a single PC slot and taking up less space to allow for more peripherals. Designed to be fully

compatible with existing software applications and integrate fully with Asterisk platform, the

2aCP8eL series cards allow many advanced call features. In this manual, we used 2aCP8eL PCI

Express card. These are identified collectively as the 2aCP8eL series cards throughout this

manual.

2.1 Hardware Echo Cancellation

Users connecting their 2aCP8eL series cards to the PSTN or other devices are likely to be

placing calls. Elimination of this echo is the responsibility of echo cancellation. Allo uses

Octassic DSP based hardware echo canceller with 128ms tail length.

The Allo 2aCP8e (8 ports PRI Card) series cards equipped with Asterisk is to perform software-

based echo cancellation. Asterisk maintains a number of open source echo cancellers. These

open source echo cancellers provide a moderate level of echo cancellation, but not capable of

dealing with higher levels or more advanced echoes.



Allo recommends that those users concerned about echo cancellation purchase the hardware

echo cancellation module. It is designed to handle up to 128ms of echo cancellation across all

channels and provides a G.168 compliant echo cancellation solution.

2.2 Identifying Ports

The 2aCP8eL series cards consists of 4 RJ45 Ports and eight status LEDs. The ports are used for

connecting T1, E1, or J1 cables via Y-adapter dongles.

The 2aCP8eL series cards can be used without Y-adaptor dongles, but only spans 1 through

4 will be accessible.

8 Port PRI PCIe card with LEC (2aCP8eL)

Ports (1-4)

PCIe Connector



8 port PRI Card- Span Status LEDs

2.3 Y-adopter Dongle

The Y-adopter dongles are provided for accessing all 8 spans on the 2aCP8eL series cards. The

following figure helps to identify a dongle and its split end ports.

Y-Adapter Dongle

Span

Status

LEDs



2.4 Dongle Split End

Split A

Split B

Dongle Split End

Connection Diagram



2.5 Slot Compatibility

Check your motherboard to verify that a compatible slot is available for a 2aCP8eL PRI card. To

determine which slots you have on your motherboard.

PCI Express 1-lane (x1) Slot




Motherboard slots

The 2aCP8e series cards work PCIe x1 slot including lane lengths x4, x8, x16

The 2aCP8eL PRI card will fit into above motherboard slots (PCI Express), but cannot fit into

any of the other slots.

3. Software Configuration

3.1 T1/E1 Selection

The 2aCP8eL series cards can be configured for either T1 or E1 mode. The T1/E1 mode may be

specified in the drivers using either the default_linemode= t1 or default_linemode=e1 module

parameter when the drivers are loaded. This will set the mode for all spans on the card.

3.2 E1/T1 mode settings

By default the card is ready to use in E1 mode



E1 Mode

Add allo4xxp at the end of /etc/dahdi/modules, so that while starting dahdi driver Allo card

modules will load automatically.

T1 Mode

To configure the PRI card in T1 signaling mode, please add the following line in the relevant files,

(i) Add allo4xxp at the end of /etc/dahdi/modules, so that while starting dahdi driver Allo

card modules will load automatically

(ii) Add options allo4xxp default_linemode=t1 # for T1 Signaling at the end of

/etc/modprobe.d/dahdi.conf

4. Hardware Setup

2nd Generation 8 port PRI Card with Dongle Splits

1) Insert the 2nd Gen 8 port PRI (PCIe) card in the corresponding PCIe slot of the Server.

2) Check if the installed PRI card is detected using the below command

# lspci



If the card has been recognized, it will be displayed in the output information.

root voiptest ~]# lspci

#04:00.0 Non-VGA unclassified device: Device 1d21:1280(rev 01)

Device PRI Id Type of PRI Card

1280 8 ports PRI Card

If the PRI card is not recognized by the system, you have to power off and take out the

card, and then insert it into another PCIe slot.

5. Software Installation Steps

This chapter describes how to install the software on your computer. Before you proceed

please make sure that your computer meets the requirements.

The following steps are applicable only for manual package installation its not applicable

for any pre-installed packages comes with Trixbox, Elastix, and FreePBX etc.

Test Environment (Example) Libpri-1.4.14

ALLO Dahdi Driver - 2.9.1

Asterisk-11.4.0

centos 6.2 (kernel version: 2.6.32)

Telephony Card: 8 port PRI PCIe card (Model: 2aCP8e)

5.1 Installation of Pre requisite packages:

Install all of Asterisks dependencies that are required to compile asterisk. Run the followings

commands to install the required packages needed for compiling drivers from source.

[root@localhost ~]# yum install bison bison-devel ncurses ncurses-devel zlib zlib-devel openssl

openssl-devel gnutls-devel gcc gcc-c++ libxml2

5.1.1 Installation of LibPRI package

Go to /usr/src directory and Download LibPRI by running the following command



[root@localhostsrc]# wget http://downloads.asterisk.org/pub/telephony/libpri/libpri-

1.4.14.tar.gz

After downloading LibPRI extract the LibPRI tar file by the command

[root@localhost src]# tar -xvzf libpri-1.4.14.tar.gz

Install the LibPRI by following the commands

[root@localhost src]# cd libpri-1.4.14

# make clean # make # make install

5.2 Installation of Dahdi Driver

Download latest ALLO Dahdi Drivers and available for download from:

http://www.allo.com/firmware/pri-card-second-gen/dahdi/dahdi-linux-complete-

2.9.1.1+2.9.1.tar.gz

You can download the respective dahdi driver from http://allo.com/pri-eight-port-card.html

under Guides & Drivers.

Download the respective dahdi driver executing the following command

#wget http://www.allo.com/firmware/pri-card-second-gen/dahdi/dahdi-linux-complete-

2.9.1.1+2.9.1.tar.gz

Extract the downloaded file and enter into that directory

# tar -xvzf dahdi-linux-complete-2.9.1.1+2.9.1.tar.gz

Use the following commands to install DAHDI drivers # cd dahdi-linux-complete-2.9.1.1+2.9.1 # cd dahdi-linux-complete-2.9.1.1+2.9.1

#make

#make install

#make config

Successful dahdi driver installation shows the similar output & lists the detected dahdi devices



Dahdi Driver Installation Output

After dahdi driver installation to list out the dahdi hardware devices run dahdi_hardware

command and output are as follows:

Dahdi-Hardware Command

5.3 Installation of Asterisk

Download the latest version of asterisk. Asterisk is available for download from:

http://downloads.asterisk.org/pub/telephony/asterisk/after downloading asterisk, extract the

asterisk tar file by giving following command.

#wget http://downloads.asterisk.org/pub/telephony/asterisk/asterisk-11-current.tar.gz

Go to asterisk folder and compile the packages as shown in the screenshot



To install asterisk give the following commands:

[root@pbx1 asterisk-11.4.0]#. /configure #make # make install # make config

If this is your first Asterisk Install, you should install the sample configuration files, to do this run:

# make samples

5.4 Enable/Disable Hardware Echo Canceller

If the PRI Card comes with hardware echo cancellation, we need to do the following

settings to be enabled.

By default hardware echo canceller is loaded when dahdi service start

There are two settings need to be configured to use hardware echo cancellation module.

1. Set the option echocanceller=none for all spans in /etc/dahdi/system.conf.

For example configuring span-1

# Span 1: ALLO2/0/1 "T2XXP (PCI) Card 0 Span 1" (MASTER)

span=1,1,0,ccs,hdb3,crc4

# termtype: te

bchan=1-15,17-31

dchan=16

echocanceller=none

2.Echo Cancellation is enabled by default in chan_dahdi.conf by the option echocancel=yes

and its length in taps.

By default, it is set to "yes, We have to set these option as no.

For example:

echocancel = no

Echocancelwhenbridge=no

If Hardware Echo canceller module present and echocanceller for all spans in

/etc/dahdi/system.conf is set to yes, might cause the bad voice quality.



6. Software Configurations

Add the line allo4xxp at the end in /etc/Dahdi/modules file. The start dahdi is to stop and

start dahdi service according to deployment scenario.

After compiling and installing DAHDI and Asterisk, load the Dahdi driver by running:

# /etc/init.d/dahdi start

# dahdi_genconf vvvvv

If there is any error, please trace the cause. Until all errors are clear up, you should execute

"dahdi_genconf" again, and then go to the next step.

By running "dahdi_genconf", it will generate /etc/dahdi/system.conf and etc/asterisk/dahdi-

channels.conf automatically. Check whether the generated files information agrees with your

hardware setup, if not, you should modify to your specific requirements.

Dahdi Channels Configure With asterisk

Do not forget to confirm dahdi-channels.conf is included in chan_dahdi.conf to configure

Dahdi channels with asterisk, if not, run command:

# echo "#include dahdi-channels.conf" >> /etc/asterisk/chan_dahdi.conf

Execute the following command:

# dahdi_cfg vvvvv

This command is used for reading and loading parameters in the configuration file system.conf

and writing to the hardware.

Start the Asterisk by executing



# asterisk gvvvvvvvvvc

Make sure that PRI spans are up and active, before making calls. Here is the command to check

the PRI span status

CLI>pri show spans

PRI Span Status (8 Port PRI Card)

If you face any issues, please contact the reseller from whom you have purchased the ALLO

product or submit a support ticket http://support.allo.com/



7. Appendix- PIN Assignments

All four ports on the 2aCP8e Series card bracket are 8-pin RJ45 ports. The pin assignments are

identified in the following table.

2aCP8e Series RJ45 Telco Port Connector

Dongle Split A RJ45 Telco Port Connector



Dongle Split B RJ45 Telco Port Connector



s

About this manualDocument ConventionsSupport Information1. Introduction2. Overview2.1 Hardware Echo Cancellation2.2 Identifying Ports2.3 Y-adopter Dongle2.4 Dongle Split End2.5 Slot Compatibility

3. Software Configuration3.1 T1/E1 Selection3.2 E1/T1 mode settings5.1 Installation of Pre requisite packages:5.1.1 Installation of LibPRI package

5.2 Installation of Dahdi Driver5.3 Installation of Asterisk5.4 Enable/Disable Hardware Echo Canceller

6. Software Configurations7. Appendix- PIN Assignments

8 port pri card quick installation guide

Documents