https://crystals.atlassian.net/browse/SRTB-5679

https://crystals.atlassian.net/browse/CR-6318

Внимание!

Обязательно производите обновление в следующей последовательности: Set Centrum → Set Retail → POS.

Начиная с версии 10.3.10.0, программно заблокирована возможность обновления кассы на версию выше, чем версия сервера (SetRetail или SetCentrum).

Например, если версия сервера 10.3.10.0, то кассу нельзя обновить на версию выше 10.3.10.X.

Новый интерфейс МУК доступен только, начиная с версии 10.2.98.0.

https://crystals.atlassian.net/browse/CR-2058

https://crystals.atlassian.net/browse/SRTS-71

1 Описание
- 1.1 Функциональность и возможности
2 Вход на страницу МУК
3 Интерфейс
4 Служба МУК
- 4.1 Управление службой МУК
  - 4.1.1 Windows
  - 4.1.2 Linux
- 4.2 Файловая структура
  - 4.2.1 Папка МУК
  - 4.2.2 Назначение папок и файлов
5 Обновление
6 Дополнительная функциональность

Описание

Менеджер Управления Конфигурацией (МУК) – сервис, предназначенный для обновления серверов SetCentrum, SetRetail и касс (клавиатурные, SetTouch, SCO, CSI K).

МУК входит в состав серверной части SetCentrum/SetRetail.

Функциональность и возможности

Использование собственного веб-приложения для обновления компонентов продукта.
Управление обновление через любой веб-браузер: Google Chrome, Microsoft Edge, Mozilla Firefox, Opera, Safari.
Обеспечение пользователя информацией о текущей версии серверов и касс.
Централизованное обновление версии серверов и касс.
Возможность проведения удаленного обновления.
Возможность проведения отложенного по времени обновления. Например: планирование автоматического обновления на часы, в зависимости от наименьшей загрузки кассового узла.
Полностью контролируемый процесс обновления.
Автоматизированная проверка первого запуска компонентов системы.
Полноценный откат к предыдущей версии с уведомлением пользователя в случае проблем при обновлении (например: обрыв связи).
Удаленная перезагрузка кассового узла (начиная с версии 10.3.27.0).

Вход на страницу МУК

1. Наберите в браузере адрес в формате http://IP-адрес сервера SetRetail10:8092 → нажмите Enter.

2. Введите данные для входа → нажмите клавишу Enter.

Учетная запись по умолчанию:
- Имя пользователя: manager
- Пароль: password

3. Откроется страница МУК с сервером и кассами.

Интерфейс

Основные элементы управления на странице

Статусы касс и сервера

Иконка статуса	Описание

Иконка статуса	Описание
	Служба МУК кассы на связи. Касса готова к обновлению
	Связь со службой МУК отсутствует. Загрузка патчей невозможна.

Столбцы списка

Столбец	Описания

Столбец	Описания
Магазин	Отображается привязка объекта к магазину топологии: SetCentrum - отображается прочерк. SetRetail - отображается текущий номер сервера магазина, на котором установлена служба МУК. Касса: SetCentrum: в случае топологии SetCentrum ↔ Кассы отображаются номера магазинов, к которым они привязаны. SetRetail ↔ Кассы отображается номер магазина SetRetail к которому привязаны кассы.
Сервер	Отображается тип сервера: SetCentrum SetRetail
Касса	Отображается номер кассы и её тип: POS - клавиатурная касса; Touch - касса SetTouch; SCO - касса самообслуживания (ITAB, NCR, CSI K и т.п.).
IP	Отображается IP-адрес сервера и касс.
Текущая версия	Текущая установленная версия для сервера или кассы
Статус	Статус обновления Когда не происходит никаких обновлений, столбец пустой. Статусы: Сервер SetCentrum/SetRetail: Загрузка версии ХХ.ХХ.ХХ.ХХ запланирована на [ДАТА ВРЕМЯ] Перезапуск системы обновления Разархивирование Сохранение текущего состояния Проверка прав доступа Применение обновления Тестовый запуск после обновления Ошибка обновления, восстановления сохраненной копии Ошибка при откате обновления Ошибка обновления или отката на версию ХХ.ХХ.ХХ.ХХ, произведен откат к текущей версии Обновление было отменено Кассы: Загрузка версии ХХ.ХХ.ХХ.ХХ запланирована на [ДАТА ВРЕМЯ] Загрузка файлов Разархивирование Ожидание перезагрузки Тестовый запуск после обновления Ошибка обновления, восстановления сохраненной копии Ошибка при откате обновления Обновление было отменено Ошибка обновления или отката на версию ХХ.ХХ.ХХ.ХХ, произведен откат к текущей версии

Фильтры поиска касс

Фильтр	Описание

