Понятия, определения

  • SS — supplementary service, услуга.
  • Вид услуги — логическая группировка нескольких реализаций услуг, которые имеют общее назначение, но различные реализации. Например, "Поиск первой свободной линии по списку" (CHUNT).
  • Имя услуги — имя определенной реализации вида услуг. Например, "групповой вызов 1" — вызов поступает одновременно на все порты группы, "Групповой вызов 2" — вызов поступает на все порты по очереди в зависимости от выставленного тайм-аута вызова участника группы.
  • План услуг (Индивидуальный план услуг) — набор настроек для определенного абонента (индивидуальный план услуг) или для группы абонентов (план услуг), которые позволяют определять, какие услуги доступны определенному абоненту на использование и управление.
  • Access list — план услуг.
  • SSD — service specific data, группа свойств (настроек), которые будут одинаковыми для всех пользователей, использующих данную услугу. Свойства данной группы могут изменять только разработчики данной услуг.
  • CSD — customer specific data. Группа свойств (настроек) услуги, которые могут быть разными, для разных пользователей, использующих данную услугу. Свойства данной группы могут изменять оператор/пользователь.
  • MSD (meta special data) — дополнительные параметры.
  • Домен — виртуальная АТС.
  • Администратор системы — пользователь системы с правами администратора системы: ECSS-ADMIN, ECSS-ROOT. Администратор системы имеет самый высокий уровень доступа и может выполнять все операции в системе.
  • Администратор домена — оператор, пользователь системы с правами администратора виртуальной АТС: ECSS-DOMAIN-ADMIN. Администратор домена выполняет операции в системе в рамках определенной виртуальной АТС.
  • Инсталляция услуги — процесс установки новой услуги с определенным именем и видом в систему. После инсталляции услуги с данным именем, можно будет активировать/деактивировать её у абонентов.
  • Деинсталляция услуги — процесс удаления услуги по имени из системы. В процессе деинсталляции, если у абонента/абонентов используется услуга с данным именем, она будет автоматически деактивирована.
  • Активировать/деактивировать услугу — подключение/отключение услуги у абонента с установленными во время подключения настройками. Активировать/деактировать услугу может администратор системы, оператор и абонент. При отключении услуги настройки будут удалены.
  • Доступ на управление для оператора — администратор системы может запреть или разрешить оператору использовать определенную услугу.
  • Доступ на управление для абонента — оператор может запретить или разрешить абоненту управлять услугой(подключать, отключать, изменять настройки). Данная функция используется, если абонент будет самостоятельно управлять услугой. Управление услугами абонентом осуществляется с телефонного аппарата, коды для управления с телефонного аппарата приведены в разделе Коды управления услугами.
  • Доступ на использование услуги абонентом — оператор может разрешить или запретить абоненту использовать услугу. Если абонент активировал услугу, но у оператора установлен запрет на использование, то услуга не будет доступна абоненту. При установке запрета на использование настройки услуги сохраняются. 
    Пример, абонент пользуется услугой "переадресация вызова по неответу" на номер 777, услуга является платной. Услуга активирована и разрешена для абонента. В определенный момент абонент не внес оплату за данную услугу и оператор запретил использовать услугу. Когда абонент внесет плату — услуга будет доступна с прежними настройками. Если у абонента разрешен доступ на управление услугой, то он может подключить услугу, даже если она заблокирована. Установка разрешения/запрета на управление услугой доступна только оператору.

Порядок установки и настройки услуг

Услугой могут управлять администратор системы, администратор домена (далее оператор) и абонент:

  • Администратор системы может установить или удалить услугу, открыть или закрыть доступ для администратора домена (оператора) на управление услугой, а так же выполнять все действия, которые доступны оператору.
  • Оператор может активировать или деактивировать услугу у абонента, разрешить или запретить абоненту использовать услугу, разрешить или запретить абоненту управлять услугой, выполнить настройки для определенной услуги.
  • Абонент самостоятельно может активировать, деактивировать и выполнить настройки определенной услуги.

На рисунке 1 приведен процесс установки и настройки услуги в системе.

Рисунок 1 — Порядок установки и настройки услуги в системе

Алгоритм добавления услуги в систему:

  1. Администратор системы устанавливает услугу.
  2. Администратор системы устанавливает разрешение на управление услугой оператору.

Алгоритм настройки услуги оператором:

  1. Оператор активирует или деактивирует услугу у абонента.
  2. Оператор выполняет настройки для услуги (только для услуг с параметрами).
  3. Оператор устанавливает разрешение на управление услугой абоненту.
  4. Оператор устанавливает разрешение на пользование услугой абонентом.

Алгоритм управления услугой абонентом:

  1. Абонент активирует или деактивирует услугу.
  2. Абонент выполняет настройку услуги (только для услуг с параметрами).
  • Абонент может использовать услугу, только если оператор активировал (подключил) и разрешил абоненту использовать услугу. В этом случае абонент не может управлять услугой с телефонного аппарата.
  • Абонент может активировать/деактивировать и настраивать услугу с телефонного аппарата самостоятельно, только если оператор установил ему разрешение на пользование и управление услугой.

Инсталляция и управление услугой через CLI

Инсталляция услуги в систему доступна только администратору системы.

Описание команд приведено в разделе Команды управления услугами.

Установка/удаление услуги администратором системы

После добавления файла-описания услуги в систему нужно установить услугу в системе.

Подключитесь к командной консоли под пользователем admin.

Пароль по умолчанию: password.

Команда для подключения к консоли:

ssh admin@localhost -p 8023

Для установки услуги в систему используются команды:

/cluster/storage/<SOME_STORAGE>/ss/install <NAME_DS> <SSTemplate>

