Установка Астериска

Для установки Астериска понадобится компьютер, сервер или виртуальная машина. В качестве операционной системы почти всегда используется Linux. Мы установим Астериск на виртуальную машину с ОС Debian 9.

Установка Debian

Установку сервера VMware и создание виртуальной машины здесь рассматривать не будем. Будем считать, что виртуальная машина для Астериска уже создана.

Подключение диска с дистрибутивом Debian к виртуальной машине

Дистрибутив (файл с расширением .iso) нужно заранее скачать с официального сайта Debian. На момент написания этой инструкции текущую версию дистрибутива можно было скачать отсюда.

Скачанный файл (например, debian-9.7.0-amd64-netinst.iso) положить на сервер VMware (например, в папку имя_сервера\iso)

Открыть в браузере vSphere Client, в дереве слева выбрать виртуальную машину, предназначенную для установки Астериска.

Подключить диск с дистрибутивом Debian:

Actions ➔ Edit Settings ➔ CD/DVD drive 1 ➔ Datastore ISO File

выбрать образ диска с дистрибутивом Debian, например, файл debian-9.7.0-amd64-netinst.iso, который заранее был скопирован в папку имя_сервера\iso, и нажать OK.

поставить галочку в Connect At Power On, нажать OK.

Перезагрузить виртуальную машину:

Actions ➔ Power ➔ Reset

Виртуальная машина перезагрузится, и начнется установка Debian.

Для выполнения дальнейших действий на виртуальной машине нужно открыть её консоль. Для этого щелкнуть по изображению с «экраном» виртуальной машины — консоль откроется в новой вкладке (или окне) браузера. Для удобства можно открыть консоль в отдельном приложении, для этого нужно щелкнуть по ссылке «Launch Remote Console» под изображением с «экраном» виртуальной машины. Приложение «Консоль» должно быть установлено на компьютере, скачать и установить его можно по ссылке «Download Remote Console» (понадобится аккаунт на сайте VMware.com — если аккаунта нет, то нужно его создать, это бесплатно).

Установка Debian с дистрибутива

На все вопросы по установке выбирать ответ по умолчанию, кроме шагов, описанных ниже.

Разделы диска

Единственного правильного решения нет. Например, можно сделать так: диск размером чуть больше 200Gb разбить на два раздела: по 100 Gb на / и на /var. Остальное на файл подкачки (SWAP).

Рекомендация из книги «Астериск - будущее телефонии»: выделить 500MB на /, остальное на /var, т.к. этот раздел будет заполняться различными данными, логами и т.д. и может переполниться. Поэтому нужно, чтобы раздел /var был смонтирован отдельно, тогда при его переполнении виртуальная машина продолжит работать, можно будет подключиться к ней и освободить место, удалив ненужные файлы. Но практика показывает, что 500MB для / недостаточно. Реальное же заполнение разделов можно будет узнать лишь со временем командами:

lsblk   — разметка диска на разделы

df -h   — место, занимаемое разделами

du -sh   — размер текущей папки

du --max-depth=1 -h   — размер текущей папки и всех папок, вложенных в текущую (с заданной глубиной вложенности). Если в выводе команды будут сообщения «Отказано в доступе», можно перед командой добавить sudo («superuser do» — т.е. выполнить команду от имени root)

Выбор пакетов и режима обновления

— автоматическое обновление не включать (No automatic updates);

— при установке выбрать только OpenSSH, от других пакетов отказаться.

Имя компьютера и домена, логины и пароли

Указать имя машины, имя домена, пароль для пользователя root.

Также указать логин и пароль для другого пользователя (например, asteriskpbx) — в целях безопасности в дальнейшем рекомендуется работать именно под этим пользователем, а не под root.

Выбрать зеркало архива Debian (например, mirror.yandex.ru). При получении настроек сети по DHCP, если выхода в интернет не будет, то значение этого параметра неважно, т.к. установщик всё равно не сможет подключиться к архиву.

Настройка сетевого интерфейса

Открыть на редактирование файл interfaces (например, с помощью редактора «nano»):

nano /etc/network/interfaces

Пример конфигурации сетевого интерфейса:

auto ens160
iface ens160 inet static
address 192.168.1.30
netmask 255.255.255.0
gateway 192.168.1.1
dns-nameservers 192.168.1.10 192.168.1.11

После редактирования сохранить файл и перезагрузить виртуальную машину:

