Custom Distribution Mastering Toolkit

Specifying the upgrade versions

To specify the previous versions of the component to upgrade, use the upgradeVersions attribute.

Set upgradeVersions in the COMP record in the .cmpnt file:

   COMP:vendorCode:componentCode:
   upgradeVersions = versionExpr

where versionExpr is a regular expression. For information about regular expressions, see regexp(TCL).

For example, to specify an upgrade of the WServer component from either 4.0.0a or 4.2.0a to version 5.0.0a, use these record attributes in the .cmpnt file:

   COMP:SCO:WServer:
   version		= 5.0.0a
   upgradeVersions = ^4\\.0\\.0a$
   upgradeVersions = ^4\\.2\\.0a$

NOTE: The string ``^4\\.2\\.0a$'' is a regular expression which matches the version ``4.2.0a'' and nothing else.

Another way to write the two upgradeVersions lines is:

   upgradeVersions = ^4\\.[02]\\.0a$

If more than one version of the component installed on the system matches the upgradeVersions attribute, custom(ADM) upgrades the latest version only. In the example, if both version COMP:SCO:WServer:4.0.0a and version COMP:SCO:WServer:4.2.0a are installed on the system, custom upgrades only version 4.2.0a to version 5.0.0a.

If the name of a component changes between versions or a package changes from one component to another, you must use the upgradeMapping attribute in the COMP record. See ``Specifying packages to upgrade''.