Оглавление
Внимание!
Наличие в базе данных чеков за большие периоды времени может существенно сказаться на скорости процедуры обновления. Если объем таблиц с чеками превышает размер в 10 ГБ, то перед проведением обновления на "боевом" сервере, следует провести обновление копии базы данных на тестовом сервере. Нужно определить временные рамки обновления, принять меры по оптимизации времени (обрезать чеки, оставив их за меньший период, и нарастить производительность сервера).
Внимание!
Перед началом обновления, просьба ознакомиться с материалами по процедуре обновления: Обновление УКМ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 можно использовать:
- архиватор 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) Восстановление рабочего каталога.
Внимание!
Перед выполнением следующего шага убедитесь в том, что каталог резервной копии перемещён в безопасное место.
...