Digium Asterisk Appliance 50 AA50 Use and care manual

Asterisk Appliance™ 50 (AA50)
Administrator’s Manual
601-00005A Release 1.20

Release 1.20 Digium, Inc. Page 2
© Digium, Inc. 2008
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 Digium, Inc.
Digium, Inc. has made every effort to ensure that the instructions contained in this document
are adequate and error free. The manufacturer will, if necessary, explain issues which may
not be covered by this documentation. The manufacturer’s liability for any errors in the
document is limited to the correction of errors and the aforementioned advisory services.
This document has been prepared for use by professional and properly trained personnel,
and the customer assumes full responsibility when using it.
Adobe and Acrobat are registered trademarks, and Acrobat Reader is a trademark of Adobe
Systems Incorporated.
Asteriskand Digium are registered trademarks andAsterisk Business Edition, AsteriskNOW,
AsteriskGUI, and Asterisk Appliance 50 are trademarks of Digium, Inc.
Any other trademarks mentioned in the document are the property of their respective owners.
Digium, Inc.
445 Jan Davis Drive
Huntsville, AL 35806
United States
Main Number: 1.256.428.6000
Tech Support: 1.256.428.6161
U.S. Toll Free: 1.877.344.4861
Sales: 1.256.428.6262
www.digium.com
www.asterisk.org
www.asterisknow.org

Release 1.20 Digium, Inc. Page 3
Safety Certification and Agency Approvals
Safety:
US/CSA 60950
IEC 60950
EN 60950
AS/NZ 60950
Other:
CE Mark (European Union)
2002/95/EC Restrictions on Hazardous Substances (RoHS), 2005/747/EC
lead free exemption (Annex C)
Telecom:
FCC Part 68, TIA-968
TBR-21 1998
Industry Canada IC-CS-03
AS-ACIF S002-2005
AS-ACIF S003-2005
EMC:
FCC Part 15 Class A
EN55022/CISPR22 Class A
EN55025
IEC 61000
CNS13438
VCCI V-32005.04

Release 1.20 Digium, Inc. Page 4
Federal Communications Commission Part 68 (USA)
This equipment complies with Part 68 of the FCC rules and the
requirements adopted by the ACTA. On the back of the Asterisk
Appliance 50 enclosure is a label that contains, among other information,
a product identifier in the format US:AAAEQ##TXXXX. If requested,
this number must be provided to the telephone company.
A plug and jack used to connect this equipment to the premises wiring
and telephone network must comply with the applicable FCC Part 68
rules and requirements adopted by the ACTA.
If the AA50 causes harm to the telephone network, the telephone
company may notify you in advance that temporary discontinuance of
service may be required. But if advance notice is not practical, the
telephone company will notify you as soon as possible. Also, you will be
advised of your right to file a complaint with the FCC if you believe it is
necessary.
The telephone company may make changes in its facilities, equipment,
operations or procedures that could affect the operation of the equipment.
If this happens, the telephone company will provide advance notice in
order for you to make necessary modifications to maintain uninterrupted
service.
If you experience problems with the Asterisk Appliance 50,contact
Digium, Inc. (+1.256.428.6161) for repair and/or warranty information. If
the equipment is causing harm to the telephone network, the telephone
company may request that you disconnect the equipment until the
problem is resolved.

Release 1.20 Digium, Inc. Page 5
FCC Part 15
This device complies with part 15 of FCC rules. Operation is subject to
the following two conditions: (1) This device may not cause harmful
interference, and (2) This device must accept any interference received,
including interference that may cause undesired operation.

Release 1.20 Digium, Inc. Page 6
Introduction to Asterisk Appliance 50 Documentation
This manual contains product information for the Asterisk Appliance 50.
Be sure to refer to any supplementary documents or release notes that
were shipped with your equipment. The manual is organized in the
following manner:
Chapter/
Appendix Title Description
1Overview Identifies the features of your unit.
2Unit Installation Provides instructions for installing the unit.
3Asterisk
Configuration Provides instructions on how to configure the
Embedded Asterisk Business Edition through the use
of the AsteriskGUI.
4Troubleshooting Explains resolutions to common problems and
frequently asked questions pertaining to the unit.
APin Assignments Lists the connectors and pin assignments.
BSpecifications Details unit specifications.
CLicense Agreement Digium End-User Purchase and License Agreement
DGlossary and
Acronyms Defines terms related to this product.

