В данном разделе описываются команды настройки базового приложения core_trike_tts сервиса TTS, доступные администратору виртуальной АТС.

Таблица 1 - Описание параметров приложения "core_trike_tts" сервиса TTS, доступные администратору виртуальной АТС

НазваниеЗначение по умолчаниюОписание
actual_calls_archive_size1000Количество завершенных вызовов, которое будет хранить сервис service_actual_calls.
actual_calls_enabledtrueОпределяет, включен (true) или выключен (false) сервисе истории вызовов (будет или нет история вызовов сохраняться в базу).
adaptationundefinedтекущая адаптация
autoclean_enabledtrueОпределяет, активирована ли автоочистка.
autoclean_start_atevery 1 day at 00:00Определяет время и периодичность запуска автоочистки.
Задается в следующих видах:
- every <N> (day/week/month/year) at <HH:MM>, где <N> - автоочистка будет срабатывать каждые <N> дней (недель, месяцев, лет соответственно) в заданное время с небольшой погрешностью, необходимой, чтобы при большом количестве доменов не создать большую нагрузку на сервер MySQL. Например, значение "every 1 day at 00:00" означает, что автоочистка будет запускаться каждый день около полуночи.
- at <DD.MM.YYYY HH:MM:SS> - автоочистка сработает в заданное время, после чего задача автоматически удалится. Например, "at 22.12.2014 15:00:00" означает, что необходимо выполнить очистку 22 декабря 2014 года ровно в 15:00.
cdr_columns_name
Команда позволяет изменить название колонки <column> на новое
cdr_generation_enabledtrueОпределяет, включена (true) или выключена (false) запись CDR в БД и генерации CDR-файлов.
cdr_field_delimitersemicolonРазделитель полей CDR:
tab - символ Tab (\t);
space - пробел ( );
comma - запятая (,);
semicolon - точка с запятой (;).
cdr_typenormalОпределяет формат создаваемых CDR-файлов: расширенный (extended), обычный (normal) или задаваемый вручную (manual). Расширенный режим отличается от обычного дополнительными полями:
- CODEC - список кодеков;
- T_DNA - время ожидания ответа абонента при неотвеченном вызове, в секундах.
В manual режиме список колонок создаваемого CDR файла берется из свойства manual_cdr_columns
cdr_time_roundingdownsideОпределяет режим округления времени при записи CDR файлов. Доступные значения:
downside - округление в меньшую сторону путем, берется только прошедшее целое количество секунд (2999мс округляется до 2-x секунд);
upside - округление в большую сторону путем. Если количество миллисекунд в последней секунде > 0 - считается эту секунду (1001мс округляется до 2-x секунд);
downside_with_delta - округление в меньшую сторону, если количество миллисекунд в последней секунде <= 850, иначе, округляем в большую сторону. Замечание: если весь вызов длился более 200мс, но меньше 1 секунды - то время вызова будет равно 1 секунде;
upside_with_delta - округление в большую сторону, если количество миллисекунд в последней секунде >= 330, иначе, округляем в меньшую сторону. Замечание: если весь вызов длился более 200мс, но меньше 1 секунды - то время вызова будет равно 1 секунде;
mathematically - математическое округление. Если количество миллисекунд в последней секунде >= 500 - округляем в большую сторону, иначе - в меньшую;
millisecond - записываем время в CDR в миллисекундах.
manual_cdr_columns

type, datetime, kod_a, kod_b, nai_a, nai_b, n_tr_gr_a, n_tr_gr_b, t_ecd, t_dba, t_dna, cause_isup, cause_int, completind, origin_dig, dialed_dig, actsusb, categ_a, place, rec_seq, servuser, servindic, treatment, conn_id, redirected, redirection, orig_called, src_ip, dst_ip, port_a, port_b, diagnostic, call_record_a, call_record_b, codec, src_port, dst_port, media_proxy, signal_src_ip, signal_dst_ip, signal_src_port, signal_dst_port

Задается список колонок, которые будут присутствовать в CDR файле. При этом колонки будут в том порядке, в каком они заданы.
enabledtrueОпределяет, включен (true) или выключен (false) сервис TTS (история вызовов, запись CDR).
partial_cdr_timeout300Период, по истечении которого в базе данных создается запись с информацией о вызове. Также параметр задает периодичность, с которой будут выгружаться "partial CDR", в секундах.
port_sourceiface_name

Формат записи имен интерфейсов:

iface_name - в CDR/tollticket будет записано имя интерфейса;

iface_id - в CDR/tollticket будет записано id интерфейса.

purge_older_than2 monthПериод времени, по истечении которого записи в базе данных будут удалены. Значение может быть задано в часах (hour[s]), днях (day[s]), неделях (week[s]), месяцах (month[s]), годах (year[s]).
sign_cdr_enabledfalseОпция, при включении которой (значение "true") будет производиться цифровая подпись CDR-файлов и отдельных записей в рамках CDR-файлов. В CDR-файл будет добавлена колонка с именем SIGN, в которой для каждой записи будет прописана её цифровая подпись. Кроме того, в CDR-файле будет создана CDR-запись типа "final", все поля которой, кроме "SIGN", будут пустыми. В поле "SIGN" у данной записи будет подпись всего CDR-файла.

Набор полей при разных cdr_type:

