The <systemService> element may be used as a targeter for the <checkDependency>, <createDependency>, <call>, <uninstall>, and <addSnapshot> steps. It identifies a particular system service component that is assumed to be installed on the current physical host.
Use of the <systemService> targeter implicitly retargets to the root physical host of the current host. If one needs to target a system service on a different host, a <retarget> step must be used. One cannot otherwise name a new host within the <systemService> targeter.
Name |
Type |
Required |
Configurable |
Description |
---|---|---|---|---|
name |
entityName |
Yes |
No |
The name of the installed component. |
path |
pathReference |
No |
No |
The path of the component. If unspecified, the path of the containing entity is assumed. |
version |
version |
No |
No |
The version of the installed component. If unspecified, the most recently installed component with any version is used. |
versionOp |
One of:" “=” “>=” “>” |
No |
No |
Specifies the operator to use when comparing the version attribute against versions of components installed on the target host. If more than one installed component applies, the most recently installed is used. If unspecified, ">=" is used by default. Ignored if version unspecified. |
only Compat |
Boolean |
No |
No |
If true, specifies that only components that are call compatible with the component having the named version should be matched. If true, a component with the named version must exist. If unspecified, “false” is used by default. Ignored if version unspecified. |
installPath |
String |
No |
Yes |
The install path of the installed component. If unspecified, the most recently installed component in any path is used. The value is converted to universal format prior to component resolution. |
host |
string |
No |
Yes |
The host on which the component is installed. Defaults to the current host. See the <retarget> step host attribute for details. |
Name |
Type |
Required |
Configurable |
Description |
---|---|---|---|---|
name |
systemName |
Yes |
No |
The name of the system service component. |