reboot

Посмотреть текущие адреса сетевых интерфейсов можно так:

ip addr

Добавление маршрутов в другие IP-сети (если нужно)

Добавить маршрут вручную (будет действовать до перезагрузки):

sudo ip route add 192.168.200.0/24 via 192.168.1.3

Добавление постоянных статических маршрутов:

открыть файл interfaces:

sudo nano /etc/network/interfaces

добавить в описание нужного интерфейса следующие строки:

# Route to another network
up /sbin/ip route add 192.168.200.0/24 via 192.168.1.3
down /sbin/ip route del 192.168.200.0/24 via 192.168.1.3

сохранить файл, перезагрузить сеть:

sudo service networking restart

в случае отсутствия ошибок не будет никаких сообщений.

Проверить действующие маршруты:

ip route

ping 192.168.200.15   — пропинговать какой-нибудь адрес, находящийся в сети, в которую добавлен маршрут.

Настройка репозиториев

Чтобы можно было устанавливать компоненты с помощью команды apt-get, нужно добавить в список репозиториев строки и параметры:

nano /etc/apt/sources.list

Пример списка репозиториев:

deb http://deb.debian.org/debian/ stretch main contrib non-free
deb-src http://deb.debian.org/debian/ stretch main contrib non-free

deb http://deb.debian.org/debian/ stretch-updates main contrib non-free
deb-src http://deb.debian.org/debian/ stretch-updates main contrib non-free

deb http://security.debian.org/debian-security/ stretch/updates main contrib non-free
deb-src http://security.debian.org/debian-security/ stretch/updates main contrib non-free

Отредактировать файл. Для редактирования в nano можно использовать горячие клавиши: F9 — вырезать строку в буфер, F10 — вставить из буфера

Сохранить файл, затем обновить список пакетов, обновить сам дистрибутив и перезагрузиться:

apt-get update
apt-get upgrade
reboot

Установка sudo и ssh

apt-get install sudo ssh

Разрешить пользователю asteriskpbx выполнять команду sudo:

visudo

после строки «root ALL=(ALL:ALL) ALL» добавить строку для asteriskpbx:

asteriskpbx	ALL=(ALL:ALL) ALL

Сохранить файл (Ctrl+O), закрыть nano (Ctrl+X)

После этого можно закрыть консоль и подключиться к серверу по ssh (например, через PuTTY) пользователем asteriskpbx — так гораздо удобнее, т.к. можно копировать и вставлять команды и другой текст..

Все команды, требующие прав root, теперь может выполнять пользователь asteriskpbx, добавив перед ними sudo. На вопрос «[sudo] пароль для asteriskpbx:» нужно вводить пароль пользователя asteriskpbx, а не root.

Установка пакетов для Астериска

Установить пакеты, необходимые для установки Астериска:

sudo apt-get install ntp mc
sudo apt-get install build-essential subversion libncurses5-dev libssl-dev libxml2-dev libsqlite3-dev uuid-dev vim-nox
sudo apt-get install linux-headers-$(uname -r)

( uname -r выдаст версию ядра ОС (например, «4.9.0-8-amd64»), $(...) подставит значение в команду, получится: sudo apt-get install linux-headers-4.9.0-8-amd64 )

sudo apt-get install autoconf pkg-config libtool
sudo apt-get install libedit-dev libjansson-dev

Установка LibPRI (если есть ISDN)

Скачать устанавливаемую версию LibPRI можно с сайта downloads.asterisk.org (скачать файл, открыть каталог).

cd ~/src/asterisk-complete/
mkdir libpri
cd libpri/
tar xvzf libpri-current.tar.gz
cd libpri-1.6.0/
make
sudo make install

Установка Астериска

Ниже будет рассмотрена установка 15-й версии Астериска. Подробнее о версиях можно прочитать на сайте asterisk.org.

Подготовка

Скачать устанавливаемую версию Астериска можно с сайта downloads.asterisk.org (скачать файл, открыть каталог).

Создать каталог для хранения дистрибутивов:

mkdir -p ~/src/asterisk-complete/asterisk

В созданный каталог (/home/asteriskpbx/src/asterisk-complete/asterisk) положить файл устанавливаемой версии Астериск asterisk-15-current.tar.gz (и другие файлы, если нужно).