Любая из этих команд считывает описание услуги из xml-файла и сохраняет его в системе.

Для удаления услуги из системы используются команды:

/cluster/storage/<SOME_STORAGE>/ss/uninstall <SSName>

где 

<SOME_STORAGE> — имя кластера хранения долговременных данных (DS);
<NAME_DS> — имя ноды DS;
<SSTemplate> — имя xml-файла с описанием услуги. В качестве имени файла может использоваться маска. В этом случае все файлы, имена которых удовлетворяют маске, будут установлены в систему. В маске используются следующие спецсимволы: * — любое количество символов, ? — один символ;
<SSName> — имя услуги. В качестве имени услуги может использоваться маска (* — любое количество символов, ? — один символ). Принимает значения:

ss_3way.xml ss_acb.xml

ss_alarm.xml ss_assistant.xml

ss_auto_redial.xml ss_auto_redial_with_callback.xml

ss_avatar.xml ss_blf.xml

ss_boss_group.xml ss_call_recording.xml

ss_callback.xml ss_cc_agent.xml

ss_cf_aon.xml ss_cf_sip.xml

ss_cfb.xml ss_cfnr.xml

ss_cfnr_type2.xml ss_cfos.xml

ss_cft.xml ss_cfu.xml

ss_cfu_type2.xml ss_cgg.xml

ss_chold.xml ss_chunt.xml

ss_click_to_call.xml ss_clip.xml

ss_clir.xml ss_cliro.xml

ss_cnip.xml ss_cnip_audio.xml

ss_conference.xml ss_cpip.xml

ss_ctr.xml ss_cw.xml

ss_direct_call.xml ss_distinctive_picture.xml

ss_distinctive_ring.xml ss_dnd.xml

ss_fax_receiver.xml ss_fax_to_email.xml

ss_fbc.xml ss_find_me.xml

ss_find_me_no_response.xml ss_flexicall.xml

ss_follow_me.xml ss_follow_me_no_response.xml

ss_fxo_trunk.xml ss_hide_cf_name.xml

ss_intercom.xml ss_intervention.xml

ss_introduce.xml ss_mcid.xml

ss_meet_me_conference.xml ss_message.xml

ss_ml.xml ss_multicast_listen.xml

ss_multicast_page.xml ss_park.xml

ss_personal_ivr.xml ss_pickup.xml

ss_presence.xml ss_privacy.xml

ss_qsig_cfb.xml ss_qsig_cfnr.xml

ss_qsig_cfu.xml ss_rbp.xml

ss_redial.xml ss_remote_phone.xml

ss_remote_ring.xml ss_rfc.xml

ss_ring_back_tone.xml ss_s4b_presence.xml

ss_sca.xml ss_sco_black.xml

ss_sco_white.xml ss_scr.xml

ss_second_handset.xml ss_sip_message.xml

ss_smart_cancel.xml ss_speed_dial.xml

ss_teleconference.xml ss_teleconference_manager.xml

ss_tsmn_request.xml ss_vip_call.xml

ss_voice_page.xml ss_voice_page_control.xml

ss_voicemail.xml ss_walkie_talkie.xml

ss_zone_page.xml

Пример

  1. Установка услуги "безусловная переадресация CFU":

    admin@[mycelium1@ecss1]:/$ cluster/storage/ds1/ss/install ds1@ecss1 ss_cfu.xml
    Successfully installed: /var/lib/ecss/ss/ss_cfu.xml
  2. Установка всех услуг, файлы-описания которых начинаются на "ss_":

    admin@[mycelium1@ecss1]:/$ cluster/storage/ds1/ss/install ds1@ecss1 ss_*
    Successfully installed: /var/lib/ecss/ss/ss_dnd.xml
    Successfully installed: /var/lib/ecss/ss/ss_clir.xml
    ...
    Successfully installed: /var/lib/ecss/ss/ss_chunt.xml
  3. Удаление всех установленных в систему услуг:

    admin@[mycelium1@ecss1]:/$ cluster/storage/ds1/ss/uninstall *
    Supplementary service dnd successfully uninstalled.
    Supplementary service chunt successfully uninstalled.
    ...
    Supplementary service cfnr successfully uninstalled.

Доступ на управление услугами для оператора виртуальной АТС

После установки в систему различных видов услуг администратор системы должен открыть доступ на управление услугами оператору виртуальной АТС. Для этого используются команды:

Для добавления разрешения оператору виртуальной АТС на работу с новым видом услуг: 

/cluster/storage/<SOME_STORAGE>/ss/access-list add <DOMAIN> <SSName> [, <SSName>]

Для удаления ранее разрешенных оператору виртуальной АТС видов услуг: 

/cluster/storage/<SOME_STORAGE>/ss/access-list remove <DOMAIN> <SSName> [, <SSName>]

Для удаления всех услуг из определенной виртуальной АТС: 

/cluster/storage/<SOME_STORAGE>/ss/access-list clear <DOMAIN>

Для просмотра видов услуг, которые можно использовать в рамках определенной виртуальной АТС или по всем виртуальным АТС, используется команда: 

/cluster/storage/<SOME_STORAGE>/ss/access-list show [<DOMAIN>]

либо

/domain/<DOMAIN>/ss/available

где
<SOME_STORAGE> — имя кластера хранения долговременных данных (DS);
<NAME_DS> — имя ноды DS;
<DOMAIN> — имя виртуальной АТС;
<SSName> — имя услуги. В качестве имени услуги может использоваться маска (* — любое количество символов, ? — один символ)

Начиная с версии 3.14.5 на ECSS-10 стали доступные лицензионные пакеты услуг, которые ограничивают список ДВО доступных для конкретного абонента.
Более подробная информация содержится на странице Лицензионные пакеты услуг


