N1 Service Provisioning System 4.1 Reference Guide

The componentRef/component Element

The <component> child element of the <componentRef> element identifies the referenced component. It has the same structure as the <component> repository component targeter, except that the "host" attribute is not permitted. The referenced component version must exist in the repository at the time the containing component is saved.


Note –

If the "version" attribute is not specified, then the version is resolved to the latest version of the referenced component that exists at the time the containing component is saved. It is a save time error if no versions of the referenced component exist. Once the containing component is saved, the versions of all the components it references are locked, and cannot be modified without creating a new version of the containing component.


The installList Element

The <installList> element is a child of the <component> element and contains one or more named install step blocks, each providing a different way to install this component. Many components will have only one install block as a child of this element.

Multiple install blocks can be used when different steps are required for different installation environments. For example, steps to deploy an EBJ app to a server cluster versus deploy to a single managed server, or steps to install for the first time versus steps to upgrade the application.

installList Child elements

Name 

How Many? 

Description 

installSteps 

1 or more 

A named install block containing steps that may be executed to install this component.  

installList Inheritance and Overriding

By default, a derived component inherits the accessible <installList> element contents of its base component. When a derived component declares an <installList>, its contents are effectively merged with those of the base component. The derived component may declare new <installSteps> elements and override inherited ones, but may not remove elements declared by the base component.