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 Window’s 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 export<timestamp>.zip.
The configutil utility allows you to apply the exported zip file on another OpenEdge 11.7 installation such that all your configuration settings from the earlier OpenEdge 11.7 installation 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
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 location. 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. Here is the syntax for the export operation:
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 export<time_stamp>.zip file that contains the following files:
The configuration.xml file that contains all the file contents.
The OEImport.properties file that contains a list of files and environment variables.
The export_info file that contains information on the version, operating system, and bit of OpenEdge installation.
Example
Proenv> configutil export
Configurations successfully exported at location: C:\DLCWOR~1\WRK\backup\export161117072437.zip
In the example, since -backupdir is not provided, the utility will export the settings to $WRKDIR/backup/export<timestamp>.zip.
By default, the utility will export all settings to $DLC/install/configbackup/configutil.properties. You may specify a different location using -propFile.
Configurations successfully exported at location: /custom/directory/export161117072437.zip
Since -backupdir is provided, the utility will export the settings to the /custom/directory/export<time_stamp>.zip file.
Since -propFile is provided, the utility will export all the settings stored in files and registries that are specified in the myconfigutil.properties file.
Configutil Import
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, the import operation leaves the target setting as is. In other words, it will not delete the setting from the target machine. Here 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 commented out a setting in the configuration.properties file, the setting is not overwritten during import.
In the example, the utility will import the settings from the export161117072437.zip file.
Configutil Undoimport
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 $WRKDIR/backup/import_archive/<Time_Stamp>/import_backup.zip. To undo the import operation, you can use this archive to restore the original configuration. Here 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.
The configuration.xml file that contains all the file contents.