normal

  • type
  • datetime
  • kod_a
  • kod_b
  • n_tr_gr_a
  • n_tr_gr_b
  • t_ecd
  • t_dba
  • cause_isup
  • cause_int
  • completind
  • dialed_dig
  • actsusb
  • categ_a
  • place
  • rec_seq
  • servuser
  • servindic
  • treatment
  • conn_id
  • redirected
  • redirection
  • orig_called
  • src_ip
  • dst_ip
  • port_a
  • port_b
  • diagnostic

extended

  • type
  • datetime
  • kod_a
  • kod_b
  • n_tr_gr_a
  • n_tr_gr_b
  • t_ecd
  • t_dba
  • t_dna
  • cause_isup
  • cause_int
  • completind
  • dialed_dig
  • actsusb
  • categ_a
  • place
  • rec_seq
  • servuser
  • servindic
  • treatment
  • conn_id
  • redirected
  • redirection
  • orig_called
  • src_ip
  • dst_ip
  • port_a
  • port_b
  • media_proxy
  • diagnostic
  • codec

manual

  • type
  • datetime
  • kod_a
  • kod_b
  • nai_a
  • nai_b
  • n_tr_gr_a
  • n_tr_gr_b
  • t_ecd
  • t_dba
  • cause_isup
  • cause_int
  • completind
  • origin_dig
  • dialed_dig
  • actsusb
  • categ_a
  • place
  • rec_seq
  • servuser
  • servindic
  • treatment
  • conn_id
  • redirected
  • redirection
  • orig_called
  • src_ip
  • dst_ip
  • port_a
  • port_b
  • diagnostic
  • signal_src_ip
  • signal_dst_ip
  • signal_src_port
  • signal_dst_port
  • call_record_a
  • call_record_b

При этом в режиме manual можно менять состав колонок и их порядок

clean

Данной командой восстанавливаются значения заданных параметров по умолчанию.

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

/domain/<DOMAIN>/tts/properties/clean

Синтаксис:

clean [<FIELD>] [--force]

Параметры:

<FIELD> - название параметра, значение которого нужно установить по умолчанию, список параметров приведен в таблице 1.

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

Пример:

admin@[ds1@ecss1]:/$ domain/biysk.local/tts/properties/clean adaptation 
Property adaptation values successfully restored

[exec at: 16.03.2019 16:04:35, exec time: 358ms, nodes: ds1@ecss1]

info

Данная команда служит для просмотра информации о настройках параметров приложения "core_trike_tts" сервиса TTS.

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

/domain/<DOMAIN>/tts/properties/info

Синтаксис:

info [<FIELD>]

Параметры:

<FIELD> - название параметра, список параметров приведен в таблице 1.

Пример:

Посмотреть информацию о настройках приложения "core_trike_tts" сервиса TTS для виртуальной АТС "test.domain".

admin@[ds1@ecss1]:/$ domain/biysk.local/tts/properties/info   
┌─────────────────────────┬───────────┬────────────────────────────────────────────────────────────────────────────────┐
│        Property         │  Domain   │                                     Value                                      │
├─────────────────────────┼───────────┼────────────────────────────────────────────────────────────────────────────────┤
│actual_calls_archive_size│biysk.local│1000                                                                            │
│actual_calls_enabled     │biysk.local│true                                                                            │
│adaptation               │biysk.local│undefined                                                                       │
│autoclean_enabled        │biysk.local│true                                                                            │
│autoclean_start_at       │biysk.local│every 1 day at 00:00                                                            │
│cdr_columns_name         │biysk.local│                                                                                │
│cdr_field_delimiter      │biysk.local│semicolon (;)                                                                   │
│cdr_generation_enabled   │biysk.local│true                                                                            │
│cdr_time_rounding        │biysk.local│downside                                                                        │
│cdr_type                 │biysk.local│extended                                                                        │
│enabled                  │biysk.local│true                                                                            │
│manual_cdr_columns       │biysk.local│type, datetime, kod_a, kod_b, nai_a, nai_b, n_tr_gr_a, n_tr_gr_b, t_ecd, t_dba, │
│                         │           │cause_isup, cause_int, completind, origin_dig, dialed_dig, actsusb, categ_a, pla│
│                         │           │ce, rec_seq, servuser, servindic, treatment, conn_id, redirected, redirection, o│
│                         │           │rig_called, src_ip, dst_ip, port_a, port_b, diagnostic                          │
│partial_cdr_timeout      │biysk.local│300                                                                             │
│purge_older_than         │biysk.local│2 month                                                                         │
│sign_cdr_enabled         │biysk.local│true                                                                            │
└─────────────────────────┴───────────┴────────────────────────────────────────────────────────────────────────────────┘

[exec at: 16.03.2019 16:00:05, exec time: 75ms, nodes: ds1@ecss1]

Описание таблицы:

  • Property - название параметра;
  • Domain - имя виртуальной АТС;
  • Value - значение параметра.

set

Данной командой выполняется настройка параметров приложения "core_trike_tts" сервиса TTS.

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

/domain/<DOMAIN>/tts/properties/set

Синтаксис:

set <FIELD> <VALUE>

Параметры:

<FIELD> - название конфигурируемого параметра, список параметров приведен в таблице 1;
<VALUE> - значение параметра.

Пример:

admin@[ds1@ecss1]:/$ domain/biysk.local/tts/properties/set adaptation mod1_adp 
Property "adaptation" successfully changed from: 
undefined
   to
mod1_adp.

[exec at: 16.03.2019 16:03:35, exec time: 383ms, nodes: ds1@ecss1]