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

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

./do.sh all down

2.Архив с новой версией 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.

3.Запустите 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».

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

2.В версии 4.7 появилась возможность перенести с СУБД на Elasticsearch поиск по некоторым критериям документов, задач, заданий и уведомлений. Если ранее вы настраивали поиск через Elasticsearch, то при обновлении с версии 4.7.40.0 и ниже заново запустите первоначальное индексирование свойств задач, заданий и уведомлений. Это необходимо, так как с версии 4.7.41.0 для задач, заданий и уведомлений расширен состав критериев, по которым можно искать через Elasticsearch. Для этого запустите утилиту InitialIndexing с ключом –r или --reindex):

./do.sh initialindexing run --command="-wp -r"

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

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

5.С версии 4.9:

•в справочнике Представления форм в поле Описание можно указывать не более 512 символов. Если ранее было задано большее количество, то при обновлении системы описание автоматически уменьшается до 512 символов. Проверьте описания представлений форм и при необходимости скорректируйте значение поля;

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

6.С версии 4.10:

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

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

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

До начала работы в системе:

1.После тестирования работы новой версии удалите MongoDB, если эта СУБД использовалась только для Directum RX.

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

3.В конфигураторе Directum Launcher удалите секцию MongoDB (SungeroMongoDB) и параметры, которые были нужны для работы с сервисной СУБД:

MONGODB_CONNECTION_STRING

WIDGETS_ORLEANS_SILO_MONGO_CLUSTERING_DATABASE_NAME

WIDGETS_ORLEANS_SILO_MONGO_GRAIN_STORAGE_DATABASE_NAME

PREVIEW_STORAGE_MONGO_DATABASE_NAME

STORAGE_SERVICE_MONGO_DATABASE_NAME

IP_BLOCKING_MONGO_DATABASE_NAME

ПРИМЕЧАНИЕ. Если оставить параметры, то работа системы не пострадает.

•появилась команда для обновления брокера сообщений. Если у вас используется версия RabbitMQ 3.7 или 3.11, установленная с помощью Directum Launcher, то вы можете обновить ее до 3.12. Подробнее см. в руководстве администратора, раздел «Обновление RabbitMQ».

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