Дерево страниц
Перейти к концу метаданных
Переход к началу метаданных

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

Все услуги реализованы программными средствами и предоставляются абонентам сети независимо от абонентского оборудования.

Команды, предназначенные для управления услугами, располагаются на виртуальной файловой системе CoCon в директориях:

  • /cluster/storage/<CLUSTER>/ss - установка/удаление услуги, активация/деактивация услуги, обновление, настройка прав доступа на использование услуг, настройка разрешения на работу с определенным видом услуг;
  • /domain/<DOMAIN>/ss - активация/деактивация услуги, настройка прав доступа на использование услуг в рамках определенной виртуальной АТС.
Услуга – вид обслуживания абонента телекоммуникационной сети, предоставляемый по заказу абонента с целью обеспечения расширенных возможностей.
Вид услуги - логическая группировка нескольких реализаций услуги, имеющих общее назначение, но различные реализации.
Имя услуги - имя конкретной реализации определенного вида услуг;
<CLUSTER> - имя кластера хранения долговременных данных (DS, Storage), для которой выполняются настройки;
<NODE> - имя ноды DS, для которой выполняются настройки;
<DOMAIN> - название виртуальной АТС (домена), для которой выполняются настройки.

В таблице 1 приведен список доступных услуг. Подробное описание услуг приведено в Части 1 Описание и работа системы ECSS-10, в разделе 4 Функции.

Таблица 1 - Список услуг

НазваниеОписание
3wayтрехсторонняя конференц-связь
acbзапрет приема вызова с неизвестного номера (блокировка анонимных вызовов)
alarmбудильник
assistantгруппа шеф-секретарь
auto_redialавтодозвон
auto_redial_with_callbackавтодозвон с обратным вызовом
blfМониторинг событий абонента по подписке
callbackобратный вызов
call_recordingзапись разговора
cc_agentагент call-центра
cfbпереадресация вызова по занятости
cfnrпереадресация вызова по неответу
cfnr_type2переадресация по неответу, Тип 2
cfosпереадресация вызова по недоступности
cfsipпереадресация вызова посредством оконечного терминала (302 сообщение)
cftпереадресация по времени
cfuбезусловная переадресация вызова
cfu_type2безусловная переадресация вызова, Тип 2
cggгрупповой вызов
choldудержание вызова
chuntпоиск первой свободной линии по списку
click_to_callвызов по клику
clipавтоматический определитель номера
clirантиопределитель номера
cnipавтоматический определитель имени абонента
cliroпреодоление запрета предоставления номера вызывающего абонента
conference_callконференц-связь с последовательным сбором участников
ctrперевод вызова во время разговора
cwизвещение о поступлении нового вызова
direct_callпрямой вызов, актуальна только для абонентов, подключенных по протоколу H.248/Megaco
distinctive_ringсервис Звонок особого типа
dndне беспокоить, запрет на все входящие вызовы, с возможностью использовать исходящую связь
fax_receiverсервис приема факса обычными терминалами
fax_to_emailFax to email
find_meпереадресация по расписанию
find_me_no_responseпереадресация по расписанию и неответу
follow_meследуй за мной, переадресация поступающих вызовов на удаленный номер
follow_me_no_responseследуй за мной по неответу
intereventionвмешательство
mcidотслеживание злонамеренного вызова
meet_me_conferenceКонференц-связь meet me
mgmуправление услугами с телефона абонента
mlmultiline
my_numberномер моего телефона, по запросу абонента проигрывает номер текущего телефона
call_parkпарковка вызова
presenceмониторинг состояний абонентов по подписке
pickupперехват вызова
rbpограничение исходящих вызовов
redialповтор последнего набранного номера
remote_phoneУдаленный телефон
rfcзапрет переадресованных вызовов
ring_back_toneгудок
scaвыборочное разрешение входящих вызовов
sco_blackвыборочный запрет исходящих вызовов
sco_whiteвыборочное разрешение исходящих вызовов
scrвыборочный запрет входящих вызовов
speed_dialбыстрый набор
teleconference_managerселекторная связь
tsmn_requestподдержка запросов на УОВЭОС
vip_callприоритетный (VIP) вызов
voice_mailголосовая почта
voice_page_controlконтроль индивидуального оповещения
voice_pageиндивидуальное оповещение
zone_pageгрупповое оповещение
qsig_cfbQSIG: переадресация вызовов по занятости
qsig_cfnrQSIG: переадресация вызовов по неответу
qsig_cfuQSIG: безусловная переадресация вызовов

