ВАЖНО. В версии 4.7 идентификаторы всех типов объектов переведены с типа int на long. Поэтому для конвертации требуется запас свободного места на диске, равный размеру существующей базы данных. Размер сконвертированной базы увеличится примерно на 30%. Перед обновлением проверьте, что на диске достаточно свободного места.

В зависимости от размера базы данных этап конвертации может занять длительное время. Например, для базы данных размером 30 ГБ, содержащей 10 млн документов, может потребоваться до 2,5 ч, а для базы размером 131 ГБ со 100 млн документов – около 10 ч.

Чтобы обновить систему:

1.Пользователю, от имени которого выполняется подключение к MongoDB, выдайте права доступа к базам данных Sungero_dist_cache, Sungero_StorageService, sungero_ip_blocking, Sungero_HealthCheck. Для этого запустите Mongo Shell и выполните команды:

use admin

db.grantRolesToUser('userMongo', [{ role: "readWrite", db: "Sungero_dist_cache"}, { role: "readWrite", db: "Sungero_StorageService"}, { role: "readWrite", db: "sungero_ip_blocking"}, { role: "readWrite", db: "Sungero_HealthCheck"}, { role: "readWrite", db: "memoRelations_<код системы>"}]);

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 и заполнены настройки веб-сервера и сервисов. Флажок и поля доступны, если в корне локальной папки с Directum Launcher есть архив Platform.zip.

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.Восстановите внешние ключи для таблиц сущностей с помощью команды:

do dt run --command="-n \"Service User\" -p <Пароль> --restore-fk"

Примечание. Логины и пароли нужно указывать в двойных кавычках с экранирующим символом \, так как они могут содержать пробелы и спецсимволы. Например, пароль вида pas~!@88 указывается как \"pas~!@88\".

После выполнения команды в лог-файл Directum Launcher current.log сохраняется список колонок, для которых выполнилось восстановление внешних ключей. Список также выводится в командной строке и записывается в лог-файл утилиты DeploymentToolCore. Для каждой колонки указывается результат восстановления: Successed – внешний ключ восстановлен, FAILED – внешний ключ восстановить не удалось.

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

Пример лог-файла:

2023-07-25 11:31:37,496 INFO For tenant 'Directum RX':
2023-07-25 11:31:37,496 INFO For table 'Sungero_Commons_City':
2023-07-25 11:31:37,496 INFO 'Region' - FAILED
2023-07-25 11:31:37,496 INFO 'Country' - FAILED
2023-07-25 11:31:37,496 INFO For table 'Sungero_Content_EDoc':
2023-07-25 11:31:37,496 INFO 'BusinessUnit_Docflow_Sungero' - Successed
2023-07-25 11:31:37,496 INFO 'Currency_Docflow_Sungero' - Successed
2023-07-25 11:31:37,496 INFO 'InRespTo_Docflow_Sungero' - Successed

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

14.После обновления уменьшите размер сконвертированной базы данных. Для этого в редакторе запросов Microsoft SQL Server Management Studio выполните SQL-запрос:

DBCC SHRINKDATABASE('<Имя БД>')

15.Чтобы освободить дисковое пространство, после обновления удалите папки прошлой версии системы из 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"

16.После обновления настройте систему.

17.Выполните обновление с версии 4.8 на 4.9.

Настройка системы

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

2.В версии 4.6 изменился механизм преобразования печатной формы формализованных документов (PDF) при подписании, заполнении реквизитов покупателя или продавца, а также при отправке ответов контрагентам. Теперь печатная форма формируется не сразу, а через некоторое время. Фоновый процесс «Электронный обмен. Преобразование в PDF» запускает асинхронные обработчики, которые конвертируют документы в порядке очереди. Чтобы преобразование в PDF выполнялось незаметно для пользователей, период запуска фонового процесса необходимо уменьшить. Рекомендуемое значение – 5 минут.

3.Если вы используете службу ввода документов, то переустановите ее после обновления на новую версию Directum RX.

4.Если установлены дополнительные решения Directum RX, например, «Мониторинг системы Directum RX», «Интеграция с ССТУ», обновите их согласно документации на соответствующие решения.

5.В версии 4.6 появилась возможность перекомплектования документов. Для этого в дистрибутив добавлен отдельный архив Repacking.zip. Функциональность доступна в варианте поставки Directum RX Intelligence.

