Инсталляция и управление услугами
Понятия, определения
- 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 — Порядок установки и настройки услуги в системе
Алгоритм добавления услуги в систему:
- Администратор системы устанавливает услугу.
- Администратор системы устанавливает разрешение на управление услугой оператору.
Алгоритм настройки услуги оператором:
- Оператор активирует или деактивирует услугу у абонента.
- Оператор выполняет настройки для услуги (только для услуг с параметрами).
- Оператор устанавливает разрешение на управление услугой абоненту.
- Оператор устанавливает разрешение на пользование услугой абонентом.
Алгоритм управления услугой абонентом:
- Абонент активирует или деактивирует услугу.
- Абонент выполняет настройку услуги (только для услуг с параметрами).
- Абонент может использовать услугу, только если оператор активировал (подключил) и разрешил абоненту использовать услугу. В этом случае абонент не может управлять услугой с телефонного аппарата.
- Абонент может активировать/деактивировать и настраивать услугу с телефонного аппарата самостоятельно, только если оператор установил ему разрешение на пользование и управление услугой.
Инсталляция и управление услугой через CLI
Инсталляция услуги в систему доступна только администратору системы.
Описание команд приведено в разделе Команды управления услугами.
Установка/удаление услуги администратором системы
После добавления файла-описания услуги в систему нужно установить услугу в системе.
Подключитесь к командной консоли под пользователем admin.
Команда для подключения к консоли:
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
Пример
Установка услуги "безусловная переадресация CFU":
admin@[mycelium1@ecss1]:/$ cluster/storage/ds1/ss/install ds1@ecss1 ss_cfu.xml Successfully installed: /var/lib/ecss/ss/ss_cfu.xml
Установка всех услуг, файлы-описания которых начинаются на "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
Удаление всех установленных в систему услуг:
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 стали доступные лицензионные пакеты услуг, которые ограничивают список ДВО доступных для конкретного абонента.
Более подробная информация содержится на странице Лицензионные пакеты услуг
Пример
Разрешить оператору виртуальной АТС "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.
Просмотреть список услуг, доступ на управление для которых открыт для оператора виртуальной АТС "p.city":
admin@[mycelium1@ecss1]:/$ cluster/storage/ds1/ss/access-list show p.city ┌───────┬──────────────────────┐ │Domain │Supplementary services│ ├───────┼──────────────────────┤ │p.city │CFU, CGG, DND │ └───────┴──────────────────────┘
Просмотреть список услуг, доступ на управление для которых открыт для всех виртуальных АТС:
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 │ │ └────────────────┴──────────────────────┘
Запретить доступ для виртуальной АТС "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> — номер или диапазон номеров абонентов;
<SSName> — имя услуги;
<SOME_STORAGE> — имя кластера хранения долговременных данных (DS);
Пример
Разрешить всем абонентам виртуальной АТС "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".
Запретить абоненту с номером 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".
Просмотреть права доступа для абонента с номером 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> — номер или диапазон номеров абонента(ов), для указания всех абонентов заданной виртуальной АТС используется "*";
<SSName> — имя услуги.
<Args> — дополнительный параметр для услуги, задается в виде "number = ЗНАЧЕНИЕ" либо "numbers = [ЗНАЧЕНИЕ1,ЗНАЧЕНИЕ2,...]".
Пример
Активация услуги 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"
Активация услуги 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"
Деактивация услуги 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".
Деактивация услуги 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-а запросит у администратора ввести значение для инициализации данного свойства у абонентов, у которых данная услуга уже активирована.
Возможны три варианта инициализации:
- Инициализация значением по умолчанию. Свойство может быть инициализировано значением по умолчанию только тогда, когда значение по умолчанию описано в xml-файле;
- Получить значение из установленного свойства. Если в ранней версии услуги было свойство того же типа, что и новое свойство, то значение для нового свойства можно скопировать из значения установленного свойства;
- Указать явно. Можно явно указать, каким значением инициализировать новое свойство.
Для обновления услуг с текущей версии (установленной в системе) до версии, указанной в 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> — номер или диапазон номеров абонента(ов), для указания всех абонентов заданной виртуальной АТС используется "*";
- -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-свойства могут изменять оператор/пользователь:
Пример
Просмотреть список услуг, активированных на виртуальной АТС "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.
Просмотреть список установленных в системе услуг (метаданные):
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
Просмотреть настройки услуг, установленных в системе:
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").
Установка/удаление услуги
Администратор системы может установить и удалить услугу.
Для установки услуги в разделе "Доступные услуги" ("SS available") нажмите на кнопку 
напротив заданной услуги.
В разделе "Установленные услуги" ("SS installed") отображается перечень установленных услуг.
Для удаления услуги — в разделе "Установленные услуги" ("SS installed") нажмите на кнопку 
напротив заданной услуги:
Доступ на управление услугой для администратора домена
Администратор системы может открыть или закрыть доступ администратору виртуальной АТС для управления услугой.
Для открытия доступа на управление в разделе "Установленные услуги" ("SS installed") в колонке "Доступ" ("Access") установите флаг напротив заданной услуги и нажмите кнопку "Сохранить" ("Save"):
Для закрытия доступа на управление в разделе "Установленные услуги" ("SS installed") в колонке "Доступ" ("Access") снимите флаг напротив заданной услуги и нажмите кнопку "Сохранить" ("Save"):
Активация/деактивация услуги
Настройки выполняются в разделе "Supplementary services" ("Дополнительные услуги") приложения "Subscriber card" ("Карточка абонента").
Настройка услуги для всех абонентов определенной виртуальной АТС, а так же для определенного абонента в отдельности выполняется в приложении "Subscriber card" ("Карточка абонента").
Для подключения услуги установите флаг напротив заданной услуги и нажмите кнопку "Сохранить" ("Save").
Для отключения снимите флаг напротив заданной услуги и нажмите кнопку "Сохранить" ("Save").
- При отключении услуги настройки услуги будут удалены.
- Подключить или отключить услугу может как оператор, так и абонент. Для того чтобы абонент мог управлять услугой, у него должен быть разрешен доступ на управление к данной услуге. После подключения услуга будет работать только в том случае, если она у абонента является разрешенной.
Управление правами доступа абонента
Управление правами доступа абонента выполняется в разделе "Supplementary services" ("Дополнительные услуги") приложения "Subscriber card" ("Карточка абонента").
Управление правами доступа всех абонентов определенной виртуальной АТС, а так же для определенного абонента в отдельности выполняется в приложении "Subscriber card" ("Карточка абонента").
Управление доступом на использование услуги абонентами осуществляется кнопками:
— разрешить использовать услугу;
— запретить использовать услугу.
Для сохранения настроек нажмите кнопку "Save" ("Сохранить").
Управление услугами оператором виртуальной АТС
В данном разделе описаны команды управления услугами, которые доступны для оператора виртуальной АТС.
Управление разрешением на использование услуг
Команда enable предназначена для установки разрешения на использование и управление услугами абонентами виртуальной АТС.
/domain/<DOMAIN>/ss/enable
Синтаксис:
enable <ADDRESS> <SSName> [<SSName 2> ... <SSName N>]
где
<DOMAIN> — имя виртуальной АТС (домен);
<ADDRESS> — номер или диапазон номеров абонента(ов). Для указания всех абонентов заданной виртуальной АТС используется символ "*";
<SSName> — имя услуги.
Команда enabled служит для просмотра информации о разрешениях в рамках виртуальной АТС используется следующая команда:/domain/<DOMAIN>/ss/enabled
enabled [<ADDRESS> ]
где
<DOMAIN> — имя виртуальной АТС (домен);
<ADDRESS> — номер или диапазон номеров абонента(ов). Для указания всех абонентов заданной виртуальной АТС используется символ "*"
Команда disable служит для удаления прав доступа на использование и управление настройками услуг в рамках виртуальной АТС./domain/<DOMAIN>/ss/disable
disable <ADDRESS> <SSName> [<SSName 2> ... <SSName N>]
где
<DOMAIN> — имя виртуальной АТС (домен);
<ADDRESS> — номер или диапазон номеров абонента(ов). Для указания всех абонентов заданной виртуальной АТС используется символ "*";
<SSName> — имя услуги.
Примеры
Разрешить абоненту виртуальной АТС "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".
Просмотреть настройки прав доступа к услугам для абонента виртуальной АТС "test.domain" с номером "100":
admin@[ds1@ecss1]:/$ domain/test.domain/ss/enabled 100 ┌───────┬───────┐ │Address│Enabled│ ├───────┼───────┤ │100 │3way │ │ │acb │ │ │cgg │ └───────┴───────┘
Просмотреть настройки прав доступа к услугам для всех абонентов виртуальной АТС "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> — номер или диапазон номеров абонента(ов). Для указания всех абонентов заданной виртуальной АТС используется символ "*";
<SSName> — имя услуги;
<ARGS> — дополнительный параметр для услуги, задается в виде "number = ЗНАЧЕНИЕ" либо "numbers = [ЗНАЧЕНИЕ1,ЗНАЧЕНИЕ2,...]";
[–safe] — дополнительный ключ, который обозначает, что если при активации услуги на абоненте, услуга уже была активирована, параметры данной услуги для этого абонента останутся неизменными.
Примеры
Установить услугу "антиопределитель номера" для всех абонентов виртуальной АТС с именем "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"
Разрешить использовать услугу "групповой вызов" абоненту "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".
Установить услугу "переадресация вызова при неответе" в течение 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> — номер или диапазон номеров абонента(ов). Для указания всех абонентов заданной виртуальной АТС используется символ "*".
<SSName> — имя услуги, которую необходимо деактивировать;
Примеры
Деактивировать услугу "групповой вызов" на виртуальной АТС "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".
Деактивировать услугу "переадресация вызова при неответе" для абонента "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>] — номер или диапазон номеров абонента(ов) (опциональный параметр). Для указания всех абонентов заданной виртуальной АТС используется символ "*".
-extended — флаг, при указании которого будет показана подробная информация.
Примеры
Просмотреть полную информацию о всех услугах, активированных на виртуальной АТС "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 │ └──────┴─────────────┴─────────────────────────┴────────────────┴─┴─┴────────────────────────────────────────┴───────────────────────────┴────────────────────────┘
Просмотреть информацию о всех услугах, активированных для абонента "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 = [] │ └──────┴───────┴─────────────────────────┴────────────────┴─┴─┴────────────────────────────────────────────┘