...
Внимание!
Перед началом обновления, просьба ознакомиться с материалами по процедуре обновления: Обновление УКМ4.zip.
Требования для подготовки к обновлению, начало процедуры обновления
1. Получить у курирующего менеджера файлы лицензий для версии, на которую запланировано обновление.
2. Заказывать лицензии на промежуточные версии и сервис-паки не нужно.
3. Запланировать и реализовать обновление следующим образом:
- Минимум за один день до начала процедуры обновления, обновить 1 кассовый терминал. (Обновление сервера при этом выполнять не нужно). Убедиться в корректной работе кассового терминала. Проверить следующие операции: открытие смены, продажа, возврат, работа скидок и систем лояльности, закрытие смены. На этом этапе следует обратить внимание, что функционал, который работает с онлайн-счетами на кассе, будет недоступен; данные о продажах в торговой системе появятся только после обновления серверной части.
- Минимум за несколько часов до начала процедуры обновления обновить сервер одного из магазинов. Убедиться, что ранее обновленная касса успешно подключилась к серверу и сохранила полную работоспособность.
- Приступить к обновлению остальных серверов и касс в магазинах. При этом, если в магазине > 1 кассы, обновление касс проводить по схеме: вначале осуществить проверку работоспособности четных касс, потом нечетных касс.
- Кассы, которые на момент обновления находились в неработоспособном состоянии (выключены/сломаны и т.п.), необходимо зафиксировать и приступить к их обновлению только после того, как основная масса серверов и касс обновлена.
- Обновление на новую версию считается успешным, если все доступные/рабочие сервера и кассы обновлены.
4. Необходимо учитывать следующие ограничения, возникающие при обновлении:
- Полнофункциональная работа ПО УКМ 4 возможна только в случае, если все узлы (сервера, кассы, сервер прайс-чекеров) имеют одну и ту же версию ПО.
- Допускается полнофункциональная работа в рамках единой версии, но разных сервис-паков.
- Работа с онлайн-счетами (бонусы, накопления, сертификаты) на момент обновления будет невозможна или ограничена в работе.
5. Желательно (необязательное требование) на кассовом терминале перед началом обновления выполнить процедуру закрытия смены. Убедиться, что все данные с кассы корректно переданы не сервер, и получены в торговой системе без ошибок.
6. Обязательно, не ранее чем за 1-3 дня до обновления, следует предупредить персонал магазина о планируемых работах.
7. Желательно (после окончания обновления ПО), чтобы персонал магазина приступил к работе на кассах только после дополнительного уведомления от системного администратора.
8. Процедура обновления должна начинаться, если существует полная уверенность в наличии резервной копии базы данных, снимка виртуальной машины и т.п. Расположение места хранения резервных копий должно отличаться о места расположения источника информации (сервера). Например, это может быть другая комната, здание это может быть другой сетевой диск, сервер и т.п.
9. Процедура обновления ПО УКМ 4 должна запускаться только в том случае, когда есть уверенность, в том, что все периферийное оборудование имеет совместимую с данной версией прошивку (прошивка ККТ, прайс-чекера и т.п.), а внешние модули авторизации, системы лояльности и системы видеонаблюдения также обновлены и работоспособны.
...
Во время установки версии данный параметр автоматически заполняется значением: 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 мин., что может привести к временной приостановке работы магазина. Для автоматического отключения автообновления есть возможность установить опцию Сброс признака "Авто-обновление" после успешного обновления кассы в разделе Настройка сервера и оборудования – Параметры сервера – Параметры (вкладка слева).
...
Процедура обновления кассовых терминалов запускается при активации параметра Авто-обновление в разделе интерфейса Настройка интерфейса Настройка сервера и оборудования – Монитор оборудования – Кассы/обновление касс (вкладка вверху).
Во время обновления сервера УКМ 4 кассовые терминалы временно отключаются от сервера УКМ 4. По окончании обновления сервера УКМ 4, кассовые терминалы пытаются восстановить подключение к серверу УКМ 4 и получают сообщение о несоответствии собственной версии и версии сервера.
После этого кассовые терминалы переходят в состояние ожидания активации параметра Авто-обновление. До момента активации данного параметра кассовые терминалы работают в автономном режиме. После активации параметра Авто-обновление процедура обновления запускается на кассовых терминалах автоматически.
...
Обновление терминала осуществляется в автоматическом режиме после активации параметра Авто-обновление. Во время обновления работа кассовой программы временно завершается и автоматически запускается менеджер обновлений. По окончании обновления кассовая программа будет запущена автоматически.
Внимание!
Во время процедуры обновления запрещается прерывать работу менеджера обновлений и выключать питание кассового терминала.
...
Если на 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 можно использовать:
...
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) Восстановление рабочего каталога.
Внимание!
Перед выполнением следующего шага убедитесь в том, что каталог резервной копии перемещён в безопасное место.
...