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

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

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

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

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

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

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

Во время установки 43 версии (обновления на 43 версию) данный параметр автоматически заполняется значением: http://ХОСТ_СЕРВЕРА_СУПЕРМАГ/ukmupdates.

В случае использования статических IP адресов и отсутствующего (некорректно настроенного сервера DNS) кассовый терминал не сможет загрузить пакеты обновления, так как не сможет преобразовать ХОСТ_СЕРВЕРА_СУПЕРМАГ в IP адрес. Поэтому сразу после установки ПО кассовых терминалов или перед началом обновления необходимо проверить с терминалов доступность сервера СуперМаг по имени хоста. Для этого достаточно подключившись на кассовый терминал по SSH выполнить команду: ping ХОСТ_СЕРВЕРА_СУПЕРМАГ

В случае если сервер СуперМаг недоступен по имени хоста, необходимо с помощью Web интерфейса отредактировать параметр магазина "URL для скачивания обновлений" заменив его значение:

с http://ХОСТ_СЕРВЕРА_СУПЕРМАГ/ukmupdates

на http://IP_АДРЕС_СЕРВЕРА_СУПЕРМАГ/ukmupdates,

где IP_АДРЕС_СЕРВЕРА_СУПЕРМАГ - IP адрес сервера.
Внимание!
Параметр «URL для скачивания обновлений» должен быть корректно настроен до начала обновления сервера СуперМаг, так как после запуска обновления сервера кассовые терминалы прерывают связь с сервером и не получают данный параметр.

Перед началом обновления сервера необходимо с помощью Web интерфейса в разделе «Администрирование» проверить и при необходимости отключить для каждой кассы параметр «Авто-обновление» (см. раздел "Кассы"). Необходимость выполнения данной операции обусловлена тем, что при включенном параметре «Авто-обновление», обновление терминалов запускается в автоматическом режиме. Процесс обновления терминалов в среднем занимает от 10 до 40 мин, что может привести к временной приостановке работы магазина.

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

Копирование на сервер СуперМаг серверных пакетов обновлений

Расположение пакетов обновления сервера СуперМаг может быть следующим:

1) локально – в одном из каталогов сервера СуперМаг;

2) на удалённом Web или FTP сервере.

Менеджер обновлений выполняет поиск пакетов обновлений по пути указанному в файле:

"C:\Program Files\ukmserver\ukmupman\ukmupman.ini" - в параметре update_url.

Значение параметра update_url – путь к ресурсу, на котором размещены пакеты обновления (URL).

URL указывается в формате:

протокол://[ресурс/]путь

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

Во время установки дистрибутива СуперМаг параметр update_url не заполняется.

По умолчанию для менеджера обновлений сервера СуперМаг параметр update_url использует значение "C:\Program Files\ukmserver\ukmupman\update".

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

При загрузке пакетов обновления по FTP или HTTP протоколам необходимо учитывать следующие особенности:

1) суммарный размер пакетов обновлений может достигать нескольких сот мегабайт, поэтому не рекомендуется использовать протоколы FTP и HTTP для загрузки обновлений в условиях нестабильной связи;

2) при размещении пакетов обновлений на Web или FTP сервере необходимо проверить корректность вывода списка файлов в каталоге. Web или FTP сервер может обрезать имена файлов при выводе списка файлов.

Например, по умолчанию в оригинальном дистрибутиве Web сервера Apache, включены опции, приводящие к обрезке имён файлов. При установке Web сервера Apache в составе дистрибутива СуперМаг для Web сервера Apache устанавливаются корректные настройки. Для справки - за отображение имён файлов отвечает параметр IndexOptions в файле "C:\Program Files\Apache Group\Apache2\conf\httpd.conf".

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

Пример некорректного вывода списка файлов Web сервером:

Index of /ukmsrv-updates

Name Last modified Size Description

Parent Directory -

00004300-00004301.op..> 26-Dec-2007 18:20 2.2M

00004301-00004302.op..> 26-Dec-2007 18:20 3.0K

00004301-00004302.pr..> 26-Dec-2007 18:32 180M

