ВАЖНО. С версии 4.2 изменено расположение файлов системы. Для установки, обновления и настройки системы используется кроссплатформенный инструмент Directum Launcher. Он поставляется в виде архива, который нужно распаковать. В распакованной папке хранится дистрибутив системы. Туда же при обновлении системы копируются файлы веб-сервера и сервисов Directum RX. Для корректной работы системы папку удалять нельзя.

Чтобы обновить систему с версии 4.1 на 4.3:

1.До обновления:

•откройте среду разработки и убедитесь, что все изменения отправлены на Git-сервер. Разработанные вами решения останутся на Git-сервере и не затрутся во время обновления среды разработки;

ВАЖНО. После проверки отправки изменений на Git-сервер закройте среду разработки. Если среду разработки оставить открытой, то при обновлении возникнут ошибки.

•в оснастке Диспетчер служб IIS остановите ранее использовавшийся сайт Directum RX;

•в оснастке Службы остановите службу DrxServiceRunner;

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

use admin

db.grantRolesToUser('mongoUser', [{role: 'readWrite', db: 'sungero_widgets_clustering'},{ role: "readWrite", db: "sungero_widgets"},{ role: "readWrite", db: "Sungero_StorageService"}])

2.Архив с Directum Launcher распакуйте в локальную папку на сервере. В корень папки скопируйте архивы:

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

•DevelopmentStudio.zip – среда разработки.

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

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

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

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

5.В правом верхнем углу появится диалог с предложением обновить настройки системы. Нажмите на кнопку Обновить:

Примечание. При бездействии диалог скрывается. Чтобы вызвать его повторно, обновите страницу в браузере. Если после этого диалог не появляется, закройте браузер и командную строку и проверьте, что оба процесса выгружены из памяти. После этого заново запустите файл DirectumLauncher.exe.

В результате из отдельных конфигурационных XML-файлов предыдущей версии системы сгенерируется конфигурационный файл config.yml. На странице заполнятся поля с минимально необходимыми настройками. Подробнее см. в руководстве администратора, разделы «Установка системы (Directum Launcher)» и «Конфигурирование настроек».

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

ПРИМЕЧАНИЕ. Если для соединения с базой данных используется Windows-аутентификация, то в конфигурационном файле DirectumLauncher\etc\config.yml в секции ServiceRunner проверьте, что параметры WINDOWS_USERNAME и WINDOWS_PASSWORD заполнены верно.

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

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

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

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

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

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

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

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

11.После обновления настройте систему и адаптируйте свою разработку.

12.Выполните обновление системы с версии 4.3 на 4.5.

Настройка системы и адаптация разработки

1.Запустите среду разработки.

2.Откройте список изменений. Если в списке появились изменения, зафиксируйте их и отправьте на Git-сервер.

3.Импортируйте пакет разработки с базовым решением из папки:

DirectumLauncher\etc\_builds\DirectumRX\<Версия>\DirectumRXbase.dat

4.В версии 4.2 появился фоновый процесс «Закрытие неактивных учетных записей». При первом запуске фонового процесса закроются учетные записи пользователей, которые не заходили в систему 90 дней и более. Если закроются учетные записи пользователей, созданных для тестирования, эти пользователи не смогут войти в систему. При необходимости вручную переведите закрытые учетные записи в действующее состояние и войдите в систему под пользователями.

5.С версии 4.2 четыре сервиса по умолчанию объединены в общем сервисе:

•сервис выполнения блоков задач;

•сервис асинхронных событий;

•сервис отчетов;

•сервис виджетов (появился как отдельный сервис в версии 4.1).

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

ВАЖНО. Для корректной отладки не разделяйте общий сервис на отдельные сервисы на компьютере разработчика.

6.Учтите в своей разработке изменения базового решения Directum RX 4.2 и изменения базового решения Directum RX 4.3.

7.Если помимо стандартного решения Directum RX вы используете другие базовые решения, импортируйте пакеты с обновленными решениями, полученные от поставщика.

8.Выполните сборку решений.

9.Опубликуйте решения. Для этого в окне публикации для базовых и разработанных вами решений измените серое положение ползунка на синее и нажмите на кнопку Опубликовать:

После публикации элементы разработки и изменения выбранных решений появятся в клиентском приложении.

10.Запустите инициализацию в среде разработки.

Подробнее об импорте пакета разработки, сборке, публикации и инициализации решений см. в справке по среде разработки в разделах «Импорт разработки», «Сборка решений», «Публикация решений», «Создание функций инициализации».

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