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

1.Ограничьте доступ сотрудников к Directum RX одним из способов:

•включите режим технического обслуживания;

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

do all down

ВАЖНО. Ограничение доступа необходимо для предотвращения ошибок, которые могут возникать из-за блокировки БД пользователями или сервисами. Если во время обновления сотрудники продолжают работать в системе, внесенные изменения могут быть потеряны.

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

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

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

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

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

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

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

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

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

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

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

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

DirectumLauncher.exe

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

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

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

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

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

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

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

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

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

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

8.Если сотрудники работают в мобильных приложениях Directum Solo и Directum Jazz, убедитесь, что установлен флажок Сервис NOMAD. Выполните шаги по обновлению сервиса NOMAD. Снимите флажок, если мобильные решения не используются.

9.Если в компании используется интеграция с 1С, то обновите коннектор на новую версию.

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

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

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

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

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

ВАЖНО. Если ошибка возникла на этапе конвертации базы данных, то сначала восстановите БД из резервной копии. Иначе при повторной попытке обновления база данных станет нерабочей.

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

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

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

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

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

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

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

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

2.С версии 4.10:

•сервисная СУБД MongoDB не используется для хранения служебной информации, например описаний файлов предпросмотра и настройки виджетов. После обновления эта информация хранится в базе данных системы. Если MongoDB использовалась только для Directum RX, то после тестирования работы системы удалите эту СУБД.

Также до начала работы в системе очистите папку с файлами предпросмотра, чтобы освободить место на диске. Файлы больше не нужны, так как информация о них хранилась в MongoDB. Расположение папки указано в конфигурационном файле config.yml в секции PreviewStorage в параметре STORAGE_PATH. В дальнейшем во время работы с системой в хранилище будут созданы новые файлы предпросмотра.

•зашифрованные документы и те, для которых включен строгий доступ, можно открывать в онлайн-редакторах ONLYOFFICE и P7-Офис. Чтобы включить эту возможность, в конфигураторе Directum Launcher в параметре WEB_EDITORS для атрибутов @supportEncrypted и @supportStrictAccess установите значение true. Подробнее см. в описании настройки решения «Интеграция с ONLYOFFICE и Р7-Офис».

Кроме этого, если ранее вы настраивали ограничение доступа к онлайн-редакторам в параметре COLLABORATION_ROLE_ID конфигурационного файла tenant1.env, то в новой версии это ограничение необходимо задать в параметре COLLABORATIVE_EDITING_ROLE_ID для веб-сервера Directum RX.

3.С версии 4.11:

•прекращается поддержка устаревшей утилиты DeploymentTool, поэтому после обновления системы утилиту можно удалить. Для этого последовательно выполните действия:

1.Из конфигурационного файла config.yml удалите секцию DeploymentToolUI вручную или с помощью команды:

do dt_ui uninstall

2.Удалите компонент:

do components delete deploymenttoolui

3.Из папки с Directum Launcher удалите архив DeploymentTool.zip.

•добавлена поддержка объектных хранилищ S3. Если вы планируете перейти с файлового на объектное хранилище, то запросите у провайдера адрес, ключ доступа и секретный ключ. Подробнее см. в руководстве администратора, раздел «Утилита S3Tool»;

•используется новый механизм усовершенствования подписей. В том числе появился фоновый процесс «Поэтапное усовершенствование подписей», который запускает новый асинхронный обработчик IncrementalImproveSignaturesWorker. В системе поддерживается совместимость со старыми настройками и стартованными асинхронными обработчиками AddTimestampToSignature и ImproveSignatureToCadesXL. Для дальнейшей работы рекомендуется перенастроить усовершенствование на новый механизм.

При настройке учитывайте, что в конфигураторе Directum Launcher больше не используются параметры:

4.С версии 4.12:

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

•появилась возможность настраивать отдельные представления для карточек в списке. Для этого достаточно создать представление формы и в поле Вид представления выбрать пункт Карточка в списке. Если ранее в системе настраивались представления форм, то после обновления они отображаются как представления по умолчанию. Рекомендуется проанализировать, нужно ли для карточек в списке задать отдельные представления и при необходимости создать их;

•теперь можно отправлять документы на последовательное свободное согласование. Для этого в карточке задачи появилось поле Старт с возможными значениями: Одновременно и Друг за другом. После обновления все ранее запущенные задачи считаются отправленными на параллельное свободное согласование;

•для роли «Все пользователи» изымаются права на просмотр следующих справочников:

При необходимости администратор может изменить права доступа;

•ограничен просмотр состава участников некоторых предопределенных ролей. При необходимости администратор может выдать права доступа необходимым сотрудникам. Подробнее см. в разделе «Ограничение просмотра состава участников роли»;

•сокращен список поддерживаемых версий поисковой системы Elasticsearch. Если у вас используются версии 7.17.13, 7.16.3, 7.4.2 и 7.4.0, то их рекомендуется обновить до версии Elasticsearch 7.17.23.

5.С версии Directum RX 4.12 можно автоматически заносить в систему документы, которые поступают с электронной почты или сканера. В прошлых версиях для этих целей организация могла использовать решение «Занесение документов с помощью DCS», которое не работает с Directum RX 4.12.

Если ранее документы заносились с помощью решения «Занесение документов с помощью DCS», после обновления системы:

•перенесите настройки из созданных для решения правил обработки документов в справочник Directum RX Источники поступления документов для занесения с электронной почты или из файловой системы;

•убедитесь, что служба ввода документов (DCS) настроена на работу с утилитой RxCmd;

•скорректируйте настройки модуля отправки службы ввода документов: в параметре ProgramArguments укажите путь до исполняемого файла rxsmartproc.bat;

•удалите решение «Занесение документов с помощью DCS». Подробнее см. в руководстве разработчика, раздел «Публикация с помощью командной строки».

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