declare

Команда используется для создания описания нового Media Gateway Controller-а в системе ECSS-10.

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

/mgc/declare

Синтаксис:

declare <NAME> <PEER_1> [, <PEER_2> [...]] [<DEVICE_NAME> [<DESCRIPTION>]]

Параметры:

<NAME> - уникальное в рамках системы имя MGC;
<PEER_N> - имя peer-а, к которому привязывается MGC. В случаях нескольких peer-ов, их необходимо записывать через запятую;
<DEVICE_NAME> - имя шлюза, который регистрирует (анонсирует) свои порты на MGC;
<DESCRIPTION> - описание данного шлюза.

Пример:

support@[mycelium1@ecss1]:/$ /mgc/declare mgc_smg_224 smg_224_tcp, smg_224_udp megaco_224 GW on SMG 192.168.1.224

Media gateway mgc_smg_224 successfully created.

support@[mycelium1@ecss1]:/$ /mgc/declare mgc_smg_224 smg_224_tcp, smg_224_udp megaco_224 GW on SMG 192.168.1.224

Error: media gateway mgc_smg_224 already created

remove

Команда используется для удаления Media Gateway Controller-а из ECSS-10.

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

/mgc/remove

Синтаксис:

remove <NAME> [--force]

Параметры:

<NAME> - имя MGC

--force - выполнить команду без запроса подтверждения.

Пример:

support@[mycelium1@ecss1]:/$ /mgc/remove mgc_smg_224 --force

Media gateway mgc_smg_224 successfully removed.

support@[mycelium1@ecss1]:/$ /mgc/remove mgc_smg_224

Error: media gateway mgc_smg_224 not exists.

support@[mycelium1@ecss1]:/$ /mgc/remove mgc_smg_224

[remove] You are going to remove media gateway mgc_smg_224, but it used in ISUP trunks: RTK_TRUNK_1, RTK_TRUNK_2.
Are you sure?: yes/no ?>

Yes
Media gateway mgc_smg_224 successfully removed.

info

Команда используется для просмотра описания медиа шлюзов в системе ECSS-10.

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

/mgc/info

Синтаксис:

info [--extended] [<NAME>]

Параметры:

<NAME> - уникальное в рамках системы имя MGC

Пример:

support@[mycelium1@ecss1]:/$ /mgc/info

┌───────────┬───────────┬────────────────┬──────────────────┬────────────────────────────────────┐
│  Name     │   Peer    │      Port      │       Bind       │         Description                │
├───────────┼───────────┼────────────────┼──────────────────┼────────────────────────────────────┤
│mgc_smg_224│smg_224_tcp│e1p1@megaco_224 │ISUP{1,160,125,0} │GW on SMG 192.168.1.224             │
│           │smg_224_udp│e1p2@megaco_224 │ISUP{2,160,125,0} │                                    │
│           │           │e1p3@megaco_224 │ISUP{3,160,125,0} │                                    │
│           │           │e1p30@megaco_224│ISUP{1,160,126,0} │                                    │
│           │           │e1p31@megaco_224│ISUP{1,160,126,0} │                                    │
│mgc_smg_225│smg_225    │e4p1@megaco_225 │                  │GW on SMG 192.168.1.225             │
│           │           │e4p2@megaco_225 │                  │                                    │
└───────────┴───────────┴────────────────┴──────────────────┴────────────────────────────────────┘
Legend:
  - ISUP{CIC,OPC,DPC,NI}

support@[mycelium1@ecss1]:/$ /mgc/info mgc_smg_225

┌───────────┬───────────┬────────────────┬──────────────────┬────────────────────────────────────┐
│  Name     │   Peer    │      Port      │       Bind       │         Description                │
├───────────┼───────────┼────────────────┼──────────────────┼────────────────────────────────────┤
│mgc_smg_225│smg_225    │e4p1@megaco_225 │                  │GW on SMG 192.168.1.225             │
│           │           │e4p2@megaco_225 │                  │                                    │
└───────────┴───────────┴────────────────┴──────────────────┴────────────────────────────────────┘
Legend:
  - ISUP{CIC,OPC,DPC,NI}

support@[mycelium1@ecss1]:/$ /mgc/info --extended mgc_smg_225

