Администрирование (Linux) > Обновление системы > Обновление в рамках версии 4.9

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

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

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

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, то при запуске инструмента установки возникнет ошибка. Проверьте, что все нужные архивы есть в папке.

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

Компонент	От какого компонента зависит
DirectumRX	Platform
WebHelp	Platform

ВАЖНО. Для корректного обновления общий путь к файлам должен быть не более 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 и заполнены настройки веб-сервера и сервисов.

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

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

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

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

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.Если сервисы Directum RX перенесены на отдельный сервер, то после обновления системы обновите перенесенные сервисы. Подробнее см. в разделе «Обновление сервисов на выделенном сервере».