Custom Distribution Mastering Toolkit

Specifying packages to upgrade

To specify the packages to upgrade to the new version, use the upgradeMapping attribute. This attribute supplements upgradeVersions by providing the ability to upgrade an old component or package name to the new name. Use upgradeMapping in cases where functionality has moved from one component to another between releases or when the names of the packages in a component change.

To use upgradeMapping:

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

   COMP:vendorCode:componentCode:
   upgradeMappings	= vendorCode:componentCode::versionExpr

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

   COMP:SCO:WServer:
   upgradeMappings	= SCO:WServer::^4\\.0\\.0a$

Set upgradeMapping in the PKG record in the .pkg file:

   PKG:packageCode:
   upgradeMappings	= vendorCode:componentCode:packageCode::versionExpr

For example:

   PKG:WServer:
   upgradeMappings	= SCO:WidgetServer:MAN::^3\\.0\\.0$