Attributes and Child Elements of the lockHost Step (What's New in the Sun N1 Service Provisioning System 5.2 Update 2 Release)

What's New in the Sun N1 Service Provisioning System 5.2 Update 2 Release

Attributes and Child Elements of the `lockHost` Step

The lockHost step has the following optional attribute:

`lockHost` Step Attribute Name	Type	Description
`lockingMode`	one of: `VIRTUAL`, `PHYSICAL` or `BOTH`	Indicates type of locking method to use. `VIRTUAL` locking locks only the virtual host. `PHYSICAL` locking locks only the physical host. `BOTH` will lock both the physical host and the virtual host. If the target type of the host on which the plan is being executed is physical, no virtual hosts are locked. `BOTH` is the default. If omitted, `BOTH` is assumed.

lockHost Step Attribute Name

Type

Description

lockingMode

one of: VIRTUAL, PHYSICAL or BOTH

Indicates type of locking method to use. VIRTUAL locking locks only the virtual host. PHYSICAL locking locks only the physical host. BOTH will lock both the physical host and the virtual host.

If the target type of the host on which the plan is being executed is physical, no virtual hosts are locked. BOTH is the default. If omitted, BOTH is assumed.

Note –

It is not possible to lock a physical host and all its virtual hosts with a single lockHost step.

The lockHost step is used to lock a target host for the duration of a step when the implicitLocking attribute of the <simpleSteps> element is set to FALSE. The lockHost step can also be used when the implicitLocking attribute of the <simpleSteps> element is set to TRUE.

Note –

If a plan is executed on a virtual host and the implicitLocking attribute of the <simpleSteps> element is set to TRUE, the virtual host is locked. If the plan includes a lockHost step with the lockingMode attribute set to PHYSICAL, the physical host is also locked, but the virtual host is not unlocked. The virtual host is not unlocked because implicitLocking attribute of the <simpleSteps> element is still set to TRUE.

The host locking in this case is the union of both the implicitLocking attribute of the <simpleSteps> element and the lockHost step.