Chapter 9: Importing and Exporting Application Components

Creating merge files

Merge files must exist in the same directory as the properties file to merge with, and have the same base name with the .merge extension. For example, to merge properties for server Jaguar, the JAR file must contain these files:

Server/Jaguar.props
Server/Jaguar.merge

If a property is set in the merge file and in the .props file, the value is merged based on the merge-file setting, and the .props file setting is ignored. If a property is not set by either the merge file or in the .props file, it is left as is when the archive is imported. Merge files are text files, with one merge operation per line. Each merge operation uses the syntax:

MergeOperation:Property=NewValue

Where:

MergeOperation is an operation listed in Table 9-2.
Property is the property name.
NewValue is the value to be merged with or removed from the existing value.

**Table 9-2: Merge operations**
Merge operation	Action
SetDefault	If the property is not set, or set with no value, set the property to the specified value. No action if the property is already set.
AppendToList	For properties that take comma-separated lists of values, append the specified value to the existing value and remove duplicate entries.
PrependToList	For properties that take comma-separated lists of values, prepend the specified value to the existing value and remove duplicate entries.
RemoveFromList	For properties that take comma-separated lists of values, remote the specified entry to the existing value.
Delete	Remove the property entirely.

Example merge operations

This example uses the AppendToList and RemoveFromList operations. For a server, this syntax could be used to remove an old version of a package and install a new version:

RemoveFromList:com.sybase.jaguar.server.packages=OEMPackageVersion1 
AppendToList:com.sybase.jaguar.server.packages=OEMPackageVersion2

This example deletes the com.sybase.jaguar.server.timeout property:

Delete:com.sybase.jaguar.server.timeout

View this book as PDF