3.14.3 Команды управления SIP-транками
Команды управления SIP-транками включают в себя:
- команды блокировки, разблокировки - данные команды предназначены для временного вывода транка из работы в административных целях;
- команды проверки состояния - данные команды предназначены для проверки доступности встречного оборудования для взаимодействия с ним по протоколу сигнализации;
- команды для работы с конфигурацией транка - данные команды предназначены для просмотра, импорта и экспорта настроек SIP-транка;
- команды просмотра активных вызовов - данные команды предназначены для просмотра детальной информации о вызовах, совершаемых через транк.
Блокировка и разблокировка SIP-транка
block
Команда для блокировки определенного транка, всех транков одной группы.
Соответствующий интерфейс переводится в неактивное состояние.
Путь команды:
/domain/<DOMAIN>/trunk/sip/block
Синтаксис:
block <GROUP> <TRUNK_INTERFACE> [--force]
Параметры:
<GROUP> - имя группы, интерфейс/интерфейсы которой нужно заблокировать;
<TRUNK_INTERFACE> - имя блокируемого интерфейса, при указании символа "*" будут заблокированы все транки заданной группы;
[--force] - опционально, при указании данного флага блокировка транка/транков будет производиться без дополнительного вопроса.
Пример:
admin@[ds1@ecss1]:/$ domain/biysk.local/trunk/sip/block ssw.gr ems3 [block] Trunk ems3 will be blocked continue: yes/no ?> yes Executed on the sip1@ecss2 ┌──────┬────┐ │ ems3 │ ok │ └──────┴────┘ [exec at: 17.03.2019 11:16:43, exec time: 3s 759ms, nodes: sip1@ecss2]
unblock
Команда для разблокировки определенного транка, всех транков одной группы.
Соответствующий интерфейс переводится в активное состояние.
Путь команды:
/domain/<DOMAIN>/trunk/sip/unblock
Синтаксис:
unblock <GROUP> <TRUNK_INTERFACE>[--force]
Параметры:
<GROUP> - имя группы, интерфейс/интерфейсы которой нужно разблокировать;
<TRUNK_INTERFACE> - имя интерфейса, символ "*" используется для указания всех интерфейсов группы;
[--force] - опционально, при указании данного флага разблокировка транка/транков будет производиться без дополнительного вопроса.
Пример:
admin@[ds1@ecss1]:/$ domain/biysk.local/trunk/sip/unblock ssw.gr * --force Executed on the sip1@ecss2 ┌──────┬────┐ │ bsk1 │ ok │ │ bsk2 │ ok │ │ ems1 │ ok │ │ ems2 │ ok │ │ ems3 │ ok │ └──────┴────┘ [exec at: 17.03.2019 11:41:42, exec time: 125ms, nodes: sip1@ecss2]
Проверка состояния SIP-транка
check
Команда проверки доступности направления. Выполняется посредством отправки запроса OPTIONS.
Тест может выполняться для определенного транка или для всех транков группы либо кластера.
Путь команды:
/domain/<DOMAIN>/trunk/sip/check
Синтаксис:
check <GROUP> [<TRUNK_INTERFACE>] [timerF = <TIMEOUT>]
Параметры:
<GROUP> - название существующей группы интерфейсов. Символ "*" используется для указания всех групп транков;
<TRUNK_INTERFACE> - логическое имя транка. Символ "*" используется для указания всех интерфейсов группы.
Если ответ не получен (направление на данный транк не доступно), то выводится результат "timeout".
Примечание.
Если удаленный клиент не поддерживает запросы OPTIONS, и при этом не отвечает ответом 405, то результат будет таким же, хотя реально направление доступно для вызовов.
В таком случае периодический контроль доступности должен быть отключен (set options_control 0).
<TIMEOUT> - тайм-аут ожидания ответа, в пределах которого отправляются повторные запросы, если удаленная сторона не отвечает. Задается в миллисекундах. Для выключения контроля установите значение тайм-аута - 0.
Пример:
admin@[ds1@ecss1]:/$ domain/biysk.local/trunk/sip/check smg.gr smg-4 timerF = 5000
Executed on the sip1@ecss2
Intermediate (incomplete) result:
Process to <<"smg-4">> check is started: {<0.22114.0>,<0.22114.0>}
...
Executed on the sip1@ecss2
Intermediate (incomplete) result:
Try to send OPTIONS to <<"smg-4">> (timerF = 5000)
...
Executed on the sip1@ecss2
┌────────┬───────┬────────────┬────────────────────────────────────────────────────────────────────────────────┐
│ Group │ Trunk │ Accessible │ Check info │
├────────┼───────┼────────────┼────────────────────────────────────────────────────────────────────────────────┤
│ smg.gr │ smg-4 │ true │ OPTIONS to <sip:192.168.2.8>: 200 OK, cseq: 200599 OPTIONS. Request by node: si│
│ │ │ │p1@ecss2 │
└────────┴───────┴────────────┴────────────────────────────────────────────────────────────────────────────────┘
[exec at: 17.03.2019 11:35:45, exec time: 392ms, nodes: sip1@ecss2]
Просмотр информации о SIP-транке
info
Команда для просмотра информации о настройках параметров транка и профилей транка.
Дополнительное описание параметров интерфейсов (транков) приведено в Приложении Б. Набор параметров интерфейса SIP.
Путь команды:
/domain/<DOMAIN>/trunk/sip/info
Синтаксис:
info <GROUP> [<TRUNK_INTERFACE>] [--profile <PROFILE>]
Параметры:
<GROUP> - название существующей группы интерфейсов, символ "*" используется для указания всех групп транков;
<TRUNK_INTERFACE> - логическое имя транка, символ "*" используется для указания всех интерфейсов группы.
Для просмотра свойств группы имя интерфейса транка (символ "*") не указывается.
--profile - флаг используется для просмотра информации о конфигурации профилей транка;
<PROFILE> - имя профиля, символ "*" используется для указания всех профилей транков.
Пример:
Свойства определенного транка:
admin@[ds1@ecss1]:/$ domain/biysk.local/trunk/sip/info smg.gr smg-4 Executed on the sip1@ecss2 ┌────────┬───────┬───────────┬────────────┬────────────┬────────────────────────────────────────────────────────────────────────┐ │ Group │ Uri │ Is active │ Is blocked │ Is dynamic │ Parameters │ ├────────┼───────┼───────────┼────────────┼────────────┼────────────────────────────────────────────────────────────────────────┤ │ smg.gr │ smg-4 │ true │ false │ false │ declared by admin at 15.12.2018 22:44:07 │ │ │ │ │ │ │ │ │ │ │ │ │ │ remote-end-point = 192.168.2.8:5061 │ │ │ │ │ │ │ local-end-point = ipset1:5061 │ │ │ │ │ │ │ mode = sip-t │ │ │ │ │ │ │ connect time = 17.03.2019 09:25:04 │ │ │ │ │ │ │ uptime = 2h 32m │ │ │ │ │ │ │ disconnections number = 0 │ │ │ │ │ │ │ last connection status = 200 │ │ │ │ │ │ │ - - - - - - - - - - - - - - = - - - - - - - - - - - - - - │ │ │ │ │ │ │ alarm_enable = false │ │ │ │ │ │ │ category_to_sip = default │ │ │ │ │ │ │ cdpn-transformation = none │ │ │ │ │ │ │ compact-form = default │ │ │ │ │ │ │ content_encoding = none │ │ │ │ │ │ │ disable-remote-port-control = false │ │ │ │ │ │ │ display-name-encoding = default │ │ │ │ │ │ │ dtmf-duration = 100 │ │ │ │ │ │ │ dtmf-relay = false │ │ │ │ │ │ │ history-info = false │ │ │ │ │ │ │ inc-authentication = none │ │ │ │ │ │ │ inc-authentication_type = user │ │ │ │ │ │ │ inc-login = none │ │ │ │ │ │ │ inc-password = none │ │ │ │ │ │ │ maddr = none │ │ │ │ │ │ │ my_from = biysk.local │ │ │ │ │ │ │ options_control = disable │ │ │ │ │ │ │ original-cdpn-to = true │ │ │ │ │ │ │ out-login = none │ │ │ │ │ │ │ out-password = none │ │ │ │ │ │ │ out-registration = disable │ │ │ │ │ │ │ referred-by-as-cgpn = false │ │ │ │ │ │ │ remote-client = default │ │ │ │ │ │ │ remote-ctr-indication = rpi │ │ │ │ │ │ │ remote-network-type = local │ │ │ │ │ │ │ req100rel = true │ │ │ │ │ │ │ rfc-4028-control = force │ │ │ │ │ │ │ routing.context = ctx_from_ewsd │ │ │ │ │ │ │ sip-domain = 192.168.2.8 (use-address) │ │ │ │ │ │ │ sip-modifications = │ │ │ │ │ │ │ sip-transit = │ │ │ │ │ │ │ sip_transport = udp_only │ │ │ │ │ │ │ symbol_hash_as_is = false │ │ │ │ │ │ │ tel-uri-in-diversion = false │ │ │ │ │ │ │ trunk (trunk name) = biysk.local.smg.gr.trunk.autoname │ │ │ │ │ │ │ user-name = smg-4 │ └────────┴───────┴───────────┴────────────┴────────────┴────────────────────────────────────────────────────────────────────────┘ [exec at: 17.03.2019 11:57:26, exec time: 100ms, nodes: sip1@ecss2]
Просмотр конфигурации профилей транков:
admin@[ds1@ecss1]:/$ domain/biysk.local/trunk/sip/info --profile * Executed on the sip1@ecss2 ┌───────────┬───────────────────────────┐ │ Profile │ Parameters │ ├───────────┼───────────────────────────┤ │ ISUP.ETSI │ network-node-id = 0 │ │ │ network-id = 0 │ │ │ use-global-callref = true │ │ │ country-code = 250 │ │ ISUP.RUS │ isup_r_ccl_send = true │ └───────────┴───────────────────────────┘ [exec at: 17.03.2019 11:58:12, exec time: 100ms, nodes: sip1@ecss2]
Просмотр активных вызовов, установленных через SIP-транк
call-list
Команда просмотра списка активных вызовов через транк.
Путь команды:
/domain/<DOMAIN>/trunk/sip/call-list
Синтаксис:
сall-list [GROUP] [INTERFACE] [OPTIONS]
Параметры:
<GROUP> - название группы интерфейсов. Символ "*" указывается для экспорта всех групп интерфейсов;
<INTERFACE> - логическое имя транка;
OPTIONS:
- <--complete> - установка данного флага позволяет отобразить все интерфейсы, на которые были приняты вызовы;
- <--more T [sec|min|hour]> - установка данного флага позволяет отобразить все вызовы, длительность которых более установленного времени;
- <--less T [sec|min|hour]> - установка данного флага позволяет отобразить все вызовы, длительность которых менее установленного времени.
Пример:
admin@[ds1@ecss1]:/$ domain/biysk.local/trunk/sip/call-list
Executed on the sip1@ecss2
┌───────────────┬────────────────────────────────┬──────────┬──────────────────────────────────────────┬───────────────────────────────────────────────────────┐
│ Interface URI │ Direction │ State │ Time │ Additional info │
├───────────────┼────────────────────────────────┼──────────┼──────────────────────────────────────────┼───────────────────────────────────────────────────────┤
│ ems1 │ sip[245718] <- ssw[9639695494] │ outgoing │ Start: Sat, 16 Mar 2019 19:15:06 │ Node: sip1@ecss1, <61649.31655.8> │
│ │ │ │ Last activity: Sun, 17 Mar 2019 11:14:40 │ CallRef: 847685256 │
│ │ │ │ │ Call-ID: "BA:8c6f71e140668560:8c6f71e7addf886e" │
│ │ │ │ │ SessionID: <<"BA:8c6f71e140668560:8c6f71e7addf886e">> │
│ │ │ │ │ Session handler: {amqp_io_8,<61649.31655.8>} │
│ smg-4 │ sip[9639695494] -> ssw[245718] │ incoming │ Start: Sat, 16 Mar 2019 19:15:06 │ Node: sip1@ecss1, <61649.31609.8> │
│ │ │ │ Last activity: Sun, 17 Mar 2019 11:14:40 │ CallRef: 847685256 │
│ │ │ │ │ Call-ID: "1552-738506-319237" │
│ │ │ │ │ SessionID: <<"8c6f71e140668560">> │
│ │ │ │ │ Session handler: {amqp_io_16,<61649.31609.8>} │
└───────────────┴────────────────────────────────┴──────────┴──────────────────────────────────────────┴───────────────────────────────────────────────────────┘
┌────────────┐
│ 2 sessions │
└────────────┘
[exec at: 17.03.2019 11:14:40, exec time: 226ms, nodes: sip1@ecss2]