Оглавление
Внимание!
Наличие в базе данных чеков за большие периоды времени может существенно сказаться на скорости процедуры обновления. Если объем таблиц с чеками превышает размер в 10 ГБ, то перед проведением обновления на "боевом" сервере, следует провести обновление копии базы данных на тестовом сервере. Нужно определить временные рамки обновления, принять меры по оптимизации времени (обрезать чеки, оставив их за меньший период, и нарастить производительность сервера).
Внимание!
Перед началом обновления, просьба ознакомиться с материалами по процедуре обновления: Обновление УКМ4.zip.
Требования для подготовки к обновлению, начало процедуры обновления
1. Получить у курирующего менеджера файлы лицензий для версии, на которую запланировано обновление.
2. Заказывать лицензии на промежуточные версии и сервис-паки не нужно.
3. Запланировать и реализовать обновление следующим образом:
- Минимум за один день до начала процедуры обновления, обновить 1 кассовый терминал. (Обновление сервера при этом выполнять не нужно). Убедиться в корректной работе кассового терминала. Проверить следующие операции: открытие смены, продажа, возврат, работа скидок и систем лояльности, закрытие смены. На этом этапе следует обратить внимание, что функционал, который работает с онлайн-счетами на кассе, будет недоступен; данные о продажах в торговой системе появятся только после обновления серверной части.
- Минимум за несколько часов до начала процедуры обновления обновить сервер одного из магазинов. Убедиться, что ранее обновленная касса успешно подключилась к серверу и сохранила полную работоспособность.
- Приступить к обновлению остальных серверов и касс в магазинах. При этом, если в магазине > 1 кассы, обновление касс проводить по схеме: вначале осуществить проверку работоспособности четных касс, потом нечетных касс.
- Кассы, которые на момент обновления находились в неработоспособном состоянии (выключены/сломаны и т.п.), необходимо зафиксировать и приступить к их обновлению только после того, как основная масса серверов и касс обновлена.
- Обновление на новую версию считается успешным, если все доступные/рабочие сервера и кассы обновлены.
4. Необходимо учитывать следующие ограничения, возникающие при обновлении:
- Полнофункциональная работа ПО УКМ 4 возможна только в случае, если все узлы (сервера, кассы, сервер прайс-чекеров) имеют одну и ту же версию ПО.
- Допускается полнофункциональная работа в рамках единой версии, но разных сервис-паков.
- Работа с онлайн-счетами (бонусы, накопления, сертификаты) на момент обновления будет невозможна или ограничена в работе.
5. Желательно (необязательное требование) на кассовом терминале перед началом обновления выполнить процедуру закрытия смены. Убедиться, что все данные с кассы корректно переданы не сервер, и получены в торговой системе без ошибок.
6. Обязательно, не ранее чем за 1-3 дня до обновления, следует предупредить персонал магазина о планируемых работах.
7. Желательно (после окончания обновления ПО), чтобы персонал магазина приступил к работе на кассах только после дополнительного уведомления от системного администратора.
8. Процедура обновления должна начинаться, если существует полная уверенность в наличии резервной копии базы данных, снимка виртуальной машины и т.п. Расположение места хранения резервных копий должно отличаться о места расположения источника информации (сервера). Например, это может быть другая комната, здание это может быть другой сетевой диск, сервер и т.п.
9. Процедура обновления ПО УКМ 4 должна запускаться только в том случае, когда есть уверенность, в том, что все периферийное оборудование имеет совместимую с данной версией прошивку (прошивка ККТ, прайс-чекера и т.п.), а внешние модули авторизации, системы лояльности и системы видеонаблюдения также обновлены и работоспособны.
Настройка параметров обновления терминалов
В ходе обновления клиентских компонентов УКМ 4 (УКМ-касса, касса Lillo) менеджер обновлений скачивает пакеты обновления с ресурса, указанного в поле URL для скачивания обновлений в параметрах Параметрах магазина (Справочники – Магазины, далее необходимо выбрать параметры конкретного магазина).конкретный магазин и перейти в пункт его параметров):
Во время установки версии данный параметр автоматически заполняется значением: http://ХОСТ_СЕРВЕРА_УКМ_4/ukmupdates.
В случае использования статических IP-адресов и отсутствующего (некорректно настроенного) сервера DNS, кассовый терминал не сможет загрузить пакеты обновления, так как не сможет преобразовать ХОСТ_СЕРВЕРА_УКМ_4 в 4 в IP-адрес. Поэтому сразу после установки ПО кассовых терминалов или перед началом обновления необходимо проверить с терминалов доступность сервера УКМ 4 по имени хоста. Для этого достаточно, подключившись на кассовый терминал по SSHпо SSH, выполнить команду: ping ХОСТ_СЕРВЕРА_УКМ_4.
В случае если сервер УКМ 4 недоступен по имени хоста, необходимо с помощью интерфейса отредактировать параметр магазина URL для скачивания обновлений, заменив его значение с http://ХОСТ_СЕРВЕРА_УКМ_4/ukmupdates на http://IP_АДРЕС_СЕРВЕРА_УКМ_4/ukmupdates, где IP где IP_АДРЕС_СЕРВЕРА_УКМ_4 – – это IP-адрес сервера.
Внимание!
Параметр URL для скачивания обновлений должен быть корректно настроен до начала обновления сервера УКМ 4, так как после запуска обновления сервера кассовые терминалы прерывают связь с сервером и не получают данный параметр.
Перед началом обновления сервера необходимо проверить и при необходимости отключить для каждой кассы параметр АвтообновлениеАвто-обновление в разделе интерфейса Настройка сервера и оборудования /– Монитор оборудования /– Кассы/обновление касскасс (вкладка вверху). Необходимость выполнения данной операции обусловлена тем, что при включенном параметре Автообновление Авто-обновление процесс обновления терминалов запускается в автоматическом режиме. Процесс обновления Обновление терминалов в среднем занимает от 10 до 40 мин., что может привести к временной приостановке работы магазина. Для автоматического отключения автообновления есть возможность установить опцию "Сброс признака "АвтообновлениеАвто-обновление" после успешного обновления кассы" в " в разделе Настройка сервера и оборудования /– Параметры сервера /Параметры"– Параметры (вкладка слева).
Не рекомендуется производить обновление всех кассовых терминалов магазина или торговой сети одновременно. Наиболее безопасным способом является поочередное обновление кассовых терминалов, либо групп кассовых терминалов.
...
2) Проверить наличие свободного места для создания резервной копии на диске указанном в параметре dir_backup конфигурационного файла C:\Program Files\ukmserver\ukmupman\ukmupman.ini.Описание параметра dir_backup см. в разделе "Менеджер обновлений".
Для обновления сервера СуперМаг УКМ 4 необходимо наличие на диске сервера свободного места = размер каталога БД , равного размеру каталога базы данных MYSQL + 1Gb. Проверку свободного места необходимо выполнить до начала обновления. Расположение каталога БД базы данных MySQL задаётся параметром datadir в файле %systemroot%файле %systemroot%\my.ini (см. раздел "разделВосстановление системы").
3) Запустить менеджер обновлений сервера УКМ 4 с помощью Главного меню Windows:
...
В случае сбоя обновления необходимо проанализировать протоколы менеджера обновлений, расположенные в каталоге C:\Program Files\ukmserver\ukmupman.
Описание файлов протоколов см. в разделе "Менеджер обновлений".
Протоколы работы
В ходе работы менеджер обновлений создаёт следующие файлы протоколов, в которых фиксируются все этапы обновления:
- ukmupman.log - – основной протокол;
- ukmup.log – протокол, содержащий вывод дополнительных программ, запускаемых в ходе обновления;
- srvupdate-ops.log – протокол обработки серверных ops-пакетов;
- srvupdate-prg.log – протокол обработки серверных prg-пакетов;
- fbackup.log – протокол создания резервной копии;
- openpack.log – протокол распаковки пакетов обновлений.
В случае сбоя обновления необходимо проанализировать указанные протоколы.
Анализ следует начинать с протокола ukmupman.log.
В случае необходимости, следует проанализировать дополнительные протоколы.
В описанном далее алгоритме работы менеджера обновлений сервера УКМ 4 при упоминании параметров и секций предполагается ссылка на конфигурационный файл C:\Program Files\ukmserver\ukmupman\ukmupman.ini.
...
Процедура обновления кассовых терминалов запускается при активации параметра Автообновление Авто-обновление в разделе интерфейса Настройка сервера и оборудования – Монитор оборудования – Кассы/обновление касс (вкладка вверху).
Во время обновления сервера УКМ 4 кассовые терминалы временно отключаются от сервера УКМ 4. По окончании обновления сервера УКМ 4, кассовые терминалы пытаются восстановить подключение к серверу УКМ 4 и получают сообщение о несоответствии собственной версии и версии сервера.
После этого кассовые терминалы переходят в состояние ожидания активации параметра Автообновление Авто-обновление. До момента активации данного параметра кассовые терминалы работают в автономном режиме. После активации параметра Автообновление Авто-обновление процедура обновления запускается на кассовых терминалах автоматически.
Для включения параметра АвтообновлениеАвто-обновление необходимо с помощью «Web перейти в раздел интерфейса интерфейса сервера Настройка сервера и оборудования /– Монитор оборудования /– Кассы/обновление касс и и включить данный параметр для соответствующей кассы(см. раздел "Кассы").
Во избежание временной приостановки работы магазина, рекомендуется выполнять обновление кассовых терминалов последовательно, а не всех сразу.
...
Обновление терминала осуществляется в автоматическом режиме после активации параметра АвтообновлениеАвто-обновление. Во время обновления работа кассовой программы временно завершается и автоматически запускается менеджер обновлений. По окончании обновления кассовая программа будет запущена автоматически.
Внимание!
Во время процедуры обновления запрещается прерывать работу менеджера обновлений и выключать питание кассового терминала.
...
Перед началом обновления необходимо установить имя ресурса, используемого кассами для загрузки пакетов обновлений. Имя ресурса для загрузки пакетов обновлений задаётся параметром магазина URL для скачивания обновлений в Параметрах магазина (Справочники /Магазины - Параметры у конкретного магазина– Магазины, далее необходимо выбрать конкретный магазин и перейти в пункт его параметров).
Если на DNS-сервере сети магазина зарегистрирован ХОСТ_СЕРВЕРА_УКМ_4, для параметра URL для скачивания обновлений следует установить следующее значение:
...
Если на DNS-сервере сети магазина не зарегистрирован ХОСТ_СЕРВЕРА_УКМ_4, DNS-сервер не работает или некорректно настроен, то для параметра URL для скачивания обновлений следует установить значение: http://IP_АДРЕС_СЕРВЕРА_УКМ_4/ukmupdates.
Загрузка серверных пакетов обновления на Linux-сервер УКМ 4
...
1) подключиться к Linux-серверу УКМ 4 по SSH или войти в систему локально;
...
Если возникла ошибка, то запускать повторно процедуру обновления категорически запрещается.
Активация обновления касс
Для активации процедуры обновления касс, необходимо перейти в раздел интерфейса Настройка сервера и оборудования /– Монитор оборудования /– Кассы/обновление касс. Зайти в конкретную кассу , зайти в настройки конкретной кассы и нажать кнопку "Старт" в в разделе загрузка Загрузка обновлений.
Откат некорректного обновления
Для отката некорректного обновления, требуется выполнить следующие действия:
1) подключиться к Linux-серверу УКМ 4 по SSH или SSH или войти в систему локально от имени пользователя root;
...
Нештатные ситуации при обновлении
Внимание!
Если в ходе обновления возникают ошибки, связанные с форс-мажорными обстоятельствами (отключение электроэнергии и т.п.), можно воспользоваться данной инструкцией по откату. Однако, данная инструкция не является правилом, работающим при любых ситуационных условиях. Для принятия окончательного решения по выходу из нештатной ситуации необходимо обратиться к разработчику!
При запуске обновления на сервере в каталоге c:\Program Files\ukmserver\ukmupman\backup\<номер_текущей_версии> создается резервная копия файлов, с помощью которой сервер можно вернуть к состоянию системы до запуска обновления.
Внимание!
Перед началом отката сохраните содержимое каталогов: c:\Program Files\ukmserver\ukmupman\backup\<номер_текущей_версии> и c:\Program Files\ukmserver\ukmupman\update:
...
2) Распаковка содержимого архива php-dir.7z в каталог C:\PHP.
Примечание:
. Для распаковки файлов резервных копий 7z можно использовать:
- архиватор 7-Zip;
- WinRAR версии 3.42 или более новый;
- plugin для FAR (см. папку 7-zip_plugin_for_FAR);
- plugin для Total Commander (см. папку 7-zip_plugin_for_Total_Commander).
...
5) Распаковка содержимого архива htdocs-ukm.7z в каталог c:\Program Files\Apache Group\Apache2\htdocs\ukm.
Внимание!
Здесь и далее обратите внимание на то, что внутри 7z-архивов с резервными копиями хранится вся структура каталогов от корня диска (например, для htdocs-ukm.7z это: Program Files\Apache Group\Apache2\htdocs\ukm).
...
2) Дать локальному пользователю __ukmuser__ права на чтение данного ресурса.
Инструкция по откату обновления на Linux-кассе при обновлении
Откат после неуспешного обновления для касс старше 70 версии выполняется автоматически.
Инструкция по откату обновления на Windows-кассе при обновлении
В инструкции используется понятие "каталог установки" (будем обозначать его через DIR_INSTALL). По умолчанию, в качестве каталога установки используется:
...
2) Восстановление рабочего каталога.
Внимание!
Перед выполнением следующего шага убедитесь в том, что каталог резервной копии перемещён в безопасное место.
...