Денис Пестрецов
03.04.2019
1810

Использование fwconsole во FreePBX 13

В данной статье рассмотрим возможности использования команды fwconsole во FreePBX 13 и ознакомимся с основными вариантами её использования. Основная информация fwconsole – это команда в Linux-системе, которая позволяет управлять FreePBX из командной строки, начиная с 13 версии и выше. Данная команда пришла на смену другой – amportal, которая активно использовалась во FreePBX 12 версии, а […]

В данной статье рассмотрим возможности использования команды fwconsole во FreePBX 13 и ознакомимся с основными вариантами её использования.

Основная информация

fwconsole – это команда в Linux-системе, которая позволяет управлять FreePBX из командной строки, начиная с 13 версии и выше. Данная команда пришла на смену другой – amportal, которая активно использовалась во FreePBX 12 версии, а также в более ранних дистрибутивах. Вообще говоря, amportal также включён и в 13 версию, но его использование не рекомендуется, так как она считается устаревшей. Также, если Вы до этого пользовались командой amportal, то увидите заметное увеличение возможностей, при использовании fwconsole.

При использовании amportal во FreePBX 13, команда будет выполнена, но в консоли увидим предупреждение:


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

Управляющие команды

В данном разделе рассмотрим основные управляющие команды fwconsole. К ним можно отнести start, stop, restart и chown.

fwconsole start – команда, используемая для старта FreePBX и Asterisk.


Старт Asterisk

fwconsole stop – выполняет остановку FreePBX и Asterisk. В случае если хотим отменить данную команду – нажимаем клавишу «С». Для быстрой остановки – нажимаем «N».


Остановка Asterisk

При остановке Asterisk используется команда, аналогичная core stop gracefully, которая предотвращает новые вызовы, однако позволяет завершить текущие. Важным отличием при использовании команды fwconsole stop/restart является то, что по умолчанию через 30 секунд Asterisk всё равно остановится, даже если за это время не успели завершиться все вызовы. Чтобы этого не происходило, следует запускать команду с параметром -m (или –maxwait) и указанием количества секунд, через которое Asterisk будет принудительно остановлен. Пример:

fwconsole stop -m 300

После выполнения данной команды, Asterisk заблокирует возможность совершения новых вызовов. При этом в течение 300 секунд будет ждать завершения текущих. В случае если по истечению 300 секунд какие-то вызовы останутся, то они будут завершены. При этом Asterisk может остановиться и раньше – если последний вызов будет завершён ранее, чем истечёт лимит в 300 секунд.

Опция -m по умолчанию поддерживает значения из диапазона 5-3600 секунд. Если указать менее 5 секунд, то будет использоваться значение по умолчанию (30 секунд). Если указать больше 3600, то будет использоваться 3600.

Изменить данные значения можно в скрипте, отвечающим за эту команду: /var/www/html/admin/libraries/Console/Stop.class.php. Править следует переменную $maxwait.

После остановки Asterisk, во FreePBX по-прежнему можно попасть, но внутри него становятся недоступны функции, напрямую взаимодействующие с Asterisk (к примеру, Extensions или Queues). Также, вместо кнопки Apply Config, находится надпись «Can Not Connect to Asterisk».

FreePBX при остановленном Asterisk

fwconsole restart – выполняет последовательную остановку и запуск Asterisk (аналогично последовательному выполнению команд fwconsole stop и fwconsole start).


Перезапуск Asterisk
Для перезапуска астериск рекомендуется использовать команду fwconsole restart, вместо service asterisk restart.

В отличие от команды stop, restart не обладает параметром -m и будет выполнять остановку по умолчанию (с выделением 30 секунд на завершение разговоров). Технически, не сложно добавить к нему параметр -m в скрипте /var/www/html/admin/libraries/Console/Restart.class.php. Для этого необходимо реализовать передачу переменной $maxwait в запуск функции Stop(). В данной статье это рассматриваться не будет.

fwconsole chown – изменяет владельца файлов, которые использует а работе FreePBX на пользователя Apache. (asterisk:asterisk). Эта команда бывает удобна, если по каким-либо причинам, владелец каких-либо файлов изменился. К примеру, могли в /etc/asterisk/ скопировать файл extensions_custom.conf с другого сервера. При этом владелец данного файла изменится и FreePBX не сможет к нему обратиться, что приведёт к возникновению ошибки.


Изменение владельца файлов

Из примера видим, что файл extensions_custom.conf принадлежал пользователю root. После выполнения команды fwconsole chown, владелец файла меняется на asterisk.

Следует учитывать, что выполнение данной команды зависит от /etc/asterisk/freepbx_chown.conf, в котором содержатся указания по выполнению данной команды на той или иной директории. Если файл пуст, значит никаких кастомных указаний по выполнению команды fwconsole chown нет.

Также команде fwconsole chown доступны следующие опции:

                verbose (-v|vv|vvv) – выводит подробную информацию о процессе выполнения (по каждому файлу);

                file=filename (-f) – изменяет владельца и права для указанного файла;

Рассмотрим нюансы fwconsole chown.

Нельзя прерывать выполнение работы fwconsole chown -v нажатием клавиш Ctrl+C. Это приведёт к блокировке fwconsole (равно как и amportal).

