Исправление ошибки превышения максимального количества вложений в контексте Asterisk

В этой статье рассмотрим исправление ошибки, связанной с превышением максимального количества вложений (include) в контекстах Asterisk, более известной, как Maximum PBX stack exceeded.

Описание ошибки

Связано это с особым внутренним устройством FreePBX. К примеру, если добавляется исходящий маршрут, то под каждый из них создаётся свой контекст, вида outrt-N, где N — id добавляемого маршрута. Посмотреть id маршрута можно в адресной строке браузера:

Подробнее о настройках исходящих маршрутов в FreePBX можно найти в статье.

После чего все маршруты добавляются посредством «инклудов» в контекст outbound-allroutes. Это и является примером одного из «узких мест» FreePBX. Всё дело в том, что количество возможных вложений в контексте жёстко ограничено в исходном коде Asterisk.

Для «чистого» Asterisk (без использования FreePBX), эта проблема обычно не актуальна, потому что используемая логика редко включает в себя использование более 128 вложений.

При превышении максимально допустимого количества вложений, в консоли Asterisk можно увидеть следующую ошибку:

Исправление ошибки

Для исправления ошибки Maximum PBX stack exceeded необходимо пересобрать Asterisk с новыми параметрами количества вложений. За это количество отвечает константа AST_PBX_MAX_STACK. Заменим её значение.

Открываем в режиме редактирования файл …/asterisk-*/include/asterisk/pbx.h.

Обычно, исходники Asterisk можно найти в каталоге /usr/src/.

В открытом файле находим объявление константы:

#define AST_PBX_MAX_STACK N

и изменяем его так, чтобы хватило для наших целей. N, в данном случае, отражает начальное значение константы. К примеру, можно выставить 256, или 512:

#define AST_PBX_MAX_STACK 512

Здесь также следует обратить внимание на параметр LOW_MEMORY, который может быть описан до параметра. Тогда объявлений констант будет 2 и код будет выглядеть следующим образом:

#ifdef LOW_MEMORY
#define AST_PBX_MAX_STACK N
#else
#define AST_PBX_MAX_STACK N
#endif

Первый параметр вступает в силу, если Asterisk бал собран с флагом LOW_MEMORY. Данный флаг выставляется при сборке командой:

make menuselect

в разделе Compiler Flags.

Подробнее про установку Asterisk 13 можно прочитать здесь.

Если собран с флагом LOW_MEMORY, то меняем верхний параметр. Если без флага – то нижний (второй). Можно также изменить и оба параметра – чтобы наверняка быть уверенным в результате, если не знаем, как именно был собран Asterisk.

После того, как внесли изменения, сохраняем этот файл и переходим ко второму: …/asterisk-*/include/asterisk/extconf.h и в нём находим такую же конструкцию:

#ifdef LOW_MEMORY
#define AST_PBX_MAX_STACK N
#else
#define AST_PBX_MAX_STACK N
#endif

Аналогично предыдущему файлу, заменяем значения и сохраняем файл.

После внесённых изменений переходим к пересборке Asterisk. Для этого выполняем последовательно в консоли следующие команды:

make

Выполнение займёт некоторое время. Если всё верно, то должны увидеть приглашение ввести команду make install, как на скриншоте ниже:

make install

Если установка прошла успешно, увидим форму Asterisk Installation Complete:

После всего необходимо перезапустить службу Asterisk. Сделать это можно из консоли Asterisk командой:

core restart now

После перезапуска Asterisk, в силу должно вступить новое значение константы AST_PBX_MAX_STACK.

На этом исправление ошибки превышения максимального количества вложений в контексте Asterisk завершено.