Overview

The Universal Products Install Merge (UPIMERGE) utility merges options and values from one Universal Agent component configuration file or component definition file with another.

Merging during Upgrades

UPIMERGE runs automatically during Universal Agent installation upgrades on UNIX and Windows. During the install, UPIMERGE combines options and values from existing configuration and component definition files with the options and values in the most recent versions of those files (delivered with the distribution package).

The result of each merge is a single file, with preserved options and values residing alongside any new options and values that were introduced to support new Universal Agent features.

Merging at any Time

The Universal Agent (UNIX and Windows) and Universal Enterprise Controller (Windows only) distribution packages also install UPIMERGE. This makes UPIMERGE available at any time for recovering archived options and values and merging them with the most recent options and values.

When used to update a Universal Agent configuration or component definition file, UPIMERGE must run with a user account that has write access to the output file. This typically means administrative access (that is, root on UNIX, Administrator on Windows).

Examples

The following pages provide examples of how configuration files can be merged:

• Files Used in UPI Merge Examples
• Merge Configuration Files Using Program Defaults
• Merge Configuration Files Introducing New Options
• Merge Configuration Files Using Installation-Dependent Values

These examples illustrate the merging of Universal Agent (for Windows or UNIX) components' configuration options using the Universal Products Install Merge (UPI) component.