История страницы

Внимание!
Наличие в базе данных чеков за большие периоды времени может существенно сказаться на скорости процедуры обновления. Если объем таблиц с чеками превышает размер в 10 ГБ, то перед проведением обновления на "боевом" сервере, следует провести обновление копии базы данных на тестовом сервере. Нужно определить временные рамки обновления, принять меры по оптимизации времени (обрезать чеки, оставив их за меньший период, и нарастить производительность сервера).

Внимание!
Перед началом обновления, просьба ознакомиться с материалами по процедуре обновления: Обновление УКМ4.zip.

Требования для подготовки к обновлению, начало процедуры обновления

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

Настройка параметров обновления терминалов

В ходе обновления клиентских компонентов «СуперМаг-УКМ» («Супермаг касса», «СуперМаг Lillo фронт»компонентов УКМ 4 (УКМ-касса, касса Lillo) менеджер обновлений скачивает пакеты обновления с ресурса, указанного в поле URL для скачивания обновлений в меню интерфейса Параметры Параметры. - нет у нас уже такой жёпы в интерфейсе в Параметрах магазина (Справочники – Магазины, далее необходимо выбрать конкретный магазин и перейти в пункт его параметров):

Image Added

Во время установки 43 версии (обновления на 43 версию) данный параметр автоматически заполняется значением: http://ХОСТ_СЕРВЕРА_УКМ_4/ukmupdates. - какая нах 43?... может, и 12 еще напишем - вдруг кому актуально будет...В случае использования статических IP-адресов

В случае использования статических 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 см. в разделе "Менеджер обновлений".

Для обновления сервера СуперМаг на 43 версию УКМ 4 необходимо наличие на диске сервера свободного места = размер каталога БД , равного размеру каталога базы данных MYSQL + 1Gb. Проверку свободного места необходимо выполнить до начала обновления. Расположение каталога БД базы данных MySQL задаётся параметром datadir в файле %systemroot%файле %systemroot%\my.ini (см. раздел "разделВосстановление системы").

3) Запустить менеджер обновлений сервера УКМ 4 с помощью Главного меню Windows:

...

В случае сбоя обновления необходимо проанализировать протоколы менеджера обновлений, расположенные в каталоге C:\Program Files\ukmserver\ukmupman.

Описание файлов протоколов см. в разделе "Менеджер обновлений".

В описанном далее алгоритме работы менеджера обновлений сервера УКМ 4 при упоминании параметров и секций предполагается ссылка на конфигурационный файл C:\Program Files\ukmserver\ukmupman\ukmupman.ini.

Менеджер обновлений сервера работает по следующему алгоритму:

1) Определяет номер текущей версии.

2) Обращается к ресурсу, указанному в параметре update_url, и считывает список доступных пакетов обновления, расположенных на данном ресурсе.

3) Анализирует возможность составить последовательность пакетов для обновления с текущей версии.

В случае наличия необходимых пакетов, скачивает их на локальный диск, если параметр update_url указывает на удалённый ресурс.

В случае отсутствия необходимых пакетов, завершает свою работу и запускает системные службы, указанные в секции [postupdate_services_start].

4) Останавливает системные службы, указанные в секции [prebackup_services_stop].

5) Выполняет создание резервной копии файлов, которые могут быть изменены в ходе обновления. Резервная копия создаётся в каталоге, указанном в параметре dir_backup.

...

Протоколы работы

В ходе работы менеджер обновлений создаёт следующие файлы протоколов, в которых фиксируются все этапы обновления:

• 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.

Менеджер обновлений сервера работает по следующему алгоритму:

1) Определяет номер текущей версии.

2) Обращается к ресурсу, указанному в параметре update_url, и считывает список доступных пакетов обновления, расположенных на данном ресурсе.

3) Анализирует возможность составить последовательность пакетов для обновления с текущей версии.

В случае наличия необходимых пакетов, скачивает их на локальный диск, если параметр update_url указывает на удалённый ресурс.

В случае отсутствия необходимых пакетов, завершает свою работу и запускает системные службы, указанные в секции [preupdatepostupdate_services_start].

7) Выполняет последовательную обработку пакетов обновлений.

4) Останавливает системные службы, указанные в секции [prebackup_services_stop].

5) Выполняет создание резервной копии файлов, которые могут быть изменены в ходе обновления. Резервная копия создаётся в каталоге, указанном в параметре dir_backup.

6) Запускает системные службы, указанные в секции [preupdate_services_start].

7) Выполняет последовательную обработку пакетов обновлений.

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

...

Процедура обновления кассовых терминалов запускается при активации параметра Автообновление. - нема у нас такогоАвто-обновление в разделе интерфейса Настройка сервера и оборудования – Монитор оборудования – Кассы/обновление касс (вкладка вверху).

