/mlpp/- команды управления многоадресной приоритизацией вызовов (MLPP)
В текущем разделе описываются команды управления сервисом MLPP (Multilevel Precedence and Preemption) на уровне системы
Для администратора системы команды выполняются на уровне сервиса MLPP в разделе /mlpp/.
В таблице 1 приведено описание свойств сервиса MLPP.
Таблица 1. Описание свойств сервиса MLPP
| Название свойства | Значения | Значение по умолчанию | Описание |
|---|---|---|---|
| default_priority | 0-15 | 4 | Приоритет, который используется, если не заданы категории вызова в свойстве "priority". |
| enable | true, false | true | Определяет состояние сервиса MLPP: - true - сервис включен; - false - сервис выключен. |
| mode | wait, force | wait | Режим работы сервиса: - wait - сервис ставит приоритетный вызов в очередь; - force - сервис завершает один из менее приоритетных вызовов и пропускает приоритетный вызов. |
| priority | 0-15 | - | Приоритет вызова для определенной категории вызова. |
| queue_length | 2, 3 | 2 | Длина очереди ожидания приоритетных вызовов, используется только в режиме "wait". |
| queue_time | 0-40 секунд | 40 | Время ожидания приоритетных вызовов в очереди, используется только в режиме "wait". |
clean
Данной командой осуществляется установка значений по умолчанию свойств подсистемы MLPP. Значения по умолчанию приведены в таблице 1.
Путь команды:
/mlpp/clean
Синтаксис:
clean [[ --property <default_priority|enable|mode|queue_length|queue_time|priority <*|category>>]<FIELD>] [--force]
Параметры:
<DOMAIN> - имя виртуальной АТС, значения свойств которой необходимо установить по умолчанию. При указании символа "*" значения свойств всех виртуальных АТС устанавливаются по умолчанию;
<FIELD> - свойство, значение которого необходимо установить в значение по умолчанию. Если не указывать данный параметр, то значения по умолчанию будут восстановлены для всех свойств заданной виртуальной АТС.
--force - выполнить команду без запроса подтверждения.
Пример:
admin@mycelium1@ecss1:/$ mlpp/clean biysk.local --property priority testCall --force Success: Properties values successfully restored [exec at: 01.03.2021 23:27:09, exec time: 59ms, nodes: sip1@ecss1 v.3.14.7.620] admin@mycelium1@ecss1:/$ mlpp/clean * [clean] You are going to clean all customized properties. Are you sure?: yes/no ?> yes Success: Properties values successfully restored [exec at: 01.03.2021 23:28:25, exec time: 3s 559ms, nodes: sip1@ecss1 v.3.14.7.620]
info
Данная команда позволяет посмотреть свойства подсистемы MLPP.
Путь команды:
/mlpp/info
Синтаксис:
info [<DOMAIN> [<FIELD>]]
Параметры:
<DOMAIN> - имя виртуальной АТС, значения свойств которой необходимо просмотреть. При указании символа "*" будет показана информация по всем виртуальным АТС системы;
<FIELD> - имя свойства, которое нужно просмотреть. Опциональный параметр. Если параметр не указывать, будут выведены все свойства. Описание свойств приведено в таблице 1.
Пример:
admin@mycelium1@ecss1:/$ mlpp/info ┌────────────────┬──────┬─────┐ │ Property │Domain│Value│ ├────────────────┼──────┼─────┤ │default_priority│ │4 │ │enable │ │true │ │mode │ │wait │ │priority │ │ │ │queue_length │ │2 │ │queue_time │ │40 │ └────────────────┴──────┴─────┘ [exec at: 01.03.2021 23:24:01, exec time: 21ms, nodes: sip1@ecss1 v.3.14.7.620
set
Данной командой производится изменение свойств подсистемы MLPP в заданной виртуальной АТС или во всей системе.
Путь команды:
/mlpp/set
Синтаксис:
set <DOMAIN> <FIELD> <VALUE>
Параметры:
<DOMAIN> - имя виртуальной АТС, значения свойств которой необходимо установить. При указании символа "*" значение свойства устанавливается для всех виртуальных АТС системы;
<FIELD> - имя свойства, значение которого необходимо изменить. Описание свойств приведено в таблице 1.
<VALUE> - новое значение свойства, возможные значения приведены в таблице 1.
Настройка свойства "priority" выполняется следующим образом:
- для добавления приоритета определенной категории используются команды:
set <DOMAIN> priority add <CATEGORY> <VALUE>
- для удаления приоритета категории используются команды:
set <DOMAIN> priority remove <CATEGORY>
где
<CATEGORY> - категория вызова, принимает значения [0..255] или задается в виде имени: autoCallII; autoCallIII; autoCallIV; category0; dataCall; freeSubscriber; hotelsSubscriber; localSubscriber; localTaksofon; operatorEngish; operatorFrench; operatorGerman; operatorRussian; operatorSpanish; ordinarySubscriber; paidSubscriber; payphone; reserved; semiautoCallI; semiautoCallII; semiautoCallIII; semiautoCallIV; spare; subscriberWithPriority; testCall; unknownAtThisTime;
<VALUE> - приоритет категории, принимает значение [0..15], где 0 - самый высокий приоритет, 15 - самый низкий.
Примеры:
admin@mycelium1@ecss1:/$ /mlpp/set * priority add testCall 5 Value "testCall( 13): 5" successfully added to property "priority". [exec at: 01.03.2021 23:25:30, exec time: 69ms, nodes: sip1@ecss1 v.3.14.7.620] admin@mycelium1@ecss1:/$ mlpp/set biysk.local mode force Property "mode" successfully changed from: wait to force. [exec at: 01.03.2021 23:26:11, exec time: 75ms, nodes: sip1@ecss1 v.3.14.7.620]