access-list

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

  • access-list show - просмотр видов услуг, которые можно использовать в рамках определенной виртуальной АТС или по всем виртуальным АТС;
  • access-list add - добавление разрешения на работу с новым видом услуг;
  • access-list clear - удаление всех услуг из определенной виртуальной АТС
  • access-list remove - удаление разрешенных ранее видов услуг.

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

/cluster/storage/<CLUSTER>/ss/access-list

Синтаксис:

access-list show [<DOMAIN>]
access-list add <DOMAIN> <SsFamily> [, <SsFamily>]
access-list clear <DOMAIN>
access-list remove <DOMAIN> <SsFamily> [, <SsFamily>]

Параметры:

<DOMAIN> - имя виртуальной АТС (домен);
<SsFamily> - новый вид (виды) услуг. Для перечисления видов услуг используется ",". Для указания всех услуг используется "*".

Пример:

Добавить все виды услуг в виртуальную АТС "p.city".

admin@[mycelium1@ecss1]:/$ /cluster/storage/ds3/ss/access-list add p.city *
Supplementary services successfully added in the domain p.city.

Добавить следующие виды услуг в виртуальную АТС "p.city": управление дополнительными услугами, переадресация вызова при не ответе, поиск первой свободной линии по списку.

admin@[mycelium1@ecss1]:/$ /cluster/storage/ds3/ss/access-list add p.city MGM, CFNR, CHUNT
Supplementary services successfully added in the domain p.city.

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

admin@[mycelium1@ecss1]:/$ /cluster/storage/ds3/ss/access-list show
-------------------------------------------------------------
|     Domain     |          Supplementary services          |
|----------------+------------------------------------------|
|p.city          |CFB, CFNR, CFU, CGG, CHUNT, CLIR, DND, MGM|
|d.city          |CLIP, CGG, CHUNT                          |
-------------------------------------------------------------

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

admin@[mycelium1@ecss1]:/$ /cluster/storage/ds3/ss/access-list show p.city
---------------------------------------------------
|Domain|          Supplementary services          |
|------+------------------------------------------|
|p.city|CFB, CFNR, CFU, CGG, CHUNT, CLIR, DND, MGM|
---------------------------------------------------

Удалить следующие виды услуг на виртуальной АТС "p.city": управление дополнительными услугами, переадресация вызова при не ответе.

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

activate

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

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

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

/cluster/storage/<CLUSTER>/ss/activate/

Синтаксис:

activate <DOMAIN> <ADDRESS> <SSName> <ARGS>

Параметры:

<DOMAIN> - имя виртуальной АТС (домен), которой принадлежит абонент;
<ADDRESS> - номер или диапазон номеров абонента(ов), для указания всех абонентов заданной виртуальной АТС используется "*". Диапазон номеров задается в виде ab {c-d}, что соответствует номерам abc, abd;
<SSNAME> - имя услуги;
<ARGS> - дополнительный параметр для услуги, задается в виде "number = ЗНАЧЕНИЕ" либо "numbers = [ЗНАЧЕНИЕ1,ЗНАЧЕНИЕ2,...]".

Пример:

Включить антиопределитель номера для всех абонентов виртуальной АТС с именем "p.city".

admin@[mycelium1@ecss1]:/$ /cluster/storage/ds3/ss/activate p.city * clir 
Supplementary service clir successfully activated to domain "p.city", address "*".

Разрешить использовать услугу "групповой вызов" абоненту "799" с абонентами "711", "712" виртуальной АТС с именем "p.city".