Пример

  1. Разрешить оператору виртуальной АТС "p.city" управлять услугами CFU и CLIR.

    admin@[mycelium1@ecss1]:/$ cluster/storage/ds1/ss/access-list add p.city CFU, CLIR
    Supplementary services successfully added in the domain p.city.
  2. Просмотреть список услуг, доступ на управление для которых открыт для оператора виртуальной АТС "p.city":

    admin@[mycelium1@ecss1]:/$ cluster/storage/ds1/ss/access-list show p.city
    ┌───────┬──────────────────────┐
    │Domain │Supplementary services│
    ├───────┼──────────────────────┤
    │p.city │CFU, CGG, DND         │
    └───────┴──────────────────────┘
  3. Просмотреть список услуг, доступ на управление для которых открыт для всех виртуальных АТС:

    admin@[mycelium1@ecss1]:/$ cluster/storage/ds1/ss/access-list show
    ┌────────────────┬──────────────────────┐
    │     Domain     │Supplementary services│
    ├────────────────┼──────────────────────┤
    │p.city          │CFU, CGG, DND         │
    │d.city          │                      │
    │d.centrix.academ│                      │
    │d.external      │                      │
    └────────────────┴──────────────────────┘
  4. Запретить доступ для виртуальной АТС "p.city" ко всем ранее разрешенным видам услуг.

    Данное действие можно выполнить двумя способами:

    admin@[mycelium1@ecss1]:/$ cluster/storage/ds1/ss/access-list remove p.city *
    Supplementary services successfully removed from the domain p.city.

    либо:

    admin@[mycelium1@ecss1]:/$ cluster/storage/ds1/ss/access-list clear p.city
    Supplementary services successfully removed from the domain p.city.
    All supplementary services successfully removed from the domain p.city.

Управление услугой оператором виртуальной АТС

Оператор определенной виртуальной АТС приступает к управлению услугой после того, как администратор системы открыл ему доступ на управление.

Оператор может разрешить либо запретить абоненту использовать услугу, активировать либо деактивировать услугу у абонента, разрешить либо запретить абоненту управлять услугой.

Необходимо учитывать, что настройки услуги, заданные для определенного абонента, будут иметь приоритет над общими настройками услуг, заданными для виртуальной АТС.

Управление правами доступа абонента

Оператор может разрешить или запретить пользоваться услугами абонентам. 
Если у абонента активирована услуга, но оператор установил запрет на ее использование, то услуга не будет доступна абоненту. При установке запрета на использование настройки услуги сохраняются.

Разрешение прав доступа на использование/управление услуг абонентами выполняется командой:

/domain/<DOMAIN>/ss/enable <ADDRESS> <SSname> [<SSname>]

Запрет прав доступа на использование/управление услуг абонентами выполняется командой:

/domain/<DOMAIN>/ss/disable <ADDRESS> <SSname> [<SSname>]

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

/domain/<DOMAIN>/ss/enabled [<ADDRESS>]

или

/cluster/storage/<SOME_STORAGE>/ss/enabled <DOMAIN> [<ADDRESS>]

где
<DOMAIN> — имя виртуальной АТС; 
<ADDRESS> — номер или диапазон номеров абонентов;

Диапазоны номеров указываются в фигурных скобках. Например: 71{1-2,9} соответствует номерам 711, 712, 719.

<SSName> — имя услуги; 
<SOME_STORAGE> — имя кластера хранения долговременных данных (DS);

Пример

  1. Разрешить всем абонентам виртуальной АТС "test.domain" доступ на использование услуги "антиАОН" (CLIR):

    admin@[mycelium1@ecss1]:/$ domain/test.domain/ss/enable * clir  
    Success: Supplementary service clir enabled for domain "test.domain", address "211".
    ...
    Success: Supplementary service clir enabled for domain "test.domain", address "799".
  2. Запретить абоненту с номером 210 на виртуальной АТС "test.domain" доступ на использование услуги "антиАОН" (CLIR):

    admin@[mycelium1@ecss1]:/$ domain/test.domain/ss/disable 210 clir  
    Success: Supplementary service clir disabled for domain "test.domain", address "210".
  3. Просмотреть права доступа для абонента с номером 212 для виртуальной АТС "test.domain":

    admin@[mycelium1@ecss1]:/$ domain/test.domain/ss/enabled 212
    ┌───────┬───────┐
    │Address│Enabled│
    ├───────┼───────┤
    │212    │chold  │
    │       │clir   │
    │       │ctr    │
    └───────┴───────┘

Активация/деактивация услуги

Оператор может разрешить или запретить управлять услугами абонентам.
Если у абонента открыт доступ на управление, то он может управлять услугой с телефонного аппарата. Коды для управления услугами, настроенные по умолчанию в системе, приведены в разделе Коды управления услугами.

Активировать/деактивировать услугу может администратор системы, оператор либо абонент. После активации услуга начинает работать только в том случае, если она является разрешенной для абонента.

Для того чтобы абонент мог активировать/деактивировать услугу, у него должен быть "доступ на управление" данной услугой.
При деактивации удаляются все настройки, которые были введены при активации услуги.
Необходимо учитывать, что при деактивации услуги на уровне виртуальной АТС услуга деактивируется и на уровне абонента (если услуга было дополнительно активирована у абонента).

Для активации и выполнения настроек услуги через интерфейс командой строки используется команда:

  • для администратора системы:

/cluster/storage/<SOME_STORAGE>/ss/activate <DOMAIN> <ADDRESS> <SSName> <Args>

  • для оператора виртуальной АТС:

/domain/<DOMAIN>/ss/activate <ADDRESS> <SSName> <Args>