Пример, когда нужны другие файлы: для астериска версии 16 нужна версия jansson не ниже 2.11, с последней же версией ОС (на момент установки) шла версия 2.9, т.е. команда sudo apt-get install jansson устанавливала версию 2.9 и считала её последней. Поэтому перед установкой Астериска версии 16 понадобилось скачать файл jansson-2.12.tar.gz, положить его в каталог для хранения дистрибутивов и установить:

cd ~/src/asterisk-complete/asterisk
tar xvzf jansson-2.12.tar.gz
cd jansson-2.12/
./configure
make
sudo make install

Установка

Установить Астериск:

cd ~/src/asterisk-complete/asterisk
tar xvzf asterisk-15-current.tar.gz
cd asterisk-15.*/
./configure
make
sudo make install
sudo make config

sudo make samples   — эту команду можно выполнять только на новом (только что установленом) астериске, т.к. она перезапишет все конфигурационные файлы!

Команда make компилирует код, make install перемещает откомпилированный код в правильное размещение в файловой системе, make config настраивает операционную систему для работы Asterisk как сервис, так чтобы она запускалась во время загрузки (устанавливает в автозапуск safe_asterisk), make samples устанавливает образцы конфигурационных файлов.

Изменить владельца и группу для указанных папок, чтобы они совпадали с пользователем (и группой), из-под которого производилась сборка:

sudo chown -R asteriskpbx:asteriskpbx /var/lib/asterisk/
sudo chown -R asteriskpbx:asteriskpbx /usr/lib/asterisk/
sudo chown -R asteriskpbx:asteriskpbx /var/spool/asterisk/
sudo chown -R asteriskpbx:asteriskpbx /var/log/asterisk/
sudo chown -R asteriskpbx:asteriskpbx /var/run/asterisk/
sudo chown -R asteriskpbx:asteriskpbx /etc/asterisk/

Если установлен DAHDI (для взаимодействия с платами Digium):

sudo nano /etc/udev/rules.d/dahdi.rules

заменить значения параметров OWNER и GROUP на указанные выше (указать пользователя и группу, под которыми будет работать asterisk):

SUBSYSTEM=="dahdi", OWNER="asteriskpbx", GROUP="asteriskpbx", MODE="0660"

В файле asterisk.conf раскомментировать параметры runuser и rungroup и заменить значения на указанные выше:

sed -i s/.*runuser.*/"runuser = asteriskpbx"/   /etc/asterisk/asterisk.conf
sed -i s/.*rungroup.*/"rungroup = asteriskpbx"/ /etc/asterisk/asterisk.conf

Настройка

Замена гудков на российские

Заменить гудки на российские: country=ru

sed -i s/.*country=us.*/country=ru/ /etc/asterisk/indications.conf

Проверка запуска Астериска в командной строке

/usr/sbin/asterisk -cvvv

Если после запуска появилось сообщение Asterisk Ready, значит астериск запущен, можно посмотреть, какие есть ошибки (ERROR).

*CLI> module show   — посмотреть, какие модули запущены;

*CLI> core stop now   — остановить астериск.

Если после запуска Астериска в логах /var/log/asterisk/messages проскакивают ошибки вида ERROR[27158] ari/config.c: No configured users for ARI, то необходимо отключить поддержку ARI в файле /etc/asterisk/ari.conf

enabled = no

и перезапустить модуль res_ari

asterisk -rx 'module reload res_ari'

Установка пакетов звуковых файлов с помощью menuselect

Установить menuselect:

sudo apt-get install libnewt-dev   — нужен для menuselect

cd ~/src/asterisk-complete/asterisk/asterisk-15.*/menuselect/
make clean
./configure
cd ..
make menuselect

Использование menuselect

cd ~/src/asterisk-complete/asterisk/asterisk-15.*/
make menuselect

откроется красно-синее меню menuselect

выбрать звуковые файлы своей страны: в разделах Core Sound Packages и Extra Sound Packages справа отметить нужные файлы — Enter-ом поставить звёздочки (*)

сохранить и выйти, затем установить выбранное:

sudo make install
sudo chown -R asteriskpbx:asteriskpbx /var/lib/asterisk/sounds/

Перезагрузить Астериск

sudo reboot

После перезагрузки проверить подключение к консоли Астериска (CLI — Command line interface):

/usr/sbin/asterisk -rvvvvv

После нескольких вводных строк появится приглашение *CLI> — установка Астериска завершена, можно переходить к конфигурации.