Instruction.md

Инструкция по подготовке ВМ c Asterisk

В данной инструкции используется VirtualBox. Вы можете использовать любую среду виртуализации.

Подготовка

1. Скачайте *.ova файл виртуальной машины и запустите скаченный файл.

2. Соглашайтесь со всем, что предлагает Virtualbox. Далее в списке виртуальных машин появится Netology_ntw_10.04.

3. Перейдите в режим настройки виртуальной машины: «Настроить»->«Сеть»->«Сетевой мост»:

4. После выбора сетевой установки типа подключения «Сетевой мост» убедитесь, что в надстройке «имя» выбран интерфейс физической машины. На интерфейсе доступна сети «Интернет» и желательно ваш домашний роутер осуществляет выдачу DHCP.

5. Нажмите «ОК» и запустите виртуальную машину Asterisk_NTW_10-04. Вход осуществляем под пользователем root пароль 1234.

6. Убедитесь, что получили IPv4 адрес с домашнего роутера: для этого введите команду ip a

Нас интересует интерфейс №2 enp0s3, и его IPv4 адрес. В случае примера 192.168.3.47.

7. Если в вашей сети отсутствует раздача по DHCP, переходите к этапу 1.

Важно:

1. Наименование интерфейса enp0s3 может отличаться. После перезагрузки виртуальной машины IPv4 адрес может измениться, учитывайте это при дальнейшей настройке.
2. В данной виртуальной машине может быть не установлен пакет sudo. Можете установить, задав команду apt install sudo.

Этап 1

1. Для настройки статического адреса в Linux почти всегда используется файл, лежащий в директории /etc/network/interfaces . Откройте файл для редактирования (так как вы зашли под root, то не используйте sudo) nano/etc/network/interfaces .
   Должно получиться, как на скрине ниже:

Примечаение: описание по работе с редактором nano находится в последнем пунтке этой инструкции

2. После строки #The primary network interfaces удалите весь текст, но запомните название интерфейса enp0s3 (он должен быть одинаковым с интерфесом №2 вывода команды ip a) и записываем следующее

iface eth0 inet static      
address 192.168.1.15      
netmask 255.255.255.0      
gateway 192.168.1.1        
broadcast 192.168.0.255        
dns-nameservers 8.8.8.8  

Должно получится, как на скрине ниже:

Горячие клавиши: ctrl+o – сохранить файл, ctrl+x – закрыть и возвратиться в cli.

3. Дайте команду, на перезапуск сетевой службы:

systemctl restart networking

4. Командой ip a проверьте, что интерфейс №2 в состоянии UP. Eсли DOWN, даем команду ifup enp0s3.

5. Проверьте доступность Yandex ping ya.ru. Если пинги не пошли, смотрите и правьте конфигурацию файла resolv.conf, который отвечает за преобразование имен в семействе Linux.

nano /etc/resolv.conf

Допишите nameserver 8.8.8.8 .

6. Сохраните, закройте. На этом подготовка виртуальной машины для установки Asterisk закончена.

7. Для более удобной работы подключитесь к нашей ВМ по ssh:

• откройте putty,
• выберите ssh,
• впишите IPv4 адрес нашего второго интерфейса, в случае примера это 192.168.3.47.

• подключитесь и примите сертификат, нажав в на кнопку «Accept».

8. Так как подключение по ssh под пользователем root изначально запрещено, войдите на ВМ под учетной записью user пароль 1234.
   Далее войдите в пользователя root, так как sudo не установлен:

su root

Введите пароль root 1234.

9. Вернитесь в домашнюю директорию root (опционально, для удобства):

cd ~

Теперь вы можете перейти к Этапу 2 и приступить к скачиванию установочного пакета Asterisk.

Этап 2

1. Для скачивания архива установщика используйте утилиту wget. Если ее нет в стандартной реализации deb-дистрибутива, дайте команду на ее установку:

apt install wget

2. Скачайте архив по ссылке:

wget
https://downloads.asterisk.org/pub/telephony/certified-asterisk/asterisk-certified-18.9-current.tar.gz

Важно: Переодически версии дистрибутива меняются. Если к вам возвращается ошибка 404 Not Found -> зайдите в браузер по ссылке: https://downloads.asterisk.org/pub/telephony/certified-asterisk/ И в наименовании архива asterisk-certified-18.9-current.tar.gz измените версию на актуальную.

3. Скаченный архив должен попасть в директорию, в которой вы на момент скачивания находились. Командой ls можно проверить расположение архива. Выглядит это так, как на скрине ниже:

4. Приступите к распаковке архива

tar -xvf asterisk-certified-18.9-current.tar.gz

Введите команду ls и убедитесь, что все распаковалось:

5. Перейдите в директорию с исполняемыми скриптами Asterisk:

cd ./asterisk-certified-18.9-cert4/contrib/scripts/

Опционально можно посмотреть, лежит ли там нужный файл:

ls -la | grep install_prereq

6. Запустите этап установки:

./install_prereq install

7. На этапе установки появится запрос на установку кода региона страны. Убедитесь, что установлена цифра «7» и нажмите ок:

Так выглядит завершение установки:

8. Запустите процесс сборки конфигурации. Для этого для удобства перейдите в домашнюю директорию root:

cd ~

И перейдите туда, где лежит файл /configure для его запуска

cd asterisk-certified-18.9-cert4/

9. Выполните запуск сценариев скрипта configure:

./configure

Должно быть, как на скрине ниже:

10. Выберите опции, которые будете устанавливать. Выполните команду:

make menuselect После этого вы попадете в меню.

Перемещение осуществляется стрелками, установка галочки с помощью Enter.

11. Выберите раздел Call detail recording, убедитесь, что стоит галочка у модуля cdr_adaptive_odbc и поставьте галочку у модуля cdr_odbc.

12. Перейдите в channel drivers, пролистайте в самый низ и выберите chan_sip.

Сохраните и осуществите выход.

13. Выполните окончательную сборку Asterisk

make && make install && make samples && make config && make install-logrotate

Дождитесь процесса окончания установки. Должно быть, как на скрине ниже:

14. Вернитесь в домашнюю директорию

root cd ~

15. Выполните

/usr/sbin/asterisk

16. Проверьте статус Asterisk

systemctl status asterisk

Если он не активен, запустите:

systemctl start asterisk

И снова убедитесь, что он запустился:

systemctl status asterisk

Должно быть, как на скрине ниже:

Этап подготовки завершен. Можно приступать к выполнению задания.

Важно: Для подключения к Asterisk следует использовать /usr/sbin/asterisk -rv

Описание использования текстового редактора nano

ctrl+x – закрыть текстовый редактор,
ctrl+o – сохранить изменения в файле,
ctrl+w – поиск по файлу,
#- внутри текста логически закрывает применение настроек данной строки, используется для комментариев.

Полное описание: https://www.opennet.ru/man.shtml?topic=nano&category=1&russian=2 Пример How-to: https://losst.pro/tekstovyj-redaktor-nano-v-linux-dlya-novichkov