Для деактивации услуги через интерфейс командой строки используются команда:

  • для администратора системы:

/cluster/storage/<SOME_STORAGE>/ss/deactivate <DOMAIN> <ADDRESS> <SSName> [<SSName>]

  • для оператора виртуальной АТС:

/domain/<DOMAIN>/ss/deactivate <ADDRESS> <SSName> [<SSName>]

где 
<SOME_STORAGE> — имя кластера хранения долговременных данных (DS);
<DOMAIN> — имя виртуальной АТС (домен), которой принадлежит абонент;
<ADDRESS> — номер или диапазон номеров абонента(ов), для указания всех абонентов заданной виртуальной АТС используется "*";

Диапазоны номеров указываются в фигурных скобках. Например: 71{1-2,9} соответствует номерам 711, 712, 719.

<SSName> — имя услуги.

<Args> — дополнительный параметр для услуги, задается в виде "number = ЗНАЧЕНИЕ" либо "numbers = [ЗНАЧЕНИЕ1,ЗНАЧЕНИЕ2,...]".

Описание настроек параметров приведено в разделе Настройка параметров услуг.

Пример

  1. Активация услуги CLIR для всех абонентов виртуальной АТС "test.domain" (для этого в качестве второго параметра указывается "*"):

    admin@[mycelium1@ecss1]:/$ domain/test.domain/ss/activate * clir 
    Success: Supplementary service clir activated for domain "test.domain" address "211" 
    ...
    Success: Supplementary service clir activated for domain "test.domain" address "799" 
  2. Активация услуги CFU для абонента 210 виртуальной АТС "test.domain". При активации указывается обязательный для данной услуги параметр "number" — номер переадресации.

    admin@[mycelium1@ecss1]:/$ domain/test.domain/ss/activate 210 cfu number = 801
    Success: Supplementary service cfu activated for domain "test.domain" address "210" 
  3. Деактивация услуги CLIR для всех абонентов виртуальной АТС "test.domain":

    admin@[mycelium1@ecss1]:/$ domain/test.domain/ss/deactivate * clir 
    Success: Supplementary service clir deactivated for domain "test.domain", address "211".
    ...
    Success: Supplementary service clir deactivated for domain "test.domain", address "799".
  4. Деактивация услуги CFU для абонента 210 виртуальной АТС "test.domain":

    admin@[mycelium1@ecss1]:/$ domain/test.domain/ss/deactivate 210 cfu 
    Success: Supplementary service cfu deactivated for domain "test.domain", address "210".

Обновление версии услуги

При обновлении услуги выполняется проверка на наличие расхождений в описании услуги между версиями, система проверяет присутствие скрипта миграции. При наличии расхождений система отправляет аварию о необходимости обновления xml-описателя. Если в новой версии xml присутствуют свойства, которых не было в предыдущей версии xml, то система проверяет, есть ли правило миграции для данного свойства. Если правила миграции присутствуют для всех полей — миграция проходит в автоматическом режиме. Если в новой версии xml присутствует свойство, правило миграции для которого отсутствует — необходимо указать правило миграции вручную. Для этого система посредством wizzard-а запросит у администратора ввести значение для инициализации данного свойства у абонентов, у которых данная услуга уже активирована.

Возможны три варианта инициализации:

  1. Инициализация значением по умолчанию. Свойство может быть инициализировано значением по умолчанию только тогда, когда значение по умолчанию описано в xml-файле;
  2. Получить значение из установленного свойства. Если в ранней версии услуги было свойство того же типа, что и новое свойство, то значение для нового свойства можно скопировать из значения установленного свойства;
  3. Указать явно. Можно явно указать, каким значением инициализировать новое свойство.
Если хотя бы для одного из новых свойств не указано правило миграции — обновление услуги не выполняется.
Все файлы-описания услуг должны располагаться в папке /var/lib/ecss/ss/ на том же хосте, где и запущен DS.

Для обновления услуг с текущей версии (установленной в системе) до версии, указанной в xml, используется следующая команда CLI:

/cluster/storage/<SOME_STORAGE>/ss/update <NAME_DS> -<Flag> <SSTemplate>

либо

/node/<NAME_DS>/ss/update -<Flag> <SSTemplate>

где <SOME_STORAGE> — имя кластера хранения долговременных данных (DS);
<NAME_DS> — имя ноды DS;
<Flag> — флаг, принимает значения:

  • -a, --auto — использовать правила миграции, описанные в xml (если они прописаны);
  • -m, --manual — не использовать правила миграции, описанные в xml (если они прописаны). В данном случае для всех новых свойств необходимо будет явно задать значения;
    <SSTemplate> — имя xml файла-описания услуги. В качестве файла-описания услуги может использоваться маска поиска. В этом случае все файлы, имена которых удовлетворяют этой маске, будут установлены в систему. В маске поиска используются символы: * — любое количество символов, ? — ровно один символ.

Пример

Обновление услуги "test" с версии 1 до версии 2.

admin@[mycelium1@ecss1]:/$ cluster/storage/ds1/ss/update ds1@ecss1 --manual ss_test_2.xml
[update] The value of the property restrict_number_22 may be copied from one of the prope
         rty:
         test_field, restrict_number
Would you like to copy properties' value?: yes/no ?> yes
[update] Select property to copy it's value to the restrict_number_22.
         Avaliable values: test_field, restrict_number
Property name: : test_field/restrict_number ?> test_field
[update] New property test_field_2 have default value 9.
Would you like to apply this value for all activate aliases?: yes/no ?> yes
[update] 
Would you like to enter default value search_strategy :: enum for already activated aliases?: yes/no ?> yes
[update] 
Default value for search_strategy: first
[update] 
Would you like to enter default value test_field_without_value :: [integer] for already activated aliases?: yes/no ?> yes
[update] 
Default value for test_field_without_value: 234
[update] 
Default value for test_field_without_value: [234]
Successfully updated: /var/lib/ecss/ss/ss_test_2.xml