Это первый, и, пожалуй, самый главный нюанс. Разберёмся, что же произойдёт, в случае, если всё же прервать выполнение команды.

После того, как прервали выполнение команды, доступ к fwconsole становится заблокированным, ввиду отсутствия прав, при этом выдаётся сообщение:

-bash: /usr/sbin/fwconsole: Permission denied

Для восстановления работы fwconsole, выполним следующую команду:

chmod +x /var/lib/asterisk/bin/fwconsole

Тем самым, восстановили доступ к команде fwconsole. Теперь выполним прерванную команду, чтобы восстановить целостность системы (к примеру, до выполнения следующей команды, amportal так и не будет работать)

fwconsole chown

После завершения выполнения данной команды, работоспособность восстановится в прежней форме.


Восстановление работоспособности fwconsole

Второй нюанс: использование опции f, или же file. Из заявленного функционала следует, что данная опция должна применять команду fwconsole chown только к указанному файлу, при этом не влияя на остальные. Однако, при запуске данной команды, она проходит всё равно по всем файлам, игнорируя введённые параметры.


Параметр –file

Из приведённого примера видим, что команда chown была выполнена для всех 21639 файлов, вместо одного Timeconditions.class.php, который был задан. Были протестированы варианты короткого и длинного использований, ровно, как и использование параметра в кавычках и без (если вызвать fwconsole chown –help, увидим, что запускать следует в кавычках).

На этом рассмотрение основных управляющих команд fwconsole завершено. Переходим к рассмотрению другой части – более узконаправленной, модульной.

Модульная часть

В этой части рассмотрим команды, которые относятся к определённым модулям.

context. С помощью этой команды можно получить краткую информацию об используемых контекстах. Очень удобно с помощью этой команды посмотреть номерной план текущего контекста. К примеру, рассмотрим контекст очередей, описанный в файле extensions_additional.conf. Для этого воспользуемся командой:

fwconsole context ext-queues

Результат выполнения данной команды можем увидеть на примере:


Получение номерного плана контекста

Или, к примеру, если в extensions_custom.conf содержится много диалплана в контексте from-internal-custom, то мы можем увидеть весь номерной план командой:

fwconsole context from-internal-custom

Кроме номерного плана, также выводится первая строка диалплана.

Также можно использовать сокращённый вариант команды, называемый алиасом – cx. Команда примет следующий вид: fwconsole cx context_name.

trunks. Команда предназначена для вывода информации по текущим транкам, а также быстрому включению/отключению их. Чтобы получить полный список транков, необходимо ввести команду:

fwconsole trunks

Список транков

Ниже списка транков идёт, указанный в квадратных скобках, ID транка. После перечисления всего списка ID номеров, увидим символ «>», указывающий на ожидание ввода одного из ID. Если ввести и нажать Enter, то показатель работы транка инвертируется (то есть, если транк был выключен, то он окажется включённым и наоборот). В приведённом выше примере включили 8 транк.

Для того чтобы изменения вступили в силу после включения или отключения транка, необходимо выполнить команду:

fwconsole r

Для более быстрого отключения и включения транков можно воспользоваться следующими командами:

fwconsole trunks --enable 10 - для включения транка с ID 10
fwconsole trunks --disable 7 - для выключения транка с ID 7

Также, для получения списка транков, без интерактивного меню изменения их состояния, можно использовать параметр –list:

fwconsole trunks --list.

Включение/отключение транков

Подробнее о настройке транков во FreePBX можно почитать в статье: Управление транками во FreePBX. Также, возможно будет интересен скрипт Мониторинга состояния транков.

dbug. Используется для включения дебага. Более подробнее о режиме дебага можно узнать из статьи: Дебаг FreePBX 13.

External IP. Для того чтобы узнать внешний IP адрес АТС, можно выполнить команду:

fwconsole extip

Sound Languages. Отображает язык воспроизведения звуковых файлов в Asterisk. Для того чтобы узнать, какие языки сейчас доступны для включения и какой используется по умолчанию, воспользуемся командой:

fwconsole sounds global list

Используемый по умолчанию будет помечен «Х».


Язык воспроизведения

Подробности о работе модуля Sound Languages можно найти в статье: FreePBX-13: русский голос.

Большинство команд можно найти в виде скриптов, хранящихся в каталоге /var/www/html/admin/libraries/Console/

На этом рассмотрение возможностей fwconsole во FreePBX 13 завершено.

 
avatar
  Подписаться  
Уведомление о

Остались вопросы?

Я - Першин Артём, менеджер компании Voxlink. Хотите уточнить детали или готовы оставить заявку? Укажите номер телефона, я перезвоню в течение 3-х секунд.

VoIP оборудование

ближайшие курсы

ближайшие Вебинары

ONLINE

Why Choose HUGE?

Unlimited pre-designed elements

Each and every design element is designed for retina ready display on all kind of devices

User friendly interface and design

Each and every design element is designed for retina ready display on all kind of devices

100% editable layered PSD files

Each and every design element is designed for retina ready display on all kind of devices

Created using shape layers

Each and every design element is designed for retina ready display on all kind of devices