2. Настройка и использование МУК


 
ВАЖНО!
Статья описывает конфигурацию и возможные проблемы МУК версии SetReatil 10.0.1.52


Менеджер Управления Конфигурации (МУК) – сервис ОС, предназначенный для обновления конфигурации
SetRetail 10 (сервер и касса). Входит в состав инсталлятора серверной части.
Основное предназначение:
  • Использование собственного приложения для обновления компонентов продукта – Менеджера Управления Конфигурацией, запускаемого в виде отдельного сервиса ОС (.air-приложение)
  • Автоматическое скачивание новых версий продукта из репозиториев компании Кристалл Сервис
  • Обеспечение пользователя информацией о текущей версии серверов и POS-терминалов
  • Централизованное обновление версии серверов и POS-терминалов до любой из уже доступных версий продукта
  • Возможность проведения удаленного обновления
  • Возможность проведения отложенного по времени обновления. Например, планирование автоматического обновления на часы наименьшей загрузки кассового узла.
  • Полностью контролируемый процесс обновления. Автоматизированная проверка первого запуска компонентов системы. Полноценный откат к предыдущей версии с уведомлением пользователя в случае проблем при обновлении.

Установка службы МУК

Служба SET:Retail10:Server Configuration Manager устанавливается автоматически при запуске инсталлятора SetRetail 10 и работает независимо от службы сервера Setv10ApplicationServer.
Файлы необходимые для установки службы находятся по адресу : \SetRetail10\acm\service wrapper\bin
Для того, чтобы проинсталлировать службу вручную необходимо просто запустить InstallSCM-NT.bat
Проверить корректность установки - появилась ли служба SET:Retail10:Server Configuration Manager

МУК: файловая структура сервера

\Set10\acm\
    backups – папка для резервных копий файлов сервера (которые будут заменяться, а также всех баз данных)
    bin – системные файлы с расширением jar
    conf – конфигурационные файлы
    logs – файлы событий
    service wrapper – инсталлятор службы МУК
    updates – папка для пакетов обновлений

МУК: файловая структура кассы

<ip кассы>\storage\crystal-cash\
    Backup – папка для zip-архивов резервных копий файлов (которые будут заменены)
    BackupDB - папка для резервных копий баз данных (которые будут заменены)
    Updates – папка для пакетов обновлений
<ip кассы>\storage\crystal-conf\
    logs – файлы событий
    ConfiguratorCash.jar – приложение
    crystal-conf.sh – скрипт службы МУК
    daemon_config.properties – конфигурационный файл (номер магазина,уровень логирования, IP и тд.)
    daemon_state.xml – текущее состояние МУК (статус обновления)



МУК: Подготовка к обновлению

Все  обновления для сервера и кассы хранятся на оф.сайте Кристалл Сервис
1. Скопировать обновления для сервера и касс в папку \SetRetail10\acm\updates\
Пакеты обновлений обязаны быть единым zip-архивом, где будет указано:

 ВАЖНО! В случае, если Вам необходимо обновить версию SetCentrum, то zip-архив необходимо  переименовать с SetRetail10_server_shop_10.0.1.52-10.0.1.52_1.zip на SetRetail10_server_centrum_10.0.1.52-10.0.1.52_1.zip

В приложении будет отображена версия для обновления

МУК: Навигация по приложению

Вкладка "Управление версиями"

Вкладка "Информация о версиях" информирует о изменениях в пакетах обновлений
Вкладка "Адрес сервера" позволяет настроить вручную подключение до сервера,на котором установлен SetRetail. 





МУК: Процесс обновления

 
ВАЖНО! Обновление конфигурации сервера необходимо выполнять последовательно (от патча  к патчу)
Кассу можно обновлять кумулятивно (до последнего патча) начиная с версии 10.0.1.50




МУК: обновление сервера

 

ВАЖНО! Если сервер подключен к системе мониторинга, необходимо на время обновления отключить службу мониторинга.

1.   Запускаем air-приложение МУК

2. Запускаем обновление

Указываем, что хотим установить обновление сейчас

Нажимаем загрузить  