Просмотр информации об услугах

После установки, активации и выполнения настроек услуги администратор системы либо оператор виртуальной АТС должен удостовериться, что сервис развернулся успешно.

Для просмотра информации об активированных в рамках виртуальной АТС услугах используется команда:

  • для администратора системы:

/cluster/storage/<SOME_STORAGE>/ss/info <DOMAIN> [*] [-all] [<ADDRESS>]

  • для оператора виртуальной АТС:

/domain/<DOMAIN>/ss/info [*] [-all] [<ADDRESS>]

где
<SOME_STORAGE> — имя кластера хранения долговременных данных (DS);
<DOMAIN> — имя виртуальной АТС (домен), которой принадлежит абонент;
<ADDRESS> — номер или диапазон номеров абонента(ов), для указания всех абонентов заданной виртуальной АТС используется "*";

Диапазоны номеров указываются в фигурных скобках. Например: 71{1-2,9} соответствует номерам 711, 712, 719.
  • -all — флаг, при указании которого будет показана полная информация об всех активированных в системе услугах;
  • * — флаг, при указании которого будет показана полная информация об всех активированных в системе услугах.

Описание параметров таблицы команды "info":

  • Domain — название виртуальной АТС;
  • Address — номер абонента;
  • Name — название услуги;
  • Family — вид услуги;
  • V — версия реализации услуги;
  • E — доступ на использование услуги абонентом: T — разрешено использовать услугу; F — запрещено использовать услугу;
  • L — доступ на управление услугой абонентом: T — разрешено управлять услугой; F — запрещено управлять услугой;
  • CSD — CSD-свойства услуги, CSD-свойства могут изменять оператор/пользователь:
  • SSD — SSD-свойства услуги, SSD-свойства могут изменять только разработчики данной услуги.

Также для просмотра информации об установленных в системе услугах используется команда:

  • для администратора системы:

/cluster/storage/<SOME_STORAGE>/ss/show [<SSNames>] | [*]

  • для оператора виртуальной АТС:

node/<NAME_DS>/ss/show [<SSNames>] | [*]

где <SOME_STORAGE> — имя кластера хранения долговременных данных (DS);
<NAME_DS> — имя ноды DS;
<NAMES> — название полей таблицы, информацию по которым нужно отобразить, для указания всех полей используется "*", список полей задается через ",":

  • Name — название услуги;
  • Family — вид услуги;
  • version — версия реализации услуги;
  • description — описание услуги;
  • ssd — SSD-свойства услуги, SSD-свойства могут изменять только разработчики данной услуги.
  • csd — CSD-свойства услуги, CSD-свойства могут изменять оператор/пользователь:

Пример

  1. Просмотреть список услуг, активированных на виртуальной АТС "p.city":

    admin@[mycelium1@ecss1]:/$ cluster/storage/ds1/ss/info test.domain 
    ┌───────────┬───────┬─────┬──────┬─┬─┬─────────────────────────┐
    │  Domain   │Address│Name │Family│V│E│           CSD           │
    ├───────────┼───────┼─────┼──────┼─┼─┼─────────────────────────┤
    │test.domain│105    │chold│CHOLD │3│T│                         │
    │test.domain│105    │ctr  │CTR   │2│T│                         │
    │test.domain│210    │3way │3WAY  │2│T│                         │
    │test.domain│210    │chold│CHOLD │3│T│                         │
    │test.domain│210    │ctr  │CTR   │2│T│                         │
    │test.domain│801    │chold│CHOLD │3│T│                         │
    │test.domain│801    │ctr  │CTR   │2│T│                         │
    │test.domain│802    │chold│CHOLD │3│T│                         │
    │test.domain│802    │ctr  │CTR   │2│T│                         │
    └───────────┴───────┴─────┴──────┴─┴─┴─────────────────────────┘

    Для абонента 210 активированы и разрешены на использование услуги 3WAY, CTR, CHOLD. Для всех остальных абонентов данного домена активировано только услуги CTR, CHOLD.

  2. Просмотреть список установленных в системе услуг (метаданные):

    admin@[mycelium1@ecss1]:/$ cluster/storage/ds1/ss/show             
    ┌─────────────────────────┬────────────────┬───────┬──────────────────────────────────────────────────┐
    │          name           │     family     │version│                   description                    │
    ├─────────────────────────┼────────────────┼───────┼──────────────────────────────────────────────────┤
    │3way                     │3WAY            │2      │3-Way Conference                                  │
    │acb                      │ACB             │1      │Anonymous Call Blocking                           │
    ...
    │speed_dial               │SpeedDial       │3      │Speed dial (Abbreviated dialing)                  │
    │teleconference_manager   │Teleconference  │2      │Teleconference manager                            │
    └─────────────────────────┴────────────────┴───────┴──────────────────────────────────────────────────┘
    Installed supplementary services: 40
  3. Просмотреть настройки услуг, установленных в системе:

    admin@[mycelium1@ecss1]:/$ cluster/storage/ds1/ss/show name msd
    ┌─────────────────────────┬────────────────────────────────────────────────────────────────────────────────┐
    │          name           │                                      msd                                       │
    ├─────────────────────────┼────────────────────────────────────────────────────────────────────────────────┤
    │3way                     │atom[] dependency_list = ['CHOLD']; //List of SS that is depended from SS       │
    │acb                      │                                                                                │
    │alarm                    │atom handle_module = ss_alarm_handler; //                                       │
    ...
    │speed_dial               │string enumType = "address_book_10|address_book_100"; //The type of address book│
    │                         │. address_book_10 supports 10 number in the address book. address_book_100 suppo│
    │                         │rts 100 numbers on the address book.                                            │
    │teleconference_manager   │                                                                                │
    └─────────────────────────┴────────────────────────────────────────────────────────────────────────────────┘
    Installed supplementary services: 40

