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

Чтобы обновить систему с версии 4.9 на версию, например, 4.9.30.0:

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

2.Остановите и удалите все сервисы. Для этого перейдите в папку с Directum Launcher, запустите командную строку и выполните команду:

do all down

3.Архив с новой версией Directum Launcher скопируйте с заменой файла в корень папки с предыдущей версией Directum Launcher. Архив распаковывать не нужно. Также в корень папки скопируйте архивы:

•Platform.zip – платформа, включающая веб-сервер и сервисы Directum RX;

•DirectumRX.zip – набор стандартных шаблонов документов, утилиты RxCmd и DrxUtil, а также стандартная прикладная разработка Directum RX.

Примечание. Для систем с заказной разработкой в архиве содержится утилита RxCmd, которая позволяет импортировать свои шаблоны документов, запускать и настраивать под себя интеллектуальную обработку документов. Также в архиве есть утилита DrxUtil для настройки интеграции с 1С. Поэтому при обновлении системы указываются оба пакета разработки: с заказной и со стандартной;

•WebHelp.zip – справка и слайдер;

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

•DeploymentTool.zip – утилита DeploymentTool, если планируете ее использовать для публикации решений. Утилита является устаревшей, оставлена для совместимости. Для новых публикаций используйте утилиту DeploymentToolCore, которая устанавливается вместе с платформой.

Некоторые компоненты зависят друг от друга. Например, без обновления платформы нельзя обновить прикладную разработку. Версии зависимых компонентов должны быть совместимы. Если зависимый компонент нужной версии не найден в папке с Directum Launcher, то при запуске инструмента установки возникнет ошибка. Проверьте, что все нужные архивы есть в папке.

В таблице приведены примеры компонентов, у которых есть зависимости:

ВАЖНО. Для корректного обновления общий путь к файлам должен быть не более 256 символов. Также он не должен содержать пробелы, символы кириллицы, запятые и спецсимволы. Поэтому используйте, например, папку D:\DirectumLauncher.

4.От имени администратора запустите файл DirectumLauncher.exe.

Если в конфигурационном файле содержатся зашифрованные параметры, то Directum Launcher нужно запускать из командной строки, иначе возникнут ошибки. Для этого перейдите в папку с инструментом и последовательно выполните:

set <Переменная окружения>=<Пароль>

DirectumLauncher

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

Страницу можно открыть вручную по ссылке http://127.0.0.1:5000/, например, если случайно закрыли браузер или он не настроен по умолчанию.

ПРИМЕЧАНИЕ. С помощью ключей запуска можно подключиться к Directum Launcher с другого компьютера, настроить аутентификацию для входа и использовать защищенный протокол HTTPS. Также можно сменить локализацию на английскую. Подробнее см. раздел «Дополнительные параметры запуска Directum Launcher».

5.Убедитесь, что установлен переключатель Обновление:

6.Убедитесь, что установлен флажок Platform и заполнены настройки веб-сервера и сервисов.

7.Проверьте, что поля заполнены верно. Подробнее см. инструкцию по установке сервера Directum RX.

ПРИМЕЧАНИЕ. Если для соединения с базой данных используется Windows-аутентификация, то в конфигураторе в секции Агент управления сервисами Directum RX (ServiceRunner) проверьте, что параметры WINDOWS_USERNAME и WINDOWS_PASSWORD заполнены верно. Подробнее см. руководство администратора, раздел «Конфигурирование настроек».

8.Убедитесь, что установлен флажок DirectumRX и заполнено поле Путь до пакета. Флажок и поле доступны, если в корне локальной папки с Directum Launcher есть архив DirectumRX.zip.

 Для систем с заказной или модифицированной разработкой

9.Для обновления справки убедитесь, что стоит флажок WebHelp. Флажок можно снять, например, если система обновляется для краткосрочного тестирования и при этом нужно сэкономить место на диске.

10.Ознакомьтесь с текстом лицензионного соглашения и установите флажок Я принимаю условия лицензионного соглашения.

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

12.Дождитесь окончания обновления. На странице выводятся этапы обновления. В раскрывающейся области с названием этапа отображаются сообщения из лог-файла DirectumLauncher\log\current.log.

Если при выполнении этапа возникает ошибка, с помощью сообщения из лог-файла проанализируйте и устраните ее, затем нажмите на кнопку Повторить.

примечание. Ошибка с кодом 503 при проверке работоспособности сервисов означает, что они не успели запуститься. В этом случае нажмите на кнопку Повторить.

Если нужно изменить ранее заданные настройки, нажмите на кнопку Вернуться к настройкам. В результате откроется страница обновления. Укажите новые значения параметров и по кнопке Обновить повторите обновление.

Когда обновление завершится, на странице появится ссылка для входа в веб-клиент.

13.Чтобы освободить дисковое пространство, после обновления удалите папки прошлой версии системы из DirectumLauncher\etc\_builds:

•DBConverter\<папка с прошлой версией>;

•Redist\<папка с прошлой версией>;

•Encryptor\<папка с прошлой версией>;

•PlatformBuilds;

•_cache.

Также рекомендуется удалить старые лог-файлы. Для этого выполните команду:

do clean_logs --config_path="<Путь до config.yml>" --skip_last_modified_days="<Количество дней>"

Где:

--config_path – путь до конфигурационного файла, в котором указана папка с лог-файлами. Если путь не указан, то по умолчанию используется файл config.yml в папке с Directum Launcher;

--skip_last_modified_days – количество дней, за которое файлы нужно оставить. Если количество дней не указано, то остаются лог-файлы, созданные за последние 7 дней. Чтобы удалить все лог-файлы, в качестве значения ключа укажите 0.

Пример команды:

do clean_logs --config_path="D:\DirectumLauncher\etc\config.yml" --skip_last_modified_days="7"

14.Если сервисы Directum RX перенесены на отдельный сервер, то после обновления системы обновите перенесенные сервисы. Подробнее см. в разделе «Обновление сервисов на выделенном сервере».

© Компания Directum, 2024