Фильтр	Описание
Магазин	Поиск по номеру магазина
Номер кассы	Поиск по номеру кассы из списка
Тип кассы	Поиск по типам касс доступным из списка
IP кассы	Поиск по IP-адресу касс
Версия	Поиск по номеру текущей версии
Статус	Поиск кассы по статусам: Ошибка обновления или отката В работе Разархивирование 10.3.27.0 https://crystals.atlassian.net/browse/SRTS-1679 https://crystals.atlassian.net/browse/CR-9262
Дата перезагрузки	Фильтр по дате перезагрузки касс 10.3.27.0 https://crystals.atlassian.net/browse/SRTS-1679 https://crystals.atlassian.net/browse/CR-9262

Форма управления обновлением

Функциональность	Описание

Функциональность	Описание
Версия	Выбирается версия, на которую будет обновлен сервер или касса. После подкладывания патчей в папку обновления ../acm/updates МУК производит валидацию целостности патча. Если CRC, архив "битый" или файл патча пустой, то он не появится в списке обновлений
Загрузить изменения прямо сейчас	Загрузить и обновить кассу/сервер сразу после нажатия на кнопку
Загрузить изменение по расписанию	Запланировать обновление по расписанию.
Создать резервную копию баз данных при обновлении	Если база данных сервера достаточно объемна, то данная функциональность позволит сэкономить время при его обновлении, так как в этом случае будут выполнены только обновления основных компонентов SetRetail10: базы данных и программные файлы. При этом в случае неудачи, произойдет откат базы данных и программных файлов на предыдущую версию.
Автоматически обновить кассы, если она простаивает	Сократить время на обновление касс, за которыми не работают кассиры, можно с помощью данной опции. Обновление неактивной кассы произойдет автоматически.

Окно состояния кассы

Кнопка	Описание

Кнопка	Описание
	Сохранить текст состояния кассы, а также возможной ошибки текста лог-файла.
	Скопировать текст состояния кассы, а также возможной ошибки текста лог-файла.
	Закрыть форму с информацией по кассе.

Также можно скопировать или сохранить текст ошибки для отправки в службу поддержки.

Служба МУК

Служба МУК устанавливается вместе с сервером SetRetail/SetCentrum.

Управление службой МУК

Windows

В оснастке служб Windows за МУК отвечает сервис SETv10 Configuration Manager.

Linux

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

service SCM_SVC start - запустить службу МУК.
service SCM_SVC stop - остановить службу МУК.
service SCM_SVC restart - перезапустить службу МУК.

Файловая структура

Папка МУК

Windows: {Disk}\{SetRetail10}\acm

Linux: /var/lib/jboss/acm

Назначение папок и файлов

Папка/файл	Описание

Папка/файл

Описание

backups

Папка для резервных копий файлов и папок сервера

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

Создать резервную копию баз данных при обновлении.

bin

Системные файлы службы МУК.

conf

Конфигурационные файлы.

history

Файлы статусов обновлений.

logs

Логирование событий работы службы и обновлений.

script_after_update

Папка для обработки SQL-скриптов обновления баз данных PostgreSQL.

script_for_revert

Папка для обработки SQL-скриптов отката баз данных PostgreSQL.

updates

Папка для обновлений (файлов патчей).

web

Папка страниц веб-версии МУК.

mook.jar

Приложение службы МУК.

updater.jar

Приложение службы МУК для процесса обновления.

update.status

Статус работы службы МУК.

Файл может быть пересоздан после перезапуска службы.

Список статусов:

BACKUP_DB – выполнение процесса резервного копирования баз данных;
BACKUP_FILES – выполнение процесса резервного копирования файлов;
DOWNGRADE_ERROR – ошибка отката версии, откат к текущей версии произвести не удалось;
DOWNGRADE_RUNNING – идет процесс отката версии;
IN_WORK – сервер/касса работает;
TEST_UPDATE – проверка работоспособности сервера/кассы после обновления;
UNZIP – распаковка файлов;
UPDATE_FILES – обновление файлов;
UPDATE_RUNNING – производится обновление;
UPGRADE_ERROR – ошибка обновления, откат произвести не удалось;
UPGRADE_ERROR_WITH_DOWNGRADE – ошибка обновления или отката версии, удалось произвести откат к текущей версии;
WAIT – ожидание (не запущено обновление на сервере);
WAIT_CASH_FOR_REBOOT – ожидание перезагрузки кассы.

Пример файла:

#Thu May 20 22:32:25 MSK 2021
status=UPDATE_RUNNING
patches=retail_10.2.98.0_10.2.98.1
shiftMustBeClosed=false
makeDBBackup=false

topology.structure

Данные по топологии.

Файл может быть пересоздан после перезапуска службы.

{
    "topologyAddress": "1.0.35.83",
    "currentVersion": "10.3.26.19",
    "previousVersion": "",
    "topologyPointIP": "10.81.5.83",
    "type": "Touch",
    "status": "IN_WORK",
    "online": true,
    "lastActivity": 1705574440741,
    "activeRestartCommandTime": {
      "seconds": 0,
      "nanos": 0
    },
    "lastStartup": {
      "seconds": 1705491888,
      "nanos": 361000000
    },
    "isMakeDbBackup": true,
    "shiftMustBeClosed": false,
    "waitUpdateCommand": false,
    "localPatches": []
  },