Инсталляция и управление услуг через web-конфигуратор

Установка/удаление/предоставление доступа к услугам

Для установки, удаления и предоставления доступа к услугам через web-конфигуратор используется приложение Управление услугами ("SS install").

Необходимо заранее выбрать домен в поле "Domain" ("Домен"), для которого необходимо добавить/удалить или предоставить/отнять доступ к услуге — .

Установка/удаление услуги

Error: You do not have permissions to view this content.

Доступ на управление услугой для администратора домена

Error: You do not have permissions to view this content.

Активация/деактивация услуги

Настройки выполняются в разделе "Supplementary services" ("Дополнительные услуги") приложения "Subscriber card" ("Карточка абонента").

Настройка услуги для всех абонентов определенной виртуальной АТС, а так же для определенного абонента в отдельности выполняется в приложении  "Subscriber card" ("Карточка абонента").

Индивидуальные настройки услуги абонента переопределяют глобальные настройки услуги (настройки на уровне домена).

Error: You do not have permissions to view this content.

Управление правами доступа абонента

Управление правами доступа абонента выполняется в разделе "Supplementary services" ("Дополнительные услуги") приложения "Subscriber card" ("Карточка абонента").

Управление правами доступа всех абонентов определенной виртуальной АТС, а так же для определенного абонента в отдельности выполняется в приложении "Subscriber card" ("Карточка абонента").

Индивидуальные настройки услуги абонента переопределяют глобальные настройки услуги (настройки а уровне домена).

Управление доступом на использование услуги абонентами осуществляется кнопками:

— разрешить использовать услугу;
— запретить использовать услугу.

Для сохранения настроек нажмите кнопку "Save" ("Сохранить").

Управление услугами оператором виртуальной АТС

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

Управление разрешением на использование услуг

Команда enable предназначена для установки разрешения на использование и управление услугами абонентами виртуальной АТС.

/domain/<DOMAIN>/ss/enable

Синтаксис:

enable <ADDRESS> <SSName> [<SSName 2> ... <SSName N>]

где

<DOMAIN> — имя виртуальной АТС (домен);
<ADDRESS> — номер или диапазон номеров абонента(ов). Для указания всех абонентов заданной виртуальной АТС используется символ "*";

Диапазоны номеров указываются в фигурных скобках. Например: 71{1-2,9} соответствует номерам 711, 712, 719.

<SSName> — имя услуги.

Команда enabled служит для просмотра информации о разрешениях в рамках виртуальной АТС используется следующая команда:
/domain/<DOMAIN>/ss/enabled

enabled [<ADDRESS> ]

где

<DOMAIN> — имя виртуальной АТС (домен);
<ADDRESS> — номер или диапазон номеров абонента(ов). Для указания всех абонентов заданной виртуальной АТС используется символ "*"

Команда disable служит для удаления прав доступа на использование и управление настройками услуг в рамках виртуальной АТС.
/domain/<DOMAIN>/ss/disable

disable <ADDRESS> <SSName> [<SSName 2> ... <SSName N>]

где

<DOMAIN> — имя виртуальной АТС (домен);
<ADDRESS> — номер или диапазон номеров абонента(ов). Для указания всех абонентов заданной виртуальной АТС используется символ "*";

Диапазоны номеров указываются в фигурных скобках. Например: 71{1-2,9} соответствует номерам 711, 712, 719.

<SSName> — имя услуги.

Примеры

  1. Разрешить абоненту виртуальной АТС "test.domain" с номером "100" пользоваться услугой "групповой вызов" (имя услуги "cgg"):

    admin@[ds1@ecss1]:/$ domain/test.domain/ss/enable 100 cgg
    Success: Supplementary service cgg enabled for domain "test.domain", address "100".
  2. Просмотреть настройки прав доступа к услугам для абонента виртуальной АТС "test.domain" с номером "100":

    admin@[ds1@ecss1]:/$ domain/test.domain/ss/enabled 100
    ┌───────┬───────┐
    │Address│Enabled│
    ├───────┼───────┤
    │100    │3way   │
    │       │acb    │
    │       │cgg    │
    └───────┴───────┘
  3. Просмотреть настройки прав доступа к услугам для всех абонентов виртуальной АТС "test.domain":

    admin@[ds1@ecss1]:/$ domain/test.domain/ss/enabled *
    ┌───────┬───────────────────┐
    │Address│      Enabled      │
    ├───────┼───────────────────┤
    │100    │3way               │
    │       │acb                │
    │       │cgg                │
    │101    │No services enabled│
    │102    │No services enabled│
    │103    │No services enabled│
    │104    │No services enabled│
    │105    │No services enabled│
    │107    │No services enabled│
    │108    │No services enabled│
    │110    │No services enabled│
    └───────┴───────────────────┘

Активация услуги — activate

Команда activate предназначена для активации определенной услуги у абонента виртуальной АТС.
Активировать услугу может оператор либо абонент. Для того, чтобы услугу можно было активировать на абоненте, необходимо дать разрешение на использование данной услуги командой enable.

Для того чтобы абонент мог активировать услугу, ему должен быть разрешен "доступ на управление" данной услугой.

/domain/<DOMAIN>/ss/activate [--safe] <ADDRESS> <SSName> <ARGS>

где

