Команды управления MEGACO-шлюзами.
<DOMAIN> - имя виртуальной АТС.
add
Данной командой производится добавление шлюза/шлюзов в кластер PA Megaco.
Путь команды:
domain/<DOMAIN>/megaco/gateways/add
Синтаксис:
add <GATEWAY1> [, <GATEWAY2> [,<GATEWAY3>,...]]
Параметры:
<GATEWAY> - имя шлюза.
Пример:
elena@[ds1@ecss1]:/$ domain/test.domain/megaco/gateways/add local test Result of update cluster settings:ok -------------------- |Gateway| Result | |-------+----------| |test |not exists| --------------------
aliases
Команда просмотра информации об алиасе определенного порта заданного шлюза.
Путь команды:
domain/<DOMAIN>/megaco/gateways/aliases
Синтаксис:
aliases <GW_NAME> [<PORT>]
Параметры:
<GW_NAME> - имя Megaco-шлюза;
<PORT> - имя физической терминации, задается в виде p/n, где n - номер физической терминации (не обязательно должен быть равен номеру порта). Может быть задан диапазон териминаций через дефис "-" (пример, p/{0-10}). При указании символа "*" будет показана информация об алиасах всех физических терминаций заданного шлюза.
Пример:
elena@[ds1@ecss1]:/$ domain/test.domain/megaco/gateways/aliases test p/1 ---------------------------------------------------- |Port| Interface |Domain|Address|State|DisplayName| |----+------------+------+-------+-----+-----------| |p/1 |acp:p/1@test| | | | | ----------------------------------------------------
audit-info
Команда для мониторинга работы PA Megaco.
Путь команды:
domain/<DOMAIN>/megaco/gateways/audit-info
Синтаксис:
audit-info <GATEWAY NAME> [<TERMINATIONID>] [<OPTS>]
Параметры:
<GATEWAY NAME> - имя шлюза;<TERMINATIONID> - идентификатор терминации:
- root - номер root терминации;
- "tid" - любой другой номер терминации.
<OPTS> - вывод детальной информации, задается в виде -detailed <false|true>, где false - не выводить детальную информацию, true - выводить детальную информацию.
Пример 1:
pavlenko@[ds3@ecss3]:/$ domain/d.local/megaco/gateways/audit-info tau72maxim p/0 -detailed false GatewayID: "tau72maxim" Active Context Num: 2 Active Termination Num: 4 ---------------------- |Context|Terminations| |-------+------------| |1 |"p/1" | | |"v5000" | | | | |2 |"p/0" | | |"v5004" | ---------------------- [exec at: 24.03.2015 09:52:06, exec time: 225ms, nodes: pa_megaco@pavlenko]
Пример 2:
pavlenko@[ds3@ecss3]:/$ domain/d.local/megaco/gateways/audit-info tau72maxim p/0 -detailed true
GatewayID: "tau72maxim"
Active Context Num: 2
Active Termination Num: 4
----------------------
|Context|Terminations|
|-------+------------|
|1 |"p/1" |
| |"v5000" |
| | |
|2 |"p/0" |
| |"v5004" |
----------------------
termId "p/1"
ctx: 1
--------------------------------------------------------------------------------------------------------
| Descriptor | Body |
|---------------------+--------------------------------------------------------------------------------|
|eventsDescriptor |{'EventsDescriptor',176, |
| | [{'RequestedEvent',"al/fl",asn1_NOVALUE,asn1_NOVALUE,[]}, |
| | {'RequestedEvent',"al/on",asn1_NOVALUE,asn1_NOVALUE, |
| | [{'EventParameter',"strict",["exact"],asn1_NOVALUE}]}, |
| | {'RequestedEvent',"ctyp/dtone",asn1_NOVALUE,asn1_NOVALUE,[]}]} |
| | |
|mediaDescriptor |{'MediaDescriptor',asn1_NOVALUE, |
| | {multiStream, |
| | [{'StreamDescriptor',1, |
| | {'StreamParms', |
| | {'LocalControlDescriptor',sendRecv,false,false, |
| | [{'PropertyParm',"tdmc/ec",["on"],asn1_NOVALUE}]}, |
| | asn1_NOVALUE,asn1_NOVALUE}}]}} |
| | |
|signalsDescriptor |[] |
| | |
|digitMapDescriptor |{'DigitMapDescriptor',"primary_dm", |
| | {'DigitMapValue',asn1_NOVALUE,asn1_NOVALUE,asn1_NOVALUE, |
| | "(F[E0-9][E0-9].F|EF[E0-9][E0-9].F|E[E0-9][E0-9].F|10xx.|11[0-9ABCDEF].||
| |1[0-9ABCDEF][0-9ABCDEF][0-9ABCDEF]|1xx.|2[0-9ABCDEF][0-9ABCDEF][0-9ABCDEF]|30007|
| |3|3[0-9ABCDEF][0-9ABCDEF]|3[0-9ABCDEF][0-9ABCDEF][0-9ABCDEF]|413|4[0-9ABCDEF][0-|
| |9ABCDEF][0-9ABCDEF]|5[0-9ABCDEF][0-9ABCDEF][0-9ABCDEF]|6[0-9ABCDEF][0-9ABCDEF][0|
| |-9ABCDEF]|742[0-9ABCDEF][0-9ABCDEF][0-9ABCDEF][0-9ABCDEF][0-9ABCDEF][0-9ABCDEF]||
| |7[0-9ABCDEF][0-9ABCDEF][0-9ABCDEF]|8[0-9ABCDEF][0-9ABCDEF][0-9ABCDEF][0-9ABCDEF]|
| |[0-9ABCDEF][0-9ABCDEF][0-9ABCDEF][0-9ABCDEF][0-9ABCDEF][0-9ABCDEF]|9[0-9ABCDEF][|
| |0-9ABCDEF][0-9ABCDEF][0-9ABCDEF][0-9ABCDEF][0-9ABCDEF][0-9ABCDEF]|A[0-9ABCDEF][0|
| |-9ABCDEF][0-9ABCDEF]|B[0-9ABCDEF][0-9ABCDEF][0-9ABCDEF]|C[0-9ABCDEF][0-9ABCDEF][|
| |0-9ABCDEF])"}} |
| | |
|statisticsDescriptor |[{'StatisticsParameter',"rtp/ps",["0"]}, |
| | {'StatisticsParameter',"rtp/pr",["0"]}, |
| | {'StatisticsParameter',"rtp/pl",["0"]}, |
| | {'StatisticsParameter',"rtp/jit",["0"]}] |
| | |
|eventBufferDescriptor|[] |
| | |
|emptyDescriptors |{'AuditDescriptor',[observedEventsToken]} |
--------------------------------------------------------------------------------------------------------
termId "v5000"
ctx: 1
--------------------------------------------------------------------------------------------------------
| Descriptor | Body |
|---------------------+--------------------------------------------------------------------------------|
|eventsDescriptor |{'EventsDescriptor',asn1_NOVALUE,[]} |
| | |
|mediaDescriptor |{'MediaDescriptor',asn1_NOVALUE, |
| | {multiStream, |
| | [{'StreamDescriptor',1, |
| | {'StreamParms', |
| | {'LocalControlDescriptor',sendRecv,false,false,[]}, |
| | {'LocalRemoteDescriptor', |
| | [[{'PropertyParm',"v",["0"],asn1_NOVALUE}, |
| | {'PropertyParm',"o", |
| | ["- 7777267175436 7777267175469 IN IP4 192.168.23.195|
| |"], |
| | asn1_NOVALUE}, |
| | {'PropertyParm',"s",["-"],asn1_NOVALUE}, |
| | {'PropertyParm',"c", |
| | ["IN IP4 192.168.23.195"], |
| | asn1_NOVALUE}, |
| | {'PropertyParm',"t",["0 0"],asn1_NOVALUE}, |
| | {'PropertyParm',"m", |
| | ["audio 5000 RTP/AVP 0"], |
| | asn1_NOVALUE}, |
| | {'PropertyParm',"a", |
| | ["rtpmap:0 PCMU/8000"], |
| | asn1_NOVALUE}]]}, |
| | {'LocalRemoteDescriptor', |
| | [[{'PropertyParm',"v",["0"],asn1_NOVALUE}, |
| | {'PropertyParm',"o", |
| | ["- 7777263149873 7777263149908 IN IP4 192.168.23.195|
| |"], |
| | asn1_NOVALUE}, |
| | {'PropertyParm',"s",["-"],asn1_NOVALUE}, |
| | {'PropertyParm',"c", |
| | ["IN IP4 192.168.23.195"], |
| | asn1_NOVALUE}, |
| | {'PropertyParm',"t",["0 0"],asn1_NOVALUE}, |
| | {'PropertyParm',"a",["ptime:20"],asn1_NOVALUE}, |
| | {'PropertyParm',"m", |
| | ["audio 5004 RTP/AVP 0"], |
| | asn1_NOVALUE}, |
| | {'PropertyParm',"a", |
| | ["rtpmap:0 PCMU/8000"], |
| | asn1_NOVALUE}]]}}}]}} |
| | |
|signalsDescriptor |[] |
| | |
|statisticsDescriptor |[{'StatisticsParameter',"rtp/ps",["0"]}, |
| | {'StatisticsParameter',"rtp/pr",["0"]}, |
| | {'StatisticsParameter',"rtp/pl",["0"]}, |
| | {'StatisticsParameter',"rtp/jit",["0"]}] |
| | |
|eventBufferDescriptor|[] |
| | |
|emptyDescriptors |{'AuditDescriptor',[observedEventsToken,digitMapToken]} |
--------------------------------------------------------------------------------------------------------
termId "p/0"
ctx: 2
--------------------------------------------------------------------------------------------------------
| Descriptor | Body |
|---------------------+--------------------------------------------------------------------------------|
|eventsDescriptor |{'EventsDescriptor',2609, |
| | [{'RequestedEvent',"ctyp/dtone",asn1_NOVALUE,asn1_NOVALUE,[]}, |
| | {'RequestedEvent',"al/fl",asn1_NOVALUE,asn1_NOVALUE,[]}, |
| | {'RequestedEvent',"al/on",asn1_NOVALUE,asn1_NOVALUE, |
| | [{'EventParameter',"strict",["exact"],asn1_NOVALUE}]}]} |
| | |
|mediaDescriptor |{'MediaDescriptor',asn1_NOVALUE, |
| | {multiStream, |
| | [{'StreamDescriptor',1, |
| | {'StreamParms', |
| | {'LocalControlDescriptor',sendRecv,false,false,[]}, |
| | asn1_NOVALUE,asn1_NOVALUE}}]}} |
| | |
|signalsDescriptor |[] |
| | |
|digitMapDescriptor |{'DigitMapDescriptor',"primary_dm", |
| | {'DigitMapValue',asn1_NOVALUE,asn1_NOVALUE,asn1_NOVALUE, |
| | "(F[E0-9][E0-9].F|EF[E0-9][E0-9].F|E[E0-9][E0-9].F|10xx.|11[0-9ABCDEF].||
| |1[0-9ABCDEF][0-9ABCDEF][0-9ABCDEF]|1xx.|2[0-9ABCDEF][0-9ABCDEF][0-9ABCDEF]|30007|
| |3|3[0-9ABCDEF][0-9ABCDEF]|3[0-9ABCDEF][0-9ABCDEF][0-9ABCDEF]|413|4[0-9ABCDEF][0-|
| |9ABCDEF][0-9ABCDEF]|5[0-9ABCDEF][0-9ABCDEF][0-9ABCDEF]|6[0-9ABCDEF][0-9ABCDEF][0|
| |-9ABCDEF]|742[0-9ABCDEF][0-9ABCDEF][0-9ABCDEF][0-9ABCDEF][0-9ABCDEF][0-9ABCDEF]||
| |7[0-9ABCDEF][0-9ABCDEF][0-9ABCDEF]|8[0-9ABCDEF][0-9ABCDEF][0-9ABCDEF][0-9ABCDEF]|
| |[0-9ABCDEF][0-9ABCDEF][0-9ABCDEF][0-9ABCDEF][0-9ABCDEF][0-9ABCDEF]|9[0-9ABCDEF][|
| |0-9ABCDEF][0-9ABCDEF][0-9ABCDEF][0-9ABCDEF][0-9ABCDEF][0-9ABCDEF]|A[0-9ABCDEF][0|
| |-9ABCDEF][0-9ABCDEF]|B[0-9ABCDEF][0-9ABCDEF][0-9ABCDEF]|C[0-9ABCDEF][0-9ABCDEF][|
| |0-9ABCDEF])"}} |
| | |
|statisticsDescriptor |[{'StatisticsParameter',"rtp/ps",["0"]}, |
| | {'StatisticsParameter',"rtp/pr",["0"]}, |
| | {'StatisticsParameter',"rtp/pl",["0"]}, |
| | {'StatisticsParameter',"rtp/jit",["0"]}] |
| | |
|eventBufferDescriptor|[] |
| | |
|emptyDescriptors |{'AuditDescriptor',[observedEventsToken]} |
--------------------------------------------------------------------------------------------------------
termId "v5004"
ctx: 2
--------------------------------------------------------------------------------------------------------
| Descriptor | Body |
|---------------------+--------------------------------------------------------------------------------|
|eventsDescriptor |{'EventsDescriptor',asn1_NOVALUE,[]} |
| | |
|mediaDescriptor |{'MediaDescriptor',asn1_NOVALUE, |
| | {multiStream, |
| | [{'StreamDescriptor',1, |
| | {'StreamParms', |
| | {'LocalControlDescriptor',sendRecv,false,false,[]}, |
| | {'LocalRemoteDescriptor', |
| | [[{'PropertyParm',"v",["0"],asn1_NOVALUE}, |
| | {'PropertyParm',"o", |
| | ["- 7777263149873 7777263149908 IN IP4 192.168.23.195|
| |"], |
| | asn1_NOVALUE}, |
| | {'PropertyParm',"s",["-"],asn1_NOVALUE}, |
| | {'PropertyParm',"c", |
| | ["IN IP4 192.168.23.195"], |
| | asn1_NOVALUE}, |
| | {'PropertyParm',"t",["0 0"],asn1_NOVALUE}, |
| | {'PropertyParm',"a",["ptime:20"],asn1_NOVALUE}, |
| | {'PropertyParm',"m", |
| | ["audio 5004 RTP/AVP 0"], |
| | asn1_NOVALUE}, |
| | {'PropertyParm',"a", |
| | ["rtpmap:0 PCMU/8000"], |
| | asn1_NOVALUE}]]}, |
| | {'LocalRemoteDescriptor', |
| | [[{'PropertyParm',"v",["0"],asn1_NOVALUE}, |
| | {'PropertyParm',"o", |
| | ["- 7777267175436 7777267175469 IN IP4 192.168.23.195|
| |"], |
| | asn1_NOVALUE}, |
| | {'PropertyParm',"s",["-"],asn1_NOVALUE}, |
| | {'PropertyParm',"c", |
| | ["IN IP4 192.168.23.195"], |
| | asn1_NOVALUE}, |
| | {'PropertyParm',"t",["0 0"],asn1_NOVALUE}, |
| | {'PropertyParm',"m", |
| | ["audio 5000 RTP/AVP 0"], |
| | asn1_NOVALUE}, |
| | {'PropertyParm',"a", |
| | ["rtpmap:0 PCMU/8000"], |
| | asn1_NOVALUE}]]}}}]}} |
| | |
|signalsDescriptor |[] |
| | |
|statisticsDescriptor |[{'StatisticsParameter',"rtp/ps",["0"]}, |
| | {'StatisticsParameter',"rtp/pr",["0"]}, |
| | {'StatisticsParameter',"rtp/pl",["0"]}, |
| | {'StatisticsParameter',"rtp/jit",["0"]}] |
| | |
|eventBufferDescriptor|[] |
| | |
|emptyDescriptors |{'AuditDescriptor',[observedEventsToken,digitMapToken]} |
--------------------------------------------------------------------------------------------------------
[exec at: 24.03.2015 09:52:14, exec time: 269ms, nodes: pa_megaco@pavlenko]
change-routing-ctx
Данной командой производится смена контекста маршрутизации для шлюза в кластере Megaco.
Команда доступна начиная с версии ПО 3.4.2.
Путь команды:
domain/<DOMAIN>/megaco/gateways/change-routing-ctx
Синтаксис:
change-routing-ctx <ROUTING_CONTEXT> <GATEWAY1> [, <GATEWAY2> [,<GATEWAY3>,...]]
Параметры:
<ROUTING_CONTEXT> - имя контекста маршрутизации;
<GATEWAY> - имя шлюза.
Пример:
elena@[ds1@ecss1]:/$ domain/test.domain/megaco/gateways/change-routing-ctx ctx_city_local test Result of update cluster settings:ok ---------------- |Gateway|Result| |-------+------| |test |ok | ----------------
list
Команда предназначена для просмотра списка шлюзов в кластере MEGACO.
Путь команды:
domain/<DOMAIN>/megaco/gateways/list
Синтаксис:
list
Параметры:
Команда не содержит аргументов.
Пример:
ssw@[megaco3@ecss3]:/#> domain/test.domain/megaco/gateways/list tau72s tau72a max_smg tau72t tau72v
remove
Командой производится удаление шлюза из кластера MEGACO.
Путь команды:
domain/<DOMAIN>/megaco/gateways/remove
Синтаксис:
remove <GATEWAY1> [, <GATEWAY2> [,<GATEWAY3>,...]] [-force] [--delete-ifaces]
Параметры:
<GATEWAY> - имя шлюза;
-force - принудительное удаление всех активных вызовов. Если этот флаг не используется, то шлюз будет удален после окончания последнего вызова
--delete-ifaces - флаг, при указании которого будут удалены интерфейсы и алиасы.
Пример:
ssw@[megaco3@ecss3]:/#> /cluster/adapter/megaco1/gateways/remove gw123 [remove] gateways will be removed from cluster Delete interfaces and aliases?: [n]/y ?> y [remove] gateways will be removed from cluster Do you really want to remove gateway(s) from cluster?: [n]/y ?> y ok
signaling-info
Команда просмотра информации о количестве переданных/принятых пакетов/байтов к/от шлюзу/а.
Путь команды:
domain/<DOMAIN>/megaco/gateways/signaling-info
Синтаксис:
signaling-info <GATEWAY>
Параметры:
<GATEWAY> - имя Megaco-шлюза, при указании символа "*" будет выведена информация по всем megaco-шлюзам виртуальной АТС.
Пример:
elena@[ds1@ecss1]:/$ domain/test.domain/megaco/gateways/signaling-info *
status
Просмотр состояния всех/определенного шлюза кластера Megaco.
Путь команды:
domain/<DOMAIN>/megaco/gateways/status
Синтаксис:
status <GATEWAY> [select <PARAM>]
Параметры:
<GATEWAY> - имя шлюза. Символ "*" используется для просмотра информации о всех шлюзах;<PARAM> - название параметра:
- acp_userid - идентификатор пользователя acp_stack;
- keep_alive_process - идентификатор процесса, который осуществляет периодический запрос аудита;
- megaco_ch - идентификатор стека megaco;
- mid - идентификатор шлюза;
- node_owner - идентификатор ноды, на которой зарегистрирован шлюз;
- profile - имя профиля шлюза;
- sdp_templates - шаблон SDP для формирования оффера;
- service_state - состояние: в работе или нет;
- state_name - состояние шлюза на адаптере;
- transport_info - транспортная информация шлюза.
Пример:
elena@[ds1@ecss1]:/$ domain/test.domain/megaco/gateways/status tau72akadem select keep_alive_process -------------------- |keep_alive_process| |------------------| |<0.15642.13> | --------------------
term-info
Просмотр терминальной информации.
Путь команды:
/cluster/adapter/<CLUSTER>/gateways/term-info
Синтаксис:
term-info <GATEWAY> <PORTS> [select <PARAM1>[, <PARAM2>[, <PARAM3>, ...]]]
Параметры:
<GATEWAY> - имя шлюза;<PORT> - номер порта шлюза. Символ "*" используется для указания всех портов;
<PARAM> - свойства порта, принимает значения:
- acp_sh - информация об обработчике ACP-сессии;
- active_side - информация о том, на каком плече вызова находится эта терминация (origination/termination);
- context - в каком контексте сейчас находится эта терминация (мегако-контексты);
- ct_requester - информация, кто запросил у этой терминации "continuity-test";
- local_sdp - локальная SDP;
- proc_pid - номер процесса, который сейчас обрабатывает сообщения от этой терминации;
- sdp_template - шаблон SDP;
- signals - ожидаемые сигналы от терминации;
- term_id - номер терминации;
- virt_id - номер виртуальной терминации, связанной с данной физической терминацией;
- acp_sid - идентификатор ACP-сессии;
- call_assns - дополнительные параметры вызова;
- context_id - номер контекста, в котором сейчас находится терминация;
- digitmap - диджитмам для текущей терминации;
- id - внутренний номер терминации;
- megaco_ch - номер обработчика MEGACO, через который работает эта терминация;
- profile - профиль (обычный шлюз или транковый);
- service_state - в обслуживании или выведен из обслуживания;
- sir_scaffold - заготовка для "SetupIndicationRequest";
- type - тип: физическая или виртуальная терминация;
- active_call_ref - текущий идентификатор звонка;
- callerid - информация для АОН;
- context_info - дополнительная информация о контексте;
- events - ожидаемые события от терминации;
- initial_call_ref - первоначальный индикатор звонка;
- owner - домен-владелец данной терминации;
- refer - номер для ACP;
- side - информация о плече звонка (origination/termination);
- state_name - текущее состояние терминации;
- uri - uri-интерфейса, связанного с этой терминацией.
Без указания <PARAM> выводит информацию для hook_state, state_name, uri, events, signals.
Пример:
domain/test.domain/megaco/gateways/term-info tau72akadem * select uri ---------------------------- | uri | |--------------------------| |<<"acp:p/12@tau72akadem">>| |<<"acp:p/4@tau72akadem">> | |<<"acp:p/0@tau72akadem">> | |<<"acp:p/1@tau72akadem">> | |<<"acp:p/13@tau72akadem">>| |<<"acp:p/14@tau72akadem">>| |<<"acp:p/15@tau72akadem">>| |<<"acp:p/7@tau72akadem">> | |<<"acp:p/8@tau72akadem">> | |<<"acp:p/5@tau72akadem">> | |<<"acp:p/11@tau72akadem">>| |<<"acp:p/3@tau72akadem">> | |<<"acp:p/10@tau72akadem">>| |<<"acp:p/9@tau72akadem">> | |<<"acp:p/6@tau72akadem">> | |<<"acp:p/2@tau72akadem">> | ----------------------------