Release 1.20 Digium, Inc. Page 7
Symbol Definitions
Caution statements indicate a condition where damageto the unit or
its configuration could occur if operational procedures are not
followed. To reduce the risk of damage or injury, follow all steps or
procedures as instructed.
The ESD symbol indicates electrostatic sensitive devices. Observe
precautions for handling devices. Wear a properly grounded
electrostatic discharge (ESD) wrist strap while handling the device.
The Electrical Hazard Symbol indicates a possibility of electrical
shock when operating this unit in certain situations. To reduce the
risk of damage or injury, follow all steps or procedures as
instructed.

Release 1.20 Digium, Inc. Page 8
Important Safety Instructions
Save these instructions for future reference.
Servicing.
Do not attempt to service this unit unless specifically instructed to do
so. Do not attempt to remove the unit from your equipment while
power is present. Refer servicing to qualified service personnel.
Water and Moisture.
Do not spill liquids on this unit. Do not operate this equipment in a
wet environment.
Heat.
Do not operate or store this product near heat sources such as
radiators, air ducts, areas subject to direct, intense sunlight, or other
products that produce heat.
Warning.
Do not place anything (including paper) on top of the Asterisk
Appliance 50. To allow proper cooling, these units must not be
stacked.
Caution.
To reduce the risk of fire, use only No. 26 AWG or larger
telecommunication wiring for network connections.
Static Electricity.
To reduce the risk of damaging the unit or your equipment, do not
attempt to open the enclosure or gain access to areas where you are
not instructed to do so. Refer servicing to qualified service personnel.
Emergency 911
The Asterisk Appliance 50 is capable of forwarding arbitrary caller
id strings to VoIP service providers, which in multi-office setups
could simply be other Asterisk Appliance 50s. Customers of Internet
Telephony Service providers to which 911 or Emergency calls are
placed should ensure their provider properly forwards the customer's
accessible PSTN phone number to the emergency call handling
center.

Release 1.20 Digium, Inc. Page 9
TABLE OFCONTENTS
Introduction to Asterisk Appliance 50 Documentation . . . . . . . . . . .6
Chapter 1
Overview . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .15
Features: . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .16
Chapter 2
Unit Installation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .17
Unpacking the Unit . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .18
Inspecting Your Shipment . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .18
Identifying Communication Ports . . . . . . . . . . . . . . . . . . . . . . . . . .19
Understanding the LEDs . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .19
Using the Configuration Reset Switch . . . . . . . . . . . . . . . . . . . . . .23
Installing the AA50 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .24
Mounting the Asterisk Appliance 50 . . . . . . . . . . . . . . . . . . . . . . . .26
Chapter 3
Telephone System Configuration . . . . . . . . . . . . . . . . . . . . . . . . . . .28
Log On to the AA50. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .30
The AA50 Interface . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .31
Analog Hardware Configuration . . . . . . . . . . . . . . . . . . . . . . . . . . .33
Trunk Configuration . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .37
Analog Trunks . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .38
Outgoing Calling Rules . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .47
Dial Plans . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .51

Release 1.20 Digium, Inc. Page 10
Table Of Contents
User Extensions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .52
Ring Groups . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .58
Music on Hold . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .60
Call Queues . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .62
Agent Login Settings . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .66
Voice Menus . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .67
Record a Voice Menu . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .73
Time Intervals . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .74
Incoming Calling Rules . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .76
Voicemail . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .79
Conferencing . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .83
Directory . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .86
Call Parking . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .87
Voicemail Groups . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .89
System Info . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .90
Networking . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .91
Backup . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .94
Update . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .95
Options . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .96
Chapter 4
Troubleshooting . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .100
Appendix A
Pin Assignments . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .101
Appendix B
Specifications . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .105

Release 1.20 Digium, Inc. Page 11
Table Of Contents
Appendix C
Asterisk Appliance 50 (AA50) License Agreement . . . . . . . . . . . .107
GNU GENERAL PUBLIC LICENSE . . . . . . . . . . . . . . . . . . . . . . .121
Version 2, June 1991 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .121
Preamble . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .121
GNU GENERAL PUBLIC LICENSE . . . . . . . . . . . . . . . . . . . . . . .123
TERMS AND CONDITIONS FOR COPYING, DISTRIBUTION AND
MODIFICATION . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .123
EXHIBIT B.2 - ncurses Licenses . . . . . . . . . . . . . . . . . . . . . . . . .133
EXHIBIT B.3 - dropbear License . . . . . . . . . . . . . . . . . . . . . . . . .136
EXHIBIT B.4 - OpenSSL License . . . . . . . . . . . . . . . . . . . . . . . . .139
EXHIBIT B.5 - ftp License . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .142
EXHIBIT B.6 - ntp and ntpdate License . . . . . . . . . . . . . . . . . . . .143
EXHIBIT B.7 - zlib License . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .143
EXHIBIT B.8 - ss and et License . . . . . . . . . . . . . . . . . . . . . . . . .144
EXHIBIT B.9 – GNU Lesser General Public License Version 2 . .145
Appendix D
Glossary and Acronyms . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .161

