Обновление 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, который маршрутизирует все сообщения.
Настройка:
- Установите MessageBroker через установщик HR Pro.
- Настройте конфигурационные файлы:
- MessageBroker.exe.config
- appsettings.json
- Убедитесь, что все сервисы (хранилища, подписание, веб-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 необходимо синхронизировать библиотеки Кадрового ЭДО.
Пошагово:
- Перенесите папку Templates в корень диска (например, C:\Templates).
- Запустите командную строку от имени администратора.
- Выполните команду:
"C:\Program Files\Directum Company\DirectumRX\Utilities\DrxUtil\drxutil.exe" -s "C:\Templates" -n Administrator -p 11111
- Проверьте, обновилась ли библиотека SungeroDomainInterfaces в папке:
DirectumRX\bin\AppliedModules
- Скопируйте её в:
- EssBaseRxWebApi\bin
- HRSolutionWebApi\bin
- Перезагрузите пулы приложений в IIS.
Если после запуска появляется ошибка — повторите процедуру. Иногда требуется несколько попыток.
Шаг 5: Тестирование и проверка
После всех настроек — тестируем:
- Личный кабинет — открывается ли, работает ли подписание.
- Создание документов — корректно ли заполняются поля из оргструктуры.
- Согласование — проходят ли маршруты, приходят ли уведомления.
- Интеграции — работают ли внешние подключения (например, к 1С или «Галактике»).
Совет: Используйте Google Chrome для тестирования — он лучше всего поддерживает плагины ЭП и веб-интерфейсы.
Итог: чек-лист обновления HR Pro до 1.9
- Поэтапное обновление: 1.5 → 1.9
- Установка и настройка MessageBroker
- Настройка всех сервисов на HTTPS
- Обновление сертификатов ЭП и установка KB4474419
- Очистка отпечатков сертификатов от невидимых символов
- Обновление библиотек КЭДО через DrxUtil
- Перезагрузка пулов приложений в IIS
- Тестирование ЛК и бизнес-процессов
Заключение
Обновление HR Pro до версии 1.9 — это масштабная работа, требующая внимания к деталям. Многие ошибки возникают не из-за сложности системы, а из-за мелких, но критичных упущений: невидимые символы в отпечатках, отсутствие обновлений ОС, пропущенные шаги в инструкции.
В ЦВД мы прошли этот путь не раз. Если вы планируете обновление — не делайте это в одиночку. Мы поможем подготовить план, сопроводить процесс и минимизировать риски.