Class Disk

Return the device path if this device type has a static one.

Some devices (LVM for example) live always at the same /dev/ path, irrespective of their status. For such devices, we return this path, for others we return None.

Compute the needed number of children for activation.

This method will return either -1 (all children) or a positive number denoting the minimum number of children needed for activation (only mirrored devices will usually return >=0).

Currently, only DRBD8 supports diskless activation (therefore we return 0), for all other we keep the previous semantics and return -1.

Check if the disk or its children are based on the given type.

Parameters:

• dev_type (constants.DTS_BLOCK) - the type to look for

Returns: boolean

boolean indicating if a device of the given type was found or not

This function returns the nodes this device lives on.

Given the node on which the parent of the device lives on (or, in case of a top-level device, the primary node of the devices' instance), this function will return a list of nodes on which this devices needs to (or can) be assembled.

Compute the node/disk tree for this disk and its children.

This method, given the node on which the parent disk lives, will return the list of all (node UUID, disk) pairs which describe the disk tree in the most compact way. For example, a drbd/lvm stack will be returned as (primary_node, drbd) and (secondary_node, drbd) which represents all the top-level devices on the nodes.

Compute the per-VG growth requirements.

This only works for VG-based disks.

Parameters:

• amount (integer) - the desired increase in (user-visible) disk space

Returns: dict

a dictionary of volume-groups and the required size

Update the size of this disk after growth.

This method recurses over the disks's children and updates their size correspondigly. The method needs to be kept in sync with the actual algorithms from bdev.

Updates the dynamic disk params for the given node.

This is mainly used for drbd, which needs ip/port configuration.

Arguments:

• target_node_uuid: the node UUID we wish to configure for
• nodes_ip: a mapping of node name to ip

The target_node must exist in nodes_ip, and should be one of the nodes in the logical ID if this device is a DRBD device.

Disk-specific conversion to standard python types.

This replaces the children lists of objects with lists of standard python types.

Overrides: ConfigObject.ToDict

Custom function for Disks

Overrides: ConfigObject.FromDict

Custom str() formatter for disks.

Overrides: object.__str__

Fill defaults for missing configuration values.

Overrides: ConfigObject.UpgradeConfig

Computes Logical Disk parameters from Disk Template parameters.

Parameters:

• disk_template (string) - disk template, one of constants.DISK_TEMPLATES
• disk_params (dict) - disk template parameters; dict(template_name -> parameters

Returns: list(dict)

a list of dicts, one for each node of the disk hierarchy. Each dict contains the LD parameters of the node. The tree is flattened in-order.