admin@[mycelium1@ecss1]:/$ /cluster/storage/ds3/ss/activate p.city 799 cgg numbers = [711, 712]
Supplementary service cgg successfully activated to domain "p.city", address "799".

Установить переадресацию вызова при не ответе в течение 10 секунд на номере "711" на номер "712".

admin@[mycelium1@ecss1]:/$ /cluster/storage/ds3/ss/activate p.city 711 cfnr number = 712, timeout = 10
Supplementary service cfnr successfully activated to domain "p.city", address "711".

deactivate

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

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

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

/cluster/storage/<CLUSTER>/ss/deactivate

Синтаксис:

deactivate <DOMAIN> <ADDRESS> <SSNAME>

Параметры:

<DOMAIN> - имя виртуальной АТС (домен), которой принадлежит абонент;
<ADDRESS> - номер или диапазон номеров абонента(ов). Для указания всех абонентов заданной виртуальной АТС используется "*". Диапазон номеров задается в виде ab {c-d}, что соответствует номерам abc, abd;
<SSNAME> - имя услуги, которую необходимо деактивировать.

Пример:

Деактивировать услугу с именем "cgg" на виртуальной АТС "p.city".

admin@[mycelium1@ecss1]:/$ /cluster/storage/ds3/ss/deactivate p.city * cgg
Supplementary service successfully deactivated.

Деактивировать услугу с именем "cfnr" для абонента "711" на виртуальной АТС "p.city".

admin@[mycelium1@ecss1]:/$ /cluster/storage/ds3/ss/deactivate p.city 711 cfnr
Supplementary service successfully deactivated.

enabled

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

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

/cluster/storage/<CLUSTER>/ss/enabled

Синтаксис:

enabled <DOMAIN> <ADDRESS>

Параметры:

<DOMAIN> - имя виртуальной АТС;
<ADDRESS> - номер или диапазон номеров абонента(ов), опциональный параметр. Если параметр не указывать, будет показана информация по всем абонентам заданной виртуальной АТС. Диапазон номеров задается в виде ab {c-d}, что соответствует номерам abc, abd.

Пример:

Просмотр включенных услуг на виртуальной АТС test.domain:

admin@[mycelium1@ecss1]:/$ domain/test.domain/ss/enabled
--------T-------¬
¦Address¦Enabled¦
+-------+-------+
¦103    ¦clir   ¦
¦104    ¦clir   ¦
¦105    ¦clir   ¦
L-------+--------

info

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

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

/cluster/storage/<CLUSTER>/ss/info

Синтаксис:

info <DOMAIN> [-extended] [<ADDRESS>]

Параметры:

<DOMAIN> - имя виртуальной АТС;

Для команд, которые располагаются "domain/<DOMAIN>/ss/", параметр <DOMAIN> не указывается.

<ADDRESS> - номер или диапазон номеров абонента(ов), опциональный параметр. Диапазон номеров задается в виде ab {c-d}, что соответствует номерам abc, abd;
-extended - флаг, при указании которого будет показана подробная информация.

Пример:

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

