Asterisk Administrator Guide

Total Page:16

File Type:pdf, Size:1020Kb

Asterisk Administrator Guide Asterisk Administrator Guide Asterisk Development Team <[email protected]> 1. About the Project . 5 1.1 A Brief History of the Asterisk Project . 6 1.2 Asterisk as a Swiss Army Knife of Telephony . 7 1.3 Asterisk Versions . 8 1.4 License Information . 10 1.4.1 Voice Prompts and Music on Hold License . 12 2. Getting Started . 13 2.1 Beginning Asterisk . 14 2.2 Installing Asterisk . 16 2.2.1 Installing AsteriskNOW . 17 2.2.2 Upgrading AsteriskNOW . 23 2.2.3 Installing Asterisk From Source . 26 2.2.4 Alternate Install Methods . 51 2.2.5 Installing Asterisk on Non-Linux Operating Systems . 60 2.3 Hello World . 63 3. Operation . 67 3.1 System Requirements . 68 3.1.1 Compiler . 69 3.1.2 System Libraries . 70 3.2 Running Asterisk . 71 3.2.1 Stopping and Restarting Asterisk From The CLI . 74 3.3 Maintenance and Upgrades . 75 3.3.1 Asterisk Backups . 76 3.3.2 Updating or Upgrading Asterisk . 77 3.4 Logging . 79 3.4.1 Basic Logging Commands . 80 3.4.2 Basic Logging Start-up Options . 81 3.4.3 Call Identifier Logging . 82 3.4.4 Collecting Debug Information . 83 3.4.5 Queue Logs . 85 3.4.6 Verbosity in Core and Remote Consoles . 87 3.5 Asterisk Command Line Interface . 88 3.5.1 Connecting to the Asterisk CLI . 89 3.5.2 CLI Syntax and Help Commands . 90 3.5.3 Creating and Manipulating Channels from the CLI . 92 3.5.4 Simple CLI Tricks . 94 3.6 Asterisk Audio and Video Capabilities . 95 4. Fundamentals . 99 4.1 Asterisk Architecture . 100 4.1.1 Asterisk Architecture, The Big Picture . 101 4.1.2 Types of Asterisk Modules . 103 4.2 Directory and File Structure . 113 4.3 Asterisk Configuration . ..
Recommended publications
  • Skype for Asterisk™ Administrator Manual
    Skype for Asterisk™ Administrator Manual 601-00017 Rev. B2 Digium, Inc. 445 Jan Davis Drive NW 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.asterisk.org www.digium.com www.asterisknow.org © Digium®, Inc. 2010 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 that may not be covered by this documentation. The manufacturer’s liability for any errors in the documents 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. Asterisk, Digium, Switchvox, and AsteriskNOW are registered trademarks and Asterisk Business Edition, AsteriskGUI, and Asterisk Appliance are trademarks of Digium, Inc. Any other trademarks mentioned in the document are the property of their respective owners. Digium, Inc. Page 2 TABLE OF CONTENTS Chapter 1: Overview.................................................................................................................6
    [Show full text]
  • Edit Bibliographic Records
    OCLC Connexion Browser Guides Edit Bibliographic Records Last updated: May 2014 6565 Kilgour Place, Dublin, OH 43017-3395 www.oclc.org Revision History Date Section title Description of changes May 2014 All Updated information on how to open the diacritic window. The shortcut key is no longer available. May 2006 1. Edit record: basics Minor updates. 5. Insert diacritics Revised to update list of bar syntax character codes to reflect and special changes in character names and to add newly supported characters characters. November 2006 1. Edit record: basics Minor updates. 2. Editing Added information on guided editing for fields 541 and 583, techniques, template commonly used when cataloging archival materials. view December 2006 1. Edit record: basics Updated to add information about display of WorldCat records that contain non-Latin scripts.. May 2007 4. Validate record Revised to document change in default validation level from None to Structure. February 2012 2 Editing techniques, Series added entry fields 800, 810, 811, 830 can now be used to template view insert data from a “cited” record for a related series item. Removed “and DDC” from Control All commands. DDC numbers are no longer controlled in Connexion. April 2012 2. Editing New section on how to use the prototype OCLC Classify service. techniques, template view September 2012 All Removed all references to Pathfinder. February 2013 All Removed all references to Heritage Printed Book. April 2013 All Removed all references to Chinese Name Authority © 2014 OCLC Online Computer Library Center, Inc. 6565 Kilgour Place Dublin, OH 43017-3395 USA The following OCLC product, service and business names are trademarks or service marks of OCLC, Inc.: CatExpress, Connexion, DDC, Dewey, Dewey Decimal Classification, OCLC, WorldCat, WorldCat Resource Sharing and “The world’s libraries.
    [Show full text]
  • Sangoma T116 16-Span T1/E1/J1 Tapping Board
    Sangoma T116 16-Span T1/E1/J1 Tapping Board Dedicated tapping solution for up to 8 two-way connections or 16 one-way connections. The T116 Tapping Card is part of Sangoma’s family of Advanced Flexible Telecommunications hardware product line — it uses the same high-performance PCI Express interface that is providing superior performance in critical systems all over the world. The T116 supports the passive tapping of up to 240 voice calls using up to 16 T1, E1 or J1 spans. With Sangoma cards, you can take advantage of hardware and software improvements, as soon as they become available. The T116, like all cards in Sangoma’s AFT family, is eld upgradable with unbreakable rmware. Choose the T116 to collect call control information, telecom protocol information and voice/media. T116 Card Features Sixteen receive-only spans with Supports Robbed Bit Channel optimum PCI-Express interface Associated Signaling (CAS) and ISDN enables tapping of sixteen one-way PRI or eight two-way conversation T1/E1 and fractional T1/E1, multiple Support for Asterisk®, Yate®, and channel HDLC per line for mixed 5 Year warranty on parts and labor FreeSWITCH® PBX/IVR Projects, as data/TDM voice applications well as other open source and Supports the passive tapping of up proprietary PBX, Switch, IVR, or VoIP WANPIPE® routing stack is to 240 voice calls using up to 16 gateway applications completely independent of TDM T1, E1 or J1 spans voice application for total system Optimized per channel DMA streams reliability and hardware-level HDLC handling Field
    [Show full text]
  • Voip Tutorial
    VoIP and FreeBSD The daemon meets the phone May 15th, 2008 University of Ottawa, , Ottawa, Canada Massimiliano Stucchi [email protected] May 16th, 2007, Agenda • Introduction • Terms • Introduction to Asterisk key concepts • Let's connect to a provider • What's a dialplan ? • How cool is an IVR... • (if time permits) AGI overview 2 Who am I ? • First of all, good morning • I’m Max, nice to meet you all • I worked on VoIP and FreeBSD for the last 3,5 years implementing technologies for businesses large and small • I’m now working at BrianTel Srl, delivering voice services over geographical Wi-Fi Networks (more on this @ other talk) Why am I doing this ? • VoIP is business, but you have to know how to deal with it (and have right equipment) • It's not rocket science, but it's a totally different environment for computer professionals • I have some deal of experience • I don't feel the need to keep others from doing what I do 1000's miles away • It's fun ! Let’s start • A few questions to let me understand the level of knowledge of the class • If you have any question further on, raise your hand at any time any time TERMS Terms 1/5 • Direct Inward Dial • It's a real PSTN number which lets the call into your VoIP system. • Normally works on a PRI DID • It's normally intended as a phone number • Can be bought from many different providers and forwarded to your asterisk box via any provider Terms 2/5 • Voice Circuit (may carry data as well) • Can carry either 24 (T1) or 30 (E1) b- channels (audio) and 1 d-channel (for data communication across peers).
    [Show full text]
  • 14 * (Asterisk), 169 \ (Backslash) in Smb.Conf File, 85
    ,sambaIX.fm.28352 Page 385 Friday, November 19, 1999 3:40 PM Index <> (angled brackets), 14 archive files, 137 * (asterisk), 169 authentication, 19, 164–171 \ (backslash) in smb.conf file, 85 mechanisms for, 35 \\ (backslashes, two) in directories, 5 NT domain, 170 : (colon), 6 share-level option for, 192 \ (continuation character), 85 auto services option, 124 . (dot), 128, 134 automounter, support for, 35 # (hash mark), 85 awk script, 176 % (percent sign), 86 . (period), 128 B ? (question mark), 135 backup browsers ; (semicolon), 85 local master browser, 22 / (slash character), 129, 134–135 per local master browser, 23 / (slash) in shares, 116 maximum number per workgroup, 22 _ (underscore) 116 backup domain controllers (BDCs), 20 * wildcard, 177 backups, with smbtar program, 245–248 backwards compatibility elections and, 23 for filenames, 143 A Windows domains and, 20 access-control options (shares), 160–162 base directory, 40 accessing Samba server, 61 .BAT scripts, 192 accounts, 51–53 BDCs (backup domain controllers), 20 active connections, option for, 244 binary vs. source files, 32 addresses, networking option for, 106 bind interfaces only option, 106 addtosmbpass executable, 176 bindings, 71 admin users option, 161 Bindings tab, 60 AFS files, support for, 35 blocking locks option, 152 aliases b-node, 13 multiple, 29 boolean type, 90 for NetBIOS names, 107 bottlenecks, 320–328 alid users option, 161 reducing, 321–326 announce as option, 123 types of, 320 announce version option, 123 broadcast addresses, troubleshooting, 289 API
    [Show full text]
  • Legacy Character Sets & Encodings
    Legacy & Not-So-Legacy Character Sets & Encodings Ken Lunde CJKV Type Development Adobe Systems Incorporated bc ftp://ftp.oreilly.com/pub/examples/nutshell/cjkv/unicode/iuc15-tb1-slides.pdf Tutorial Overview dc • What is a character set? What is an encoding? • How are character sets and encodings different? • Legacy character sets. • Non-legacy character sets. • Legacy encodings. • How does Unicode fit it? • Code conversion issues. • Disclaimer: The focus of this tutorial is primarily on Asian (CJKV) issues, which tend to be complex from a character set and encoding standpoint. 15th International Unicode Conference Copyright © 1999 Adobe Systems Incorporated Terminology & Abbreviations dc • GB (China) — Stands for “Guo Biao” (国标 guóbiâo ). — Short for “Guojia Biaozhun” (国家标准 guójiâ biâozhün). — Means “National Standard.” • GB/T (China) — “T” stands for “Tui” (推 tuî ). — Short for “Tuijian” (推荐 tuîjiàn ). — “T” means “Recommended.” • CNS (Taiwan) — 中國國家標準 ( zhôngguó guójiâ biâozhün) in Chinese. — Abbreviation for “Chinese National Standard.” 15th International Unicode Conference Copyright © 1999 Adobe Systems Incorporated Terminology & Abbreviations (Cont’d) dc • GCCS (Hong Kong) — Abbreviation for “Government Chinese Character Set.” • JIS (Japan) — 日本工業規格 ( nihon kôgyô kikaku) in Japanese. — Abbreviation for “Japanese Industrial Standard.” — 〄 • KS (Korea) — 한국 공업 규격 (韓國工業規格 hangug gongeob gyugyeog) in Korean. — Abbreviation for “Korean Standard.” — ㉿ — Designation change from “C” to “X” on August 20, 1997. 15th International Unicode Conference Copyright © 1999 Adobe Systems Incorporated Terminology & Abbreviations (Cont’d) dc • TCVN (Vietnam) — Tiu Chun Vit Nam in Vietnamese. — Means “Vietnamese Standard.” • CJKV — Chinese, Japanese, Korean, and Vietnamese. 15th International Unicode Conference Copyright © 1999 Adobe Systems Incorporated What Is A Character Set? dc • A collection of characters that are intended to be used together to create meaningful text.
    [Show full text]
  • The Luacode Package
    The luacode package Manuel Pégourié-Gonnard <[email protected]> v1.2a 2012/01/23 Abstract Executing Lua code from within TEX with \directlua can sometimes be tricky: there is no easy way to use the percent character, counting backslashes may be hard, and Lua comments don’t work the way you expect. This package provides the \luaexec command and the luacode(*) environments to help with these problems, as well as helper macros and a debugging mode. Contents 1 Documentation1 1.1 Lua code in LATEX...................................1 1.2 Helper macros......................................3 1.3 Debugging........................................3 2 Implementation3 2.1 Preliminaries......................................4 2.2 Internal code......................................5 2.3 Public macros and environments...........................7 3 Test file 8 1 Documentation 1.1 Lua code in LATEX For an introduction to the most important gotchas of \directlua, see lualatex-doc.pdf. Before presenting the tools in this package, let me insist that the best way to manage a non- trivial piece of Lua code is probably to use an external file and source it from Lua, as explained in the cited document. \luadirect First, the exact syntax of \directlua has changed along version of LuaTEX, so this package provides a \luadirect command which is an exact synonym of \directlua except that it doesn’t have the funny, changing parts of its syntax, and benefits from the debugging facilities described below (1.3).1 The problems with \directlua (or \luadirect) are mainly with TEX special characters. Actually, things are not that bad, since most special characters do work, namely: _, ^, &, $, {, }. Three are a bit tricky but they can be managed with \string: \, # and ~.
    [Show full text]
  • Freepbx-Distro-6.12.65
    FreePBX-Distro-6.12.65 About FreePBX Distro and AsteriskNOW-6.12.65 Stable Releases Below is an outline of this version: FreePBX 12 SHMZ OS 6.5 (Derived from CentOS) Asterisk 11 or 13 DAHDI 2.10 System Impact The upgrade procedures outlined below will stop Asterisk and may also require a system reboot to fully apply. Perform the system upgrade using a scheduled maintenance window. Release Notes Click here to view the Release Notes for 6.12.65. This page contains release notes for all of the versions listed below. Upgrade Scripts Upgrade Scripts Below is a list of shell upgrade scripts officially released to update an existing FreePBX Distro 6.12.65 system to a specific minor release version. The scripts will update the entire distribution, including all FreePBX web components and all OS-level components (such as the kernel and kernel modules). All upgrades need to be installed in numeric ascending order. Do not skip any available upgrade step. Upgrade scripts are not cumulative. Each upgrade script should be run in ascending order to get to the desired final version. The upgrade path is one-way. These scripts cannot be used to downgrade the version of FreePBX Distro to an earlier version. The only way to reverse the effects of the upgrade procedure is to restore the system from a backup. FreePBX Distro 6.12.65-1 (No Upgrade script, as this is the initial release version of this track.) FreePBX Distro 6.12.65-2 https://upgrades.freepbxdistro.org/stable/6.12.65/upgrade-6.12.65-2.sh FreePBX Distro 6.12.65-3 https://upgrades.freepbxdistro.org/stable/6.12.65/upgrade-6.12.65-3.sh
    [Show full text]
  • Asterisk Record Codec
    Asterisk record codec Record(filename:format[|silence][|maxduration][|option]) video portion of the recording is automatically set to the active video codec (Asterisk. Asterisk CodecsAsterisk supports the following narrow-band and kHz wideband codec; passthrough, playback and recording in Asterisk ;. ord A Call NativelyDescriptionMixMonitor. Current Documentation Record A Call Natively. Asterisk has issue regarding video codec negotiation; Advanced When you record a message to a voicemail, Asterisk records video too. As a part of the Media Overhaul project for Asterisk 10, changes have been made to Asterisk to increase the number of codecs it's capable of. Hi all, i'm trying to record a video call between two SIP client using ast_translator_build_path: No translator path: (ending codec is not valid). However if you playback something and recording is not in.g you need codec. If you use uncompressed stream(other codec or pstn/e1. Digium's implementation of the G codec allows Asterisk software to of Asterisk such as Call Conferences, DTMF digit collection, Call Recording and more. Asterisk is going to expect that all audio conforms to this standard. There are a lot of codecs that are used to compress the audio, the most common being ULAW. Also, this paves the way for other codecs under the G umbrella. Added support for recording of Asterisk voice calls (TDM and IP) using Xorcoms Asterisk. In the early days I used asterisk to record the prompts. It's not bad but you're limited by the quality of your phone and the codec you use. Asterisk can forward video with compressed H, but it can't act as a gateway to The standard video codecs can play recorded movies, clips, or other.
    [Show full text]
  • List of Approved Special Characters
    List of Approved Special Characters The following list represents the Graduate Division's approved character list for display of dissertation titles in the Hooding Booklet. Please note these characters will not display when your dissertation is published on ProQuest's site. To insert a special character, simply hold the ALT key on your keyboard and enter in the corresponding code. This is only for entering in a special character for your title or your name. The abstract section has different requirements. See abstract for more details. Special Character Alt+ Description 0032 Space ! 0033 Exclamation mark '" 0034 Double quotes (or speech marks) # 0035 Number $ 0036 Dollar % 0037 Procenttecken & 0038 Ampersand '' 0039 Single quote ( 0040 Open parenthesis (or open bracket) ) 0041 Close parenthesis (or close bracket) * 0042 Asterisk + 0043 Plus , 0044 Comma ‐ 0045 Hyphen . 0046 Period, dot or full stop / 0047 Slash or divide 0 0048 Zero 1 0049 One 2 0050 Two 3 0051 Three 4 0052 Four 5 0053 Five 6 0054 Six 7 0055 Seven 8 0056 Eight 9 0057 Nine : 0058 Colon ; 0059 Semicolon < 0060 Less than (or open angled bracket) = 0061 Equals > 0062 Greater than (or close angled bracket) ? 0063 Question mark @ 0064 At symbol A 0065 Uppercase A B 0066 Uppercase B C 0067 Uppercase C D 0068 Uppercase D E 0069 Uppercase E List of Approved Special Characters F 0070 Uppercase F G 0071 Uppercase G H 0072 Uppercase H I 0073 Uppercase I J 0074 Uppercase J K 0075 Uppercase K L 0076 Uppercase L M 0077 Uppercase M N 0078 Uppercase N O 0079 Uppercase O P 0080 Uppercase
    [Show full text]
  • Beginner's Guide to Asterisk
    Getting Started With Open Source Telephony A Beginners Guide to Asterisk Steve Sokol Asterisk Marketing Lead, Digium Justin Hester Lead Asterisk Technical Instructor, Digium Agenda • Summary of Asterisk • Basics and Distributions • Resources • Asterisk is a toolkit • Distros are more complete • Training classes package with GUI • Digium and Asterisk • Getting started using Asterisk • AstriCon 2016 • Architecture - Linux + Asterisk • Difference between CLI and GUI • Versioning Getting Started with Asterisk Getting Started with Asterisk • Find it • Install it • Configure it What is Asterisk? An Open Source Communications Platform • Software, written in C, that you put on an ordinary operating system—transforming that system into a communications engine. Software – A communications platform A system through which communications flow, from one endpoint to another. What is Asterisk - Platform Open Source Communications Platform Software - Extensible Architecture A simple core with only a few responsibilities Module Management Reading Configuration CORE System Timing CORE Channel Management Software – Modular Architecture Modules app_dial.so • Use the native modules • Use Asterisk’s APIs to control and extend Asterisk – AMI, AGI, and ARI Preparing for Asterisk – Set up a host machine • Old physical hardware – Laptop, rackmount or tower system • Virtual machine – e.g. VirtualBox (on your Mac, Windows or Linux laptop!) www.virtualbox.org • Cloud server – e.g. www.digitalocean.com or aws.amazon.com Finding Asterisk – Choose your path ‘Source’ or ‘Plain Vanilla’ AsteriskNOW, a PBX ‘distro’. www.asterisk.org/downloads Choosing Asterisk - Source • Install a Linux operating system • Set up networking • Configure software repositories • Install Asterisk dependencies • Download and install Asterisk, DAHDI, LibPRI from provided scripts. And you will have an unconfigured, pristine, ready to configure “Asterisk Configuration Framework”.
    [Show full text]
  • Integration of Asterisk IP-PBX with ESP32 Embedded System for Remote Code Execution †
    Proceedings Integration of Asterisk IP-PBX with ESP32 Embedded System for Remote Code Execution † Juan Pablo Berrío López 1,* and Yury Montoya Pérez 2 1 Facultad de Ingeniería, Diseño e Innovación (FIDI), Institución Universitaria Politécnico Grancolombiano, 050034 Medellín, Colombia 2 Facultad de Ciencias Básicas e Ingeniería, Corporación Universitaria Remington, 050012 Medellín, Colombia * Correspondence: [email protected]; Tel.: +57-304-439-7353 † Presented at the 2nd XoveTIC Congress, A Coruña, Spain, 5–6 September 2019. Published: 5 August 2019 Abstract: This paper explains the design and construction of a platform that implements the ESP32 embedded system and connects it to a telephone asterisk plant, to exchange data on both sides, commands sent from a telephone to the esp32 and make calls from an order of sending from a digital input of esp32. It is a low-cost device that can be implemented through the use of Wi-Fi, and as a use in the industry, it has a role in analogue communication in buildings, for example. Keywords: sensors; wireless fidelity; internet of things; microcontrollers; ESP32; embedded systems 1. Introduction Internet of Things is a concept based on the connection of electronic devices with each other or through the Internet, which has been generating expectation for years as it is expected to be a great driver of digital transformation in homes and cities, as well as in companies. IP telephony has taken a central role in the information highway so that the network can interconnect each home and each business through a packet switching network [1,2]. In this work, the Asterisk pbx was used based on the Issabel Linux distribution, which allowed to create dial plans to receive calls from the users and through an IVR to make a POST request to the ESP32 platform, which within its code has established methods that for investigation, allowed to move a servo motor and turn on led lights.
    [Show full text]