/domain/<DOMAIN>/iface/ - команды управления интерфейсами
В этом разделе описываются команды для управления конфигурацией интерфейсов.
Для администратора виртуальной АТС команды выполняются в разделе /domain/<DOMAIN>/iface/ и применяются только для определенной виртуальной АТС.
<DOMAIN> - имя виртуальной АТС.
Описание параметров (свойств) SIP-интерфейса приведено в разделе Приложение Б. Набор параметров интерфейса SIP или во вкладке ниже.
Приложение Б. Набор параметров интерфейса SIP
Описание параметров (свойств) MEGACO-интерфейса приведено в разделе Приложении В. Набор параметров интерфейса MEGACO или во вкладке ниже.
Приложение В. Набор параметров интерфейса MEGACO
Команды управления конфигурацией определенного интерфейса
info
Команда для вывода на экран информации о свойствах (свойстве) определенного интерфейса.
Путь команды:
/domain/<DOMAIN>/iface/info
Синтаксис:
info *|<OWNER> *|<GROUP> <NAME RANGE> [<PROPERTY>]
Параметры:
<OWNER> - название владельца (символ "*" используется для указания всех владельцев);
<GROUP> - название группы (символ "*" используется для указания всех групп);
<NAME RANGE> - название интерфейса;
<PROPERTY> - свойство (опциональный параметр, если параметр не задан, то будет отображена информация о всех свойствах данного интерфейса).
Пример:
admin@[mycelium1@ecss1]:/$ domain/biysk.local/iface/info * loc.gr 240101@biysk.local
┌──────────────────┬─┬────────────────┬────────────────────────────────────────────────────────────────────────────────┐
│ Interface │W│ Property │ Value │
├──────────────────┼─┼────────────────┼────────────────────────────────────────────────────────────────────────────────┤
│240101@biysk.local│i│account │{"...50-52-48-49-48-49","...101-120-116-95-49-48-49-95-83-83-87-45-51"} │
│ │i│adapter\version │"3.14.0.152" │
│ │i│alias │"alias-as-user" │
│ │i│aliases_list │["240101"] │
│ │i│auth_qop │true │
│ │i│declaration │{"admin",{1544,889009,619218}} │
│ │D│dtmf_source │'rfc+info' │
│ │i│gate │{gate_amqp,<<"acp.adapter.init.ex">>,<<"acp.sip.sip1.ipset1.init.rk">>} │
│ │i│group │"loc.gr" │
│ │i│id │<<"708c5e7b5dfb8675">> │
│ │i│isActive │true │
│ │i│login │login_as_number │
│ │i│media-profile │{media_profile,"biysk.local","default", │
│ │ │ │ "Default media profile for current domain.",user, │
│ │ │ │ [{media_profile_codecs,'<other>', │
│ │ │ │ [{media_profile_codec,<<"<other>">>,<<"*">>,true,[]}], │
│ │ │ │ [{[offroad],true}]}, │
│ │ │ │ {media_profile_codecs,audio, │
│ │ │ │ [{media_profile_codec,<<"G722">>,<<"*">>,true,[]}, │
│ │ │ │ {media_profile_codec,<<"PCMA">>,<<"*">>,true,[]}, │
│ │ │ │ {media_profile_codec,<<"PCMU">>,<<"*">>,true,[]}, │
│ │ │ │ {media_profile_codec,<<"G729">>,<<"*">>,true,[]}, │
│ │ │ │ {media_profile_codec,<<"telephone-event">>,<<"*">>,true,[]}], │
│ │ │ │ [{[offroad],true}]}], │
│ │ │ │ []} │
│ │i│my_from │none │
│ │i│owner │"sip1" │
│ │i│password │"ext_101_SSW-3" │
│ │i│profile │undefined │
│ │i│routing.context │ctx_from_local │
│ │i│sip_domain │"biysk.local" │
│ │D│site │<<"local">> │
│ │i│subtype │user │
│ │i│support-encoding│utf8 │
│ │D│terminal_type │smart │
│ │i│type │sip │
│ │i│user_agent │"Yealink SIP-T28P 2.73.14.3" │
│ │i│user_name │"240101" │
│ │D│zone │<<"default">> │
└──────────────────┴─┴────────────────┴────────────────────────────────────────────────────────────────────────────────┘
Legend:
W: Where property is set:
D: This is default property
G: This is global property
g: This is group property
O: This is owner property
B: This is group+owner property
i: This is interface property
?: Unknown property level
Note: * char in W column means "Can't read iface resource info". Error reason in value column in this case
[exec at: 06.03.2019 21:59:57, exec time: 67ms, nodes: ds1@ecss1]
list
Команда для просмотра списка интерфейсов ECSS-10 для определенного профиля группы, владельца.
Путь команды:
/domain/<DOMAIN>/iface/list
Синтаксис:
list [*|<OWNER> [*|<GROUP>]] [<PROPERTY> <OPERATOR> <VALUE>]]
Параметры:
- <OWNER> - название владельца (символ "*" используется для указания всех владельцев);
- <GROUP> - название группы (символ "*" используется для указания всех групп).
- <PROPERTY> - свойство интерфейса, возможные значения приведены в таблице 1.;
- <OPERATOR> - оператор сравнения : '==' | '<>' | '>' | '<' | '>=' | '=<' | '~';
- '==' - равно;
- '<>' - не равно;
- '>' - больше;
- '>=' - больше или равно;
- '<' - меньше;
- '=<' - меньше или равно;
- '~' - содержит.
- <VALUE> - значение свойства.
Пример:
admin@[mycelium1@ecss1]:/$ domain/biysk.local/iface/list sip1 loc.gr terminal_type == basic ┌────────┬─────────────────────────────────┬────────────────────────────────────────────┬──────────────────────┬──────────────────────┬────────┐ │ Type │ Iface │ Name │ Owner │ Group │ Active │ ├────────┼─────────────────────────────────┼────────────────────────────────────────────┼──────────────────────┼──────────────────────┼────────┤ │sip │708c5c2121a4c0a3 │240474@biysk.local │sip1 │loc.gr │true │ │sip │708c5bf76388b92e │240464@biysk.local │sip1 │loc.gr │true │ │sip │708c5c15c1d0802d │240470@biysk.local │sip1 │loc.gr │true │ │sip │708c5fc249143c76 │240471@biysk.local │sip1 │loc.gr │true │ │sip │708c60a0c102c2d9 │240475@biysk.local │sip1 │loc.gr │true │ │sip │708c6030c1ad7239 │240473@biysk.local │sip1 │loc.gr │true │ │sip │708c5beda8cd39d0 │240462@biysk.local │sip1 │loc.gr │true │ │sip │708c5bbb3f198bc9 │240001@biysk.local │sip1 │loc.gr │false │ └────────┴─────────────────────────────────┴────────────────────────────────────────────┴──────────────────────┴──────────────────────┴────────┘ Ifaces for domain: "biysk.local" Ifaces in table: 8 [exec at: 06.03.2019 22:09:26, exec time: 125ms, nodes: ds1@ecss1]
user-set
Данной командой настраиваются свойства интерфейса. Описание свойств, которые настраиваются на определенном интерфейсе приведено выше.
Путь команды:
/domain/<DOMAIN>/iface/user-set
Синтаксис:
user-set <OWNER> <GROUP> <IFACE RANGE> <PROPERTY> <VALUE>
Параметры:
<OWNER> - название владельца (символ "*" используется для указания всех владельцев);
<GROUP> - название группы (символ "*" используется для указания всех групп);
<IFACE RANGE> - название интерфейса;
<PROPERTY> - свойство интерфейса, значение которого требуется установить, описание приведено в таблице 1
<VALUE> - значение свойства.
Примеры:
Установка кодировки:
admin@[mycelium1@ecss1]:/$ domain/biysk.local/iface/user-set sip1 loc.gr 240801@biysk.local support-encoding utf8 Property 'support-encoding' successfully changed to 'utf8' for interfaces: 240801@biysk.local [exec at: 06.03.2019 22:26:52, exec time: 66ms, nodes: ds1@ecss1]
Установка контекста маршрутизации:
admin@[mycelium1@ecss1]:/$ domain/biysk.local/iface/user-set .system * system:ivr routing.context ctx_from_local Property 'routing.context' successfully changed to 'ctx_from_local' for interfaces: system:ivr [exec at: 06.03.2019 22:28:41, exec time: 83ms, nodes: ds1@ecss1]
Установка предпочитаемого сайта для абонента:
admin@ds1@ecss1:/$ domain/biysk.local/iface/user-set sip1 loc.gr 240606@biysk.local site remote Property 'site' successfully changed to 'remote' for interfaces: 240606@biysk.local [exec at: 16.05.2019 11:27:38, exec time: 123ms, nodes: ds1@ecss1]
Установка зоны для транка:
admin@ds1@ecss1:/$ domain/biysk.local/iface/user-set sip1 sbc.gr nsk_sbc zone nsk Property 'zone' successfully changed to 'nsk' for interfaces: nsk_sbc [exec at: 16.05.2019 11:28:32, exec time: 87ms, nodes: ds1@ecss1]
Включение поддержки CFC на интерфейсе:
admin@mycelium1@ecss1:/$ domain/biysk.local/iface/user-set sip1 loc.gr 240473@biysk.local cfc-support true Property 'cfc-support' successfully changed to 'true' for interfaces: 240473@biysk.local [exec at: 18.09.2019 10:26:19, exec time: 153ms, nodes: ds1@ecss1]
Команды конфигурирования свойств интерфейсов для профиля группы, профиля владельца
group-info
Команда для просмотра информации о свойствах интерфейсов.
Путь команды:
/domain/<DOMAIN>/iface/group-info
Синтаксис:
group-info [-o <OWNER>] [-g <GROUP>]
Параметры:
-о - флаг, который указывает на свойства уровня владельца интерфейса;
-g - флаг, который указывает на свойства глобального уровня;
<OWNER> - имя профиля владельца;
<GROUP> - имя профиля группы.
Пример:
admin@[mycelium1@ecss1]:/$ domain/biysk.local/iface/group-info -g sbc.gr -o sip1
Domain biysk.local onwer sip1 group sbc.gr iface resoureces properties:
┌─┬────────┬───────────────────────────────────────────────────────────────────────┐
│W│Property│ Value │
├─┼────────┼───────────────────────────────────────────────────────────────────────┤
│g│domain │"biysk.local" │
│g│gate │{gate_amqp,<<"acp.adapter.init.ex">>,<<"acp.sip.sip1.ipset1.init.rk">>}│
│g│owner │"sip1" │
└─┴────────┴───────────────────────────────────────────────────────────────────────┘
Legend:
W: Where property is set:
G: This is global property
g: This is group property
O: This is owner group property
B: This is group+owner property
?: Unknown property level
Note: * char in W column means "Can't read iface resource info". Error reason in value column in this case
[exec at: 06.03.2019 22:34:30, exec time: 75ms, nodes: ds1@ecss2]
group-clean
Команда для сброса свойств интерфейсов.
Путь команды:
/domain/<DOMAIN>/iface/group-clean
Синтаксис:
group-clean [-o <OWNER>] [-g <GROUP>] -p <PROPERTY>
Параметры:
-о - флаг, который указывает на свойства уровня владельца интерфейса;
-g - флаг, который указывает на свойство принадлежности группы;
-p - флаг, который указывает на параметр для группы интерфейса
<OWNER> - имя профиля владельца;
<GROUP> - имя профиля группы;
<PROPERTY> - свойство интерфейса.
Пример:
admin@[mycelium1@ecss1]:/$ domain/biysk.local/iface/group-clean -g ssw.gr -o sip1 -p cfc-support Iface resources group property cfc-support is cleaned for domain biysk.local owner sip1, group ssw.gr [exec at: 06.03.2019 22:43:01, exec time: 84ms, nodes: ds1@ecss1]
group-set
Команда для установки свойств интерфейсов.
Путь команды:
/domain/<DOMAIN>/iface/group-set
Синтаксис:
group-set [-o <OWNER>] [-g <GROUP>] -p <PROPERTY> <VALUE>
Параметры:
-о - флаг, который указывает на свойства уровня владельца интерфейса;
-g - флаг, который указывает на свойства глобального уровня;
-p - флаг, который указывает на параметр для группы интерфейса
<OWNER> - имя профиля владельца;
<GROUP> - имя профиля группы;
<PROPERTY> - свойство интерфейса;
<VALUE> - значение свойства.
Пример:
admin@[mycelium1@ecss1]:/$ domain/biysk.local/iface/group-set -g ssw.gr -o sip1 -p cfc-support true Defined iface resources group property cfc-support for group ssw.gr, owner sip1 [exec at: 06.03.2019 22:40:59, exec time: 91ms, nodes: ds1@ecss2]