Особенности установки и обновления Directum HR Pro: советы от ЦВД

В этой статье — практические рекомендации от наших экспертов, основанные на реальных кейсах внедрения HR Pro. Поделимся тонкостями, которые не всегда указаны в официальных инструкциях, но критически важны для стабильной работы.
Установка: начните с правильной инструкции
При обновлении HR Pro (например, с версии 1.5 до 1.6) не используйте инструкцию по обновлению, если в ней отсутствуют ключевые шаги по регистрации сервисов.
Рекомендация: Даже при обновлении — руководствуйтесь инструкцией по установке. Она содержит полный список действий, включая:
- Регистрацию сервиса хранилищ.
- Настройку сервиса подписания.
- Привязку к HTTPS.
Это помогает избежать ошибок, связанных с пропущенными шагами.
HTTPS — везде и всегда
Протокол https — не рекомендация, а обязательное требование для всех сервисов HR Pro.
Что важно:
- Укажите https в настройках всех сервисов: хранилищ, подписания, сообщений, веб-API.
- Даже если в инструкции указан http — используйте https.
- Убедитесь, что сертификаты установлены и доверены на сервере.
Нарушение этого правила — частая причина ошибок при вызове внешних сервисов.
Работа с DrxUtil: подготовка и запуск
Утилита DrxUtil.exe — мощный инструмент для импорта/экспорта модификаций, но она требует правильной настройки.
Пошаговая инструкция:
- Перенесите папку Templates в корень диска (например, C:\Templates).
- Запустите командную строку от имени администратора.
- Выполните команду:
"C:\Program Files\Directum Company\DirectumRX\Utilities\DrxUtil\drxutil.exe" -s "C:\Templates" -n Administrator -p 11111
Совет: Используйте простой пароль для тестовых стендов, чтобы избежать проблем с экранированием спецсимволов.
Обновление библиотек КЭДО — критически важный шаг
При разработке или обновлении системы не забывайте синхронизировать библиотеки КЭДО (Кадровый ЭДО).
Что делать:
- После внесения изменений запустите команду из инструкции «Directum HR Pro. Процессы 1.4. Описание модуля Кадровый ЭДО».
- Проверьте, обновилась ли библиотека SungeroDomainInterfaces в папке:
DirectumRX\bin\AppliedModules
- Скопируйте эту библиотеку в папки:
- EssBaseRxWebApi\bin
- HRSolutionWebApi\bin
- Перезагрузите пулы приложений в IIS.
Если после запуска появляется ошибка — повторите процедуру. Иногда требуется несколько попыток для полной синхронизации.
Личный кабинет: браузер имеет значение
Для настройки и тестирования Личного кабинета (ЛК) рекомендуем использовать Google Chrome.
Почему:
- Наиболее стабильная поддержка Web-интерфейсов Directum.
- Корректная работа с плагинами ЭП и веб-формами.
- Минимальное количество конфликтов с JavaScript.
Альтернативы: Edge (на Chromium) — тоже подходит. Избегайте Internet Explorer.
Сертификаты ЭП: ловушки при работе со старыми системами
Один из самых коварных моментов — установка сертификатов подписания на старых версиях Windows (например, Windows Server 2012 R2).
Проблема: При копировании отпечатка сертификата из MMC (оснастки управления сертификатами) копируются невидимые символы, что приводит к ошибкам при запуске сервиса.
Решение:
- Скопируйте отпечаток в Блокнот.
- Удалите все пробелы и лишние символы.
- Вставьте чистый отпечаток в JSON-файлы конфигурации.
- Проверьте, что в файле нет лишних пробелов или символов UTF-8.
Дополнительно:
- Не создавайте .pfx-файлы с шифрованием SHA256, если они будут использоваться на старых системах.
- Чтобы использовать сертификат на старой платформе, импортируйте его на современной ОС с поддержкой SHA256, экспортируйте с галочкой «Разрешить экпорт закрытого ключа», затем экспортируйте обратно с шифрованием 3DES-SHA1.
Управление файлами: не забывайте о службах
Перед тем как удалять или изменять файлы в папке Id (например, при обновлении IdentityService), обязательно остановите службу Directum RX.
Почему:
- Служба блокирует файлы, и удалить их будет невозможно.
- Это может привести к ошибкам при последующем запуске.
Порядок действий:
- Остановите службу Directum RX.
- Выполните операции с файлами.
- Запустите службу обратно.
Что можно пропустить при обновлении?
Не все шаги из инструкций нужно выполнять каждый раз.
Важно: Пункты, связанные с удалением содержимого папок AppliedModules, bin, Templates и т.п., можно пропустить, если вы не обновляете сам дистрибутив платформы.
Файлы заменяются автоматически при установке новой версии. Ручное удаление может привести к потере данных.
Итог: чек-лист для успешного обновления HR Pro
- Использована инструкция по установке, а не обновлению
- Все сервисы настроены на https
- DrxUtil запущен от администратора с правильным путём
- Библиотеки КЭДО синхронизированы и перезагружены в IIS
- Отпечатки сертификатов очищены от невидимых символов
- Служба Directum RX остановлена перед удалением файлов
- ЛК тестируется в Google Chrome
Заключение
Установка и обновление Directum HR Pro — не просто следование инструкции, а понимание подводных камней. Многие ошибки возникают не из-за сложности системы, а из-за мелких, но критичных упущений.
В ЦВД мы сталкиваемся с этими кейсами ежедневно. Если вы планируете обновление — обратитесь к нам за консультацией. Поможем избежать простоев и сэкономить время.