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

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

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

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

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

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

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

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

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

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

fwconsole stop -m 300

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

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

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

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

В отличие от команды 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.

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

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

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

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

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

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

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

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

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

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

fwconsole chown

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

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

Из приведённого примера видим, что команда 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

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

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: русский голос.

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