Где взять актуальный Upgrade Tool:

  1. Инструмент обновления может быть получен из существующей установки YSoft SafeQ 6 выполненной через Server Installer (YSoft SafeQ 6 Server Installer\ysq-server-ocr-install) по пути в <YSoft SafeQ 6 home>/Management/upgrade/

(с последних версий папка upgrade не создается при чистой установки, см. п.2).

  1. Можно получить инструмент из *.bin файлов Server Installer, для этого:
    1. Распакуйте архив ysq-server-ocr-install.zip в папке YSoft SafeQ 6 Build 38 Complete Pack (2019-11-07)\YSoft SafeQ 6 Server Installer:

  1. Распакуйте 1.bin используя 7zip:

  1. Актуальный инструмент расположен в папке 1, подкаталог upgrade:

 

!!! Средство обновления YSoft SafeQ 5 до YSoft SafeQ 6 предназначено для полного обновления YSoft SafeQ 5 до YSoft SafeQ 6. Этот инструмент запускается автоматически. Установка сервера YSoft SafeQ 6 из программы установки сервера, но в случае сбоя процесса обновления его также можно запустить вручную.

 

Он запускает процедуры базы данных и импортирует специальный файл движка на основе правил для переноса данных из более старой версии в более новую.

 

!!! Обратите внимание, что если встроенная база данных PostgreSQL используется в часовом поясе, отличном от GMT, необходимо применить следующий обходной путь с известным ограничением.

«Configuring the PostgreSQL Time Zone for Correct Print Job and Report Data»

 

ОБЗОР

Средство обновления управляет всем процессом обновления с YSoft SafeQ 5 до YSoft SafeQ 6. Он запускает набор шагов обновления, проверяет их результаты и решает, выполняется ли следующий шаг или процесс обновления прерывается. Основной целью процесса обновления является миграция базы данных. Миграция делится на конкретные шаги, которые должны выполняться в установленном порядке. Если какой-либо шаг завершается неудачей, процесс миграции прерывается, данные с определенного шага откатываются, и требуется вмешательство администратора вручную. Администратор может проверить журналы (и отчет об обновлении) и решить, можно ли продолжить процесс обновления, проигнорировав результат шага или пропустить весь шаг. Игнорирование результата шага означает, что шаг обрабатывается, данные, вероятно, частично переносятся, и можно попытаться выполнить следующие шаги. Если шаг не может быть завершен по техническим причинам, этот шаг может быть полностью проигнорирован, но администратор должен явно исключить этот шаг после тщательного рассмотрения.

 

Предпосылки

 

Свойства конфигурации (с примерами значений):

 

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

 

Свойства sq5.database.username, sq5.database.password, sq5.database.host, sq5.database.port игнорируются в случае базы данных MSSQL, поскольку базы данных YSoft SafeQ 5 должны находиться на одном компьютере с базой данных и учетными данными для YSoft SafeQ 6 используются вместо. Однако свойства по-прежнему должны быть установлены, даже если они не оказывают никакого влияния (это известное ограничение инструмента обновления).

 

Как запустить

Запустите через командную строку инструмент обновления с помощью <YSoft SafeQ 6 home>/Management/upgrade/sq5-upgrade-tool.bat, а затем выполните требуемую команду (для поддерживаемых команд см. далее, запустите справку для списка возможных команд).

 

Немедленно запустите оболочку инструмента обновления с необходимой командой - запустите <YSoft SafeQ 6 home> /Management/upgrade/sq5-upgrade-tool.bat <command>

 

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

 

КОМАНДА "ОБНОВЛЕНИЕ"

Команда для запуска всего обновления: upgrade

 

Команда обновления имеет необязательные параметры:

--ignore-steps-result - список имен шагов, разделенных запятыми, которые будут получены, будут игнорироваться во время обновления (т. е. при неудачном завершении шага обновление может быть продолжено до следующего шага).

--ignore-steps - список имен шагов, разделенных запятыми, которые будут игнорироваться при обновлении. Используйте эту опцию в качестве последней возможности продолжить обновление, только если последствия игнорируемого шага хорошо известны.

 

!!!  Пример аргументов командной строки

upgrade --ignore-step-result TENANT.DEVICES,DWH.STATS --ignore-steps TENANT.COMMON

 

Имена шагов должны быть в формате <схема обновления>.<Шаг обновления> (<upgrade scheme>.<upgrade step>)

Разрешенные схемы обновления:

Разрешенные шаги обновления:

 

Смотрите «Подробное описание шага обновления» для получения дополнительной информации о конкретных шагах.

 

КОМАНДА "ИМПОРТ ПРАВИЛ"

Импорт правил RBE является частью процесса обновления, но импорт можно запустить отдельно с помощью команды: rule import

 

Команда импорта правил имеет необязательный параметр:

-- file Путь к файлу правил YSoft SafeQ 5 RBE для импорта. Если этот параметр не установлен, используется файл по умолчанию из конфигурации инструмента обновления.

 

!!!  Пример аргументов командной строки

rule import --file C:/path/rbe.drl 

 

После запуска

См. Вывод консоли, а также файлы журнала и отчет об обновлении.

 

Вот возможные результаты запуска инструмента обновления (в консоли или в журнале):

 

!!!  Служба управления (Management Service) и другие службы, связанные с YSoft SafeQ, должны быть остановлены перед выполнением обновления.

 

ФАЙЛОВА СТРУКТУРА И ЛОГИ ИНСТРУМЕНТА:

Структура <YSoft SafeQ 6 home>/Management/upgrade: