Пользовательская документация
Дерево страниц

Сравнение версий

Старая версия 21

changes.mady.by.user Горбунова Евгения Александровна

Сохранено

по сравнению с

Новая версия 22

changes.mady.by.user Рамазанов Руслан Александрович

Сохранено

Ключ

  • Эта строка добавлена.
  • Эта строка удалена.
  • Изменено форматирование.

...

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

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

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

...

Перед началом обновления сервера необходимо проверить и при необходимости отключить для каждой кассы параметр Автообновление в разделе интерфейса АдминистрированиеНастройка сервера и оборудования/Монитор оборудования/Кассы/обновление касс. Необходимость выполнения данной операции обусловлена тем, что при включенном параметре Автообновление обновление терминалов запускается в автоматическом режиме. Процесс обновления терминалов в среднем занимает от 10 до 40 мин., что может привести к временной приостановке работы магазина. Не Для автоматического отключения автообновления есть возможность установить опцию "Сброс признака "Автообновление" после успешного обновления кассы" в "Настройка сервера и оборудования/Параметры сервера/Параметры".

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

...

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

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

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

...

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

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

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

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

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

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

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

  • 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 указывает на удалённый ресурс.

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

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

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

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

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

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

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

http://ХОСТ_СЕРВЕРА_УКМ_4/ukmupdates

...

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

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

...

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

...

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

Если на DNS-сервере сети магазина зарегистрирован ХОСТ_СЕРВЕРА_УКМ_4, для параметра URL для скачивания обновлений следует установить следующее значение:

...

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

...

Настройка сервера и оборудования/Монитор оборудования/Кассы/обновление касс. Зайти в конкретную кассу и нажать кнопку "Старт" в разделе загрузка обновлений.

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

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

...

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 можно использовать следующие программы:

В ходе обновления на 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.
   ==========================================================

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

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

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

  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 кассе при обновлении

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

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

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

...