В этом разделе описываются команды для управления конфигурацией интерфейсов.

Для администратора виртуальной АТС команды выполняются в разделе /domain/<DOMAIN>/iface/ и применяются только для определенной виртуальной АТС.

<DOMAIN> - имя виртуальной АТС.

Описание параметров (свойств) SIP-интерфейса приведено в разделе  Приложение Б. Набор параметров интерфейса SIP или во вкладке ниже.


Приложение Б. Набор параметров интерфейса SIP


Команды управления конфигурацией определенного интерфейса

info

Команда для вывода на экран информации о свойствах (свойстве) определенного интерфейса.

Путь команды:

/domain/<DOMAIN>/iface/info

Синтаксис:

info *|<OWNER> *|<GROUP> <NAME RANGE> [<PROPERTY>]

Параметры:

<OWNER> - название владельца (символ "*" используется для указания всех владельцев);
<GROUP> - название группы (символ "*" используется для указания всех групп);
<NAME RANGE> - название интерфейса;
<PROPERTY> - свойство (опциональный параметр, если параметр не задан, то будет отображена информация о всех свойствах данного интерфейса).

Примеры:

Просмотр параметров интерфейса абонента:

/domain/test_domain/iface/info * sip 42007@test_domain
┌─────────────────┬─┬──────────────────┬────────────────────────────────────────────────────────────────────────────────┐
│    Interface    │W│     Property     │                                     Value                                      │
├─────────────────┼─┼──────────────────┼────────────────────────────────────────────────────────────────────────────────┤
│42007@test_domain│i│account           │{"...52-50-48-48-55","...52-50-48-48-55"}                                       │
│                 │i│adapter\version   │"3.14.16.0.1528"                                                                │
│                 │i│alias             │"alias-as-user"                                                                 │
│                 │i│aliases_list      │["42007"]                                                                       │
│                 │i│auth_qop          │true                                                                            │
│                 │D│cfc-support       │true                                                                            │
│                 │i│declaration       │{none,{1754,272574,797964}}                                                     │
│                 │g│domain            │"test_domain"                                                                   │
│                 │i│gate              │{gate_amqp,<<>>,<<"acp.sip.sip1.0a00141f.init.q">>}                             │
│                 │i│group             │"sip"                                                                           │
│                 │i│id                │<<"06da428bec13ff40">>                                                          │
│                 │i│isActive          │true                                                                            │
│                 │i│keep_alive_control│{options,0}                                                                     │
│                 │i│media-profile     │{media_profile,"default",user,                                                  │
│                 │ │                  │    [{media_profile_codecs,'<other>',                                           │
│                 │ │                  │         [{media_profile_codec,<<"<other>">>,<<"*">>,true,#{}}],                │
│                 │ │                  │         #{offroad => false,'rtcp-enabled' => 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 => false,'rtcp-enabled' => true}}],                          │
│                 │ │                  │    #{'dtmf-receive-type' => auto,'dtmf-transmit-type' => transit}}             │
│                 │i│modificator       │undefined                                                                       │
│                 │i│my_from           │none                                                                            │
│                 │i│owner             │"sip1"                                                                          │
│                 │i│profile           │undefined                                                                       │
│                 │i│routing.context   │default_routing                                                                 │
│                 │i│sip_domain        │"test_domain"                                                                   │
│                 │D│site              │<<"local">>                                                                     │
│                 │i│subtype           │user                                                                            │
│                 │i│support-encoding  │utf8                                                                            │
│                 │D│terminal_type     │smart                                                                           │
│                 │i│type              │sip                                                                             │
│                 │i│user_agent        │"VP-15P/2.7.6.34 sofia-sip/1.12"                                                │
│                 │i│user_name         │"42007"                                                                         │
│                 │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


Просмотр установленного значения временной зоны для транка:

/domain/test_domain/iface/info * * sip timezone      
┌─────────┬─┬────────┬───────────┐
│Interface│W│Property│   Value   │
├─────────┼─┼────────┼───────────┤
│sip      │i│timezone│'UTC+07:00'│
└─────────┴─┴────────┴───────────┘

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

list

Команда для просмотра списка интерфейсов ECSS-10 для определенного профиля группы, владельца.

Путь команды:

/domain/<DOMAIN>/iface/list

Синтаксис:

list [*|<OWNER> [*|<GROUP>]] [<PROPERTY> <OPERATOR> <VALUE>]]

Параметры:

Пример:

/domain/test_domain/iface/list sip1 sip terminal_type == basic
┌─────────┬───────────────────────────────────────┬─────────────────────────────────────────────────────┬──────────────────────────┬──────────────────────────┬─────────┐
│  Type   │                 Iface                 │                        Name                         │          Owner           │          Group           │ Active  │
├─────────┼───────────────────────────────────────┼─────────────────────────────────────────────────────┼──────────────────────────┼──────────────────────────┼─────────┤
│sip      │06d0e9448ce6f64e                       │50001@test_domain                                    │sip1                      │sip                       │true     │
│sip      │06d60cace399180c                       │42001@test_domain                                    │sip1                      │sip                       │false    │
└─────────┴───────────────────────────────────────┴─────────────────────────────────────────────────────┴──────────────────────────┴──────────────────────────┴─────────┘
Ifaces for domain: "test_domain"
Ifaces in table: 2

user-set

Данной командой настраиваются свойства интерфейса. Описание свойств, которые настраиваются на определенном  интерфейсе приведено выше.

Путь команды:

/domain/<DOMAIN>/iface/user-set

Синтаксис:

user-set <OWNER> <GROUP> <IFACE RANGE> <PROPERTY> <VALUE>

Параметры:

<OWNER> - название владельца (символ "*" используется для указания всех владельцев);
<GROUP> - название группы (символ "*" используется для указания всех групп);
<IFACE RANGE> - название интерфейса;
<PROPERTY> - свойство интерфейса, значение которого требуется установить, описание приведено в таблице 1
<VALUE> - значение свойства.

Примеры:

Установка кодировки:

admin@ds1@ecss1:/$ domain/biysk.local/iface/user-set sip1 loc.gr 240530@biysk.local support-encoding utf8
Property 'support-encoding' successfully changed to 'utf8' for interfaces:
240530@biysk.local

[exec at: 16.02.2021 15:08:04, exec time: 18ms, nodes: ds1@ecss1 v.3.14.7.585]

Установка контекста маршрутизации:

admin@ds1@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: 16.02.2021 15:08:33, exec time: 28ms, nodes: ds1@ecss1 v.3.14.7.585]


Установка предпочитаемого сайта для абонента:

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.02.2021 15:12:10, exec time: 21ms, nodes: ds1@ecss1 v.3.14.7.585]



Установка зоны для транка:

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.02.2021 15:12:35, exec time: 26ms, nodes: ds1@ecss1 v.3.14.7.585]



Включение поддержки  CFC на интерфейсе:

admin@ds1@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: 16.02.2021 15:12:56, exec time: 30ms, nodes: ds1@ecss1 v.3.14.7.585]



