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 Интерфейс
5 Служба МУК
- 5.1 Управление службой МУК
  - 5.1.1 Windows
  - 5.1.2 Linux
- 5.2 Файловая структура
  - 5.2.1 Папка МУК
  - 5.2.2 Назначение папок и файлов
6 Обновление
7 Дополнительная функциональность

Описание

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

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

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

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

Ограничение минимальной версии для продолжения обновления

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

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

Начиная с версии 10.5.1.0 в патчах МУК может быть указано ограничение на минимальную текущую версию узла. Это означает, что для некоторых патчей недостаточно просто иметь полный набор промежуточных обновлений: перед применением такого патча сервер или касса должны быть уже обновлены минимум до версии, указанной в самом патче.

Ограничение задается в специальном файле патча параметром current_version. Если параметр указан, МУК проверяет текущую версию обновляемого узла:

если текущая версия узла больше или равна значению current_version, обновление на этот патч разрешается;
если текущая версия узла ниже значения current_version, обновление на этот патч не выполняется. Необходимо сначала обновить узел до требуемой версии, а затем повторно запустить обновление до целевой версии.

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

Пример. Требуется обновиться с версии 10.4.25.0 до 10.5.2.1. При этом патч 10.4.25.0 → 10.5.0.0 является кумулятивным, а в патче для перехода на 10.5.2.0 указано ограничение: начальная версия должна быть не ниже 10.5.1.0.

В такой ситуации нельзя одним запуском перейти с 10.4.25.0 сразу на 10.5.2.1, даже если все патчи лежат в папке обновлений. МУК дойдет до патча, для которого требуется версия не ниже 10.5.1.0, сравнит это требование с текущей версией узла и остановит обновление, если узел еще не достиг нужной версии.

Правильная последовательность действий:

Сначала обновите сервер или кассу до версии, которая удовлетворяет ограничению патча, например до 10.5.1.0.
Убедитесь, что узел успешно обновлен и находится в рабочем состоянии.
После этого запустите обновление до требуемой конечной версии, например до 10.5.2.1.

Такая логика нужна, чтобы исключить небезопасные кумулятивные переходы через версии, в которых меняется механизм обновления или появляются обязательные промежуточные изменения. Если МУК сообщает, что текущая версия ниже допустимой для выбранного патча, это не означает повреждение патча: необходимо выполнить обновление поэтапно и сначала дойти до версии, указанной в ограничении.

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

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. Также для просмотра состояния сервера можно кликнуть по его названию.

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