White Papers

Power Supply Profile
Version 1.0.0a 19
8.2 Method: CIM_RedundancySet.Failover( )
The CIM_RedundancySet.Failover( ) method forces a failover from one member of a
CIM_RedundancySet collection to another. When the method executes successfully, the power supply
that is represented by the CIM_PowerSupply instance referenced by the FailoverFrom parameter will
become inactive. The power supply that is represented by the CIM_PowerSupply instance referenced by
the FailoverTo parameter will take over as the active power supply.
The Failover(
) method may be supported if the FailoverSupported property of at least one instance of
CIM_IsSpare that references the CIM_RedundancySet has a value of 3 (Manual) or 4 (Both Manual and
Automatic).
The Failover(
) method shall not be supported if the FailoverSupported property of every instance of
CIM_IsSpare that references the CIM_RedundancySet has a value of 2 (Automatic).
The execution of the Failover(
) method shall return a value of 2 (Error Occurred) under the following
conditions:
• The CIM_PowerSupply instance that is referenced by the FailoverTo parameter is not a Spare
Power Supply.
• The CIM_PowerSupply instance that is referenced by the FailoverFrom parameter is not
associated with the CIM_RedundancySet instance only through the CIM_MemberOfCollection
association.
After the Failover(
) method executes successfully:
• The CIM_PowerSupply instance that is referenced by the FailoverTo parameter shall take over as
the active power supply. The CIM_PowerSupply instance that is referenced by the FailoverTo
parameter shall be associated with the CIM_RedundancySet only through the
CIM_MemberOfCollection association.
• The CIM_PowerSupply instance that is referenced by FailoverFrom parameter shall become a
Spare Power Supply.
• When the power supply state management is supported, the EnabledState property of the
CIM_PowerSupply instance that is referenced by the FailoverFrom parameter shall not have a
value of 2 (Enabled), but may have a value of 6 (Enabled but Offline).
CIM_RedundancySet.Failover(
) return values shall be as specified in Table 6.
CIM_RedundancySet.Failover(
) parameters are specified in Table 7.
No standard messages are defined for this method.
Table 6 – CIM_RedundancySet.Failover(
) Method: Return Code Values
Value Description
0 Request was successfully executed.
1 Method is not supported in the implementation.
2 Error occurred