Обновление HR Pro до версии 1.9: как мы прошли путь с 1.5 до 1.9 на Directum RX 4.5

В этом материале — наш подробный опыт поэтапного обновления, включая настройку MessageBroker, работу с сертификатами ЭП, обновление сервисов и преодоление подводных камней на старых серверах.
Почему поэтапное обновление?
HR Pro не обновляется «одним кликом» с 1.5 до 1.9. Между версиями есть критические изменения, требующие промежуточных шагов:
— 1.5 → 1.6 → 1.7 → 1.8 → 1.9
Каждый этап требует:
— Установки новой версии модификации.
— Регистрации и настройки сервисов.
— Проверки совместимости с платформой.
Совет: Не пропускайте версии. Даже если в описании указано, что можно обновляться напрямую — лучше пройти все шаги. Это снижает риск ошибок и потери данных.
Шаг 1: Настройка MessageBroker — новый брокер от вендора
Одно из ключевых изменений в HR Pro 1.9 — переход на MessageBroker как единый шлюз для обмена сообщениями между сервисами.
Что изменилось:
— Раньше использовались отдельные сервисы: DirectumRX.MessageBroker.Service, DirectumRX.SignatureService и др.
— Теперь — единый сервис MessageBroker, который маршрутизирует все сообщения.
Настройка:
1. Установите MessageBroker через установщик HR Pro.
2. Настройте конфигурационные файлы:
— MessageBroker.exe.config
— appsettings.json
3. Убедитесь, что все сервисы (хранилища, подписание, веб-API) указывают на https://ваш-сервер:8090.
Важно: Используйте HTTPS — это обязательное требование. Даже если в инструкции указан http, в продакшене должен быть только https.
Шаг 2: Обновление сервиса подписания и хранилищ
После настройки MessageBroker необходимо обновить и другие сервисы.
Что обновляем:
— Сервис подписания — теперь работает через MessageBroker.
— Сервис хранилищ — обеспечивает работу с файлами и вложениями.
— Web-API — для интеграции с Личным кабинетом и внешними системами.
Ключевые действия:
— Убедитесь, что все пути в конфигах корректны.
— Проверьте права доступа к папкам и базе данных.
— Перезапустите пулы приложений в IIS.
Ошибка: Если сервис не запускается — проверьте сертификаты ЭП. Часто проблема именно в них.
Шаг 3: Сертификаты ЭП — ловушки на старых серверах
Один из самых болезненных моментов — обновление сертификатов электронной подписи на серверах с Windows Server 2012 R2.
Проблема: Новые сертификаты используют алгоритм SHA256, который не поддерживается по умолчанию на старых ОС.
Решение:
— Установите обновление KB4474419 для Windows Server 2012 R2.
— После установки — перезагрузите сервер.
— Только после этого импортируйте сертификаты в хранилище Local Machine.
Дополнительно:
— При копировании отпечатка сертификата из MMC (оснастки управления сертификатами) копируются невидимые символы.
— Чтобы избежать ошибок — вставьте отпечаток сначала в Блокнот, удалите все пробелы и лишние символы, затем используйте чистую строку.
Шаг 4: DrxUtil и обновление библиотек КЭДО
После установки новой версии HR Pro необходимо синхронизировать библиотеки Кадрового ЭДО.
Пошагово:
1. Перенесите папку Templates в корень диска (например, C:\Templates).
2. Запустите командную строку от имени администратора.
3. Выполните команду:
"C:\Program Files\Directum Company\DirectumRX\Utilities\DrxUtil\drxutil.exe" -s "C:\Templates" -n Administrator -p 11111
4. Проверьте, обновилась ли библиотека SungeroDomainInterfaces в папке:
DirectumRX\bin\AppliedModules
5. Скопируйте её в:
— EssBaseRxWebApi\bin
— HRSolutionWebApi\bin
6. Перезагрузите пулы приложений в IIS.
Если после запуска появляется ошибка — повторите процедуру. Иногда требуется несколько попыток.
Шаг 5: Тестирование и проверка
После всех настроек — тестируем:
1. Личный кабинет — открывается ли, работает ли подписание.
2. Создание документов — корректно ли заполняются поля из оргструктуры.
3. Согласование — проходят ли маршруты, приходят ли уведомления.
4. Интеграции — работают ли внешние подключения (например, к 1С или «Галактике»).
Совет: Используйте Google Chrome для тестирования — он лучше всего поддерживает плагины ЭП и веб-интерфейсы.
Итог: чек-лист обновления HR Pro до 1.9
1. Поэтапное обновление: 1.5 → 1.9
2. Установка и настройка MessageBroker
3. Настройка всех сервисов на HTTPS
4. Обновление сертификатов ЭП и установка KB4474419
5. Очистка отпечатков сертификатов от невидимых символов
6. Обновление библиотек КЭДО через DrxUtil
7. Перезагрузка пулов приложений в IIS
8. Тестирование ЛК и бизнес-процессов
Заключение
Обновление HR Pro до версии 1.9 — это масштабная работа, требующая внимания к деталям. Многие ошибки возникают не из-за сложности системы, а из-за мелких, но критичных упущений: невидимые символы в отпечатках, отсутствие обновлений ОС, пропущенные шаги в инструкции.
В ЦВД мы прошли этот путь не раз. Если вы планируете обновление — не делайте это в одиночку. Мы поможем подготовить план, сопроводить процесс и минимизировать риски.
— Бесплатная консультация по сценариям вашей интеграции
— Демонстрация решения в течение 24 часов