┌───────────┬───────────┬────────────────┬──────────────────┬────────────────────────────────────┬───────────────────────────────────┐
│  Name     │   Peer    │      Port      │       Bind       │         Description                │            Options                │
├───────────┼───────────┼────────────────┼──────────────────┼────────────────────────────────────┼───────────────────────────────────┤
│mgc_smg_225│smg_225    │e4p1@megaco_225 │                  │GW on SMG 192.168.1.225             │trans_timer = 123                  │
│           │           │e4p2@megaco_225 │                  │                                    │ppid = 7                           │
│           │           │                │                  │                                    │encoding_mod = custom_text_encoder │
└───────────┴───────────┴────────────────┴──────────────────┴────────────────────────────────────┴───────────────────────────────────┘
Legend:
  - ISUP{CIC,OPC,DPC,NI)

clean

Команда используется для сброса свойств MGC в значение по умолчанию.

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

/mgc/clean

Синтаксис:

clean <DEVICE_NAME> <KEY>

Параметры:

<DEVICE_NAME> - уникальное в рамках системы имя медиа-шлюза;

<KEY> :: - ключ для активации:

  • peers - имя пира для привязки;
  • description - описание данного MGC;
  • trans_id - идентификатор текущей транзакции;
  • max_trans_id - крайний идентификатор транзакции (по умолчанию: бесконечный);
  • request_timer - таймер ожидания ответа;
  • long_request_timer - таймер ожидания ответа (по умолчанию: 60000);
  • request_keep_alive_timeout - таймер request-keep-alive timer (по умолчанию: обычный);
  • reply_timer - таймер ожидания подтверждения (пл умолчанию: 30000);
  • call_proxy_gc_timeout - таймер ожидания для прокси вызовов (по умолчанию: 5000);
  • auto_ack - автоматическое подтверждение при получении ответа на транзакцию (по умолчанию: False);
  • trans_ack - должны ли подтверждения накапливаться или отправляться сразу (по умолчанию: False);
  • trans_ack_maxcount - максимальное количество накапливаемых подтверждений (по умолчанию: 10);
  • trans_req - должны ли запросы накапливаться или отравляться сразу (по умолчанию: False);
  • trans_req_maxcount - максимальное количество накапливаемых запросов (по умолчанию: 10);
  • trans_timer - таймаут ожидания накопления запросов или подтверждений (по умолчанию: False);
  • pending_timer - таймер перевода в ожидание (по умолчанию: 30000);
  • sent_pending_limit - предел транзакций ожидающих подтверждение (по умолчанию: бесконечно);
  • recv_pending_limit - предел транзакций ожидающих запрос  (по умолчанию: бесконечно);
  • protocol_version - актуальная версия протокола (по умолчанию: 1);
  • strict_version - строгий контроль версии протокола. То есть при получении сообщения, система убеждается, что версия является той, которая была согласована (по умолчанию: True);
  • threaded - если полученное сообщение содержит несколько запросов, эта опция указывает, должны ли запросы обрабатываться последовательно в одном процессе (по умолчанию: False);
  • resend_indication - эта опция указывает, будет ли транспортный модуль отправлять сообщения повторно (по умолчанию: false);
  • segment_reply_ind  - эта опция указывает, должна ли система уведомлять пользователя о полученных частичных ответах (по умолчанию: False);
  • segment_recv_timer - этот таймер запускается когда уже был получен последний сегмент сообщений, но еще не были получены все промежуточные сегменты (по умолчанию: 10000);
  • segment_send - исходящие сообщения должны быть сегментированы (по умолчанию: False);
  • max_pdu_size - максимальный размер сообщений (по умолчанию: бесконечный);
  • mid - идентификатор сообщения;
  • address - список разрешенных IP-адресов MG (<IP>:<порт>)

Пример:

support@[mycelium1@ecss1]:/$ /mgc/clean mgc_smg_225 encoding_mod

Property encoding_mod for MGC mgc_smg_225 successfully cleaned

support@[mycelium1@ecss1]:/$ /mgc/gateway/port/clean mgc_smg_220 encoding_mod

Error: mgc mgc_smg_220 not found

gateway-add

Команда используется для добавления новых медиа-шлюзов в MGC.

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

/mgc/gateway-add

Синтаксис:

gateway-add <NAME> <DEVICE_NAME>

Параметры:

<NAME> - уникальное в рамках системы MGC;
<DEVICE_NAME> - имя шлюза, который регистрирует (анонсирует) свои порты на MGC

Пример:

support@[mycelium1@ecss1]:/$ /mgc/gateway-add mgc_smg_224 megaco_224

Media gateway megaco_224 successfully added at MGC mgc_smg_224

support@[mycelium1@ecss1]:/$ /mgc/gateway-add mgc_smg_224 megaco_224

