LMI_StorageConfigurationService

” Module for LMI_StorageConfigurationService class.

LMI_StorageConfigurationService

class openlmi.storage.LMI_StorageConfigurationService.LMI_StorageConfigurationService(*args, **kwargs)

Provider of LMI_StorageConfigurationService.

__init__(*args, **kwargs)

cim_method_createormodifyelementfromelements(*args, **kwargs)

Implements LMI_StorageConfigurationService.CreateOrModifyElementFromElements()

Start a job to create (or modify) a MD RAID from specified input StorageExtents. Only whole StorageExtents can be added to a RAID.

As an input parameter, Size specifies the desired size of

the element and must match size of all input StorageVolumes combined in the RAID. Use null to avoid this calculation. As an output parameter, it specifies the size achieved.

The desired

Settings for the element are specified by the Goal parameter.

If 0 is returned, the function completed successfully and no ConcreteJob instance was required. If 4096/0x1000 is returned, a ConcreteJob will be started to create the element. The Job’s reference will be returned in the output parameter Job.

This

method does not support MD RAID modification for now.

cim_method_createormodifyelementfromstoragepool(*args, **kwargs)

Implements LMI_StorageConfigurationService

.CreateOrModifyElementFromStoragePool()

Start a job to create (or modify) a Logical Volume from a LMI_StoragePool. One of the parameters for this method is Size. As an input parameter, Size specifies the desired size of the element. As an output parameter, it specifies the size achieved. The Size is rounded to extent size of the Volume Group. Space is taken from the input StoragePool. The desired settings for the element are specified by the Goal parameter. If the requested size cannot be created, no action will be taken, and the Return Value will be 4097/0x1001. Also, the output value of Size is set to the nearest possible size. This method supports renaming or resizing of a Logical Volume. If 0 is returned, the function completed successfully and no ConcreteJob instance was required. If 4096/0x1000 is returned, a ConcreteJob will be started to create the element. The Job’s reference will be returned in the output parameter Job.

cim_method_createormodifylv(*args, **kwargs)

Implements LMI_StorageConfigurationService.CreateOrModifyLV()

Create or modify Logical Volume. This method is shortcut to CreateOrModifyElementFromStoragePool with the right Goal. Lazy applications can use this method to create or modify LVs, without calculation of the Goal setting.

cim_method_createormodifymdraid(*args, **kwargs)

Implements LMI_StorageConfigurationService.CreateOrModifyMDRAID()

Create or modify MD RAID array. This method is shortcut to CreateOrModifyElementFromElements with the right Goal. Lazy applications can use this method to create or modify MD RAID with the right level, without calculation of the Goal setting.

Either

Level or Goal must be specified. If both are specified, they must match.

RAID modification is not yet supported.

cim_method_createormodifystoragepool(*args, **kwargs)

Implements LMI_StorageConfigurationService.CreateOrModifyStoragePool()

Starts a job to create (or modify) a StoragePool.Only Volume Groups can be created or modified using this method.

LMI supports only

creation of pools from whole StorageExtents, it is not possible to allocate only part of an StorageExtent.

One of the parameters for

this method is Size. As an input parameter, Size specifies the desired size of the pool. It must match sum of all input extent sizes. Error will be returned if not, with correct Size output parameter value.

Any InPools as parameter will result in

error.

The capability requirements that the Pool must support are

defined using the Goal parameter.

This method supports renaming

of a Volume Group and adding and removing StorageExtents to/from a Volume Group.

If 0 is returned, then the task completed

successfully and the use of ConcreteJob was not required. If the task will take some time to complete, a ConcreteJob will be created and its reference returned in the output parameter Job.

This method automatically formats the StorageExtents added to a Volume Group as Physical Volumes.

cim_method_createormodifyvg(*args, **kwargs)

Implements LMI_StorageConfigurationService.CreateOrModifyVG()

Create or modify Volume Group. This method is shortcut to CreateOrModifyStoragePool with the right Goal. Lazy applications can use this method to create or modify VGs, without calculation of the Goal setting.

On implementation side, this method is called by CreateOrModifyStoragePool. If so, input_arguments and method_name parameters are set, so we can create proper Job here.

cim_method_deletelv(*args, **kwargs)

Implements LMI_StorageConfigurationService.DeleteLV()

Start a job to delete a Logical Volume. If 0 is returned, the function completed successfully and no ConcreteJob was required. If 4096/0x1000 is returned, a ConcreteJob will be started to delete the element. A reference to the Job is returned in the Job parameter. This method is alias of ReturnToStoragePool().

cim_method_deletemdraid(*args, **kwargs)

Implements LMI_StorageConfigurationService.DeleteMDRAID()

Delete MD RAID array. All members are detached from the array and all RAID metadata are erased.

Keyword arguments: env – Provider Environment (pycimmb.ProviderEnvironment) object_name – A pywbem.CIMInstanceName or pywbem.CIMCLassName

specifying the object on which the method DeleteMDRAID() should be invoked.

param_theelement – The input parameter TheElement (type REF (pywbem.CIMInstanceName(classname=’LMI_MDRAIDStorageExtent’, ...))

The MD RAID device to destroy.

Returns a two-tuple containing the return value (type pywbem.Uint32 self.Values.DeleteMDRAID) and a list of CIMParameter objects representing the output parameters

Output parameters: Job – (type REF (pywbem.CIMInstanceName(classname=’CIM_ConcreteJob’, ...))

Reference to the job (may be null if job completed).

Possible Errors: CIM_ERR_ACCESS_DENIED CIM_ERR_INVALID_PARAMETER (including missing, duplicate,

unrecognized or otherwise incorrect parameters)

CIM_ERR_NOT_FOUND (the target CIM Class or instance does not

exist in the specified namespace)

CIM_ERR_METHOD_NOT_AVAILABLE (the CIM Server is unable to honor

the invocation request)

CIM_ERR_FAILED (some other unspecified error occurred)

cim_method_deletestoragepool(*args, **kwargs)

Implements LMI_StorageConfigurationService.DeleteStoragePool()

Start a job to delete a StoragePool. The freed space is returned source StoragePools (indicated by AllocatedFrom StoragePool) or back to underlying storage extents. If 0 is returned, the function completed successfully, and no ConcreteJob was required. If 4096/0x1000 is returned, a ConcreteJob will be started to delete the StoragePool. A reference to the Job is returned in the Job parameter.

Implementation just calls DeleteVG with the same arguments.

cim_method_deletevg(*args, **kwargs)

Implements LMI_StorageConfigurationService.DeleteVG()

Start a job to delete a Volume Group. If 0 is returned, the function completed successfully, and no ConcreteJob was required. If 4096/0x1000 is returned, a ConcreteJob will be started to delete the StoragePool. A reference to the Job is returned in the Job parameter.

cim_method_returntostoragepool(*args, **kwargs)

Implements LMI_StorageConfigurationService.ReturnToStoragePool()

Start a job to delete an element, i.e. Logical Volume, previously created from a StoragePool. The freed space is returned to the source StoragePool. If 0 is returned, the function completed successfully and no ConcreteJob was required. If 4096/0x1000 is returned, a ConcreteJob will be started to delete the element. A reference to the Job is returned in the Job parameter.