LMI_FileSystemConfigurationService

” Module for LMI_FileSystemConfigurationService class.

LMI_FileSystemConfigurationService

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

LMI_FileSystemConfigurationService provider implementation.

__init__(*args, **kwargs)

cim_method_deletefilesystem(*args, **kwargs)

Implements LMI_FileSystemConfigurationService.DeleteFileSystem()

Start a job to delete a FileSystem. If the FileSystem cannot be deleted, no action will be taken, and the Return Value will be 4097/0x1001. If the method completed successfully and did not require a long-running ConcreteJob, it will return 0. If 4096/0x1000 is returned, a ConcreteJob will be started to delete the FileSystem. A Reference to the ConcreteJob will be returned in the output parameter Job.

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

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

param_waittime – The input parameter WaitTime (type pywbem.Uint32)

An integer that indicates the time (in seconds) that the provider must wait before deleting this FileSystem. If WaitTime is not zero, the method will create a job, if supported by the provider, and return immediately. If the provider does not support asynchronous jobs, there is a possibility that the client could time-out before the job is completed. The combination of InUseOptions = ‘4’ and WaitTime =‘0’ (the default) is interpreted as ‘Wait (forever) until Quiescence, then Delete Filesystem’ and will be performed asynchronously if possible.

param_thefilesystem – The input parameter TheFileSystem (type REF (pywbem.CIMInstanceName(classname=’CIM_ManagedElement’, ...))

An element or association that uniquely identifies the FileSystem to be deleted.

param_inuseoptions – The input parameter InUseOptions (type pywbem.Uint16 self.Values.DeleteFileSystem.InUseOptions)

An enumerated integer that specifies the action to take if the FileSystem is still in use when this request is made.

Returns a two-tuple containing the return value (type pywbem.Uint32 self.Values.DeleteFileSystem) 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_lmi_createfilesystem(*args, **kwargs)

Implements LMI_FileSystemConfigurationService.LMI_CreateFileSystem()

Start a job to create a FileSystem on StorageExtents. If the operation completes successfully and did not require a long-running ConcreteJob, it will return 0. If 4096/0x1000 is returned, a ConcreteJob will be started to create the element. A Reference to the ConcreteJob will be returned in the output parameter Job. If any other value is returned, the job will not be started, and no action will be taken.

The parameter TheElement

will contain a Reference to the FileSystem if this operation completed successfully.

The StorageExtents to use is specified

by the InExtents parameter.

The desired settings for the

FileSystem are specified by the Goal parameter. Goal is an element of class CIM_FileSystemSetting, or a derived class. Unlike CIM standard CreateFileSystem, the parameter is reference to CIM_FileSystemSetting stored on the CIMOM.

A ResidesOnExtent

association is created between the created FileSystem and the StorageExtents used for it.

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

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

param_elementname – The input parameter ElementName (type unicode)

Label of the filesystem being created. If NULL, a system-supplied default name can be used. The value will be stored in the ‘ElementName’ property for the created element.

param_goal – The input parameter Goal (type REF (pywbem.CIMInstanceName(classname=’CIM_FileSystemSetting’, ...))

The requirements for the FileSystem element to maintain. This is an element of class CIM_FileSystemSetting, or a derived class. This allows the client to specify the properties desired for the file system. If NULL, the FileSystemConfigurationService will create default filesystem.

param_filesystemtype – The input parameter FileSystemType (type pywbem.Uint16 self.Values.LMI_CreateFileSystem.FileSystemType)

Type of file system to create. When NULL, file system type is retrieved from Goal parameter, which cannot be NULL.

param_inextents – The input parameter InExtents (type REF (pywbem.CIMInstanceName(classname=’CIM_StorageExtent’, ...))

The StorageExtents on which the created FileSystem will reside. At least one extent must be provided. If the filesystem being created supports more than one storage extent (e.g. btrfs), more extents can be provided. The filesystem will then reside on all of them.

Returns a two-tuple containing the return value (type pywbem.Uint32 self.Values.LMI_CreateFileSystem) 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).

TheElement – (type REF (pywbem.CIMInstanceName(classname=’CIM_FileSystem’, ...))

The newly created FileSystem.

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)