The AdminServer's managed database and ubroker settings are found in the following files:
- conmgr.properties contains database configuration information for databases managed by the AdminServer
- ubroker.properties contains configuration information about unified broker resources (NameServer, AppServer, Webspeed etc)
When the new version of the AdminServer starts up and finds .properties files that need updating, it makes the necessary corrections for the new version changes to the prior versions entries.
To upgrade an older version conmgr.properties or ubroker.properties file to a newer version:
- Backup the ubroker.properties and conmgr.properties from the existing installation DLC\properties directory
- Install the new OpenEdge version (always backup the properties folder before installing a new version on the same machine)
- If the same ubroker.properties file is used concurrently on several systems across the same network, regenerate new UUIDs for each broker for the new deployment. See Article What do the UUID's found within the ubroker.properties file require uniqueness against?
- Place the ubroker.properties and conmgr.properties files into the new installation's DLC\properties directory ensuring permissions are correct otherwise conversion will fail.
- Stop and restart the AdminServer to upgrade the properties files.
The reason that the AdminServer needs to be restarted is that the .properties files are overwriting the current files so configurations of the file being copied will not be recognized while still running. It is only when .properties files are manually edited or the mergeprop utility is used when the AdminServer is online that new instances updated within the current files are recognised.
As an alternative to the above, after installing the new version:
- Stop the AdminServer
- Replace the conmgr.properties and ubroker.properties (as detailed above)
- Restart the AdminServer which will convert the properties files
A method commonly (but incorrectly) used to migrate configuration property files is
MERGEPROP.
The mergeprop utility was never intended to be used for upgrading .properties from older versions.
MERGEPROP is meant to be used to create/update/delete instances in a given .properties file of the
same version.
- If there have been no changes to the .properties files between versions, then mergeprop will work.
- If the changes between versions are understood, mergeprop will work.
Otherwise, specifically in cases where properties have been
deprecated or
renamed or are
new mandatory entries, while mergeprop will populate the new version with the old version's values, it will not make the necessary corrections for new version changes. That is what the AdminServer does when it finds a .properties file that needs updating when it starts up.
Since
OpenEdge 11.7, a new feature:
configutil was introduced to manage properties files transfer between earlier and later OpenEdge 11.7 installations on the same or different machines. For further information refer to:
