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

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

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

1.У пользователя, от имени которого развернут контейнер, по умолчанию есть полные права доступа на базы данных MongoDB. Если для подключения к MongoDB планируется указать другого пользователя, то выдайте ему права на базы данных. Для этого запустите 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.sh all down

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

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

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

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

•DockerImages.tar.gz – базовые docker-образы. Скопируйте архив, если на сервере отсутствует доступ к сети Интернет;

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

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

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

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

4.Запустите Directum Launcher с помощью команды:

./DirectumLauncher --host=0.0.0.0

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

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

./DirectumLauncher --host=0.0.0.0

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

Страницу можно открыть вручную по ссылке http://<IP-адрес сервера, где выполняется установка>:5000/, например, если случайно закрыли браузер. По умолчанию используется порт 5000. Порт можно изменить, добавив к команде ключ --port=<номер порта>.

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

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

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

7.Проверьте, что поля заполнены верно. Описание полей см. в инструкции по установке системы на Linux. В поле Сервер БД укажите базу данных предыдущей версии системы.

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

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

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

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

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

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

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

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

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

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

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

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

13.Восстановите внешние ключи для таблиц сущностей с помощью команды:

./do.sh 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.Обновите статистику, которую использует планировщик для выбора наиболее эффективного способа выполнения запроса. Для этого в редакторе запросов PGAdmin выполните SQL-запрос vacuum full analyze:

vacuum full analyze;

ПРИМЕЧАНИЕ. Обновление статистики может занимать продолжительное время.

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

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

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

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

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

•PlatformBuilds;

•_cache.

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

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

Где:

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

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

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

./do.sh clean_logs --config_path="/srv/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.В версии 4.7 добавлена поддержка запуска Docker в режиме Rootless. Он позволяет безопасно запускать службу Docker, так как для этого используется учетная запись без привилегий суперпользователя, она не имеет доступа к системным ресурсам. Дополнительно в этом режиме можно запускать и сами службы внутри контейнеров от учетных записей без привилегий root. Для этого выполните установку и настройку Docker и контейнеров в режиме Rootless.

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

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

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

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

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

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

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

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

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