SRTB-5679 - Получение подробных данных проблемы… СТАТУС

CR-6318 - Получение подробных данных проблемы… СТАТУС

CR-2058 - Получение подробных данных проблемы… СТАТУС

SRTS-71 - Получение подробных данных проблемы… СТАТУС

Описание

Менеджер Управления Конфигурацией (МУК) – сервис, предназначенный для обновления серверов 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. Откроется страница МУК с сервером и кассами.

Интерфейс

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

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

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

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

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

Функциональность	Описание
Версия	Выбирается версия, на которую будет обновлен сервер или касса. После подкладывания патчей в папку обновления ../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. Проверьте владельцев новых файлов.

Патчи для SetCentrum

• Ручное переименование
• Переименование в командной строке
  • Linux
  • Windows

Ручное переименование

Обновление SetCentrum ничем не отличается от стандартного процесса в SetRetail.

Для того, чтобы модуль обновления увидел патчи, переименуйте префикс файла патча для SetRetail из retail_XX.X.XX.X_XX.X.XX.X.zip в centrum_XX.X.XX.X_XX.X.XX.X.zip.

Переименование в командной строке

Linux

Для переименования введите команды:

Ubuntu

cd /var/lib/jboss/acm/updates
rename 's/retail_10\./centrum_10\./' *.zip

CentOS 7

cd /var/lib/jboss/acm/updates
rename "retail_10." "centrum_10." *.zip

Windows

1. Откройте командную строку Windows, выполните команду по переходу на тот, диск где установлен SetСentrum.

Например:

d:

2. Перейдите в папку командой:

cd %SET10_HOME%\acm\updates\

3. Выполните команду по переименованию:

rename retail_10.*.zip centrum_10.*.zip

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

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

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

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

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

2. Выберите версию, на которую требуется обновить сервер → установите переключатель , в зависимости от того когда требуется произвести обновление, а также флажок , если требуется создать резервную копию баз данных (Внимание! Резервное копирование баз данных сервера может занять продолжительное время) → кликните.

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

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

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

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

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

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

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

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

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

1. Установите флажок  напротив требуемых касс → кликните .

2. Выберите версию, на которую требуется обновить кассы → установите переключатель , в зависимости от того когда требуется произвести обновление, а также флажок , если требуется создать резервную копию баз данных (Внимание! Резервное копирование баз данных сервера может занять продолжительное время), или обновить кассы, если на них никто не работает → кликните.

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

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

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

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

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

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

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

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

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

Откат

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

Пример отката кассы:

1. Установите флажок  напротив требуемых касс или сервера → кликните .