Обновление

Загрузка патчей

Для загрузки патчей перейдите в раздел портала поддержки.

Копирование патчей в папку МУК

Скопируйте патчи сервера и касс в папку для обновления на сервер SetCentrum/SetRetail.

Windows: {Disk}\{SetRetail10}\acm\updates

Linux: /var/lib/jboss/acm/updates

Назначение прав владельца файлов патчей ОС Linux

После добавления патчей измените владельца файлов на пользователя jboss:jboss

1. Перейдите в папку с патчами.

2. Проверьте владельцев новых файлов.

Если владелец отображается root:root, тогда выполните команду:

sudo chown -R jboss:users /var/lib/jboss/acm/updates/

Патчи для SetCentrum

Структура файлов патчей

Тип патча	Тип файла

Тип патча	Тип файла
retail	Патч для обновления сервера SetRetail (сервер магазина)
centrum	Патч для обновления центрального сервера SetCentrum (не выпускается отдельно, переименовывается префикс патча сервера SetRetail).
pos	Патч для обновления клавиатурных касс POS.
touch	Патч для обновления касс SetTouch
sco	Патч для обновления касс самообслуживания и CSI K.

Подготовка к обновлению и рекомендации

Перед обновлением

Перед запуском обновления на серверах с ОС Windows закройте ВСЕ окна проводника и оснастки MMC (Службы, Управление Компьютером и прочие).
Отключите антивирус на время обновления, так как он может при сканировании заблокировать исполняемые файлы SetRetail10, которые заменяются при обновлении.

Обновление сервера и касс можно выполнять кумулятивно. Например: можно обновить кассу с версии 10.2.95.0 до 10.2.99.0.
Для обновления от версии к версии должна соблюдаться полная последовательность:
- Пример: обновиться с версии 10.2.95.0 до 10.2.97.0, при этом есть версия 10.2.96.0, для которой есть патч 10.2.95.1_10.2.96.0, и патч 10.2.96.3_10.2.97.0
  - В этом случае обязательно нужно сделать цепочку из всех патчей, таким образом она будет выглядеть так:
    - 10.2.95.0_10.2.95.1
    - 10.2.95.1_10.2.96.0
    - 10.2.96.0_10.2.96.1
    - 10.2.96.1_10.2.96.2
    - 10.2.96.2_10.2.96.3
    - 10.2.96.3_10.2.97.0
Если сервер подключен к системе мониторинга, необходимо на время обновления отключить эту службу.

Обновление сервера

1. Установите флажок

→ кликните

.

2. Выберите версию, на которую требуется обновить сервер → установите переключатель

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

, если требуется создать резервную копию баз данных (

Внимание! Резервное копирование баз данных сервера может занять продолжительное время) → кликните

.

3. Появится надпись о планировании обновления. Если по каким-либо причинам, обновление не должно проводится, тогда кликните по ссылке Отменить.

4. Служба МУК сервера, как правило перезапускается, и появляется соответствующее сообщение. Не закрывайте окно браузера и дождитесь её перезапуска.

5. После того, как служба МУК перезапущена, появится соответствующий статус.

6. Начнутся процессы разархивирования и сохранения текущих настроек сервера.

7. Во время применения обновления, если патчей несколько, в столбце Текущая версия будет происходить смена номеров версий сервера.

8. После того как сервер обновлен, будет произведен тестовый запуск.

9. Если тестовый запуск прошел успешно, номер версии сервера изменится на новую.

10. Также для просмотра состояния сервера можно кликнуть по его названию.

Обновление касс

1. Установите флажок

напротив требуемых касс → кликните

.

2. Выберите версию, на которую требуется обновить кассы → установите переключатель

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

, если требуется создать резервную копию баз данных (

Внимание! Резервное копирование баз данных сервера может занять продолжительное время), или обновить кассы, если на них никто не работает → кликните

.

3. Появится надпись о планировании обновления. Если по каким-либо причинам, обновление не должно проводится, тогда кликните по ссылке Отменить.

4. Начнется загрузка файлов на кассы.

5. Обратите внимание, что после загрузки файлов, будет перезапущена служба МУК на кассе, или она сама. В это время значки будут отображать недоступность кассы и кассовой службы МУК.

6. Начнутся процессы разархивирования и сохранения текущих настроек касс.

7. После того, как произойдет разархивирование патча, нужно перезагрузить кассы для применения обновления, если не был установлен флажок

Автоматически обновить кассы, если они простаивают.

Во время применения обновления, если патчей несколько, в столбце Текущая версия будет происходить смена номеров версий сервера.

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

9. То же самое произойдет и с остальными кассами.

10. Также для просмотра состояния кассы можно кликнуть по её названию.

Откат

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

Примеры

SetRetail10 ▪️ МУК ◾️ Руководство пользователя по обновлению сервера и касс