Перенос параметров старта баз данных из OpenEdge Management 11.7 в OpenEdge Management 12.8

В OpenEdge 11.7 появилась утилита configutil, предназначенная для миграции файлов свойств между различными версиями продукта — как более ранними, так и более поздними. Ниже приведён пошаговый алгоритм переноса параметров старта баз данных при обновлении с OpenEdge Management (OEM) версии 11.7 до версии 12.8.

Подготовка файла конфигурации в OpenEdge 11.7

Скопируйте файл %DLC%/install/configbackup/configutil.properties в рабочую директорию (например, в %WRKDIR%).

Отредактируйте скопированный файл:

• оставьте только строку [$DLC/properties/conmgr.properties];
• удалите остальные строки;
• сохраните значения переменных OVERRIDE_PATHS и OVERRIDE_HOSTNAME по умолчанию (false).

После редактирования содержимое файла configutil.properties должно выглядеть следующим образом:

[Environment]
OVERRIDE_PATHS=false
OVERRIDE_HOSTNAME=false

[$DLC/properties/conmgr.properties]

Экспорт конфигурации из OpenEdge 11.7

Откройте командную строку proenvдля OpenEdge 11.7.

Выполните команду экспорта:

configutil export -backupdir %WRKDIR% -propFile %WRKDIR%\configutil.properties

В результате будет создан архив с экспортированными параметрами конфигурации.

Configurations successfully exported at location: D:\Progress117\WRK\export260127145227.zip

Импорт конфигурации в OpenEdge 12.8

Откройте командную строку proenv для OpenEdge 12.8.

Выполните команду импорта, указав путь к созданному ранее архиву:

configutil import -backupfile D:\Progress117\WRK\export260127145227.zip

После завершения импорта система создаст бэкап исходной конфигурации.
Путь к бэкапу будет отображён в консоли, например:

Import Successful
Backup of original configurations saved at location: V:\Progress128\WRK\backup\importArchives\2026_01_27_15_22_34\import_backup.zip

Перезапуск служб

После импорта конфигурации необходимо перезапустить админсервер и OEM 12.8.

Остановите службы:

fathom -stop
proadsv -stop

Запустите службы:

proadsv -start
fathom-start

Возврат к исходной конфигурации (при необходимости)

Если потребуется восстановить исходную конфигурацию, выполните команду:

configutil undoimport -importbackupfile V:\Progress128\WRK\backup\importArchives\2026_01_27_15_22_34\import_backup.zip

где путь к файлу бэкапа указывается согласно информации, выведенной при импорте.

Важные замечания

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

Если установить OVERRIDE_PATHS=true, то пути к базам данных будут перенесены в файл conmgr.properties. В этом случае рекомендуется:

• проверить и при необходимости скорректировать пути к базам данных;
• для базы данных fathomtrenddatabase проверить и исправить номер порта в свойстве port
  (он также может быть заменён на значение из старой версии).

Внесение изменений. Корректировки путей и портов можно выполнить:

• вручную в файле conmgr.properties — до перезапуска админсервера и OEM;
• через веб‑интерфейс OEM — после запуска служб.

Заключение

Описанный процесс обеспечивает корректный перенос параметров старта баз данных между версиями OpenEdge Management.
При соблюдении указанных шагов и учёте особых случаев минимизируется риск ошибок и потери данных при обновлении системы.

Для получения дополнительной информации обратитесь к официальной документации OpenEdge:

• Migrating Progress versions, can existing conmgr.properties and ubroker.properties be used in the migrated version?
• How to import configuration into new installation
• Configutil operations