summaryrefslogtreecommitdiff
path: root/network/asterisk/README.SBo
blob: c9df08f3fb4cbe805f6d5bdde4f68aaaac6b48be (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
** IMPORTANT **
===============
As of version 16, Asterisk no longer supports an external PJSIP package.
If you are using PJSIP with Asterisk 13, you will need to remove the
pjsip package and use the pjsip libraries included as part of Asterisk
by setting the PJSIP flag to 'yes'.

Plugins
=======
Asterisk has a number of optional build dependencies.  If you intend to
use any analogue PSTN hardware such as a DigiumTDM400P or plan on
implementing a key system which uses the app_meetme conferencing plugin
you will need to install the dahdi-linux and dahdi-tools software and
drivers before compiling Asterisk. If you will instead use digital
telephony hardware (not IP phones) such as T1/E1 lines or a PRI, you'll
need to install libpri, again before compiling Asterisk.

Examples
========
Be sure to see /usr/doc/asterisk-16.0.0/sample_confs/ after
installation for any additional configuration files you may need.

Database Support
================
If you have plans of using Asterisk with a database backend you may
want to install the alembic package. Since version 12.0 the database
schemas that Asterisk uses are being captured in the form of python
script files that use alembic to create/update database schemas. The
asterisk package places these database scripts in the
/usr/doc/asterisk-16.0.0/ast-db-manage directory.

Build Flags
===========
This build script supports the following flags:

 * G711_NEW : [default = no]

   Set this flag to 'yes' if you would like to use the newer G711 codec
   code. This requires a more powerful machine than would be normally
   required.

 * JANSSON : [default = no]

   Set this flag to 'yes' if you would like to build the projects
   internal jansson libraries. The default for this option is 'no',
   which requires you to have jansson >= 2.11 installed on your system.
   Set this to 'yes' if you would like to ignore the system requirement
   and have Asterisk build an internal version of the library.

 * LANGUAGE : [default = EN]

   Set this flag to change the language used by Asterisk. This flag
   supports the following values: EN, EN_AU, EN_GB, EN_NX, ES, FR, IT,
   RU, JA, and SV.

 * MEETME : [default = no]

   Set this flag to 'yes' if you would like to build the app_meetme
   plugin. This plugin is required for key style systems and
   conferencing using meetme. This plugin requires the dahdi-linux
   package for timing purposes.

 * MOH : [default = no]

   Set this flag to 'yes' if you would like to include some royalty-free
   music on hold sound files with your installation. Setting this
   option will cause the build to download some sound files from the
   internet.

 * PJSIP : [default = no]

   Set this flag to 'yes' if you would like to build the projects
   internal pjsip libraries. Asterisk no longer supports an external
   system-wide install of pjsip. If you need pjsip support it is
   strongly recommended that you uninstall pjsip and use Asterisks
   internal pjsip library.

 * SOUNDS_EXTRA : [default = no]

   Set this flag to 'yes' if you would like to include the extra sound
   package with your installation. Setting this option will cause the
   build to download some sound files from the internet.

 * VM_ODBC : [default = no]

   Set this flag to 'yes' if you would like to store your voicemail
   messages in a database. This plugin requires the unixODBC package.
   This flag will override the VM_IMAP flag if both are set to 'yes'.
   You will probably want to install the alembic package to configure
   your database with the latest database schemas for Asterisk.

 * VM_IMAP : [default = no]

   Set this flag to 'yes' if you would like to store your voicemail
   messages on an IMAP server. This plugin requires the University of
   Washingtons IMAP server source. This flag will be overridden by the
   VM_ODBC flag if both are set to 'yes'.