Release 1.20 Digium, Inc. Page 12
List of Figures
Figure 1: The Asterisk Appliance 50 (AA50) . . . . . . . . . . . . . .17
Figure 2: Example Asterisk Appliance 50 Port Identification . .22
Figure 3: Asterisk Appliance 50 Back View . . . . . . . . . . . . . . .23
Figure 4: Mounting Instructions . . . . . . . . . . . . . . . . . . . . . . . .26
Figure 5: GUI Login . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .30
Figure 6: System Status Page . . . . . . . . . . . . . . . . . . . . . . . . .31
Figure 7: Configure Hardware . . . . . . . . . . . . . . . . . . . . . . . . .33
Figure 8: Trunk Configuration Page . . . . . . . . . . . . . . . . . . . . .37
Figure 9: New Analog Trunk Definition . . . . . . . . . . . . . . . . . .38
Figure 10: Add New Service Provider . . . . . . . . . . . . . . . . . . . .42
Figure 11: Edit VoIP Service Provider . . . . . . . . . . . . . . . . . . . .43
Figure 12: Outbound Calling Rules . . . . . . . . . . . . . . . . . . . . . .47
Figure 13: New Calling Rule . . . . . . . . . . . . . . . . . . . . . . . . . . .48
Figure 14: Create New Dial Plan . . . . . . . . . . . . . . . . . . . . . . . .51
Figure 15: User Extensions . . . . . . . . . . . . . . . . . . . . . . . . . . . .52
Figure 16: Create New User . . . . . . . . . . . . . . . . . . . . . . . . . . .53
Figure 17: New Ring Group . . . . . . . . . . . . . . . . . . . . . . . . . . . .58
Figure 18: Music on Hold . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .60
Figure 19: New Call Queue . . . . . . . . . . . . . . . . . . . . . . . . . . . .62
Figure 20: Default Voice Menu . . . . . . . . . . . . . . . . . . . . . . . . .67
Figure 21: Record Menu Prompts . . . . . . . . . . . . . . . . . . . . . . .73
Figure 22: New Time Interval . . . . . . . . . . . . . . . . . . . . . . . . . . .74
Figure 23: Incoming Calling Rules . . . . . . . . . . . . . . . . . . . . . . .76
Figure 24: Incoming Calling Rules . . . . . . . . . . . . . . . . . . . . . . .77
Figure 25: Voicemail . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .79
Figure 26: New Conference Bridge . . . . . . . . . . . . . . . . . . . . . .83
Figure 27: Directory Settings . . . . . . . . . . . . . . . . . . . . . . . . . . .86
Figure 28: Call Parking Preferences . . . . . . . . . . . . . . . . . . . . .87

Release 1.20 Digium, Inc. Page 13
List of Figures
Figure 29: New Voicemail Group . . . . . . . . . . . . . . . . . . . . . . . .89
Figure 30: System Information . . . . . . . . . . . . . . . . . . . . . . . . . .90
Figure 31: Networking . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .91
Figure 32: Backup Page . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .94
Figure 33: Update . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .95
Figure 34: AA50 Options . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .96
Figure A-1: Back Panel Ports . . . . . . . . . . . . . . . . . . . . . . . . . .101

Release 1.20 Digium, Inc. Page 14
List of Tables
Table A-1: CRAFT Port Pinout . . . . . . . . . . . . . . . . . . . . . . . . .102
Table A-2: RJ11 Analog Port Connector. . . . . . . . . . . . . . . . . .103
Table A-3: LAN & WAN Ethernet Port Pinouts . . . . . . . . . . . . .104
Table B-4: Maximum 12V Power Consumption . . . . . . . . . . . .106

Release 1.20 Digium, Inc. Page 15
Chapter 1
Overview
The Digium®Asterisk Appliance 50 (AA50) is a stand alone PBX which
runs Embedded Asterisk Business Edition™. It is suitable for the desktop,
or mounting in a typical network closet or restricted access location. The
AA50 is ideal for small office environments or as an extension to a central
Asterisk PBX.
The AA50 can function not only as a PBX, but also as a voice mail server,
IVR server, conferencing server, VoIP ATA, or VoIP gateway. It has up to
eight analog ports which are configured as FXO or FXS ports depending
upon the product model. Additionally, the built in four port switch and
WAN port allow it to also serve as a basic router.
The AsteriskGUI™ is the interface for the AA50. It gives you the ability
to configure the basic hardware and dial plan elements you need when
initially setting up your system, as well as every element needed to
customize your setup. You must create trunks, system users,
conferencing, voice mail, etc. The AsteriskGUI supports the following
browsers:
Firefox 1.5 through 3.0
IE 7
Safari 3.x
Opera 9.x