Установка временной зоны для транка:

/domain/test_domain/iface/user-set sip1 sip sip timezone UTC+07:00        
Property 'timezone' successfully changed to 'UTC+07:00' for interfaces:
sip


Команды конфигурирования свойств интерфейсов для профиля группы, профиля владельца

group-info

Команда для просмотра информации о свойствах интерфейсов.

Путь команды:

/domain/<DOMAIN>/iface/group-info

Синтаксис:

group-info [-o <OWNER>] [-g <GROUP>]

Параметры:

-о - флаг, который указывает на свойства уровня владельца интерфейса;
-g - флаг, который указывает на свойства глобального уровня;
<OWNER> - имя профиля владельца;
<GROUP> - имя профиля группы.

Пример:

admin@ds1@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│group   │{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: 16.02.2021 15:13:19, exec time: 5ms, nodes: ds1@ecss1 v.3.14.7.585]

group-clean

Команда для сброса свойств интерфейсов.

Путь команды:

/domain/<DOMAIN>/iface/group-clean

Синтаксис:

group-clean [-o <OWNER>] [-g <GROUP>] -p <PROPERTY>

Параметры:

-о - флаг, который указывает на свойства уровня владельца интерфейса;
-g - флаг, который указывает на свойство принадлежности группы;
-p - флаг, который указывает на параметр для группы интерфейса
<OWNER> - имя профиля владельца;
<GROUP> - имя профиля группы;
<PROPERTY> - свойство интерфейса.

Пример:

admin@ds1@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: 16.02.2021 15:14:24, exec time: 24ms, nodes: ds1@ecss1 v.3.14.7.585]

group-set

Команда для установки свойств интерфейсов.

Путь команды:

/domain/<DOMAIN>/iface/group-set

Синтаксис:

group-set [-o <OWNER>] [-g <GROUP>] -p <PROPERTY> <VALUE>

Параметры:

-о - флаг, который указывает на свойства уровня владельца интерфейса;
-g - флаг, который указывает на свойства глобального уровня;
-p - флаг, который указывает на параметр для группы интерфейса
<OWNER> - имя профиля владельца;
<GROUP> - имя профиля группы;
<PROPERTY> - свойство интерфейса;
<VALUE> - значение свойства.

Пример:

admin@ds1@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: 16.02.2021 15:13:50, exec time: 20ms, nodes: ds1@ecss1 v.3.14.7.585]