6.В версии 4.6 появился конфигуратор настроек системы. С его помощью можно визуально редактировать параметры конфигурационного файла config.yml. Для этого на странице инструмента Directum Launcher в режиме Настройка по умолчанию переключатель находится в положении Визуальный режим конфигурирования. Возможность редактировать параметры в редакторе или напрямую в конфигурационном файле остается. Подробнее см. руководство администратора, раздел «Конфигурирование настроек».

7.В версии 4.6 появилась возможность перенести выполнение кода сторонних сборок на сервис изолированного кода, чтобы обезопасить систему от возможных ошибок и нестабильности стороннего кода. Для этого в среде разработки создайте изолированную область в нужном модуле и подключите к ней стороннюю библиотеку. Подробнее см. руководство разработчика, раздел «Изолированные области».

8.С версии Directum RX 4.6 веб-сервер, среда разработки и все микросервисы работают на .NET 6. Совместимость с .NET Core 3.1 сохраняется. Если вы используете сторонние библиотеки, собранные по спецификации .NET Standard 2.0, то при обновлении на Directum RX 4.6 их адаптировать не нужно, так как они совместимы и с .NET Core 3.1, и с .NET 6. Если в вашей разработке есть сторонние библиотеки, которые поддерживают только .NET Framework, то оставлена возможность перенастроить сервис асинхронных событий на работу под .NET Framework 4.8. Порядок настройки см. в руководстве администратора, раздел «Сервис асинхронных событий».

9.С версии 4.6 схема новых типов задач по умолчанию настраивается в проводнике веб-клиента. Для таких задач в редакторе типа задачи установлен флажок Схема настраивается в проводнике. Ранее созданные типы задач остаются без изменений. Для них флажок не установлен, и схема по-прежнему настраивается в среде разработки. Подробнее см. руководство разработчика, раздел «Разработка задач и заданий».

10.В версии 4.7 появилась возможность перенести с СУБД на Elasticsearch поиск по некоторым критериям документов, задач, заданий и уведомлений. Для этого необходимо установить Elasticsearch и выполнить дополнительные настройки в системе. Рекомендуется переносить поиск на Elasticsearch, только если поиск объектов по большому объему данных (десятки и сотни миллионов документов, задач или заданий) создает нагрузку на СУБД и занимает продолжительное время. Подробнее см. в руководстве администратора, раздел «Поиcк по критериям документов, задач и заданий в Elasticsearch».

11.На основании приказа ФНС России № ЕД-7-26/133@ в версии 4.7 изменился регламент обмена служебными документами – извещениями о получении (ИОП). При обновлении системы в справочнике Сведения о документе обмена для существующих записей:

•в поле Статус ИОП значение Отправлен автоматически меняется на новый конечный статус Обработан для записей, у которых обработка ИОП завершена;

•новое поле Статус ИОП на титул покупателя заполняется значением Не требуется.

Для записей, у которых статус ИОП не был заполнен, после обновления необходимо сгенерировать отсутствующие ИОП вручную. Для этого зайдите в личный кабинет сервиса обмена один раз, дождитесь генерации извещений и затем синхронизируйте их в Directum RX с помощью фонового процесса «Электронный обмен. Получение сообщений».

12.Если в Directum RX настроен обмен с головной организацией контрагента, то после обновления на версию 4.8 все филиалы и подразделения контрагента автоматически синхронизируются в систему согласно расписанию нового фонового процесса «Электронный обмен. Синхронизация филиалов и подразделений контрагентов». Но если компания планирует продолжать обмениваться документами через головную организацию, т.е. по-старому, то после обновления рекомендуется сразу отключить фоновый процесс.

13.В версии 4.8 в файлах с настройками слайдов ProductNotesSlider.json и ReleaseNotesSlider.json можно указать любую ссылку. Для этого появился параметр HelpUrlRU. Например, на слайде можно дать ссылку на разработанный справочник. Подробнее см. в руководстве администратора, раздел «Слайдер c описанием возможностей веб-клиента».

14.Если в компании используется интеграция с 1С, то при обновлении на версию 4.8 рекомендуется перейти на новый коннектор, который обеспечивает синхронизацию данные между системами по протоколу OData без утилиты DrxUtil. Подробнее см. раздел «Переход на новый коннектор к 1С».

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