Во время обновления сервера УКМ 4 кассовые терминалы временно отключаются от сервера УКМ 4. По окончании обновления сервера УКМ 4, кассовые терминалы пытаются восстановить подключение к серверу УКМ 4 и получают сообщение о несоответствии собственной версии и версии сервера.

После этого кассовые терминалы переходят в состояние ожидания активации параметра Автообновление Авто-обновление. До момента активации данного параметра кассовые терминалы работают в автономном режиме. После активации параметра Автообновление Авто-обновление процедура обновления запускается на кассовых терминалах автоматически.

Для включения параметра АвтообновлениеАвто-обновление необходимо с помощью «Web  перейти в раздел  Администрирование –> Терминалы –> Автообновление - нет у нас такого адреса вообще и включить интерфейса сервера Настройка сервера и оборудования – Монитор оборудования – Кассы/обновление касс и включить данный параметр для соответствующей кассы(см. раздел "Кассы").

Во избежание временной приостановки работы магазина, рекомендуется выполнять обновление кассовых терминалов последовательно, а не всех сразу.

...

Обновление терминала осуществляется в автоматическом режиме после активации параметра АвтообновлениеАвто-обновление. Во время обновления работа кассовой программы временно завершается и автоматически запускается менеджер обновлений. По окончании обновления кассовая программа будет запущена автоматически.

Внимание! 

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

...

Перед началом обновления необходимо установить имя ресурса, используемого кассами для загрузки пакетов обновлений. Имя ресурса для загрузки пакетов обновлений задаётся параметром магазина URL для скачивания обновлений (пункт меню «Параметры»/«Параметры» Web интерфейса). - нету у нас такого в Параметрах магазина (Справочники – Магазины, далее необходимо выбрать конкретный магазин и перейти в пункт его параметров).

Если на 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).

...

7. Добавление в переменную окружения PATH путей: C:\PHP и C:\PHP\DLLS, если переменная окружения PATH их не содержит.

8. Запуск служб:

• MySQL;
• УКМ-сервер;
• Apache2;
• с помощью Web-интерфейса проверьте корректность запуска службы УКМ-сервер.

9. Сетевая настройка:

      1) Для каталога c:\Program Files\ukmclient создать сетевой ресурс с именем ukminst.

      2) Дать локальному пользователю __ukmuser__ права на чтение данного ресурса.

Инструкция по откату обновления на 43 версию на кассовом терминале - СТАРЬО И АЦТОЙ

Инструкция предназначена для возврата кассового терминала к состоянию до начала обновления.

Данную инструкцию можно использовать в случаях, если СТАРТОВАЯ_ВЕРСИЯ обновления меньше чем 43 - то есть для ситуаций, когда в ходе обновления 43 версия является промежуточной или конечной (например: 42sp3 -> 43; 42sp6 -> 43; 42sp6 -> 4301; 42sp6 -> 4302).
Внимание!
В случае если СТАРТОВАЯ_ВЕРСИЯ больше или равна 43 - данную инструкцию использовать не следует.

Для отката обновления выполнить следующие действия.

1. Сохранить для анализа лог файлы обновления.

