/cluster/storage/<STORAGE>/ss/ - команды управления услугами
В данном разделе описаны команды управления услугами.
Вид услуги — логическая группировка нескольких реализаций услуги, имеющих общее назначение, но различные реализации.
Имя услуги — имя конкретной реализации определенного вида услуг;
<CLUSTER> — имя кластера хранения долговременных данных (DS, Storage), для которой выполняются настройки;
<NODE> — имя ноды DS, для которой выполняются настройки;
<DOMAIN> — название виртуальной АТС (домена), для которой выполняются настройки.
Описание доступных услуг приведено в разделе Описание и настройка услуг:
Все услуги реализованы программными средствами и предоставляются абонентам сети независимо от абонентского оборудования.
Команды, предназначенные для управления услугами, располагаются на виртуальной файловой системе CoCon в директориях:
- /cluster/storage/<CLUSTER>/ss/ — установка/удаление услуги, активация/деактивация услуги, обновление, настройка прав доступа на использование услуг, настройка разрешения на работу с определенным видом услуг;
access-list
Команда просмотра, добавления, удаления видов услуг, которые будут доступны для активации на виртуальной АТС.
- access-list show — просмотр видов услуг, которые можно использовать в рамках определенной виртуальной АТС или по всем виртуальным АТС;
- access-list add — добавление разрешения на работу с новым видом услуг;
- access-list clear — удаление всех услуг из определенной виртуальной АТС
- access-list remove — удаление разрешенных ранее видов услуг.
Путь команды:
/cluster/storage/<CLUSTER>/ss/access-list
Синтаксис:
access-list show [<DomainName>]
access-list add <DomainName> <SSName> [, <SSName>]
access-list clear <DomainName>
access-list remove <DomainName> <SSName> [, <SSName>]
Параметры:
<DOMAIN> — имя виртуальной АТС (домен);
<SSName> — новый вид (виды) услуг. Для перечисления видов услуг используется ",". Для указания всех услуг используется "*".
Пример:
Добавить все виды услуг в виртуальную АТС "front.office":
admin@mycelium1@ecss1:/$ cluster/storage/ds1/ss/access-list add test * Supplementary services successfully added in the domain test. [exec at: 02.03.2021 14:00:09, exec time: 25ms, nodes: ds1@ecss1 v.3.14.7.620]
Добавить следующий вид услуг в виртуальную АТС "front.office": переадресация вызова при занятости:
admin@mycelium1@ecss1:/$ cluster/storage/ds1/ss/access-list add test cfb Supplementary services successfully added in the domain test. [exec at: 02.03.2021 14:08:40, exec time: 21ms, nodes: ds1@ecss1 v.3.14.7.620]
Просмотреть список видов услуг, установленных для виртуальной АТС "front.office":
Просмотреть список всех видов услуг, установленных в системе для виртуальной АТС "test":
Удалить следующие виды услуг на виртуальной АТС "biysk.local": qsig-переадресация вызова при не ответе.
admin@mycelium1@ecss1:/$ cluster/storage/ds1/ss/access-list remove biysk.local qsig_cfb Supplementary services successfully removed from the domain biysk.local. [exec at: 02.03.2021 14:43:30, exec time: 42ms, nodes: ds1@ecss1 v.3.14.7.620]
Удаление всех услуг из виртуальной АТС "test":
admin@mycelium1@ecss1:/$ cluster/storage/ds1/ss/access-list clear test All supplementary services successfully removed from the domain test. [exec at: 02.03.2021 14:44:23, exec time: 36ms, nodes: ds1@ecss1 v.3.14.7.620]
activate
Команда для активации услуги у абонента. Активировать услугу может оператор либо абонент. После активации услуга будет работать только, если она разрешена абоненту.
Для того чтобы абонент мог активировать услугу, у него должен быть "доступ на управление" данной услугой.
Необходимо учитывать, что настройки услуги, заданные для определенного абонента, будут перекрывать общие (для всей виртуальной АТС) настройки услуг.
Путь команды:
/cluster/storage/<CLUSTER>/ss/activate/
Синтаксис:
activate <DOMAIN> <ADDRESS> <SSName> <ARGS>
Параметры:
<DOMAIN> — имя виртуальной АТС (домен), которой принадлежит абонент;
<ADDRESS> — номер или диапазон номеров абонента(ов), для указания всех абонентов заданной виртуальной АТС используется "*". Диапазон номеров задается в виде ab {c-d}, что соответствует номерам abc, abd;
<SSNAME> — имя услуги;
<ARGS> — дополнительный параметр для услуги, задается в виде "number = ЗНАЧЕНИЕ" либо "numbers = [ЗНАЧЕНИЕ1,ЗНАЧЕНИЕ2,...]".
Пример:
Включить определитель имени для абонента 240465 виртуальной АТС с именем "biysk.local".
admin@mycelium1@ecss1:/$ cluster/storage/ds1/ss/activate biysk.local 240465 cnip Success: Supplementary service cnip activated for domain "biysk.local" address "240465" [exec at: 03.03.2021 15:10:35, exec time: 12ms, nodes: ds1@ecss1 v.3.14.7.625]
Разрешить использовать услугу "групповой вызов" абоненту "240244" с абонентами "240462", "240469" виртуальной АТС с именем "biysk.local".
admin@mycelium1@ecss1:/$ domain/biysk.local/ss/activate 240244 cgg numbers = [240462, 240469] Success: Supplementary service cgg activated for domain "biysk.local" address "240244" [exec at: 03.03.2021 15:22:39, exec time: 8ms, nodes: ds1@ecss1 v.3.14.7.625]
Установить переадресацию вызова при отсутствии ответа в течение 10 секунд на номере "240100" на номер "416370".
admin@mycelium1@ecss1:/$ cluster/storage/ds1/ss/activate biysk.local 240469 cfu number = 240100 Success: Supplementary service cfu activated for domain "biysk.local" address "240469" [exec at: 09.03.2021 21:02:57, exec time: 42ms, nodes: ds1@ecss1 v.3.14.8.22]
deactivate
Команда деактивации определенной услуги на определенной виртуальной АТС для абонента или группы абонентов.
При деактивации удаляются все настройки, которые были введены при активации услуг.
Путь команды:
/cluster/storage/<CLUSTER>/ss/deactivate
Синтаксис:
deactivate <Domain> <Address> <SSNameList>
Параметры:
<Domain> — имя виртуальной АТС (домен), которой принадлежит абонент;
<Address> — номер или диапазон номеров абонента(ов). Для указания всех абонентов заданной виртуальной АТС используется "*". Диапазон номеров задается в виде ab {c-d}, что соответствует номерам abc, abd;
<SSNameList> — имя услуги, которую необходимо деактивировать.
Пример:
Деактивировать услугу с именем "cfu" на виртуальной АТС "biysk.local" на номере 240465.
admin@mycelium1@ecss1:/$ cluster/storage/ds1/ss/deactivate biysk.local 240469 cfu Success: Supplementary service cfu deactivated for domain "biysk.local", address "240469". [exec at: 09.03.2021 21:03:42, exec time: 35ms, nodes: ds1@ecss2 v.3.14.8.22]
disable
Командой устанавливается запрет на использование услуги абонентом.
Путь команды:
/cluster/storage/<CLUSTER>/ss/disable
Синтаксис:
disable <Domain> <Address> <SSNameList>
Параметры:
<Domain> — имя виртуальной АТС (домен), которой принадлежит абонент;
<ADDRESS> — номер или диапазон номеров абонента(ов), символ "*" используется для указания всех абонентов заданной виртуальной АТС. Диапазон номеров задается в виде ab {c-d}, что соответствует номерам abc, abd;
<SSNameList> — список услуг, которые будут недоступны абоненту.
Пример:
Запретить абоненту с номером 240465 использовать услугу немедленной переадресации:
admin@mycelium1@ecss1:/$ cluster/storage/ds1/ss/disable biysk.local 240465 cfu Success: Supplementary service cfu disabled for domain "biysk.local", address "240465". [exec at: 02.03.2021 15:55:44, exec time: 14ms, nodes: ds1@ecss1 v.3.14.7.620]
enable
Командой устанавливается разрешение на использование услуги абонентом.
Путь команды:
/cluster/storage/<CLUSTER>/ss/enable
Синтаксис:
enable <Domain> <Address> <SSNameList>
Параметры:
<Domain> — имя виртуальной АТС (домен), которой принадлежит абонент;
<ADDRESS> — номер или диапазон номеров абонента(ов), символ "*" используется для указания всех абонентов определенной виртуальной АТС. Диапазон номеров задается в виде ab {c-d}, что соответствует номерам abc, abd;
<SSNameList> — список услуг, которые необходимо включить, список задается через ",". Символ "*" используется для указания всех абонентов.
Пример:
Разрешить абонентам с номерами 240462, 240464,240465-240467,240469 пользоваться услугой "немедленной переадресации":
admin@mycelium1@ecss1:/$ cluster/storage/ds1/ss/enable biysk.local 24046{2,4,5-7,9} cfu Success: Supplementary service cfu enabled for domain "biysk.local", address "240462". Success: Supplementary service cfu enabled for domain "biysk.local", address "240464". Success: Supplementary service cfu enabled for domain "biysk.local", address "240465". Success: Supplementary service cfu enabled for domain "biysk.local", address "240466". Success: Supplementary service cfu enabled for domain "biysk.local", address "240467". Success: Supplementary service cfu enabled for domain "biysk.local", address "240469". [exec at: 03.03.2021 14:34:48, exec time: 12ms, nodes: ds1@ecss1 v.3.14.7.625]
enabled
Команда просмотра списка разрешенных услуг для определенных абонентов.
Путь команды:
/cluster/storage/<CLUSTER>/ss/enabled
Синтаксис:
enabled <Domain><ADDRESS>
Параметры:
<Domain> — имя виртуальной АТС;
<Address> — номер или диапазон номеров абонента(ов), опциональный параметр. Если параметр не указывать, будет показана информация по всем абонентам заданной виртуальной АТС. Диапазон номеров задается в виде ab {c-d}, что соответствует номерам abc, abd.
Пример:
Просмотр включенных услуг на виртуальной АТС biysk.local для абонентов 240501, 240501, 240503:
admin@mycelium1@ecss1:/$ cluster/storage/ds1/ss/enabled biysk.local 24050{1-3} ┌─────────────────────────────────┬───────────────────────────────────────────────────────────────────────────────────────┐ │ Address │ Enabled │ ├─────────────────────────────────┼───────────────────────────────────────────────────────────────────────────────────────┤ │240501 │cc_agent │ │ │chold │ │ │clip │ │ │cnip │ │ │ctr │ │240502 │clip │ │ │clir │ │ │ctr │ │240503 │No services enabled │ └─────────────────────────────────┴───────────────────────────────────────────────────────────────────────────────────────┘ Total: 3 [exec at: 03.03.2021 15:26:37, exec time: 31ms, nodes: ds1@ecss1 v.3.14.7.625]
force-activated
Команда одновременно разрешает и активирует услугу для абонентов.
Путь команды:
/cluster/storage/<CLUSTER>/ss/force-activate
Синтаксис:
force-activate <Domain> <Address> <SSName> <Args>
Параметры:
<Domain> — имя виртуальной АТС;
<Address> — номер или диапазон номеров абонента(ов), опциональный параметр. Если параметр не указывать, будет показана информация по всем абонентам заданной виртуальной АТС. Диапазон номеров задается в виде ab {c-d}, что соответствует номерам abc, abd.
<SSName> — имя активируемой услуги;
<Args> — параметры услуги.
Пример:
Разрешение и активация услуги немедленной переадресации для абонентов 240465 и 240467:
admin@mycelium1@ecss1:/$ cluster/storage/ds1/ss/force-activate biysk.local 24046{5,7} cfu number = 416370 Success: Supplementary service cfu activated for domain "biysk.local" address "240465" Success: Supplementary service cfu activated for domain "biysk.local" address "240467" [exec at: 03.03.2021 16:22:18, exec time: 10ms, nodes: ds1@ecss1 v.3.14.7.625]
info
Команда просмотра информации об активированных в рамках виртуальной АТС услугах. Команда позволяет просматривать параметры, заданные при активации сервиса, а также показывает, доступно ли услуга для абонента на использование/управление или нет.
Для просмотра информации по определенному абоненту необходимо ввести имя виртуальной АТС и номер абонента.
Если требуется просмотреть информацию по всем абонентам в рамках определенной виртуальной АТС, то параметр "номер абонента" можно опустить либо ввести "all".
Если требуется просмотреть информацию только по услугам, активированным на уровне домена, то в качестве параметра "номер абонента" нужно ввести символ "*".
Путь команды:
/cluster/storage/<CLUSTER>/ss/info
Синтаксис:
info <Domain> [-extended] [<Address>] [<SSName>]
Параметры:
<DOMAIN> — имя виртуальной АТС;
[-extended] — флаг, при указании которого будет показана подробная информация;
[<Address>] — номер телефона или диапазон номеров абонента(ов) виртуальной АТС . Диапазон номеров задается в виде ab {c-d}, что соответствует номерам abc, abd;
[<SSName>] — название услуги.
Пример:
Просмотреть полную информацию о всех услугах, активированных на виртуальной АТС "biysk.local", для абонентов 240465-240469.
admin@mycelium1@ecss1:/$ cluster/storage/ds1/ss/info biysk.local -extended 24046{5-9} Domain: biysk.local Supplementary services' settings: ┌───────────────────┬────────────────────────────────┬─┬─┬─────────────────────────────────────────────┬─────────────────────────────────────────────┬───────────────────────────────────────────────────┐ │ Address │ Name │V│E│ MSD │ SSD │ CSD │ ├───────────────────┼────────────────────────────────┼─┼─┼─────────────────────────────────────────────┼─────────────────────────────────────────────┼───────────────────────────────────────────────────┤ │240465 │cc_agent │4│T│view_group = "Other" │ │extra_number = [] │ │240465 │cf_sip │1│T│conflict_list = [cfu,assistant,follow_me,tsmn│forwarding_ss = true │ │ │ │ │0│ │_request] │ │ │ │ │ │ │ │owner = any │ │ │ │ │ │ │ │view_group = "Forwarding" │ │ │ │240465 │cfu │1│T│conflict_list = [assistant,follow_me,cfu_type│forwarding_ss = true │external_number = [] │ │ │ │5│ │2,meet_me_conference] │ │number = "416370" │ │ │ │ │ │owner = any │ │use_external_number = false │ │ │ │ │ │view_group = "Forwarding" │ │ │ │240465 │cgg │8│T│conflict_list = [assistant,follow_me,cfu_type│forwarding_ss = true │numbers = 240462, 240469 │ │ │ │ │ │2,meet_me_conference,cfu,find_me, │ │send_call_diversion = true │ │ │ │ │ │ cf_aon,cft] │ │ │ │ │ │ │ │view_group = "Call groups" │ │ │ │240465 │chold │9│T│view_group = "call manipulation" │dtmf_detector = true │disable_moh = false │ │ │ │ │ │ │ │dtmf_sequence_as_flash = false │ │240465 │clip │6│T│view_group = "identification" │ │ │ │240465 │cnip │4│T│owner = any │ │ │ │ │ │ │ │view_group = "identification" │ │ │ │240465 │conference │1│T│conflict_list = ['3way'] │ │destroy_mode = by_no_master │ │ │ │1│ │dependency_list = [chold,ctr] │ │max_participants = 16 │ │ │ │ │ │enumDestroy_mode = "by_no_master|by_no_more_c│ │ │ │ │ │ │ │alls" │ │ │ │ │ │ │ │integer_rangeMax_participants = "[3,64]" │ │ │ │ │ │ │ │view_group = "Conference" │ │ │ │240465 │ctr │6│T│dependency_list = [chold] │dtmf_detector = true │ │ │ │ │ │ │view_group = "call manipulation" │ │ │ │240465 │intervention │5│T│enumRestriction = "full_control|implicitly_al│dtmf_detector = true │restriction = full_control │ │ │ │ │ │lowed|explicitly_allowed" │ │ │ │ │ │ │ │view_group = "call manipulation" │ │ │ │240465 │mcid │3│T│view_group = "identification" │ │ │ │240465 │ml │7│T│integer_rangeLine_count = "[0,32]" │ │line_count = 3 │ │ │ │ │ │integer_rangeLine_count_out = "[-1,32]" │ │line_count_out = -1 │ │ │ │ │ │view_group = "call manipulation" │ │ │ │240465 │park │3│T│view_group = "call manipulation" │ │ │ │240466 │cc_agent │4│T│view_group = "Other" │ │extra_number = [] │ │240466 │cf_sip │1│T│conflict_list = [cfu,assistant,follow_me,tsmn│forwarding_ss = true │ │ │ │ │0│ │_request] │ │ │ │ │ │ │ │owner = any │ │ │ │ │ │ │ │view_group = "Forwarding" │ │ │ │240466 │chold │9│T│view_group = "call manipulation" │dtmf_detector = true │disable_moh = false │ │ │ │ │ │ │ │dtmf_sequence_as_flash = false │ │240466 │clip │6│T│view_group = "identification" │ │ │ │240466 │cnip │4│T│owner = any │ │ │ │ │ │ │ │view_group = "identification" │ │ │ │240466 │conference │1│T│conflict_list = ['3way'] │ │destroy_mode = by_no_master │ │ │ │1│ │dependency_list = [chold,ctr] │ │max_participants = 16 │ │ │ │ │ │enumDestroy_mode = "by_no_master|by_no_more_c│ │ │ │ │ │ │ │alls" │ │ │ │ │ │ │ │integer_rangeMax_participants = "[3,64]" │ │ │ │ │ │ │ │view_group = "Conference" │ │ │ │240466 │ctr │6│T│dependency_list = [chold] │dtmf_detector = true │ │ │ │ │ │ │view_group = "call manipulation" │ │ │ │240466 │intervention │5│T│enumRestriction = "full_control|implicitly_al│dtmf_detector = true │restriction = full_control │ │ │ │ │ │lowed|explicitly_allowed" │ │ │ │ │ │ │ │view_group = "call manipulation" │ │ │ │240466 │mcid │3│T│view_group = "identification" │ │ │ │240466 │ml │7│T│integer_rangeLine_count = "[0,32]" │ │line_count = 3 │ │ │ │ │ │integer_rangeLine_count_out = "[-1,32]" │ │line_count_out = -1 │ │ │ │ │ │view_group = "call manipulation" │ │ │ │240466 │park │3│T│view_group = "call manipulation" │ │ │ │240467 │cc_agent │4│T│view_group = "Other" │ │extra_number = [] │ │240467 │cf_sip │1│T│conflict_list = [cfu,assistant,follow_me,tsmn│forwarding_ss = true │ │ │ │ │0│ │_request] │ │ │ │ │ │ │ │owner = any │ │ │ │ │ │ │ │view_group = "Forwarding" │ │ │ │240467 │chold │9│T│view_group = "call manipulation" │dtmf_detector = true │disable_moh = false │ │ │ │ │ │ │ │dtmf_sequence_as_flash = false │ │240467 │clip │6│T│view_group = "identification" │ │ │ │240467 │cnip │4│T│owner = any │ │ │ │ │ │ │ │view_group = "identification" │ │ │ │240467 │conference │1│T│conflict_list = ['3way'] │ │destroy_mode = by_no_master │ │ │ │1│ │dependency_list = [chold,ctr] │ │max_participants = 16 │ │ │ │ │ │enumDestroy_mode = "by_no_master|by_no_more_c│ │ │ │ │ │ │ │alls" │ │ │ │ │ │ │ │integer_rangeMax_participants = "[3,64]" │ │ │ │ │ │ │ │view_group = "Conference" │ │ │ │240467 │ctr │6│T│dependency_list = [chold] │dtmf_detector = true │ │ │ │ │ │ │view_group = "call manipulation" │ │ │ │240467 │intervention │5│T│enumRestriction = "full_control|implicitly_al│dtmf_detector = true │restriction = full_control │ │ │ │ │ │lowed|explicitly_allowed" │ │ │ │ │ │ │ │view_group = "call manipulation" │ │ │ │240467 │mcid │3│T│view_group = "identification" │ │ │ │240467 │ml │7│T│integer_rangeLine_count = "[0,32]" │ │line_count = 3 │ │ │ │ │ │integer_rangeLine_count_out = "[-1,32]" │ │line_count_out = -1 │ │ │ │ │ │view_group = "call manipulation" │ │ │ │240467 │park │3│T│view_group = "call manipulation" │ │ │ │240469 │cc_agent │4│T│view_group = "Other" │ │extra_number = [] │ └───────────────────┴────────────────────────────────┴─┴─┴─────────────────────────────────────────────┴─────────────────────────────────────────────┴───────────────────────────────────────────────────┘ Legend: V - version of the supplementary service; E - enable state of selected supplementary service to current domain, address [exec at: 03.03.2021 10:49:40, exec time: 45ms, nodes: ds1@ecss1 v.3.14.7.625]
Просмотреть информацию о всех услугах, активированных для абонента "240465" на виртуальной АТС " biysk.local".
admin@mycelium1@ecss1:/$ cluster/storage/ds1/ss/info biysk.local 240465 Domain: biysk.local Supplementary services' settings: ┌────────────────────────────────────┬────────────────────────────────────────────────────────────┬──┬──┬─────────────────────────────────────────────────────────────────────────────────────────────────┐ │ Address │ Name │V │E │ CSD │ ├────────────────────────────────────┼────────────────────────────────────────────────────────────┼──┼──┼─────────────────────────────────────────────────────────────────────────────────────────────────┤ │240465 │cc_agent │4 │T │extra_number = [] │ │240465 │cf_sip │10│T │ │ │240465 │cfu │15│T │external_number = [] │ │ │ │ │ │number = "416370" │ │ │ │ │ │use_external_number = false │ │240465 │cgg │8 │T │numbers = 240462, 240469 │ │ │ │ │ │send_call_diversion = true │ │240465 │chold │9 │T │disable_moh = false │ │ │ │ │ │dtmf_sequence_as_flash = false │ │240465 │clip │6 │T │ │ │240465 │cnip │4 │T │ │ │240465 │conference │11│T │destroy_mode = by_no_master │ │ │ │ │ │max_participants = 16 │ │240465 │ctr │6 │T │ │ │240465 │intervention │5 │T │restriction = full_control │ │240465 │mcid │3 │T │ │ │240465 │ml │7 │T │line_count = 3 │ │ │ │ │ │line_count_out = -1 │ │240465 │park │3 │T │ │ └────────────────────────────────────┴────────────────────────────────────────────────────────────┴──┴──┴─────────────────────────────────────────────────────────────────────────────────────────────────┘ Legend: V - version of the supplementary service; E - enable state of selected supplementary service to current domain, address [exec at: 03.03.2021 11:11:38, exec time: 48ms, nodes: ds1@ecss1 v.3.14.7.625]
install
Команда установки описания новой услуги с определенным именем и видом в систему. Команда берет описание услуги из XML-файла, имя которого передается команде в качестве параметра, и сохраняет его в системе. После того, как данная команда выполнена, администратор ECSS-10/виртуальной АТС может активировать данную услугу.
Путь команды:
/cluster/storage/<CLUSTER>/ss/install
Синтаксис:
install <NODE> <SSTemplate>
Параметры:
<NODE> — имя подсистемы DS;<SSTemplate> — имя XML файла-описания услуги. В качестве файла-описания услуги может использоваться маска поиска. В этом случае все файлы, имена которых удовлетворяют этой маске, будут установлены в систему. В маске поиска используются символы:
- * — любое количество символов,
- ? — ровно один символ.
Пример:
Установить новую услугу:
admin@mycelium1@ecss1:/$ cluster/storage/ds1/ss/install ds1@ecss1 ss_fax_receiver.xml Successfully installed: /var/lib/ecss/ss/ss_fax_receiver.xml [exec at: 03.03.2021 11:14:03, exec time: 57ms, nodes: ds1@ecss1 v.3.14.7.625]
Установить услуги название которых начинается с символов "cf":
admin@mycelium1@ecss1:/$ cluster/storage/ds1/ss/install ds1@ecss1 ss_cf??.xml Successfully installed: /var/lib/ecss/ss/ss_cfos.xml Successfully installed: /var/lib/ecss/ss/ss_cfnr.xml [exec at: 03.03.2021 11:15:48, exec time: 75ms, nodes: ds1@ecss1 v.3.14.7.625]
show
Команда просмотра настроек услуги, установленных в систему.
Команда позволяет выбрать интересующие поля (все поля) и вывести значение этих полей в табличном представлении.
Путь команды:
cluster/storage/<CLUSTER>/ss/show
Синтаксис:
show [<SSNames> | *]
Параметры:
<SSName> — поле для просмотра:
- csd — настройки услуги, которые может менять абонент при активации;
- description — описание услуги;
- name — имя услуги;
- ssd — настройки услуги, которые нельзя менять при активации. Они нужны для работы сервиса, но не требуют изменения со стороны пользователя;
- msd — метаинформация об услуге, которая необходима только для работы команд управления услугой;
- version — версия реализации услуги.
Для перечисления нескольких параметров используется ",". Для указания всех параметров используется "*".
Пример:
Список установленных услуг:
Полная информация об установленных услугах:
uninstall
Команда для удаления из системы установленных услуг. Если услуга была активирована, перед удалением она будет деактивирована.
Путь команды:
/cluster/storage/<CLUSTER>/ss/uninstall
Синтаксис:
uninstall <SSNames> | *
Параметры:
<SSNames> — имя услуги, которую необходимо удалить из системы. Для указания всех установленных в системе услугах используется "*". Для перечисления услуг используется ",".
Пример:
Удалить услугу "запись разговора" из системы:
admin@mycelium1@ecss1:/$ cluster/storage/ds1/ss/uninstall cfos,cfnr Supplementary service cfos successfully uninstalled. Supplementary service cfnr successfully uninstalled. [exec at: 03.03.2021 11:15:21, exec time: 104ms, nodes: ds1@ecss1 v.3.14.7.625]
Удалить все виды услуг, установленные в системе:
update
Командой выполняется обновление услуги с текущей версии, установленной в системе, до версии, указанной в XML-файле.
Команда берет описание услуги из XML-файла, проверяет наличие расхождений описания услуги между версиями, проверяет присутствие скрипта миграции (также в XML-файле).
Если в новой версии XML присутствуют свойства, которых не было в предыдущей версии XML, то система проверяет, есть ли правило миграции для данного свойства. Если правила миграции присутствуют для всех полей — миграция проходит в автоматическом режиме. Если в новой версии XML присутствует свойство, правило миграции для которого отсутствует — необходимо указать правило миграции вручную. Для этого система посредством wizzard-а запросит у администратора ввести значение для инициализации данного свойства у абонентов, у которых данная услуга уже активирована.
Возможны три варианта инициализации:
- Инициализация значением по умолчанию. Свойство может быть инициализировано значением по умолчанию только тогда, когда значение по умолчанию описано в XML-файле;
- Получить значение из установленного свойства. Если в ранней версии услуги было свойство того же типа, что и новое свойство, то значение для нового свойства можно скопировать из значения установленного свойства;
- Указать явно. Можно явно указать, каким значением инициализировать новое свойство.
Путь команды:
/cluster/storage/<CLUSTER>/ss/update
Синтаксис:
update <NODE> -<Flag> <SSTemplate>
Параметры:
<NODE> — имя подсистемы DS;<Flag> — флаг, принимает значения:
- -a, --auto — использовать правила миграции, описанные в XML (если они прописаны);
- -m, --manual — не использовать правила миграции, описанные в XML (если они прописаны). В данном случае для всех новых свойств необходимо будет явно задать значения;
<SSTemplate> — имя XML файла-описания услуги.
В качестве файла-описания услуги может использоваться маска поиска. В этом случае все файлы, имена которых удовлетворяют этой маске, будут установлены в систему. В маске поиска используются символы: - * — любое количество символов,
- ? — ровно один символ.
Пример:
Обновление услуги "zone_page" с версии 6 до версии 7.
admin@mycelium1@ecss1:/$ cluster/storage/ds1/ss/update ds1@ecss1 --auto ss_zone_page.xmlSupplemenraty service already updated to version 13: /var/lib/ecss/ss/ss_zone_page.xml[exec at: 03.03.2021 11:31:57, exec time: 21ms, nodes: ds1@ecss1 v.3.14.7.625]Обновление без правил миграции:
admin@mycelium1@ecss1:/$ cluster/storage/ds1/ss/update ds1@ecss1 --manual ss_flexicall.xml Supplemenraty service already updated to version 2: /var/lib/ecss/ss/ss_flexicall.xml [exec at: 03.03.2021 11:32:27, exec time: 23ms, nodes: ds1@ecss1 v.3.14.7.625]
limit
Команда просмотра использования лицензий ДВО
Путь команды:
/cluster/storage/<CLUSTER>/ss/limit <OPTIONS>
Параметры:
<OPTIONS>
- --show-aliaces — информация по лицензионым пакетам на алиасах (default: false)
- --show-ss — список услуг в пакете (default: false)
- --sort-by-time — сортировка по времени (default: false) Requires: --show-aliases.
Пример:
Выведем информацию об использовании лицензий ДВО на уровне системы
admin@mycelium1@ecss1:/$ cluster/storage/ds1/ss/limit --show-aliases --show-ss --sort-by-time ┌──────────┬──────────┬─────────────┬──────────────────────────┬─────────────┬─────────────────────────┐ │ Name │ Used │ Domain │ Description │ Aliases │ SS List │ │ │ │pre-allocated│ │ │ │ ├──────────┼──────────┼─────────────┼──────────────────────────┼─────────────┼─────────────────────────┤ │ECSS-GEN │0 / 1300 │ infinity│Стандартные услуги (РД 45)│ │cc_agent │ │ │ │ │ │ │cfb │ │ │ │ │ │ │cfnr │ │ │ │ │ │ │cfos │ │ │ │ │ │ │cfu │ │ │ │ │ │ │chold │ │ │ │ │ │ │clip │ │ │ │ │ │ │cnip │ │ │ │ │ │ │ctr │ │ │ │ │ │ │cw │ │ │ │ │ │ │direct_call │ │ │ │ │ │ │mcid │ │ │ │ │ │ │qsig_cfb │ │ │ │ │ │ │qsig_cfnr │ │ │ │ │ │ │qsig_cfu │ │ │ │ │ │ │teleconference │ │ │ │ │ │ │teleconference_manager │ │ │ │ │ │ │tsmn_request │ │ECSS-BAS │0 / 1300 │ infinity│Базовые услуги (РД 45) │ │3way │ │ │ │ │ │ │cfnr_type2 │ │ │ │ │ │ │cfu_type2 │ │ │ │ │ │ │clir │ │ │ │ │ │ │cliro │ │ │ │ │ │ │dnd │ │ │ │ │ │ │ml │ │ │ │ │ │ │pickup │ │ │ │ │ │ │redial │ │ECSS-BAS+ │0 / 1300 │ infinity│Расширение базовых услуг │ │acb │ │ │ │ │ │ │alarm │ │ │ │ │ │ │auto_redial │ │ │ │ │ │ │auto_redial_with_callback│ │ │ │ │ │ │callback │ │ │ │ │ │ │cf_aon │ │ │ │ │ │ │cf_sip │ │ │ │ │ │ │conference │ │ │ │ │ │ │fbc │ │ │ │ │ │ │hide_cf_name │ │ │ │ │ │ │meet_me_conference │ │ │ │ │ │ │rbp │ │ │ │ │ │ │rfc │ │ │ │ │ │ │ring_back_tone │ │ │ │ │ │ │sca │ │ │ │ │ │ │sco_black │ │ │ │ │ │ │sco_white │ │ │ │ │ │ │scr │ │ │ │ │ │ │speed_dial │ │ │ │ │ │ │vip_call │ │ │ │ │ │ │voicemail │ │ECSS-ADV │0 / 1300 │ infinity│Дополнительные услуги │ │blf │ │ │ │ │ │ │call_recording │ │ │ │ │ │ │cft │ │ │ │ │ │ │cgg │ │ │ │ │ │ │chunt │ │ │ │ │ │ │click_to_call │ │ │ │ │ │ │fax_receiver │ │ │ │ │ │ │fax_to_email │ │ │ │ │ │ │find_me │ │ │ │ │ │ │find_me_no_response │ │ │ │ │ │ │follow_me │ │ │ │ │ │ │follow_me_no_response │ │ │ │ │ │ │intercom │ │ │ │ │ │ │park │ │ │ │ │ │ │presence │ │ │ │ │ │ │second_handset │ │ │ │ │ │ │sip_message │ │ECSS-ADV+ │0 / 1300 │ infinity│Дополнительные услуги + │ │assistant │ │ │ │ │ │ │avatar │ │ │ │ │ │ │boss_group │ │ │ │ │ │ │cnip_audio │ │ │ │ │ │ │cpip │ │ │ │ │ │ │distinctive_picture │ │ │ │ │ │ │distinctive_ring │ │ │ │ │ │ │flexicall │ │ │ │ │ │ │fxo_trunk │ │ │ │ │ │ │intervention │ │ │ │ │ │ │introduce │ │ │ │ │ │ │message │ │ │ │ │ │ │multicast_listen │ │ │ │ │ │ │multicast_page │ │ │ │ │ │ │personal_ivr │ │ │ │ │ │ │privacy │ │ │ │ │ │ │remote_phone │ │ │ │ │ │ │remote_ring │ │ │ │ │ │ │s4b_presence │ │ │ │ │ │ │smart_cancel │ │ │ │ │ │ │voice_page │ │ │ │ │ │ │voice_page_control │ │ │ │ │ │ │walkie_talkie │ │ │ │ │ │ │zone_page │ │ECSS-FULL+│361 / 1300│ infinity│Все услуги что есть │ a.test: │3way │ │ │ │ │ │ 150-190│acb │ │ │ │ │ │biysk.local: │alarm │ │ │ │ │ │240001-240003│assistant │ │ │ │ │ │ 240006│auto_redial │ │ │ │ │ │ 240007│auto_redial_with_callback│ │ │ │ │ │ 240100│avatar │ │ │ │ │ │ 240101│blf │ │ │ │ │ │ 240244│boss_group │ │ │ │ │ │ 240316│call_recording │ │ │ │ │ │ 240462│callback │ │ │ │ │ │240464-240467│cc_agent │ │ │ │ │ │240469-240471│cf_aon │ │ │ │ │ │240473-240475│cf_sip │ │ │ │ │ │240500-240799│cfb │ │ │ │ │ │ │cfnr │ │ │ │ │ │ │cfnr_type2 │ │ │ │ │ │ │cfos │ │ │ │ │ │ │cft │ │ │ │ │ │ │cfu │ │ │ │ │ │ │cfu_type2 │ │ │ │ │ │ │cgg │ │ │ │ │ │ │chold │ │ │ │ │ │ │chunt │ │ │ │ │ │ │click_to_call │ │ │ │ │ │ │clip │ │ │ │ │ │ │clir │ │ │ │ │ │ │cliro │ │ │ │ │ │ │cnip │ │ │ │ │ │ │cnip_audio │ │ │ │ │ │ │conference │ │ │ │ │ │ │cpip │ │ │ │ │ │ │ctr │ │ │ │ │ │ │cw │ │ │ │ │ │ │direct_call │ │ │ │ │ │ │distinctive_picture │ │ │ │ │ │ │distinctive_ring │ │ │ │ │ │ │dnd │ │ │ │ │ │ │fax_receiver │ │ │ │ │ │ │fax_to_email │ │ │ │ │ │ │fbc │ │ │ │ │ │ │find_me │ │ │ │ │ │ │find_me_no_response │ │ │ │ │ │ │flexicall │ │ │ │ │ │ │follow_me │ │ │ │ │ │ │follow_me_no_response │ │ │ │ │ │ │fxo_trunk │ │ │ │ │ │ │hide_cf_name │ │ │ │ │ │ │intercom │ │ │ │ │ │ │intervention │ │ │ │ │ │ │introduce │ │ │ │ │ │ │mcid │ │ │ │ │ │ │meet_me_conference │ │ │ │ │ │ │message │ │ │ │ │ │ │ml │ │ │ │ │ │ │multicast_listen │ │ │ │ │ │ │multicast_page │ │ │ │ │ │ │park │ │ │ │ │ │ │personal_ivr │ │ │ │ │ │ │pickup │ │ │ │ │ │ │presence │ │ │ │ │ │ │privacy │ │ │ │ │ │ │qsig_cfb │ │ │ │ │ │ │qsig_cfnr │ │ │ │ │ │ │qsig_cfu │ │ │ │ │ │ │rbp │ │ │ │ │ │ │redial │ │ │ │ │ │ │remote_phone │ │ │ │ │ │ │remote_ring │ │ │ │ │ │ │rfc │ │ │ │ │ │ │ring_back_tone │ │ │ │ │ │ │s4b_presence │ │ │ │ │ │ │sca │ │ │ │ │ │ │sco_black │ │ │ │ │ │ │sco_white │ │ │ │ │ │ │scr │ │ │ │ │ │ │second_handset │ │ │ │ │ │ │sip_message │ │ │ │ │ │ │smart_cancel │ │ │ │ │ │ │speed_dial │ │ │ │ │ │ │teleconference │ │ │ │ │ │ │teleconference_manager │ │ │ │ │ │ │tsmn_request │ │ │ │ │ │ │vip_call │ │ │ │ │ │ │voice_page │ │ │ │ │ │ │voice_page_control │ │ │ │ │ │ │voicemail │ │ │ │ │ │ │walkie_talkie │ │ │ │ │ │ │zone_page │ └──────────┴──────────┴─────────────┴──────────────────────────┴─────────────┴─────────────────────────┘ Legend: Used: UsedLicence / AvailableLicence [exec at: 03.03.2021 11:33:30, exec time: 19ms, nodes: ds1@ecss1 v.3.14.7.625]