N1 Service Provisioning System 4.1 Reference Guide

The toplevelRef Repository Component Targeter

The <toplevelRef> element may be used as a targeter for the <install> step. It identifies a toplevel component reference declared or inherited by the current composite component. Only steps within composite components may use this targeter.

This targeter is semantically equivalent to the <component> targeter, except that the "name", "path" and "version" attributes are predefined based on the referenced component. A toplevel component reference may be installed any number of times on any number of hosts.

toplevelRef Targeter Attributes

Name 

Type 

Required 

Configurable 

Description 

name 

identifier 

Yes 

No 

The name of a toplevel component reference within this component. 

host 

String 

No 

Yes 

The host on which the referenced component is to be installed. Defaults to the current host. See the <retarget> step host attribute for details.