admin@[core1@ecss1]:/$ cluster/storage/ds1/ss/info test.domain -extended                       
-----------------------------------------------------------------------------------------------------------------------------------------------------
|G|  Domain   |Address|     Name     |  Family  |V|E|L|                  MSD                   |     SSD      |                 CSD                 |
|-+-----------+-------+--------------+----------+-+-+-+----------------------------------------+--------------+-------------------------------------|
| |test.domain|*      |chold         |CHOLD     |3|T|T|                                        |sip_moh = true|                                     |
| |test.domain|*      |ctr           |CTR       |2|T|T|dependency_list = ['CHOLD']             |              |                                     |
| |test.domain|*      |mgm           |MGM       |1|T|F|                                        |              |                                     |
| |test.domain|210    |chold         |CHOLD     |3|T|F|                                        |sip_moh = true|                                     |
| |test.domain|210    |ctr           |CTR       |2|T|F|dependency_list = ['CHOLD']             |              |                                     |
| |test.domain|211    |chold         |CHOLD     |3|T|F|                                        |sip_moh = true|                                     |
| |test.domain|211    |ctr           |CTR       |2|T|F|dependency_list = ['CHOLD']             |              |                                     |
| |test.domain|212    |chold         |CHOLD     |3|T|F|                                        |sip_moh = true|                                     |
| |test.domain|212    |ctr           |CTR       |2|T|F|dependency_list = ['CHOLD']             |              |                                     |
| |test.domain|700    |call_recording|CallRecord|3|T|F|enumMode = "incoming|outgoing|both|none"|locked = true |mode = both                          |
| |test.domain|700    |pickup        |PICKUP    |1|T|F|                                        |              |pickup_groups = [{"room1",undefined}]|
|*|test.domain|700    |chold         |CHOLD     |3|T|F|                                        |sip_moh = true|                                     |
| |test.domain|701    |call_recording|CallRecord|3|T|F|enumMode = "incoming|outgoing|both|none"|locked = true |mode = both                          |
| |test.domain|701    |pickup        |PICKUP    |1|T|F|                                        |              |pickup_groups = [{"room1",undefined}]|
|*|test.domain|701    |chold         |CHOLD     |3|T|F|                                        |sip_moh = true|                                     |
| |test.domain|702    |pickup        |PICKUP    |1|T|F|                                        |              |pickup_groups = [{"room1",undefined}]|
|*|test.domain|702    |chold         |CHOLD     |3|T|F|                                        |sip_moh = true|                                     |
|*|test.domain|702    |ctr           |CTR       |2|T|F|dependency_list = ['CHOLD']             |              |                                     |
| |test.domain|703    |chold         |CHOLD     |3|T|F|                                        |sip_moh = true|                                     |
| |test.domain|703    |ctr           |CTR       |2|T|F|dependency_list = ['CHOLD']             |              |                                     |
| |test.domain|790    |cfu           |CFU       |4|T|F|conflict_list = ["CTU","CGG","FollowMe"]|              |number = "500"                       |
| |test.domain|791    |cfu           |CFU       |4|T|F|conflict_list = ["CTU","CGG","FollowMe"]|              |number = "501"                       |
| |test.domain|792    |cfu           |CFU       |4|T|F|conflict_list = ["CTU","CGG","FollowMe"]|              |number = "502"                       |
| |test.domain|799    |cgg           |CGG       |2|T|F|                                        |              |numbers = ["790","791","792"]        |
-----------------------------------------------------------------------------------------------------------------------------------------------------
Legend:
  G - supplementary service activated on domain;
  V - version of the supplementary service;
  E - enable state of selected supplementary service to current domain, address
  L - lock state of selected supplementary service to current domain, address

[exec at: 02.07.2015 10:34:08, exec time: 34ms, nodes: ds1@ecss2]

Просмотреть информацию о всех услугах, активированных для абонента "705" на виртуальной АТС "test.domain".

admin@[core1@ecss1]:/$ cluster/storage/ds1/ss/info test.domain 705
----------------------------------------------
|G|  Domain   |Address|Name |Family|V|E|L|CSD|
|-+-----------+-------+-----+------+-+-+-+---|
| |test.domain|*      |chold|CHOLD |3|T|T|   |
| |test.domain|*      |ctr  |CTR   |2|T|T|   |
| |test.domain|*      |mgm  |MGM   |1|T|F|   |
----------------------------------------------
Legend:
  G - supplementary service activated on domain;
  V - version of the supplementary service;
  E - enable state of selected supplementary service to current domain, address
  L - lock state of selected supplementary service to current domain, address

[exec at: 02.07.2015 10:34:35, exec time: 27ms, nodes: ds1@ecss1]

install

Команда установки описания новой услуги с определенным именем и видом в систему. Команда берет описание услуги из XML-файла, имя которого передается команде в качестве параметра, и сохраняет его в системе. После того, как данная команда выполнена, администратор ECSS-10/виртуальной АТС может активировать данную услугу.

Все файлы-описания услуг должны располагаться в папке /var/lib/ecss/ss/ на вычислительном ресурсе, где запущена система DS.

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