Error: media gateway megaco_224 already added at MGC other_mgc

support@[mycelium1@ecss1]:/$ /mgc/gateway-add mgc_smg_224 megaco_224

Error: MGC mgc_smg_224 not exists

gateway-remove

Команда используется для удаления медиа-шлюзов из MGC.

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

/mgc/gateway-remove

Синтаксис:

gateway-remove <NAME> <DEVICE_NAME>

Параметры:

<NAME> - уникальное в рамках системы MGC;
<DEVICE_NAME> - имя медиа шлюза

Пример:

support@[mycelium1@ecss1]:/$ /mgc/gateway-remove mgc_smg_224 megaco_224

Media gateway megaco_224 successfully removed from MGC mgc_smg_224

support@[mycelium1@ecss1]:/$ /mgc/gateway-remove mgc_smg_224 megaco_224

Error: media gateway megaco_224 not exists at MGC mgc_smg_224

support@[mycelium1@ecss1]:/$ /mgc/gateway-remove mgc_smg_224 megaco_224

Error: MGC mgc_smg_224 not exists

set

Команда используется для изменения свойств MGC в системе ECSS-10.

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

/mgc/set

Синтаксис:

set <NAME> <KEY> <VALUE>

Параметры:

<NAME> - имя шлюза;
<KEY> :: - ключ для активации:

  • peers - имя пира для привязки;
  • description - описание данного MGC;
  • trans_id - идентификатор текущей транзакции;
  • max_trans_id - крайний идентификатор транзакции (по умолчанию: бесконечный);
  • request_timer - таймер ожидания ответа;
  • long_request_timer - таймер ожидания ответа (по умолчанию: 60000);
  • request_keep_alive_timeout - таймер request-keep-alive timer (по умолчанию: обычный);
  • reply_timer - таймер ожидания подтверждения (пл умолчанию: 30000);
  • call_proxy_gc_timeout - таймер ожидания для прокси вызовов (по умолчанию: 5000);
  • auto_ack - автоматическое подтверждение при получении ответа на транзакцию (по умолчанию: False);
  • trans_ack - должны ли подтверждения накапливаться или отправляться сразу (по умолчанию: False);
  • trans_ack_maxcount - максимальное количество накапливаемых подтверждений (по умолчанию: 10);
  • trans_req - должны ли запросы накапливаться или отравляться сразу (по умолчанию: False);
  • trans_req_maxcount - максимальное количество накапливаемых запросов (по умолчанию: 10);
  • trans_timer - таймаут ожидания накопления запросов или подтверждений (по умолчанию: False);
  • pending_timer - таймер перевода в ожидание (по умолчанию: 30000);
  • sent_pending_limit - предел транзакций ожидающих подтверждение (по умолчанию: бесконечно);
  • recv_pending_limit - предел транзакций ожидающих запрос  (по умолчанию: бесконечно);
  • protocol_version - актуальная версия протокола (по умолчанию: 1);
  • strict_version - строгий контроль версии протокола. То есть при получении сообщения, система убеждается, что версия является той, которая была согласована (по умолчанию: True);
  • threaded - если полученное сообщение содержит несколько запросов, эта опция указывает, должны ли запросы обрабатываться последовательно в одном процессе (по умолчанию: False);
  • resend_indication - эта опция указывает, будет ли транспортный модуль отправлять сообщения повторно (по умолчанию: false);
  • segment_reply_ind  - эта опция указывает, должна ли система уведомлять пользователя о полученных частичных ответах (по умолчанию: False);
  • segment_recv_timer - этот таймер запускается когда уже был получен последний сегмент сообщений, но еще не были получены все промежуточные сегменты (по умолчанию: 10000);
  • segment_send - исходящие сообщения должны быть сегментированы (по умолчанию: False);
  • max_pdu_size - максимальный размер сообщений (по умолчанию: бесконечный);
  • mid - идентификатор сообщения;
  • address - список разрешенных IP-адресов MG (<IP>:<порт>)

<VALUE> - новое значение (формат значений аналогичен тому, как описано в команде declare)

Пример:

support@[mycelium1@ecss1]:/$ /mgc/set mgc_smg_224 peers smg_224_tcp, smg_224_udp_new

Property peers successfully changed from media gateway mgc_smg_224.

support@[mycelium1@ecss1]:/$ /mgc/set mgc_smg_224 peers smg_224_tcp, smg_224_udp_new

Error: media gateway mgc_smg_224 not found.