Apache/2.0.52 (Win32) PHP/4.3.9 Server at localhost Port 80

Пример корректного вывода списка файлов Web сервером:

Index of /ukmsrv-updates

Name

Parent Directory

00004300-00004301.ops.s.zip

00004301-00004302.ops.s.zip

00004301-00004302.prg.s.zip

Apache/2.0.52 (Win32) PHP/4.3.9 DAV/2 Server at localhost Port 80

Обновление сервера СуперМаг

Обновление сервера СуперМаг выполняется путём ручного запуска менеджера обновлений.

Для обновления сервера СуперМаг необходимо выполнить следующие действия:

1) Завершить работу всех программ, в том числе компонентов «СуперМаг касса», «СуперМаг Lillo фронт», если они установлены на одном компьютере с компонентом «СуперМаг Сервер». Во избежание блокировки временных каталогов закрыть все файловые менеджеры и архиваторы.

2) Проверить наличие свободного места для создания резервной копии на диске указанном в параметре dir_backup конфигурационного файла "C:\Program Files\ukmserver\ukmupman\ukmupman.ini"

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

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

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

Пуск -> Программы -> Супермаг -> Менеджер обновлений

4)Дождаться окончания обновления.

Об успешном окончании обновления будет свидетельствовать появление в консольном окне менеджера обновлений надписи:

...

SUCCESS: update completed

...

О сбое обновления будет свидетельствовать появление в консольном окне менеджера обновлений надписи:

...

ERROR: update failed

...

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

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

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

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

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

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

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

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

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

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

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

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

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

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

Во время установки дистрибутива для параметра dir_cli_update устанавливается значение "C:\Program Files\Apache Group\Apache2\htdocs\ukmupdates"

что соответствует параметру Web интерфейса «URL для скачивания обновлений»

http://ХОСТ_СЕРВЕРА_СУПЕРМАГ/ukmupdates

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

7) Завершает свою работу и запускает системные службы, указанные в секции [postupdate_services_start].

Активация обновления терминалов

Процедура обновления кассовых терминалов запускается при активации параметра «Авто-обновление».

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

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

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

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

Обновление терминалов

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

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

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

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

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

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

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

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

6) Завершает свою работу и запускает кассовую программу.

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

Установка имени ресурса для загрузки пакетов обновлений

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

Если на DNS сервере сети магазина зарегистрирован «ХОСТ_СЕРВЕРА_СУПЕРМАГ», для параметра "URL для скачивания обновлений" следует установить значение:

http://ХОСТ_СЕРВЕРА_СУПЕРМАГ/ukmupdates

Если на DNS сервере сети магазина не зарегистрирован «ХОСТ_СЕРВЕРА_СУПЕРМАГ», DNS сервер не работает или некорректно настроен, то для параметра "URL для скачивания обновлений" следует установить значение:

http://IP_АДРЕС_СЕРВЕРА_СУПЕРМАГ/ukmupdates

Загрузка серверных пакетов обновления на Linux сервер Супермаг

Загрузка серверных пакетов обновления на Linux сервер Супермаг может выполняться двумя способами:

1) автоматически - в ходе процедуры обновления сервера;

2) вручную.

Для автоматической загрузки пакетов обновления необходимо, чтобы в конфигурационном файле менеджера обновлений сервера /usr/local/ukmsrv/ukmupman/ukmupman.ini параметр update_urlсодержал URL для скачивания обновлений в виде:

http://хост_для_загрузки_обновлений/каталог_с_пакетами_обновлений

ftp://хост_для_загрузки_обновлений/каталог_с_пакетами_обновлений

При этом предполагается, что пакеты обновлений размещены на отдельном FTP или Web сервере.

Для ручной загрузки пакетов обновлений необходимо скопировать пакеты обновления в каталог: /usr/local/ukmsrv/ukmupman/update

Обновление Linux сервера Супермаг

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

1) подключиться к Linux серверу Супермаг по SSH или войти в систему локально;

2) перейти в каталог /usr/local/ukmsrv/ukmupman;

3) запустить скрипт ukmupman.sh;

4) дождаться окончания работы скрипта;