• Для этого загрузить с кассы следующие файлы:
  • /usr/local/ukmclient/update/*.log
  • /usr/local/ukmclient/ukmupman/*.log
  • /usr/local/lillo/ukmupman/*.log
  • /tmp/43update/*.log

...

В ходе обновления выполняется изменение структуры каталогов, поэтому в разные моменты времени в процессе обновления некоторые из указанных каталогов могут отсутствовать.
Примечание:
Для копирования файлов по SSH можно использовать следующие программы:

• WinSCP;
• PSCP.

В ходе обновления на 43 версию, выполняется отключение на кассе Samba сервера поэтому для копирования файлов на кассу и с кассы следует использовать SSH.

2. Скопировать на кассу в каталог «/tmp» файл «cli-rollback-43.tgz» из архива "Откат на кассе.zip"

3. Подключиться к кассе по SSH и выполнить следующие команды:

• cd /tmp
• tar xzf cli-rollback-43.tgz
• cd cli-rollback-43

4. Отредактировать файл «cli-rollback-43.sh»:

• заменить в этом файле в строке export DIR_BACKUP="/usr/local/ukmclient/backup/NOVERSION"

значение в кавычках на путь к резервной копии созданной во время обновления

Например: export DIR_BACKUP="/usr/local/ukmclient/backup/00004205"

5. Выполнить команду: ./cli-rollback-43.sh

6. В ответ на запрос «Are you sure to perform rollback?» ввести «yes» и нажать клавишу [Enter].

7. Дождаться окончания процедуры отката.

Об успешном выполнении отката будет свидетельствовать появление сообщения:

Rollback performed without errors ДАТА_ВРЕМЯ SUCCESS: ./cli-rollback-43-internal.sh completed.

В случае ошибки появится сообщение: ERROR: ./cli-rollback-43-internal.sh failed

Для анализа причины ошибки следует просмотреть протокол отката «cli-rollback-43.log»

8. В случае успешного завершения процедуры отката перезагрузить кассу с помощью команды reboot
Внимание!
В ходе процедуры отката содержимое каталога резервной копии, указанное в переменной DIR_BACKUP переносится в каталог /tmp/backup-copy-43 ,а сам каталог резервной копии удаляется.

9. В случае если в ходе отката возникнет ошибка, для повторного запуска отката необходимо создать каталог, указанный в переменной «DIR_BACKUP» и скопировать в него содержимое каталога «/tmp/backup-copy-43».

Инструкция по откату обновления на Linux кассе при обновлении с версий 43 и старше

Инструкция предназначена для возврата кассы к состоянию до начала обновления, в случае если СТАРТОВАЯ_ВЕРСИЯ обновления 43 или больше, то есть для ситуаций, когда СТАРТОВАЯ_ВЕРСИЯ обновления больше или равна 43.

...

Для отката обновления требуется выполнить следующие действия:

1) Сохраните для анализа лог-файлы обновления. Для этого загрузите с кассы следующие файлы:

• /usr/local/ukmclient/ukmupman/*.log
• /usr/local/lillo/ukmupman/*.log

2) Скопируйте на кассу в каталог /tmp файл cli-rollback-post43.tgz из архива. - чо за сцылка на архив???

3) Подключитесь к кассе по SSH и выполните следующие команды:

• cd /tmp
• tar xzf cli-rollback-post43.tgz
• cd cli-rollback-post43

4) Отредактируйте файл cli-rollback.sh, заменив в нём в строке

  export DIR_BACKUP="/usr/local/ukmclient/ukmupman/backup/NOVERSION" 

значение в кавычках на путь к резервной копии, созданной во время обновления.

5) Для ukmclient-касс резервная копия располагается в каталоге

  /usr/local/ukmclient/ukmupman/backup/НОМЕР_ВЕРСИИ_С_КОТОРОЙ_НАЧАТО_ОБНОВЛЕНИЕ.

Для Lillo-касс резервная копия располагается в каталоге

  /usr/local/lillo/ukmupman/backup/НОМЕР_ВЕРСИИ_С_КОТОРОЙ_НАЧАТО_ОБНОВЛЕНИЕ.

Например:

    export DIR_BACKUP="/usr/local/ukmclient/ukmupman/backup/00004301"

6) Выполните команду

  ./cli-rollback.sh

7) В ответ на запрос:

Are you sure to perform rollback?

наберите на клавиатуре: yes[Enter]

8) Дожидайтесь окончания процедуры отката. Об успешном выполнении отката будет свидетельствовать появление следующего сообщения:

   ==========================================================
   Rollback performed without errors
   ДАТА_ВРЕМЯ
   SUCCESS: ./cli-rollback-internal.sh completed.
   ==========================================================

В случае ошибки появится сообщение:

...

.

...

Для анализа причины ошибки следует просмотреть протокол отката:

  cli-rollback.log

В случае успешного завершения процедуры отката, перезагружать кассу не требуется. Кассовая программа будет запущена автоматически.

Внимание! В ходе процедуры отката, содержимое каталога резервной копии, указанное в переменной DIR_BACKUP, переносится в каталог /tmp/!backup-copy!, а сам каталог резервной копии удаляется.

9) В случае, если в ходе отката возникнет ошибка, для повторного запуска отката необходимо создать каталог, указанный в переменной DIR_BACKUP, и скопировать в него содержимое каталога /tmp/!backup-copy!.

Инструкция по откату обновления для Windows клиентов УКМ 4 при обновлении с версии 43 или более новой

Инструкция предназначена для возврата компонентов УКМ-касса и Lillo к состоянию до начала обновления, в случае, если стартовая версияобновления 43 или выше.

8. Запуск служб:

• MySQL;
• УКМ-сервер;
• Apache2;
• с помощью Web-интерфейса проверьте корректность запуска службы УКМ-сервер.

9. Сетевая настройка:

      1) Для каталога c:\Program Files\ukmclient создать сетевой ресурс с именем ukminst.

      2) Дать локальному пользователю __ukmuser__ права на чтение данного ресурса.

Инструкция по откату обновления на Linux-кассе при обновлении

Откат после неуспешного обновления для касс старше 70 версии выполняется автоматически.

Инструкция по откату обновления на Windows-кассе при обновлении

В инструкции используется понятие "каталог установки" (будем обозначать его через DIR_INSTALL). По умолчанию, в качестве каталога установки используется:

...

2) Восстановление рабочего каталога.

Внимание! 

Перед выполнением следующего шага убедитесь в том, что каталог резервной копии перемещён в безопасное место.

...