ЦВД
14 июля 2022 г. 5 мин

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

Обновление или установка решения Directum HR Pro — процесс, который требует внимания к деталям. Даже небольшая ошибка в настройке сервиса или копировании сертификата может привести к сбоям в работе системы, проблемам с подписанием документов или остановке бизнес-процессов.
Особенности установки и обновления Directum HR Pro: советы от ЦВД

В этой статье — практические рекомендации от наших экспертов, основанные на реальных кейсах внедрения HR Pro. Поделимся тонкостями, которые не всегда указаны в официальных инструкциях, но критически важны для стабильной работы.

Установка: начните с правильной инструкции

При обновлении HR Pro (например, с версии 1.5 до 1.6) не используйте инструкцию по обновлению, если в ней отсутствуют ключевые шаги по регистрации сервисов.

Рекомендация: Даже при обновлении — руководствуйтесь инструкцией по установке. Она содержит полный список действий, включая:

  • Регистрацию сервиса хранилищ.
  • Настройку сервиса подписания.
  • Привязку к HTTPS.

Это помогает избежать ошибок, связанных с пропущенными шагами.

HTTPS — везде и всегда

Протокол https — не рекомендация, а обязательное требование для всех сервисов HR Pro.

Что важно:

  • Укажите https в настройках всех сервисов: хранилищ, подписания, сообщений, веб-API.
  • Даже если в инструкции указан http — используйте https.
  • Убедитесь, что сертификаты установлены и доверены на сервере.

Нарушение этого правила — частая причина ошибок при вызове внешних сервисов.

Работа с DrxUtil: подготовка и запуск

Утилита DrxUtil.exe — мощный инструмент для импорта/экспорта модификаций, но она требует правильной настройки.

Пошаговая инструкция:

  1. Перенесите папку Templates в корень диска (например, C:\Templates).
  2. Запустите командную строку от имени администратора.
  3. Выполните команду:

"C:\Program Files\Directum Company\DirectumRX\Utilities\DrxUtil\drxutil.exe" -s "C:\Templates" -n Administrator -p 11111

Совет: Используйте простой пароль для тестовых стендов, чтобы избежать проблем с экранированием спецсимволов.

Обновление библиотек КЭДО — критически важный шаг

При разработке или обновлении системы не забывайте синхронизировать библиотеки КЭДО (Кадровый ЭДО).

Что делать:

  1. После внесения изменений запустите команду из инструкции «Directum HR Pro. Процессы 1.4. Описание модуля Кадровый ЭДО».
  2. Проверьте, обновилась ли библиотека SungeroDomainInterfaces в папке:

DirectumRX\bin\AppliedModules

  1. Скопируйте эту библиотеку в папки:
    • EssBaseRxWebApi\bin
    • HRSolutionWebApi\bin
  2. Перезагрузите пулы приложений в IIS.

Если после запуска появляется ошибка — повторите процедуру. Иногда требуется несколько попыток для полной синхронизации.

Личный кабинет: браузер имеет значение

Для настройки и тестирования Личного кабинета (ЛК) рекомендуем использовать Google Chrome.

Почему:

  • Наиболее стабильная поддержка Web-интерфейсов Directum.
  • Корректная работа с плагинами ЭП и веб-формами.
  • Минимальное количество конфликтов с JavaScript.

Альтернативы: Edge (на Chromium) — тоже подходит. Избегайте Internet Explorer.

Сертификаты ЭП: ловушки при работе со старыми системами

Один из самых коварных моментов — установка сертификатов подписания на старых версиях Windows (например, Windows Server 2012 R2).

Проблема: При копировании отпечатка сертификата из MMC (оснастки управления сертификатами) копируются невидимые символы, что приводит к ошибкам при запуске сервиса.

Решение:

  1. Скопируйте отпечаток в Блокнот.
  2. Удалите все пробелы и лишние символы.
  3. Вставьте чистый отпечаток в JSON-файлы конфигурации.
  4. Проверьте, что в файле нет лишних пробелов или символов UTF-8.

Дополнительно:

  • Не создавайте .pfx-файлы с шифрованием SHA256, если они будут использоваться на старых системах.
  • Чтобы использовать сертификат на старой платформе, импортируйте его на современной ОС с поддержкой SHA256, экспортируйте с галочкой «Разрешить экпорт закрытого ключа», затем экспортируйте обратно с шифрованием 3DES-SHA1.

Управление файлами: не забывайте о службах

Перед тем как удалять или изменять файлы в папке Id (например, при обновлении IdentityService), обязательно остановите службу Directum RX.

Почему:

  • Служба блокирует файлы, и удалить их будет невозможно.
  • Это может привести к ошибкам при последующем запуске.

Порядок действий:

  1. Остановите службу Directum RX.
  2. Выполните операции с файлами.
  3. Запустите службу обратно.

Что можно пропустить при обновлении?

Не все шаги из инструкций нужно выполнять каждый раз.

Важно: Пункты, связанные с удалением содержимого папок AppliedModules, bin, Templates и т.п., можно пропустить, если вы не обновляете сам дистрибутив платформы.

Файлы заменяются автоматически при установке новой версии. Ручное удаление может привести к потере данных.

Итог: чек-лист для успешного обновления HR Pro

  1. Использована инструкция по установке, а не обновлению
  2. Все сервисы настроены на https
  3. DrxUtil запущен от администратора с правильным путём
  4. Библиотеки КЭДО синхронизированы и перезагружены в IIS
  5. Отпечатки сертификатов очищены от невидимых символов
  6. Служба Directum RX остановлена перед удалением файлов
  7. ЛК тестируется в Google Chrome

Заключение

Установка и обновление Directum HR Pro — не просто следование инструкции, а понимание подводных камней. Многие ошибки возникают не из-за сложности системы, а из-за мелких, но критичных упущений.

В ЦВД мы сталкиваемся с этими кейсами ежедневно. Если вы планируете обновление — обратитесь к нам за консультацией. Поможем избежать простоев и сэкономить время.

Подбор решения за 60 секунд
Ответьте на 4 коротких вопроса, и мы бесплатно подберём для вас оптимальное решение на базе Directum RX