Release 1.20 Digium, Inc. Page 16
Chapter 1: Overview
Features:
Embedded Asterisk Business Edition™
AsteriskGUI™
Four port 10/100BaseT Ethernet switch with Auto-MDI/MDI-X capa-
bility for the four 10/100BaseT LAN ports and one
10/100baseT WAN port (both 802.3/802.3u)
Up to eight analog ports supporting either FXS or FXO lines depend-
ing on product version
SIP and IAX2 VoIP protocols
CompactFlash interface (Type 1) suitable for standard CompactFlash
cards
Configuration reset switch
High performance Analog Devices Incorporated (ADI) BlackFin
BF537 processor
uClinux Operating System
Transcoding provided on the Blackfin processor
32ms (Hardware Revision B) or 128ms (Hardware Revision C) of ana-
log port echo cancellation
8MB on board serial Flash memory
64MB 16 bit parallel SDRAM
Front panel LEDs

Release 1.20 Digium, Inc. Page 17
Chapter 2
Unit Installation
This chapter provides the following information:
Unpacking the Unit on page 18
Inspecting Your Shipment on page 18
Identifying Communication Ports on page 19
Understanding the LEDs on page 19
Using the Configuration Reset Switch on page 23
Installing the AA50 on page 24
Mounting the Asterisk Appliance 50 on page 26
Figure 1: The Asterisk Appliance 50 (AA50)

Release 1.20 Digium, Inc. Page 18
Chapter 2: Unit Installation
Unpacking the Unit
When you unpack your unit, carefully inspect it for any damage that may
have occurred during shipment. If damage is suspected, file a claim with
the carrier and contact your reseller from which the unit was purchased or
Digium Technical Support (+1.256.428.6161). Keep the original shipping
container to use for future shipment or proof of damage during shipment.
Note: Only qualified service personnel should install the unit. Users
should not attempt to perform this function themselves.
Inspecting Your Shipment
The following items are included in shipment of the Asterisk Appliance
50:
Asterisk Appliance 50 (AA50)
Compact Flash Card
Power Supply
Power Cable
Analog Cables (optional depending on model)
CD-ROM containing manual and installation files
Product Registration Card
Support and Warranty Information

Release 1.20 Digium, Inc. Page 19
Chapter 2: Unit Installation
Identifying Communication Ports
The Asterisk Appliance 50 unit consists of up to eight RJ11 analog ports
which are configured as FXO or FXS ports depending on the Asterisk
Appliance 50 model. These ports provide 32ms (Hardware Revisions B)
or 128ms (Hardware Revisions C) of analog port echo cancellation. The
unit is rated for a total of 8 REN across all FXS ports. Each individual
port is rated for up to 3 REN @ 1500ft (450m).
Four 10/100BaseT LAN ports and one 10/100BaseT WAN port provide
the functionality to connect to the local network as well as allowing the
Asterisk Appliance 50 to act as a router. All the Ethernet ports support
auto-MDI-X.
See Figure 2 on page 22 to locate the ports and their corresponding LEDs.
Understanding the LEDs
There are 15 LEDs on the front panel of the Asterisk Appliance 50. The
eight LEDs corresponding to the analog ports on the rear panel indicate
the type of interface installed. The definition of each LED and its color
representation is explained in Table 1.

Release 1.20 Digium, Inc. Page 20
Chapter 2: Unit Installation
Table 1: LED Definitions
LED Color Description
Power Blue
(pulsing) On when the unit boots up, after the
bootload process has completed. The LED
pulses at a rate which is proportional to the
processor load.
Compact
Flash Blue
(flashing) Flashes each time there is read or write
activity to or from the CompactFlash card.
WAN Off No line is connected or the interface is
inactive.
Green
(flashing) Link is up at 100Mbps. LED flashes at 1/
10 second intervals as traffic is detected.
Orange
(flashing) Link is up at 10Mbps. LED flashes at 1/10
second intervals as traffic is detected.
LAN
(4 ports) Off No line is connected or the interface is
inactive.
Green
(flashing) Link is up at 100Mbps. LED flashes at 1/
10 second intervals as traffic is detected.
Orange
(flashing) Link is up at 10Mbps. LED flashes at 1/10
second intervals as traffic is detected.
Other manuals for Asterisk Appliance 50 AA50
1
This manual suits for next models
2
Table of contents
Other Digium PBX manuals