/cluster/storage/<CLUSTER>/ss/install

Синтаксис:

install <NODE> <SSTemplate>

Параметры:

<NODE> - имя подсистемы DS;<SSTemplate> - имя XML файла-описания услуги. В качестве файла-описания услуги может использоваться маска поиска. В этом случае все файлы, имена которых удовлетворяют этой маске, будут установлены в систему. В маске поиска используются символы:

  • * - любое количество символов,
  • ? - ровно один символ.

Пример:

Установить новую услугу.

admin@[mycelium1@ecss1]:/$ /cluster/storage/ds1/ss/install ds1@ecss1 ss_clir.xml
Successfully installed: /var/lib/ecss/ss/ss_clir.xml

Установить все услуги, название файла-описания которых начинается на "ss_".

admin@[mycelium1@ecss1]:/$ /cluster/storage/ds1/ss/install ss_*.xml

show

Команда просмотра настроек услуги, установленных в систему. 
Команда позволяет выбрать интересующие поля (все поля) и вывести значение этих полей в табличном представлении.

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

/cluster/storage/<CLUSTER>/ss/show

Синтаксис:

show [<SSNames> | *]

Параметры:

<SSName> - поле для просмотра:

  • csd - настройки услуги, которые может менять абонент при активации;
  • description - описание услуги;
  • family - вид услуги;
  • name - имя услуги;
  • ssd - настройки услуги, которые нельзя менять при активации. Они нужны для работы сервиса, но не требуют изменения со стороны пользователя;
  • msd - метаинформация об услуге, которая необходима только для работы команд управления услугой;
  • version - версия реализации услуги.

Для перечисления нескольких параметров используется ",". Для указания всех параметров используется "*".

Пример:

Посмотреть настройки услуг, установленные в системе.

admin@[ds1@ecss1]:/$ cluster/storage/ds1/ss/show name, family, description
┌─────────────────────────┬────────────────┬──────────────────────────────────────────────────┐
│          name           │     family     │                   description                    │
├─────────────────────────┼────────────────┼──────────────────────────────────────────────────┤
│3way                     │3WAY            │3-Way Conference                                  │
│acb                      │ACB             │SS Anonymouse Call Block                          │
│alarm                    │Alarm           │Alarm Call Service                                │
│auto_redial              │AutoRedial      │Auto redial                                       │
│auto_redial_with_callback│AutoRedialWithCB│Auto redial with callback                         │
│call_recording           │CallRecord      │Call recording                                    │
│callback                 │CallBack        │CallBack                                          │
│cfb                      │CFB             │Call Forwarding Busy                              │
│cfnr                     │CFNR            │Call Forwarding No Reply                          │
│cfnr_type2               │CFNR_Type2      │Call Forwarding No Reply without notification     │
│cfos                     │CFOS            │Call Forwarding Out of Service                    │
│cft                      │CFT             │Call Forwarding Unconditional Time Dependent      │
│cfu                      │CFU             │Call Forwarding Unconditional                     │
│cfu_type2                │CFU_Type2       │Call Forwarding Unconditional without notification│
│cgg                      │CGG             │Calling Group                                     │
│chold                    │CHOLD           │Call hold                                         │
│chunt                    │CHUNT           │Call hunt groups                                  │
│clip                     │CLIP            │Calling Line Identification Presentation          │
│clir                     │CLIR            │Calling Line Identification Restriction           │
│conference               │Conference      │Multiparty conference service                     │
│ctr                      │CTR             │Call Transfer                                     │
│cw                       │CW              │Call Waiting                                      │
│direct_call              │DirectCall      │Fixed Destination Call                            │
│dnd                      │DND             │Denied                                            │
│follow_me                │FollowMe        │Follow me                                         │
│follow_me_no_response    │FollowMeNR      │Follow me no response                             │
│mcid                     │MCID            │Malicious Call Identification                     │
│my_number                │MyNumber        │Get number of my phone.                           │
│park                     │Park            │Call park/unpark service                          │
│pickup                   │PICKUP          │SS Call pick-up                                   │
│rbp                      │RBP             │SS for restricting call-processes by NI and PIN   │
│redial                   │Redial          │Last number redial                                │
│rfc                      │RFC             │Rejection of Forwarded Calls                      │
│sca                      │SCA             │Selective Call Acceptance by incomming call       │
│sco_black                │SCO_black       │Selective Call Rejection by outcomming call       │
│sco_white                │SCO_white       │Selective Call Acceptance by outcomming call      │
│scr                      │SCR             │Selective Call Rejection by incomming call        │
│speed_dial               │SpeedDial       │Speed dial (Abbreviated dialing)                  │
│teleconference_manager   │Teleconference  │Teleconference manager                            │
└─────────────────────────┴────────────────┴──────────────────────────────────────────────────┘
Installed supplementary services: 39

