<installedComponent> Installed Component Targeter

The <installedComponent> element identifies a particular installed component that is assumed to be installed on the target host.

This element can be used as a targeter for the <checkDependency>, <createDependency>, <call>, <uninstall>, and <addSnapshot> steps.

This targeter matches the specified component directly and cannot be used to match derived instances of that component. Use the <systemType> targeter to target components that are derived from a particular type.

Attributes for the <installedComponent> Targeter

This targeter has the following attributes:

• name – A required attribute of type entityName, which is the name of the installed component.

• path – An optional attribute of type pathReference, which is the path of the component. If this attribute is omitted, the path of the containing entity is assumed.

• version – An optional attribute of type version, which is the version of the installed component. If this attribute is omitted, the most recently installed component, regardless of the version, is used.

• versionOp – An optional attribute that specifies the operator to use when comparing the version attribute with versions of components that are installed on the target host. If more than one installed component applies, the most recently installed component is used. These values are permitted: =, >=, and >.

  The >= operator is used by default. If version is not specified, versionOp is ignored.

• onlyCompat – An optional attribute that specifies the components that should match.

  If the value is true, only components that are call compatible with the component of version version should be matched. A component of version version must exist. By default, the value is false. If version is omitted, this element is ignored.

• installPath – An optional attribute that is the install path of the installed component. If this attribute is omitted, the most recently installed component in any path is used. The value is converted to universal format prior to component resolution. This attribute can reference simple substitution variables.

• host – An optional attribute that is the host on which the component is installed. By default, host is the current host. See the description of the host attribute in Attributes for the <retarget> Step. This attribute can reference simple substitution variables.