<DOMAIN> — имя виртуальной АТС (домен), которой принадлежит абонент;
<ADDRESS> — номер или диапазон номеров абонента(ов). Для указания всех абонентов заданной виртуальной АТС используется символ "*";

Диапазоны номеров указываются в фигурных скобках. Например: 71{1-2,9} соответствует номерам 711, 712, 719.

<SSName> — имя услуги;
<ARGS> — дополнительный параметр для услуги, задается в виде "number = ЗНАЧЕНИЕ" либо "numbers = [ЗНАЧЕНИЕ1,ЗНАЧЕНИЕ2,...]";

[–safe] — дополнительный ключ, который обозначает, что если при активации услуги на абоненте, услуга уже была активирована, параметры данной услуги для этого абонента останутся неизменными.  

Примеры

  1. Установить услугу "антиопределитель номера" для всех абонентов виртуальной АТС с именем "p.city":

    /domain/p.city/ss/enable * clir 
    Success: Supplementary service clir enabled for domain "p.city", address "710".
    Success: Supplementary service clir enabled for domain "p.city", address "711".
    Success: Supplementary service clir enabled for domain "p.city", address "712".
    
    /domain/p.city/ss/activate * clir 
    Success: Supplementary service clir activated for domain "p.city" address "710" 
    Success: Supplementary service clir activated for domain "p.city" address "711" 
    Success: Supplementary service clir activated for domain "p.city" address "712" 
  2. Разрешить использовать услугу "групповой вызов" абоненту "799" с абонентами "711", "712" виртуальной АТС с именем "p.city":

    /domain/p.city/ss/enable 799 cgg
    /domain/p.city/ss/activate 799 cgg numbers = [711, 712]
    Supplementary service cgg successfully activated to domain "p.city", address "799".
  3. Установить услугу "переадресация вызова при неответе" в течение 10 секунд с номера "711" на номер "712":

    /domain/p.city/ss/enable 711 cfnr
    /domain/p.city/ss/activate 711 cfnr number = 712, timeout = 10
    Supplementary service cfnr successfully activated to domain "p.city", address "711".

Деактивация услуги — deactivate

Команда deactivate предназначена для деактивации определенной услуги на заданной виртуальной АТС для определенного абонента (группы абонентов).
При деактивации настройки, которые были заданы для услуги сохраняются. При последующей активации через web-конфигуратор они могут быть использованы.

domain/<DOMAIN>/ss/deactivate <ADDRESS> <SSName>

где

<DOMAIN> — имя виртуальной АТС (домен), которой принадлежит абонент;
<ADDRESS> — номер или диапазон номеров абонента(ов). Для указания всех абонентов заданной виртуальной АТС используется символ "*".

Диапазоны номеров указываются в фигурных скобках. Например, 71{1-2,9} соответствует номерам 711, 712, 719.

<SSName> — имя услуги, которую необходимо деактивировать;

Примеры

  1. Деактивировать услугу "групповой вызов" на виртуальной АТС "p.city":

    /domain/p.city/ss/deactivate * clir
    Success: Supplementary service clir deactivated for domain "p.city", address "710".
    Success: Supplementary service clir deactivated for domain "p.city", address "711".
    Success: Supplementary service clir deactivated for domain "p.city", address "712".
  2. Деактивировать услугу "переадресация вызова при неответе" для абонента "711" на виртуальной АТС "p.city":

    /domain/p.city/ss/deactivate 711 cfnr
    Success: Supplementary service cfnr deactivated for domain "p.city", address "711".

Просмотр информации об активированных услугах — info

Команда info предназначена для просмотра информации об активированных в рамках виртуальной АТС услугах. Команда позволяет просматривать параметры, заданные при активации сервиса, а также показывает, доступно ли определенная услуга для определенного абонента на использование/управление или нет. Для просмотра информации по определенному абоненту необходимо ввести имя виртуальной АТС и номер абонента. Если требуется просмотреть информацию по всем абонентам в рамках определенной виртуальной АТС, то параметр "номер абонента" можно опустить либо ввести символ "*".

/domain/<DOMAIN>/ss/info [-extended] [<ADDRESS>]

где

<DOMAIN> — имя виртуальной АТС (домена);
[<ADDRESS>] — номер или диапазон номеров абонента(ов) (опциональный параметр). Для указания всех абонентов заданной виртуальной АТС используется символ "*".

Диапазоны номеров указываются в фигурных скобках. Например: 71{1-2,9} соответствует номерам 711, 712, 719.

-extended — флаг, при указании которого будет показана подробная информация.