uninstall

Команда для удаления из системы установленных услуг. Если услуга была активирована, перед удалением она будет деактивирована.

После удаления услуги все настройки этой услуги на всех виртуальных АТС будут удалены.

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

/cluster/storage/<CLUSTER>/ss/uninstall

Синтаксис:

uninstall <SSNames>

Параметры:

<SSNames> - имя услуги, которую необходимо удалить из системы. Для указания всех установленных в системе услугах используется "*". Для перечисления услуг используется ",".

Пример:

Удалить виды услуг "конференц-связь", "удержание вызова" из системы.

admin@[mycelium1@ecss1]:/$ /cluster/storage/ds3/ss/uninstall 3way,chold
Supplementary service 3way successfully uninstalled.
Supplementary service chold successfully uninstalled.

Удалить все виды услуг, установленные в системе.

admin@[mycelium1@ecss1]:/$ /cluster/storage/ds3/ss/uninstall *
Supplementary service white_list_in successfully uninstalled.
Supplementary service black_list_in successfully uninstalled.
Supplementary service mgm successfully uninstalled.
Supplementary service alarm successfully uninstalled.
Supplementary service chunt_manual successfully uninstalled.
Supplementary service chunt_serial successfully uninstalled.
Supplementary service speed_dial successfully uninstalled.
Supplementary service direct_call successfully uninstalled.
Supplementary service redial successfully uninstalled.
Supplementary service auto_redial successfully uninstalled.
Supplementary service auto_redial_with_callback successfully uninstalled.
Supplementary service callback successfully uninstalled.
Supplementary service 3way successfully uninstalled.
Supplementary service cgg successfully uninstalled.
Supplementary service cw successfully uninstalled.
Supplementary service cfu successfully uninstalled.
Supplementary service chunt_cycle successfully uninstalled.
Supplementary service follow_me successfully uninstalled.
Supplementary service mcid successfully uninstalled.
Supplementary service cft successfully uninstalled.
Supplementary service white_list_out successfully uninstalled.
Supplementary service dnd successfully uninstalled.
Supplementary service chold successfully uninstalled.
Supplementary service black_list_out successfully uninstalled.
Supplementary service rfc successfully uninstalled.
Supplementary service cfos successfully uninstalled.
Supplementary service cfb successfully uninstalled.
Supplementary service ctr successfully uninstalled.
Supplementary service acb successfully uninstalled.
Supplementary service cfnr successfully uninstalled.
Supplementary service cfu_type2 successfully uninstalled.
Supplementary service my_number successfully uninstalled.
Supplementary service clir successfully uninstalled.
Supplementary service pickup successfully uninstalled.
Supplementary service chunt_group successfully uninstalled.
Supplementary service rbp successfully uninstalled.
Supplementary service clip successfully uninstalled.

update

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

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

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

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

/cluster/storage/<CLUSTER>/ss/update

Синтаксис:

update <NODE> -<Flag> <SSTemplate>

Параметры:

<NODE> - имя подсистемы DS;<Flag> - флаг, принимает значения:

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

Пример:

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

admin@[mycelium1@ecss1]:/$ /cluster/storage/ds/ss/update ds3@ecss3 --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
  • Нет меток