test

N1 Service Provisioning System 4.1 Reference Guide

Component References

There are a number of steps that reference components. These steps can be divided into two categories:

Steps that reference components that have yet to be installed need only specify the component name and an optional version. However, steps that reference an installed component may additionally specify the install path in which the desired component is located. The installPath is needed in the case of installed component because the same component may be installed multiple times on the same machine.

For example, assume the “apache” component is installed on a host with the following attributes:

Table 1–1 Examples of Component Attributes

Component Instance 

Install Path 

Version 

Install Date 

A 

/opt 

1.3 

6/1/01 5:00 PM 

B 

/usr/local 

1.4 

6/1/01 6:00 PM 

C 

/opt 

1.2 

6/2/01 5:00 PM 

D 

/usr/local/bin 

1.4 

6/3/01 5:00 PM 

E 

/export 

1.1 

6/4/01 5:00 PM 

Table 1–2 shows which installed component is referenced when various combinations of installPath and build version are supplied.

Table 1–2 Component Versions Referenced by Attribute Combination

Install Path 

Version 

Version Op 

Result 

Explanation 

None 

None 

None 

E 

The most recently installed component on the target host is used, regardless of build and installPath. 

/opt 

None 

None 

C 

The most recently installed component in the named install path is used regardless of build. 

/usr/bin 

None 

None 

ERROR 

No component is installed in the named path. 

None 

1.4 

= 

D 

The most recently installed component with the specified build is chosen, regardless of install path. 

None 

1.5 

Any 

ERROR 

No component is installed with the named build. 

/usr/local 

1.4 

=, >= 

B 

The component with the install path and build is chosen. 

/usr/local 

1.2 

= 

ERROR 

No such build at that install path. 

/usr/local 

1.2 

>, >= 

B 

Path, version and version operator match 

/opt 

3 

Any 

ERROR 

If two or more components with the same name are installed in the same path, the most recently installed component effectively overwrites any other components installed earlier. Components installed at an earlier date cannot be accessed, even if named directly.