Примеры

  1. Просмотреть полную информацию о всех услугах, активированных на виртуальной АТС "d.local":

    antoniy@[mycelium1@ryabkov]:/$ domain/p.city/ss/info -extended *
    ┌──────┬─────────────┬─────────────────────────┬────────────────┬─┬─┬────────────────────────────────────────┬───────────────────────────┬────────────────────────┐
    │Domain│   Address   │          Name           │     Family     │V│E│                  MSD                   │            SSD            │        CSD             │
    ├──────┼─────────────┼─────────────────────────┼────────────────┼─┼─┼────────────────────────────────────────┼───────────────────────────┼────────────────────────┤
    │p.city│710          │auto_redial              │AutoRedial      │2│T│                                        │                           │no_answer_timeout = 30  │
    │      │             │                         │                │ │ │                                        │                           │queue_strategy = wait   │
    │      │             │                         │                │ │ │                                        │                           │recall_count = 6        │
    │      │             │                         │                │ │ │                                        │                           │recall_timeout = 15     │
    │p.city│710          │callback                 │CallBack        │2│T│                                        │a_onhook_timeout = 5       │queue_strategy = wait   │
    │      │             │                         │                │ │ │                                        │max_call_retry = 5         │                        │
    │p.city│710          │chold                    │CHOLD           │2│T│                                        │sip_moh = true             │queue_strategy = wait   │
    │p.city│710          │clir                     │CLIR            │2│T│                                        │                           │queue_strategy = wait   │
    │p.city│710          │ctr                      │CTR             │2│T│dependency_list = ['CHOLD']             │                           │queue_strategy = wait   │
    │p.city│710          │cw                       │CW              │2│T│dependency_list = ['CHOLD']             │                           │queue_strategy = wait   │
    │p.city│710          │mcid                     │MCID            │2│T│                                        │                           │queue_strategy = wait   │
    │p.city│710          │my_number                │MyNumber        │2│T│                                        │                           │queue_strategy = wait   │
    │p.city│720          │auto_redial              │AutoRedial      │2│T│                                        │                           │no_answer_timeout = 30  │
    │      │             │                         │                │ │ │                                        │                           │queue_strategy = wait   │
    │      │             │                         │                │ │ │                                        │                           │recall_count = 6        │
    │      │             │                         │                │ │ │                                        │                           │recall_timeout = 15     │
    │p.city│720          │callback                 │CallBack        │2│T│                                        │a_onhook_timeout = 5       │queue_strategy = wait   │
    │      │             │                         │                │ │ │                                        │max_call_retry = 5         │                        │
    │p.city│720          │chold                    │CHOLD           │2│T│                                        │sip_moh = true             │queue_strategy = wait   │
    │p.city│720          │ctr                      │CTR             │2│T│dependency_list = ['CHOLD']             │                           │queue_strategy = wait   │
    │p.city│720          │cw                       │CW              │2│T│dependency_list = ['CHOLD']             │                           │queue_strategy = wait   │
    │p.city│720          │mcid                     │MCID            │2│T│                                        │                           │queue_strategy = wait   │
    │p.city│720          │my_number                │MyNumber        │2│T│                                        │                           │queue_strategy = wait   │
    └──────┴─────────────┴─────────────────────────┴────────────────┴─┴─┴────────────────────────────────────────┴───────────────────────────┴────────────────────────┘
  2. Просмотреть информацию о всех услугах, активированных для абонента "6040" виртуальной АТС "d.local":

    antoniy@[mycelium1@ryabkov]:/$ domain/p.city/ss/info 725
    ┌──────┬───────┬─────────────────────────┬────────────────┬─┬─┬────────────────────────────────────────────┐
    │Domain│Address│          Name           │     Family     │V│E│                    CSD                     │
    ├──────┼───────┼─────────────────────────┼────────────────┼─┼─┼────────────────────────────────────────────┤
    │p.city│725    │3way                     │3WAY            │2│T│queue_strategy = wait                       │
    │p.city│725    │alarm                    │Alarm           │2│T│alarm_1 = {'one-time',[5],{15,23},"Alarm_1"}│
    │      │       │                         │                │ │ │alarm_2 = off                               │
    │      │       │                         │                │ │ │alarm_3 = off                               │
    │      │       │                         │                │ │ │alarm_4 = off                               │
    │      │       │                         │                │ │ │alarm_5 = off                               │
    │      │       │                         │                │ │ │alarm_6 = off                               │
    │      │       │                         │                │ │ │alarm_7 = off                               │
    │      │       │                         │                │ │ │alarm_8 = off                               │
    │      │       │                         │                │ │ │alarm_9 = off                               │
    │      │       │                         │                │ │ │call_attempt_count = 3                      │
    │      │       │                         │                │ │ │call_attempt_timeout = 60                   │
    │      │       │                         │                │ │ │cancel_digits = "*"                         │
    │      │       │                         │                │ │ │no_answer_timeout = 45                      │
    │      │       │                         │                │ │ │queue_strategy = wait                       │
    │p.city│725    │auto_redial              │AutoRedial      │2│T│no_answer_timeout = 30                      │
    │      │       │                         │                │ │ │queue_strategy = wait                       │
    │      │       │                         │                │ │ │recall_count = 6                            │
    │      │       │                         │                │ │ │recall_timeout = 15                         │
    │p.city│725    │auto_redial_with_callback│AutoRedialWithCB│2│T│a_no_answer_timeout = 10                    │
    │      │       │                         │                │ │ │b_no_answer_timeout = 30                    │
    │      │       │                         │                │ │ │queue_strategy = wait                       │
    │      │       │                         │                │ │ │recall_count = 30                           │
    │      │       │                         │                │ │ │recall_timer = 90                           │
    │p.city│725    │call_recording           │CallRecord      │3│T│mode = both                                 │
    │p.city│725    │callback                 │CallBack        │2│T│queue_strategy = wait                       │
    │p.city│725    │chold                    │CHOLD           │2│T│queue_strategy = wait                       │
    │p.city│725    │conference               │Conference      │2│T│queue_strategy = wait                       │
    │p.city│725    │mcid                     │MCID            │2│T│queue_strategy = wait                       │
    │p.city│725    │my_number                │MyNumber        │2│T│queue_strategy = wait                       │
    │p.city│725    │park                     │Park            │2│T│queue_strategy = wait                       │
    │p.city│725    │pickup                   │PICKUP          │2│T│pickup_groups = [{"pg1","1"},{"pg3","3"}]   │
    │      │       │                         │                │ │ │queue_strategy = wait                       │
    │p.city│725    │teleconference_manager   │Teleconference  │2│T│queue_strategy = wait                       │
    │      │       │                         │                │ │ │second_line = []                            │
    └──────┴───────┴─────────────────────────┴────────────────┴─┴─┴────────────────────────────────────────────┘