В главном окне будет указано, что производится обновление сервера до определенной версии

3.       Для просмотра текущего состояния обновления необходимо открыть файл \SetRetail10\acm\conf\topology-environment.xml (рекомендуем открыть документ FAR-менеджером для просмотра текущего статуса в реальном времени)

Данный файл является описанием текущего состояния конфигураций сервера и кассы

<myself topology-address="1.0.17.0" <номер магазина>   ip="172.16.10.15" <ip-адрес сервера>   service-port="2005">

        <current-version>10.0.1.20_4</current-version> <текущая версия>  

        <previous-version>10.0.1.20_3</previous-version> < предыдущая версия >  

        <state>IN_WORK</state> < состояние конфигурации сервера

IN_WORKработает

UPDATE RUNNINGобновляется

DOWNGRADE RUNNINGидет процесс отката версии

UPGRADEERROR – ошибка обновления, откат произвести не удалось

 DOWNGRADEERROR – ошибка отката версии, откат к текущей версии произвести не удалось

UPGRADEERRORWITHDOWNGRADE – ошибка обновления или отката версии, удалось произвести откат к текущей версии >  

        <update-state>WAIT</update-state> < состояние обновлений

UNZIPраспаковка файлов

BACKUP DBбэкапирование баз данных

BACKUP FILES бэкапирование файлов

UPDATE FILESобновление файлов

TEST UPDATE проверка работоспособности сервера после обновления

WAIT ожидание (сервер не запущено обновление) >

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


МУК: обновление кассы

1.       Запускаем air-приложение МУК

2.       Запускаем обновление

3.       Для просмотра текущего состояния обновления необходимо открыть файл \\<ip кассы>\storage\ \crystal-conf\ daemon_state.xml (рекомендуем открыть документ FAR-менеджером для просмотра текущего статуса в реальном времени)

Данный файл является описанием текущего состояния конфигурации кассы

<properties>

  <Status value="UPGRADE_RUNNING"/> <текущее состояние конфигурации

In_Workкасса не находится в режиме обновления, предыдущие обновления завершились удачно

UPDATE RUNNINGидет процесс обновления версии

DOWNGRADE RUNNINGидет процесс отката версии

UPGRADEERROR ошибка обновления, откат произвести не удалось

DOWNGRADEERROR ошибка отката версии, откат к текущей версии произвести не удалось

UPGRADEERRORWITHDOWNGRADE ошибка обновления или отката версии, удалось произвести откат к текущей версии

  <UpgradesList type="list"> <файл обновления>

    <item value="SetRetail10_cash_10.0.1.20_4-10.0.1.20_5.zip"/>

  </UpgradesList>

  <ChangeToVersion value="10.0.1.20_5"/> <планируемая версия обновления>

  <State value="WAIT_CASH_FOR_REBOOT"/> <текущее состояние обновления

DOWNLOAD_FILES скачивание пакета обновления

ARCHIVEрезервное копирование обновляемых файлов и архивирование в zip-архив

BACKUP_DBрезервное копирование обновляемой БД

WAIT_CASH_FOR_REBOOTожидание перезагрузки кассы

</properties>

 4.       Когда статус обновления перейдет в статус WAIT_CASH_FOR_REBOOT , а так же в  приложении МУК будет отображено сообщение:


кассу следует перезагрузить через «МЕНЮ» - «ПЕРЕЗАГРУЗКА»

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

 

МУК: откат версии

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

Статусы отката на предыдущую версию будут изменяться последовательно

Для сервера: от DOWNGRADE_RUNNING=> BACKUP_FILES=>BACKUP_DB=>UPDATE_FILES=>TEST_UPDATE=>IN_WORK

Для кассы: от FD_UNZIP_BACKUP=>IN_WORK ,после чего касса автоматически перезагрузится.

После установления статуса IN_WORK, в air-приложение МУК будет указано, что была применена предыдущая версия конфигурации


ВАЖНО! Откат возможен только к предыдущей версии конфигурации! Откатиться на 2 или более версий назад НЕВОЗМОЖЕН.