5) проанализировать результат процедуры обновления с помощью протоколов обновления

/usr/local/ukmsrv/ukmupman/ukmupman.log

/usr/local/ukmsrv/ukmupman/ukmup.log

В случае успешного завершения обновления протокол обновления будет содержать запись: SUCCESS: Update completed

В случае сбоя обновления протокол обновления будет содержать запись: ERROR: UPDATE FAILED

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

Активация обновления касс

Для активации процедуры обновления касс необходимо с помощью Web интерфейса перейти в раздел "Кассы". В результате процедура обновления касс запустится автоматически.

Откат некорректного обновления

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

1) подключиться к Linux серверу Супермаг по SSH или войти в систему локально от имени пользователя root;

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

cp -afv /usr/local/ukmsrv/srv-rollback /tmp

cd /tmp/srv-rollback

3) отредактировать файл srv-rollback.sh заменив в нём в строке

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

NOVERSION на номер версии с которой было начато сбойное обновление;

4) запустить файл srv-rollback.sh.

Нештатные ситуации при обновлении

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

При запуске обновления на сервере в каталоге:

c:\Program Files\ukmserver\ukmupman\backup\<номер_текущей_версии>

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

Перед началом отката сохраните содержимое каталогов:

c:\Program Files\ukmserver\ukmupman\backup\<номер_текущей_версии>;

c:\Program Files\ukmserver\ukmupman\update.

• .log файлы из следующих каталогов (каталоги целиком сохранять не нужно):

• • c:\Program Files\ukmserver (каталог "c:\Program Files\ukmserver\logs" сохранять не нужно)
  • c:\Program Files\ukmserver\ukmupman
  • c:\Program Files\ukmserver\ukmupman\backup

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

1. Остановка служб:

• Остановка "УКМ Сервер"
• Остановка "MySQL"
• Остановка "Apache2".

2. Откат Apache + PHP:

• Удаление всех файлов из каталога «C:\PHP».
• Распаковка содержимого архива «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).

• Если существует файл

c:\Program Files\Apache Group\Apache2\conf\httpd.conf.php4.bak:

замена файла c:\Program Files\Apache Group\Apache2\conf\httpd.conf файлом c:\Program Files\Apache Group\Apache2\conf\httpd.conf.php4.bak

Переименование файла c:\Program Files\Apache Group\Apache2\conf\httpd.conf.php4.bak на c:\Program Files\Apache Group\Apache2\php.ini

• Удаление всех файлов из каталога c:\Program Files\Apache Group\Apache2\htdocs\ukm

• Удаление каталога c:\Program Files\Apache Group\Apache2\htdocs\ukminstall

*Распаковка содержимого архива «htdocs-ukm.7z» в каталог c:\Program Files\Apache Group\Apache2\htdocs\ukm
Внимание!
Здесь и далее обратите внимание на то, что внутри 7z архивов с резервными копиями хранится вся структура каталогов от корня диска (например, для htdocs-ukm.7z это: Program Files\Apache Group\Apache2\htdocs\ukm).

• Если существует каталог c:\Program Files\Apache Group\Apache2\htdocs\UKM_SERVER - удаление этого каталога.
• Распаковка содержимого архива «htdocs-ukm_server.7z» в каталог С:\
• Если существует каталог «C:\Program Files\Zend2.bak», то:

удаление каталога «C:\Program Files\Zend»;

переименование каталога «C:\Program Files\Zend2.bak» в «C:\Program Files\Zend»

3. Откат MySQL:

• Замена файла «%systemroot%\my.ini» файлом «my.ini» из резервной копии
• Если существует каталог «C:\MYSQL4»:

• • Удаление каталога «C:\MYSQL»

• • Переименование каталога «C:\MYSQL4» в «C:\MYSQL»

• Если существует файл резервной копии «mysql-data.7z»: удаление каталога «MYSQL4DATA». Каталог «MYSQL4DATA» находится на диске, который был указан в «my.ini» в параметре «datadir». Если после установки УКМ файл «my.ini» не менялся, то каталог «MYSQL4DATA» находится на диске C:\.

• Если существует файл резервной копии «mysql-data.7z»:

• • Удаление содержимого каталога «C:\MYSQL\DATA»

• • Распаковка содержимого архива «mysql-data.7z» в каталог «C:\MYSQL\DATA»

4. Откат Демо-кассы:

• Если была установлена демо-касса:
  • Удаление всех файлов из каталога c:\Program Files\ukmclient-demo
  • Распаковка содержимого архива «ukmclient-demo.7z» в каталог «c:\Program Files\ukmclient-demo»

5. Откат дистрибутива кассы:

• Удаление всех файлов из каталога c:\Program Files\ukmclient
• Распаковка содержимого архива «ukmclient-dir.7z» в каталог «c:\Program Files\ukmclient»

6. Откат сервера УКМ.
Внимание!
Перед выполнением следующего шага проверьте, что содержимое каталога "c:\Program Files\ukmserver\ukmupman\backup\<номер_текущей_версии>" сохранено в каталоге, отличном от "c:\Program Files\ukmserver".

• Удаление вместе с содержимым каталога "c:\Program Files\ukmserver"
• Распаковка содержимого архива «ukmserver-dir.7z» в каталог "c:\Program Files\ukmserver"

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

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

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

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

• Для каталога "c:\Program Files\ukmclient" создать сетевой ресурс с именем «ukminst»
• Дать локальному пользователю «__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.
Внимание!
В случае если СТАРТОВАЯ_ВЕРСИЯ меньше 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" 

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

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

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

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

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

Например

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

5. Выполните команду

  ./cli-rollback.sh

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

Are you sure to perform rollback?

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

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

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

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

  ERROR: ./cli-rollback-internal.sh failed

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

  cli-rollback.log

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

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

Инструкция по откату обновления для Windows клиентов Супермаг при обновлении с версии 43 или более новой

Инструкция предназначена для возврата компонентов "Супермаг касса" и "Супермаг Lillo фронт" к состоянию до начала обновления, в случае, если СТАРТОВАЯ_ВЕРСИЯ обновления 43 или больше (пример 43 -> 43sp1, 43sp1 -> 44)

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

• для компонента "Супермаг касса": "C:\Program Files\ukmclient-win"
• для компонента "Супермаг Lillo фронт": "C:\Program Files\lillo-win"

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

• для компонента "Супермаг касса": DIR_INSTALL\ukmupman\backup
• для компонента "Супермаг Lillo фронт": DIR_INSTALL\ukmupman\backup

Для возврата Windows клиента Супермаг к состоянию до начала обновления выполните следующие действия:

1. Сохранение временных данных для повторного обновления.

В ходе процедуры отката содержимое каталога DIR_INSTALL будет удалено. Сохраните в каталоге (будем называть его BACKUP_COPY), не используемом в ходе процедуры отката, следующие данные:

  а)лог файлы обновления DIR_INSTALL\ukmupman\*.log

  б)содержимое каталога резервной копии DIR_INSTALL\ukmupman\backup

  В дальнейшем для восстановления файлов используйте каталог BACKUP_COPY

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

Удалите содержимое каталога DIR_INSTALL.

Распакуйте архив cli-work-dir.7z в каталог DIR_INSTALL

3. Восстановление БД:

  a)Распакуйте файл резервной копии БД с именем *.sql.7z во временный каталог

  в)Скопируйте во временный каталог файлы:
      *restore-clidb.cmd
      *restore-clidb-internal.cmd

  г)Перейдите во временный каталог

  д)Отредактируйте файл restore-clidb-internal.cmd заменив строку
     SET DIR_INSTALL=

     на

     SET DIR_INSTALL=каталог установки

  е)запустите файл restore-clidb.cmd и дождитесь завершения его работы
    В случае успешного завершения процесса на экран будет выдано сообщение:
    ----------------------------------------
    SUCCESS: restore completed
    ----------------------------------------

В случае неудачного завершения проверки на экран будет выдано сообщение:

    ----------------------------------------
     ERROR:   restore failed
     Check clidb-resore.log for details
    ----------------------------------------

При этом с помощью протокола проверки clidb-resore.log необходимо выяснить причину сбоя.