After installing OpenEdge, you may have customized the configuration files, such as adding new servers, changing ports, and changing logging levels. All these customizations are typically stored in some configuration files such as .properties, .xml, and .pf files, or in the Windows registry. The configutil utility allows you to capture these configuration changes and preserve them so that they can be applied to a different OpenEdge installation. This process of capturing the existing configuration setting is referred to as the export operation. This process creates a zip file named exporttimestamp.zip.

The configutil utility allows you to apply the exported zip file on another OpenEdge installation such that all your configuration settings from the installation of an earlier version of OpenEdge are applied to the new installation. This process is the import operation.

After an import, if you want to revert to your original configuration, the configutil utility allows you to do so using the undoimport option.

Configutil export operation

This operation exports all the settings stored in configuration files and registry keys that are specified in the configutil.properties file in the install-dir/install/configbackup directory. You can create a custom.properties file to contain only the list of files and registry entries that you want to export and use the -propFile option to specify the custom file. The syntax for the export operation follows:
Export Usage: configutil export [option]
The options are as follows:
  -backupdir  The directory where the exported zip file will be stored
              	         Defaults to $WRKDIR/backup
  -propFile   The user defined configutil.properties file   
                           Defaults to $DLC/install/configbackup/configutil.properties
The configutil export creates the exporttime_stamp.zip file that contains the following files:
  • configuration.xml—Contains all the file contents
  • OEImport.properties—Contains a list of files and environment variables
  • export_info—Contains information on the version, operating system, and details about the OpenEdge installation
Proenv> configutil export

Configurations successfully exported at location: C:\DLCWOR~1\WRK\backup\export161117072437.zip

In the preceding example, because -backupdir is not provided, the utility exports the settings to $WRKDIR/backup/exporttimestamp.zip.

By default, the utility exports all settings to the $DLC/install/configbackup/configutil.properties file. You may specify a different location using the -propFile option.

The following is another example:

Proenv> configutil export -backupdir /custom/directory -propFile /custom/myconfigutil.properties

Configurations successfully exported at location: /custom/directory/export161117072437.zip

Because the -backupdir option is specified, configutil exports the settings to the /custom/directory/exporttime_stamp.zip file.

Because the -propFile option is specified, the utility exports all the settings stored in files and registries that are specified in the myconfigutil.properties file.

Configutil import operation

This operation imports the settings in the exported zip file and applies it to the new installation. If there is a setting with a different value on the target machine, the import operation overwrites the value contained in the exported setting. If a setting is not present on the source machine but does exist on the target machine, then the import operation leaves the target setting as is. It does not delete the setting from the target machine. The following is the syntax for the import operation:

Import Usage: configutil import -backupfile backup zip path

The options are as follows:
  - backupfile The directory path where the exported file (export Timestamp.zip) is saved on the
machine where you want to import the settings of another OpenEdge installation. The default path
is WRKDIR/backup.

If you comment out a setting in the configuration.properties file, the setting is not overwritten during import.

proenv>configutil import -backupfile C:\DLCWOR~1\WRK\backup\export161117072437.zip

In the example, the utility will import the settings from the export161117072437.zip file.

Configutil undoimport operation

This operation reverts the import operation. The import option also creates a backup of existing settings of the target machine before the exported settings are applied. The backup is stored as the $WRKDIR/backup/import_archive/Time_Stamp/import_backup.zip file. To undo the import operation, you can use this archive to restore the original configuration. The following is the syntax for the undoimport operation:

Undo Import Usage: configutil undoimport -importbackupfile import backup zip path

The options are as follows:
  -importbackupfile The directory path $WRKDIR/backup/import_archive/<Time_Stamp>/import_backup.zip where the backup file is saved during the import operation.