В текущем разделе описываются команды управления сервисом MLPP (Multilevel Precedence and Preemption) на уровне системы

Для администратора системы команды выполняются на уровне сервиса MLPP в разделе /mlpp/.

В таблице 1 приведено описание свойств сервиса MLPP.

Таблица 1. Описание свойств сервиса MLPP

Название свойстваЗначенияЗначение по умолчаниюОписание
default_priority0-154Приоритет, который используется, если не заданы категории вызова в свойстве "priority".
enabletrue, falsetrueОпределяет состояние сервиса MLPP:
- true - сервис включен;
- false - сервис выключен.
modewait, forcewaitРежим работы сервиса:
- wait - сервис ставит приоритетный вызов в очередь;
- force - сервис завершает один из менее приоритетных вызовов и пропускает приоритетный вызов.
priority0-15-Приоритет вызова для определенной категории вызова.
queue_length2, 32Длина очереди ожидания приоритетных вызовов, используется только в режиме "wait".
queue_time0-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]