X-Git-Url: https://code.grnet.gr/git/ganeti-local/blobdiff_plain/0caf64850b93a82f06124a9af90a8afd83932262..6abe9194834b97e375fdbb71bd5573de4b529334:/lib/bdev.py diff --git a/lib/bdev.py b/lib/bdev.py index e706772..7ba3470 100644 --- a/lib/bdev.py +++ b/lib/bdev.py @@ -24,9 +24,11 @@ import re import time import errno +import pyparsing as pyp +import os +import logging from ganeti import utils -from ganeti import logger from ganeti import errors from ganeti import constants @@ -41,21 +43,16 @@ class BlockDev(object): - online (=used, or ready for use) A device can also be online but read-only, however we are not using - the readonly state (MD and LV have it, if needed in the future) - and we are usually looking at this like at a stack, so it's easier - to conceptualise the transition from not-existing to online and back + the readonly state (LV has it, if needed in the future) and we are + usually looking at this like at a stack, so it's easier to + conceptualise the transition from not-existing to online and back like a linear one. The many different states of the device are due to the fact that we need to cover many device types: - logical volumes are created, lvchange -a y $lv, and used - - md arrays are created or assembled and used - drbd devices are attached to a local disk/remote peer and made primary - The status of the device can be examined by `GetStatus()`, which - returns a numerical value, depending on the position in the - transition stack of the device. - A block device is identified by three items: - the /dev path of the device (dynamic) - a unique ID of the device (static) @@ -63,15 +60,13 @@ class BlockDev(object): Not all devices implement both the first two as distinct items. LVM logical volumes have their unique ID (the pair volume group, logical - volume name) in a 1-to-1 relation to the dev path. For MD devices, - the /dev path is dynamic and the unique ID is the UUID generated at - array creation plus the slave list. For DRBD devices, the /dev path - is again dynamic and the unique id is the pair (host1, dev1), - (host2, dev2). + volume name) in a 1-to-1 relation to the dev path. For DRBD devices, + the /dev path is again dynamic and the unique id is the pair (host1, + dev1), (host2, dev2). You can get to a device in two ways: - creating the (real) device, which returns you - an attached instance (lvcreate, mdadm --create) + an attached instance (lvcreate) - attaching of a python instance to an existing (real) device The second point, the attachement to a device, is different @@ -81,26 +76,13 @@ class BlockDev(object): after assembly we'll have our correct major/minor. """ - STATUS_UNKNOWN = 0 - STATUS_EXISTING = 1 - STATUS_STANDBY = 2 - STATUS_ONLINE = 3 - - STATUS_MAP = { - STATUS_UNKNOWN: "unknown", - STATUS_EXISTING: "existing", - STATUS_STANDBY: "ready for use", - STATUS_ONLINE: "online", - } - - def __init__(self, unique_id, children): self._children = children self.dev_path = None self.unique_id = unique_id self.major = None self.minor = None - + self.attached = False def Assemble(self): """Assemble the device from its components. @@ -123,28 +105,31 @@ class BlockDev(object): status = status and child.Assemble() if not status: break - status = status and child.Open() + + try: + child.Open() + except errors.BlockDeviceError: + for child in self._children: + child.Shutdown() + raise if not status: for child in self._children: child.Shutdown() return status - def Attach(self): """Find a device which matches our config and attach to it. """ raise NotImplementedError - def Close(self): """Notifies that the device will no longer be used for I/O. """ raise NotImplementedError - @classmethod def Create(cls, unique_id, children, size): """Create the device. @@ -159,25 +144,24 @@ class BlockDev(object): """ raise NotImplementedError - def Remove(self): """Remove this device. - This makes sense only for some of the device types: LV and to a - lesser degree, md devices. Also note that if the device can't - attach, the removal can't be completed. + This makes sense only for some of the device types: LV and file + storeage. Also note that if the device can't attach, the removal + can't be completed. """ raise NotImplementedError + def Rename(self, new_id): + """Rename this device. - def GetStatus(self): - """Return the status of the device. + This may or may not make sense for a given device type. """ raise NotImplementedError - def Open(self, force=False): """Make the device ready for use. @@ -190,7 +174,6 @@ class BlockDev(object): """ raise NotImplementedError - def Shutdown(self): """Shut down the device, freeing its children. @@ -201,7 +184,6 @@ class BlockDev(object): """ raise NotImplementedError - def SetSyncSpeed(self, speed): """Adjust the sync speed of the mirror. @@ -214,7 +196,6 @@ class BlockDev(object): result = result and child.SetSyncSpeed(speed) return result - def GetSyncStatus(self): """Returns the sync status of the device. @@ -222,17 +203,23 @@ class BlockDev(object): status of the mirror. Returns: - (sync_percent, estimated_time, is_degraded) + (sync_percent, estimated_time, is_degraded, ldisk) + + If sync_percent is None, it means the device is not syncing. - If sync_percent is None, it means all is ok If estimated_time is None, it means we can't estimate - the time needed, otherwise it's the time left in seconds + the time needed, otherwise it's the time left in seconds. + If is_degraded is True, it means the device is missing redundancy. This is usually a sign that something went wrong in the device setup, if sync_percent is None. + The ldisk parameter represents the degradation of the local + data. This is only valid for some devices, the rest will always + return False (not degraded). + """ - return None, None, False + return None, None, False, False def CombinedSyncStatus(self): @@ -243,10 +230,10 @@ class BlockDev(object): children. """ - min_percent, max_time, is_degraded = self.GetSyncStatus() + min_percent, max_time, is_degraded, ldisk = self.GetSyncStatus() if self._children: for child in self._children: - c_percent, c_time, c_degraded = child.GetSyncStatus() + c_percent, c_time, c_degraded, c_ldisk = child.GetSyncStatus() if min_percent is None: min_percent = c_percent elif c_percent is not None: @@ -256,7 +243,8 @@ class BlockDev(object): elif c_time is not None: max_time = max(max_time, c_time) is_degraded = is_degraded or c_degraded - return min_percent, max_time, is_degraded + ldisk = ldisk or c_ldisk + return min_percent, max_time, is_degraded, ldisk def SetInfo(self, text): @@ -268,6 +256,16 @@ class BlockDev(object): for child in self._children: child.SetInfo(text) + def Grow(self, amount): + """Grow the block device. + + Arguments: + amount: the amount (in mebibytes) to grow with + + Returns: None + + """ + raise NotImplementedError def __repr__(self): return ("<%s: unique_id: %s, children: %s, %s:%s, %s>" % @@ -290,9 +288,10 @@ class LogicalVolume(BlockDev): raise ValueError("Invalid configuration data %s" % str(unique_id)) self._vg_name, self._lv_name = unique_id self.dev_path = "/dev/%s/%s" % (self._vg_name, self._lv_name) + self._degraded = True + self.major = self.minor = None self.Attach() - @classmethod def Create(cls, unique_id, children, size): """Create a new logical volume. @@ -319,7 +318,8 @@ class LogicalVolume(BlockDev): result = utils.RunCmd(["lvcreate", "-L%dm" % size, "-n%s" % lv_name, vg_name] + pvlist) if result.failed: - raise errors.BlockDeviceError(result.fail_reason) + raise errors.BlockDeviceError("%s - %s" % (result.fail_reason, + result.output)) return LogicalVolume(unique_id, children) @staticmethod @@ -338,13 +338,14 @@ class LogicalVolume(BlockDev): "--separator=:"] result = utils.RunCmd(command) if result.failed: - logger.Error("Can't get the PV information: %s" % result.fail_reason) + logging.error("Can't get the PV information: %s - %s", + result.fail_reason, result.output) return None data = [] for line in result.stdout.splitlines(): fields = line.strip().split(':') if len(fields) != 4: - logger.Error("Can't parse pvs output: line '%s'" % line) + logging.error("Can't parse pvs output: line '%s'", line) return None # skip over pvs from another vg or ones which are not allocatable if fields[1] != vg_name or fields[3][0] != 'a': @@ -363,43 +364,82 @@ class LogicalVolume(BlockDev): result = utils.RunCmd(["lvremove", "-f", "%s/%s" % (self._vg_name, self._lv_name)]) if result.failed: - logger.Error("Can't lvremove: %s" % result.fail_reason) + logging.error("Can't lvremove: %s - %s", + result.fail_reason, result.output) return not result.failed + def Rename(self, new_id): + """Rename this logical volume. + + """ + if not isinstance(new_id, (tuple, list)) or len(new_id) != 2: + raise errors.ProgrammerError("Invalid new logical id '%s'" % new_id) + new_vg, new_name = new_id + if new_vg != self._vg_name: + raise errors.ProgrammerError("Can't move a logical volume across" + " volume groups (from %s to to %s)" % + (self._vg_name, new_vg)) + result = utils.RunCmd(["lvrename", new_vg, self._lv_name, new_name]) + if result.failed: + raise errors.BlockDeviceError("Failed to rename the logical volume: %s" % + result.output) + self._lv_name = new_name + self.dev_path = "/dev/%s/%s" % (self._vg_name, self._lv_name) def Attach(self): """Attach to an existing LV. This method will try to see if an existing and active LV exists - which matches the our name. If so, its major/minor will be + which matches our name. If so, its major/minor will be recorded. """ - result = utils.RunCmd(["lvdisplay", self.dev_path]) + self.attached = False + result = utils.RunCmd(["lvs", "--noheadings", "--separator=,", + "-olv_attr,lv_kernel_major,lv_kernel_minor", + self.dev_path]) if result.failed: - logger.Error("Can't find LV %s: %s" % - (self.dev_path, result.fail_reason)) + logging.error("Can't find LV %s: %s, %s", + self.dev_path, result.fail_reason, result.output) return False - match = re.compile("^ *Block device *([0-9]+):([0-9]+).*$") - for line in result.stdout.splitlines(): - match_result = match.match(line) - if match_result: - self.major = int(match_result.group(1)) - self.minor = int(match_result.group(2)) - return True - return False + out = result.stdout.strip().rstrip(',') + out = out.split(",") + if len(out) != 3: + logging.error("Can't parse LVS output, len(%s) != 3", str(out)) + return False + + status, major, minor = out[:3] + if len(status) != 6: + logging.error("lvs lv_attr is not 6 characters (%s)", status) + return False + + try: + major = int(major) + minor = int(minor) + except ValueError, err: + logging.error("lvs major/minor cannot be parsed: %s", str(err)) + self.major = major + self.minor = minor + self._degraded = status[0] == 'v' # virtual volume, i.e. doesn't backing + # storage + self.attached = True + return True def Assemble(self): """Assemble the device. - This is a no-op for the LV device type. Eventually, we could - lvchange -ay here if we see that the LV is not active. + We alway run `lvchange -ay` on the LV to ensure it's active before + use, as there were cases when xenvg was not active after boot + (also possibly after disk issues). """ - return True - + result = utils.RunCmd(["lvchange", "-ay", self.dev_path]) + if result.failed: + logging.error("Can't activate lv %s: %s", self.dev_path, result.output) + return False + return self.Attach() def Shutdown(self): """Shutdown the device. @@ -410,35 +450,30 @@ class LogicalVolume(BlockDev): """ return True + def GetSyncStatus(self): + """Returns the sync status of the device. + + If this device is a mirroring device, this function returns the + status of the mirror. - def GetStatus(self): - """Return the status of the device. + Returns: + (sync_percent, estimated_time, is_degraded, ldisk) - Logical volumes will can be in all four states, although we don't - deactivate (lvchange -an) them when shutdown, so STATUS_EXISTING - should not be seen for our devices. + For logical volumes, sync_percent and estimated_time are always + None (no recovery in progress, as we don't handle the mirrored LV + case). The is_degraded parameter is the inverse of the ldisk + parameter. - """ - result = utils.RunCmd(["lvs", "--noheadings", "-olv_attr", self.dev_path]) - if result.failed: - logger.Error("Can't display lv: %s" % result.fail_reason) - return self.STATUS_UNKNOWN - out = result.stdout.strip() - # format: type/permissions/alloc/fixed_minor/state/open - if len(out) != 6: - return self.STATUS_UNKNOWN - #writable = (out[1] == "w") - active = (out[4] == "a") - online = (out[5] == "o") - if online: - retval = self.STATUS_ONLINE - elif active: - retval = self.STATUS_STANDBY - else: - retval = self.STATUS_EXISTING + For the ldisk parameter, we check if the logical volume has the + 'virtual' type, which means it's not backed by existing storage + anymore (read from it return I/O error). This happens after a + physical disk failure and subsequent 'vgreduce --removemissing' on + the volume group. - return retval + The status was already read in Attach, so we just return it. + """ + return None, None, self._degraded, self._degraded def Open(self, force=False): """Make the device ready for I/O. @@ -446,8 +481,7 @@ class LogicalVolume(BlockDev): This is a no-op for the LV device type. """ - return True - + pass def Close(self): """Notifies that the device will no longer be used for I/O. @@ -455,8 +489,7 @@ class LogicalVolume(BlockDev): This is a no-op for the LV device type. """ - return True - + pass def Snapshot(self, size): """Create a snapshot copy of an lvm block device. @@ -482,12 +515,12 @@ class LogicalVolume(BlockDev): result = utils.RunCmd(["lvcreate", "-L%dm" % size, "-s", "-n%s" % snap_name, self.dev_path]) if result.failed: - raise errors.BlockDeviceError("command: %s error: %s" % - (result.cmd, result.fail_reason)) + raise errors.BlockDeviceError("command: %s error: %s - %s" % + (result.cmd, result.fail_reason, + result.output)) return snap_name - def SetInfo(self, text): """Update metadata with info text. @@ -504,577 +537,436 @@ class LogicalVolume(BlockDev): result = utils.RunCmd(["lvchange", "--addtag", text, self.dev_path]) if result.failed: - raise errors.BlockDeviceError("Command: %s error: %s" % - (result.cmd, result.fail_reason)) + raise errors.BlockDeviceError("Command: %s error: %s - %s" % + (result.cmd, result.fail_reason, + result.output)) + def Grow(self, amount): + """Grow the logical volume. + + """ + # we try multiple algorithms since the 'best' ones might not have + # space available in the right place, but later ones might (since + # they have less constraints); also note that only recent LVM + # supports 'cling' + for alloc_policy in "contiguous", "cling", "normal": + result = utils.RunCmd(["lvextend", "--alloc", alloc_policy, + "-L", "+%dm" % amount, self.dev_path]) + if not result.failed: + return + raise errors.BlockDeviceError("Can't grow LV %s: %s" % + (self.dev_path, result.output)) + +class DRBD8Status(object): + """A DRBD status representation class. -class MDRaid1(BlockDev): - """raid1 device implemented via md. + Note that this doesn't support unconfigured devices (cs:Unconfigured). """ - def __init__(self, unique_id, children): - super(MDRaid1, self).__init__(unique_id, children) - self.major = 9 - self.Attach() + LINE_RE = re.compile(r"\s*[0-9]+:\s*cs:(\S+)\s+st:([^/]+)/(\S+)" + "\s+ds:([^/]+)/(\S+)\s+.*$") + SYNC_RE = re.compile(r"^.*\ssync'ed:\s*([0-9.]+)%.*" + "\sfinish: ([0-9]+):([0-9]+):([0-9]+)\s.*$") + + def __init__(self, procline): + m = self.LINE_RE.match(procline) + if not m: + raise errors.BlockDeviceError("Can't parse input data '%s'" % procline) + self.cstatus = m.group(1) + self.lrole = m.group(2) + self.rrole = m.group(3) + self.ldisk = m.group(4) + self.rdisk = m.group(5) + + self.is_standalone = self.cstatus == "StandAlone" + self.is_wfconn = self.cstatus == "WFConnection" + self.is_connected = self.cstatus == "Connected" + self.is_primary = self.lrole == "Primary" + self.is_secondary = self.lrole == "Secondary" + self.peer_primary = self.rrole == "Primary" + self.peer_secondary = self.rrole == "Secondary" + self.both_primary = self.is_primary and self.peer_primary + self.both_secondary = self.is_secondary and self.peer_secondary + + self.is_diskless = self.ldisk == "Diskless" + self.is_disk_uptodate = self.ldisk == "UpToDate" + + m = self.SYNC_RE.match(procline) + if m: + self.sync_percent = float(m.group(1)) + hours = int(m.group(2)) + minutes = int(m.group(3)) + seconds = int(m.group(4)) + self.est_time = hours * 3600 + minutes * 60 + seconds + else: + self.sync_percent = None + self.est_time = None + self.is_sync_target = self.peer_sync_source = self.cstatus == "SyncTarget" + self.peer_sync_target = self.is_sync_source = self.cstatus == "SyncSource" + self.is_resync = self.is_sync_target or self.is_sync_source - def Attach(self): - """Find an array which matches our config and attach to it. - This tries to find a MD array which has the same UUID as our own. +class BaseDRBD(BlockDev): + """Base DRBD class. + + This class contains a few bits of common functionality between the + 0.7 and 8.x versions of DRBD. - """ - minor = self._FindMDByUUID(self.unique_id) - if minor is not None: - self._SetFromMinor(minor) - else: - self.minor = None - self.dev_path = None + """ + _VERSION_RE = re.compile(r"^version: (\d+)\.(\d+)\.(\d+)" + r" \(api:(\d+)/proto:(\d+)(?:-(\d+))?\)") - return (minor is not None) + _DRBD_MAJOR = 147 + _ST_UNCONFIGURED = "Unconfigured" + _ST_WFCONNECTION = "WFConnection" + _ST_CONNECTED = "Connected" + _STATUS_FILE = "/proc/drbd" @staticmethod - def _GetUsedDevs(): - """Compute the list of in-use MD devices. - - It doesn't matter if the used device have other raid level, just - that they are in use. + def _GetProcData(filename=_STATUS_FILE): + """Return data from /proc/drbd. """ - mdstat = open("/proc/mdstat", "r") - data = mdstat.readlines() - mdstat.close() + stat = open(filename, "r") + try: + data = stat.read().splitlines() + finally: + stat.close() + if not data: + raise errors.BlockDeviceError("Can't read any data from %s" % filename) + return data - used_md = {} - valid_line = re.compile("^md([0-9]+) : .*$") - for line in data: - match = valid_line.match(line) - if match: - md_no = int(match.group(1)) - used_md[md_no] = line + @staticmethod + def _MassageProcData(data): + """Transform the output of _GetProdData into a nicer form. - return used_md + Returns: + a dictionary of minor: joined lines from /proc/drbd for that minor + """ + lmatch = re.compile("^ *([0-9]+):.*$") + results = {} + old_minor = old_line = None + for line in data: + lresult = lmatch.match(line) + if lresult is not None: + if old_minor is not None: + results[old_minor] = old_line + old_minor = int(lresult.group(1)) + old_line = line + else: + if old_minor is not None: + old_line += " " + line.strip() + # add last line + if old_minor is not None: + results[old_minor] = old_line + return results - @staticmethod - def _GetDevInfo(minor): - """Get info about a MD device. + @classmethod + def _GetVersion(cls): + """Return the DRBD version. - Currently only uuid is returned. + This will return a dict with keys: + k_major, + k_minor, + k_point, + api, + proto, + proto2 (only on drbd > 8.2.X) """ - result = utils.RunCmd(["mdadm", "-D", "/dev/md%d" % minor]) - if result.failed: - logger.Error("Can't display md: %s" % result.fail_reason) - return None - retval = {} - for line in result.stdout.splitlines(): - line = line.strip() - kv = line.split(" : ", 1) - if kv: - if kv[0] == "UUID": - retval["uuid"] = kv[1].split()[0] - elif kv[0] == "State": - retval["state"] = kv[1].split(", ") - return retval + proc_data = cls._GetProcData() + first_line = proc_data[0].strip() + version = cls._VERSION_RE.match(first_line) + if not version: + raise errors.BlockDeviceError("Can't parse DRBD version from '%s'" % + first_line) + values = version.groups() + retval = {'k_major': int(values[0]), + 'k_minor': int(values[1]), + 'k_point': int(values[2]), + 'api': int(values[3]), + 'proto': int(values[4]), + } + if values[5] is not None: + retval['proto2'] = values[5] - @staticmethod - def _FindUnusedMinor(): - """Compute an unused MD minor. + return retval - This code assumes that there are 256 minors only. + @staticmethod + def _DevPath(minor): + """Return the path to a drbd device for a given minor. """ - used_md = MDRaid1._GetUsedDevs() - i = 0 - while i < 256: - if i not in used_md: - break - i += 1 - if i == 256: - logger.Error("Critical: Out of md minor numbers.") - raise errors.BlockDeviceError("Can't find a free MD minor") - return i - + return "/dev/drbd%d" % minor @classmethod - def _FindMDByUUID(cls, uuid): - """Find the minor of an MD array with a given UUID. + def _GetUsedDevs(cls): + """Compute the list of used DRBD devices. """ - md_list = cls._GetUsedDevs() - for minor in md_list: - info = cls._GetDevInfo(minor) - if info and info["uuid"] == uuid: - return minor - return None + data = cls._GetProcData() + used_devs = {} + valid_line = re.compile("^ *([0-9]+): cs:([^ ]+).*$") + for line in data: + match = valid_line.match(line) + if not match: + continue + minor = int(match.group(1)) + state = match.group(2) + if state == cls._ST_UNCONFIGURED: + continue + used_devs[minor] = state, line - @staticmethod - def _ZeroSuperblock(dev_path): - """Zero the possible locations for an MD superblock. + return used_devs - The zero-ing can't be done via ``mdadm --zero-superblock`` as that - fails in versions 2.x with the same error code as non-writable - device. + def _SetFromMinor(self, minor): + """Set our parameters based on the given minor. - The superblocks are located at (negative values are relative to - the end of the block device): - - -128k to end for version 0.90 superblock - - -8k to -12k for version 1.0 superblock (included in the above) - - 0k to 4k for version 1.1 superblock - - 4k to 8k for version 1.2 superblock + This sets our minor variable and our dev_path. - To cover all situations, the zero-ing will be: - - 0k to 128k - - -128k to end + """ + if minor is None: + self.minor = self.dev_path = None + self.attached = False + else: + self.minor = minor + self.dev_path = self._DevPath(minor) + self.attached = True - As such, the minimum device size must be 128k, otherwise we'll get - I/O errors. + @staticmethod + def _CheckMetaSize(meta_device): + """Check if the given meta device looks like a valid one. - Note that this function depends on the fact that one can open, - read and write block devices normally. + This currently only check the size, which must be around + 128MiB. """ - overwrite_size = 128 * 1024 - empty_buf = '\0' * overwrite_size - fd = open(dev_path, "r+") + result = utils.RunCmd(["blockdev", "--getsize", meta_device]) + if result.failed: + logging.error("Failed to get device size: %s - %s", + result.fail_reason, result.output) + return False try: - fd.seek(0, 0) - p1 = fd.tell() - fd.write(empty_buf) - p2 = fd.tell() - logger.Debug("Zeroed %s from %d to %d" % (dev_path, p1, p2)) - fd.seek(-overwrite_size, 2) - p1 = fd.tell() - fd.write(empty_buf) - p2 = fd.tell() - logger.Debug("Zeroed %s from %d to %d" % (dev_path, p1, p2)) - finally: - fd.close() + sectors = int(result.stdout) + except ValueError: + logging.error("Invalid output from blockdev: '%s'", result.stdout) + return False + bytes = sectors * 512 + if bytes < 128 * 1024 * 1024: # less than 128MiB + logging.error("Meta device too small (%.2fMib)", (bytes / 1024 / 1024)) + return False + if bytes > (128 + 32) * 1024 * 1024: # account for an extra (big) PE on LVM + logging.error("Meta device too big (%.2fMiB)", (bytes / 1024 / 1024)) + return False + return True - @classmethod - def Create(cls, unique_id, children, size): - """Create a new MD raid1 array. + def Rename(self, new_id): + """Rename a device. + + This is not supported for drbd devices. """ - if not isinstance(children, (tuple, list)): - raise ValueError("Invalid setup data for MDRaid1 dev: %s" % - str(children)) - for i in children: - if not isinstance(i, BlockDev): - raise ValueError("Invalid member in MDRaid1 dev: %s" % type(i)) - for i in children: - try: - cls._ZeroSuperblock(i.dev_path) - except EnvironmentError, err: - logger.Error("Can't zero superblock for %s: %s" % - (i.dev_path, str(err))) - return None - minor = cls._FindUnusedMinor() - result = utils.RunCmd(["mdadm", "--create", "/dev/md%d" % minor, - "--auto=yes", "--force", "-l1", - "-n%d" % len(children)] + - [dev.dev_path for dev in children]) + raise errors.ProgrammerError("Can't rename a drbd device") - if result.failed: - logger.Error("Can't create md: %s: %s" % (result.fail_reason, - result.output)) - return None - info = cls._GetDevInfo(minor) - if not info or not "uuid" in info: - logger.Error("Wrong information returned from mdadm -D: %s" % str(info)) - return None - return MDRaid1(info["uuid"], children) +class DRBD8(BaseDRBD): + """DRBD v8.x block device. - def Remove(self): - """Stub remove function for MD RAID 1 arrays. + This implements the local host part of the DRBD device, i.e. it + doesn't do anything to the supposed peer. If you need a fully + connected DRBD pair, you need to use this class on both hosts. - We don't remove the superblock right now. Mark a to do. + The unique_id for the drbd device is the (local_ip, local_port, + remote_ip, remote_port) tuple, and it must have two children: the + data device and the meta_device. The meta device is checked for + valid size and is zeroed on create. - """ - #TODO: maybe zero superblock on child devices? - return self.Shutdown() + """ + _MAX_MINORS = 255 + _PARSE_SHOW = None + + def __init__(self, unique_id, children): + if children and children.count(None) > 0: + children = [] + super(DRBD8, self).__init__(unique_id, children) + self.major = self._DRBD_MAJOR + version = self._GetVersion() + if version['k_major'] != 8 : + raise errors.BlockDeviceError("Mismatch in DRBD kernel version and" + " requested ganeti usage: kernel is" + " %s.%s, ganeti wants 8.x" % + (version['k_major'], version['k_minor'])) + + if len(children) not in (0, 2): + raise ValueError("Invalid configuration data %s" % str(children)) + if not isinstance(unique_id, (tuple, list)) or len(unique_id) != 4: + raise ValueError("Invalid configuration data %s" % str(unique_id)) + self._lhost, self._lport, self._rhost, self._rport = unique_id + self.Attach() + @classmethod + def _InitMeta(cls, minor, dev_path): + """Initialize a meta device. - def AddChild(self, device): - """Add a new member to the md raid1. + This will not work if the given minor is in use. """ - if self.minor is None and not self.Attach(): - raise errors.BlockDeviceError("Can't attach to device") - if device.dev_path is None: - raise errors.BlockDeviceError("New child is not initialised") - result = utils.RunCmd(["mdadm", "-a", self.dev_path, device.dev_path]) - if result.failed: - raise errors.BlockDeviceError("Failed to add new device to array: %s" % - result.output) - new_len = len(self._children) + 1 - result = utils.RunCmd(["mdadm", "--grow", self.dev_path, "-n", new_len]) + result = utils.RunCmd(["drbdmeta", "--force", cls._DevPath(minor), + "v08", dev_path, "0", "create-md"]) if result.failed: - raise errors.BlockDeviceError("Can't grow md array: %s" % + raise errors.BlockDeviceError("Can't initialize meta device: %s" % result.output) - self._children.append(device) + @classmethod + def _FindUnusedMinor(cls): + """Find an unused DRBD device. - def RemoveChild(self, dev_path): - """Remove member from the md raid1. + This is specific to 8.x as the minors are allocated dynamically, + so non-existing numbers up to a max minor count are actually free. """ - if self.minor is None and not self.Attach(): - raise errors.BlockDeviceError("Can't attach to device") - if len(self._children) == 1: - raise errors.BlockDeviceError("Can't reduce member when only one" - " child left") - for device in self._children: - if device.dev_path == dev_path: - break - else: - raise errors.BlockDeviceError("Can't find child with this path") - new_len = len(self._children) - 1 - result = utils.RunCmd(["mdadm", "-f", self.dev_path, dev_path]) - if result.failed: - raise errors.BlockDeviceError("Failed to mark device as failed: %s" % - result.output) + data = cls._GetProcData() - # it seems here we need a short delay for MD to update its - # superblocks - time.sleep(0.5) - result = utils.RunCmd(["mdadm", "-r", self.dev_path, dev_path]) - if result.failed: - raise errors.BlockDeviceError("Failed to remove device from array:" - " %s" % result.output) - result = utils.RunCmd(["mdadm", "--grow", "--force", self.dev_path, - "-n", new_len]) + unused_line = re.compile("^ *([0-9]+): cs:Unconfigured$") + used_line = re.compile("^ *([0-9]+): cs:") + highest = None + for line in data: + match = unused_line.match(line) + if match: + return int(match.group(1)) + match = used_line.match(line) + if match: + minor = int(match.group(1)) + highest = max(highest, minor) + if highest is None: # there are no minors in use at all + return 0 + if highest >= cls._MAX_MINORS: + logging.error("Error: no free drbd minors!") + raise errors.BlockDeviceError("Can't find a free DRBD minor") + return highest + 1 + + @classmethod + def _IsValidMeta(cls, meta_device): + """Check if the given meta device looks like a valid one. + + """ + minor = cls._FindUnusedMinor() + minor_path = cls._DevPath(minor) + result = utils.RunCmd(["drbdmeta", minor_path, + "v08", meta_device, "0", + "dstate"]) if result.failed: - raise errors.BlockDeviceError("Can't shrink md array: %s" % - result.output) - self._children.remove(device) + logging.error("Invalid meta device %s: %s", meta_device, result.output) + return False + return True + @classmethod + def _GetShowParser(cls): + """Return a parser for `drbd show` output. - def GetStatus(self): - """Return the status of the device. + This will either create or return an already-create parser for the + output of the command `drbd show`. """ - self.Attach() - if self.minor is None: - retval = self.STATUS_UNKNOWN - else: - retval = self.STATUS_ONLINE - return retval + if cls._PARSE_SHOW is not None: + return cls._PARSE_SHOW + # pyparsing setup + lbrace = pyp.Literal("{").suppress() + rbrace = pyp.Literal("}").suppress() + semi = pyp.Literal(";").suppress() + # this also converts the value to an int + number = pyp.Word(pyp.nums).setParseAction(lambda s, l, t: int(t[0])) - def _SetFromMinor(self, minor): - """Set our parameters based on the given minor. + comment = pyp.Literal ("#") + pyp.Optional(pyp.restOfLine) + defa = pyp.Literal("_is_default").suppress() + dbl_quote = pyp.Literal('"').suppress() - This sets our minor variable and our dev_path. + keyword = pyp.Word(pyp.alphanums + '-') - """ - self.minor = minor - self.dev_path = "/dev/md%d" % minor + # value types + value = pyp.Word(pyp.alphanums + '_-/.:') + quoted = dbl_quote + pyp.CharsNotIn('"') + dbl_quote + addr_port = (pyp.Word(pyp.nums + '.') + pyp.Literal(':').suppress() + + number) + # meta device, extended syntax + meta_value = ((value ^ quoted) + pyp.Literal('[').suppress() + + number + pyp.Word(']').suppress()) + # a statement + stmt = (~rbrace + keyword + ~lbrace + + pyp.Optional(addr_port ^ value ^ quoted ^ meta_value) + + pyp.Optional(defa) + semi + + pyp.Optional(pyp.restOfLine).suppress()) - def Assemble(self): - """Assemble the MD device. + # an entire section + section_name = pyp.Word(pyp.alphas + '_') + section = section_name + lbrace + pyp.ZeroOrMore(pyp.Group(stmt)) + rbrace + + bnf = pyp.ZeroOrMore(pyp.Group(section ^ stmt)) + bnf.ignore(comment) - At this point we should have: - - list of children devices - - uuid + cls._PARSE_SHOW = bnf + + return bnf + + @classmethod + def _GetShowData(cls, minor): + """Return the `drbdsetup show` data for a minor. """ - result = super(MDRaid1, self).Assemble() - if not result: - return result - md_list = self._GetUsedDevs() - for minor in md_list: - info = self._GetDevInfo(minor) - if info and info["uuid"] == self.unique_id: - self._SetFromMinor(minor) - logger.Info("MD array %s already started" % str(self)) - return True - free_minor = self._FindUnusedMinor() - result = utils.RunCmd(["mdadm", "-A", "--auto=yes", "--uuid", - self.unique_id, "/dev/md%d" % free_minor] + - [bdev.dev_path for bdev in self._children]) - if result.failed: - logger.Error("Can't assemble MD array: %s: %s" % - (result.fail_reason, result.output)) - self.minor = None - else: - self.minor = free_minor - return not result.failed - - - def Shutdown(self): - """Tear down the MD array. - - This does a 'mdadm --stop' so after this command, the array is no - longer available. - - """ - if self.minor is None and not self.Attach(): - logger.Info("MD object not attached to a device") - return True - - result = utils.RunCmd(["mdadm", "--stop", "/dev/md%d" % self.minor]) + result = utils.RunCmd(["drbdsetup", cls._DevPath(minor), "show"]) if result.failed: - logger.Error("Can't stop MD array: %s" % result.fail_reason) - return False - self.minor = None - self.dev_path = None - return True - - - def SetSyncSpeed(self, kbytes): - """Set the maximum sync speed for the MD array. - - """ - result = super(MDRaid1, self).SetSyncSpeed(kbytes) - if self.minor is None: - logger.Error("MD array not attached to a device") - return False - f = open("/sys/block/md%d/md/sync_speed_max" % self.minor, "w") - try: - f.write("%d" % kbytes) - finally: - f.close() - f = open("/sys/block/md%d/md/sync_speed_min" % self.minor, "w") - try: - f.write("%d" % (kbytes/2)) - finally: - f.close() - return result - - - def GetSyncStatus(self): - """Returns the sync status of the device. - - Returns: - (sync_percent, estimated_time) - - If sync_percent is None, it means all is ok - If estimated_time is None, it means we can't esimate - the time needed, otherwise it's the time left in seconds - - """ - if self.minor is None and not self.Attach(): - raise errors.BlockDeviceError("Can't attach to device in GetSyncStatus") - dev_info = self._GetDevInfo(self.minor) - is_clean = ("state" in dev_info and - len(dev_info["state"]) == 1 and - dev_info["state"][0] in ("clean", "active")) - sys_path = "/sys/block/md%s/md/" % self.minor - f = file(sys_path + "sync_action") - sync_status = f.readline().strip() - f.close() - if sync_status == "idle": - return None, None, not is_clean - f = file(sys_path + "sync_completed") - sync_completed = f.readline().strip().split(" / ") - f.close() - if len(sync_completed) != 2: - return 0, None, not is_clean - sync_done, sync_total = [float(i) for i in sync_completed] - sync_percent = 100.0*sync_done/sync_total - f = file(sys_path + "sync_speed") - sync_speed_k = int(f.readline().strip()) - if sync_speed_k == 0: - time_est = None - else: - time_est = (sync_total - sync_done) / 2 / sync_speed_k - return sync_percent, time_est, not is_clean - - - def Open(self, force=False): - """Make the device ready for I/O. - - This is a no-op for the MDRaid1 device type, although we could use - the 2.6.18's new array_state thing. - - """ - return True - - - def Close(self): - """Notifies that the device will no longer be used for I/O. - - This is a no-op for the MDRaid1 device type, but see comment for - `Open()`. - - """ - return True - - -class BaseDRBD(BlockDev): - """Base DRBD class. - - This class contains a few bits of common functionality between the - 0.7 and 8.x versions of DRBD. - - """ - _VERSION_RE = re.compile(r"^version: (\d+)\.(\d+)\.(\d+)" - r" \(api:(\d+)/proto:(\d+)\)") - _DRBD_MAJOR = 147 - _ST_UNCONFIGURED = "Unconfigured" - _ST_WFCONNECTION = "WFConnection" - _ST_CONNECTED = "Connected" - - @staticmethod - def _GetProcData(): - """Return data from /proc/drbd. - - """ - stat = open("/proc/drbd", "r") - try: - data = stat.read().splitlines() - finally: - stat.close() - if not data: - raise errors.BlockDeviceError("Can't read any data from /proc/drbd") - return data - - @classmethod - def _GetVersion(cls): - """Return the DRBD version. - - This will return a list [k_major, k_minor, k_point, api, proto]. - - """ - proc_data = cls._GetProcData() - first_line = proc_data[0].strip() - version = cls._VERSION_RE.match(first_line) - if not version: - raise errors.BlockDeviceError("Can't parse DRBD version from '%s'" % - first_line) - return [int(val) for val in version.groups()] - - @staticmethod - def _DevPath(minor): - """Return the path to a drbd device for a given minor. - - """ - return "/dev/drbd%d" % minor - - @classmethod - def _GetUsedDevs(cls): - """Compute the list of used DRBD devices. - - """ - data = cls._GetProcData() - - used_devs = {} - valid_line = re.compile("^ *([0-9]+): cs:([^ ]+).*$") - for line in data: - match = valid_line.match(line) - if not match: - continue - minor = int(match.group(1)) - state = match.group(2) - if state == cls._ST_UNCONFIGURED: - continue - used_devs[minor] = state, line - - return used_devs - - -class DRBDev(BaseDRBD): - """DRBD block device. - - This implements the local host part of the DRBD device, i.e. it - doesn't do anything to the supposed peer. If you need a fully - connected DRBD pair, you need to use this class on both hosts. - - The unique_id for the drbd device is the (local_ip, local_port, - remote_ip, remote_port) tuple, and it must have two children: the - data device and the meta_device. The meta device is checked for - valid size and is zeroed on create. - - """ - def __init__(self, unique_id, children): - super(DRBDev, self).__init__(unique_id, children) - self.major = self._DRBD_MAJOR - [kmaj, kmin, kfix, api, proto] = self._GetVersion() - if kmaj != 0 and kmin != 7: - raise errors.BlockDeviceError("Mismatch in DRBD kernel version and" - " requested ganeti usage: kernel is" - " %s.%s, ganeti wants 0.7" % (kmaj, kmin)) - - if len(children) != 2: - raise ValueError("Invalid configuration data %s" % str(children)) - if not isinstance(unique_id, (tuple, list)) or len(unique_id) != 4: - raise ValueError("Invalid configuration data %s" % str(unique_id)) - self._lhost, self._lport, self._rhost, self._rport = unique_id - self.Attach() - - @classmethod - def _FindUnusedMinor(cls): - """Find an unused DRBD device. - - """ - data = cls._GetProcData() - - valid_line = re.compile("^ *([0-9]+): cs:Unconfigured$") - for line in data: - match = valid_line.match(line) - if match: - return int(match.group(1)) - logger.Error("Error: no free drbd minors!") - raise errors.BlockDeviceError("Can't find a free DRBD minor") + logging.error("Can't display the drbd config: %s - %s", + result.fail_reason, result.output) + return None + return result.stdout @classmethod - def _GetDevInfo(cls, minor): - """Get details about a given DRBD minor. + def _GetDevInfo(cls, out): + """Parse details about a given DRBD minor. - This return, if available, the local backing device in (major, - minor) formant and the local and remote (ip, port) information. + This return, if available, the local backing device (as a path) + and the local and remote (ip, port) information from a string + containing the output of the `drbdsetup show` command as returned + by _GetShowData. """ data = {} - result = utils.RunCmd(["drbdsetup", cls._DevPath(minor), "show"]) - if result.failed: - logger.Error("Can't display the drbd config: %s" % result.fail_reason) + if not out: return data - out = result.stdout - if out == "Not configured\n": - return data - for line in out.splitlines(): - if "local_dev" not in data: - match = re.match("^Lower device: ([0-9]+):([0-9]+) .*$", line) - if match: - data["local_dev"] = (int(match.group(1)), int(match.group(2))) - continue - if "meta_dev" not in data: - match = re.match("^Meta device: (([0-9]+):([0-9]+)|internal).*$", line) - if match: - if match.group(2) is not None and match.group(3) is not None: - # matched on the major/minor - data["meta_dev"] = (int(match.group(2)), int(match.group(3))) - else: - # matched on the "internal" string - data["meta_dev"] = match.group(1) - # in this case, no meta_index is in the output - data["meta_index"] = -1 - continue - if "meta_index" not in data: - match = re.match("^Meta index: ([0-9]+).*$", line) - if match: - data["meta_index"] = int(match.group(1)) - continue - if "local_addr" not in data: - match = re.match("^Local address: ([0-9.]+):([0-9]+)$", line) - if match: - data["local_addr"] = (match.group(1), int(match.group(2))) - continue - if "remote_addr" not in data: - match = re.match("^Remote address: ([0-9.]+):([0-9]+)$", line) - if match: - data["remote_addr"] = (match.group(1), int(match.group(2))) - continue - return data + bnf = cls._GetShowParser() + # run pyparse + + try: + results = bnf.parseString(out) + except pyp.ParseException, err: + raise errors.BlockDeviceError("Can't parse drbdsetup show output: %s" % + str(err)) + + # and massage the results into our desired format + for section in results: + sname = section[0] + if sname == "_this_host": + for lst in section[1:]: + if lst[0] == "disk": + data["local_dev"] = lst[1] + elif lst[0] == "meta-disk": + data["meta_dev"] = lst[1] + data["meta_index"] = lst[2] + elif lst[0] == "address": + data["local_addr"] = tuple(lst[1:]) + elif sname == "_remote_host": + for lst in section[1:]: + if lst[0] == "address": + data["remote_addr"] = tuple(lst[1:]) + return data def _MatchesLocal(self, info): """Test if our local config matches with an existing device. @@ -1085,25 +977,26 @@ class DRBDev(BaseDRBD): device. """ - if not ("local_dev" in info and "meta_dev" in info and - "meta_index" in info): - return False + if self._children: + backend, meta = self._children + else: + backend = meta = None - backend = self._children[0] if backend is not None: - retval = (info["local_dev"] == (backend.major, backend.minor)) + retval = ("local_dev" in info and info["local_dev"] == backend.dev_path) else: - retval = (info["local_dev"] == (0, 0)) - meta = self._children[1] + retval = ("local_dev" not in info) + if meta is not None: - retval = retval and (info["meta_dev"] == (meta.major, meta.minor)) - retval = retval and (info["meta_index"] == 0) + retval = retval and ("meta_dev" in info and + info["meta_dev"] == meta.dev_path) + retval = retval and ("meta_index" in info and + info["meta_index"] == 0) else: - retval = retval and (info["meta_dev"] == "internal" and - info["meta_index"] == -1) + retval = retval and ("meta_dev" not in info and + "meta_index" not in info) return retval - def _MatchesNet(self, info): """Test if our network config matches with an existing device. @@ -1129,34 +1022,6 @@ class DRBDev(BaseDRBD): info["remote_addr"] == (self._rhost, self._rport)) return retval - - @staticmethod - def _IsValidMeta(meta_device): - """Check if the given meta device looks like a valid one. - - This currently only check the size, which must be around - 128MiB. - - """ - result = utils.RunCmd(["blockdev", "--getsize", meta_device]) - if result.failed: - logger.Error("Failed to get device size: %s" % result.fail_reason) - return False - try: - sectors = int(result.stdout) - except ValueError: - logger.Error("Invalid output from blockdev: '%s'" % result.stdout) - return False - bytes = sectors * 512 - if bytes < 128*1024*1024: # less than 128MiB - logger.Error("Meta device too small (%.2fMib)" % (bytes/1024/1024)) - return False - if bytes > (128+32)*1024*1024: # account for an extra (big) PE on LVM - logger.Error("Meta device too big (%.2fMiB)" % (bytes/1024/1024)) - return False - return True - - @classmethod def _AssembleLocal(cls, minor, backend, meta): """Configure the local part of a DRBD device. @@ -1167,65 +1032,45 @@ class DRBDev(BaseDRBD): """ if not cls._IsValidMeta(meta): return False - result = utils.RunCmd(["drbdsetup", cls._DevPath(minor), "disk", - backend, meta, "0", "-e", "detach"]) - if result.failed: - logger.Error("Can't attach local disk: %s" % result.output) - return not result.failed - - - @classmethod - def _ShutdownLocal(cls, minor): - """Detach from the local device. - - I/Os will continue to be served from the remote device. If we - don't have a remote device, this operation will fail. - - """ - result = utils.RunCmd(["drbdsetup", cls._DevPath(minor), "detach"]) - if result.failed: - logger.Error("Can't detach local device: %s" % result.output) - return not result.failed - - - @staticmethod - def _ShutdownAll(minor): - """Deactivate the device. - - This will, of course, fail if the device is in use. - - """ - result = utils.RunCmd(["drbdsetup", DRBDev._DevPath(minor), "down"]) + args = ["drbdsetup", cls._DevPath(minor), "disk", + backend, meta, "0", "-e", "detach", "--create-device"] + result = utils.RunCmd(args) if result.failed: - logger.Error("Can't shutdown drbd device: %s" % result.output) + logging.error("Can't attach local disk: %s", result.output) return not result.failed - @classmethod - def _AssembleNet(cls, minor, net_info, protocol): + def _AssembleNet(cls, minor, net_info, protocol, + dual_pri=False, hmac=None, secret=None): """Configure the network part of the device. - This operation can be, in theory, done multiple times, but there - have been cases (in lab testing) in which the network part of the - device had become stuck and couldn't be shut down because activity - from the new peer (also stuck) triggered a timer re-init and - needed remote peer interface shutdown in order to clear. So please - don't change online the net config. - """ lhost, lport, rhost, rport = net_info - result = utils.RunCmd(["drbdsetup", cls._DevPath(minor), "net", - "%s:%s" % (lhost, lport), "%s:%s" % (rhost, rport), - protocol]) + if None in net_info: + # we don't want network connection and actually want to make + # sure its shutdown + return cls._ShutdownNet(minor) + + args = ["drbdsetup", cls._DevPath(minor), "net", + "%s:%s" % (lhost, lport), "%s:%s" % (rhost, rport), protocol, + "-A", "discard-zero-changes", + "-B", "consensus", + "--create-device", + ] + if dual_pri: + args.append("-m") + if hmac and secret: + args.extend(["-a", hmac, "-x", secret]) + result = utils.RunCmd(args) if result.failed: - logger.Error("Can't setup network for dbrd device: %s" % - result.fail_reason) + logging.error("Can't setup network for dbrd device: %s - %s", + result.fail_reason, result.output) return False timeout = time.time() + 10 ok = False while time.time() < timeout: - info = cls._GetDevInfo(minor) + info = cls._GetDevInfo(cls._GetShowData(minor)) if not "local_addr" in info or not "remote_addr" in info: time.sleep(1) continue @@ -1236,35 +1081,209 @@ class DRBDev(BaseDRBD): ok = True break if not ok: - logger.Error("Timeout while configuring network") + logging.error("Timeout while configuring network") return False return True + def AddChildren(self, devices): + """Add a disk to the DRBD device. + + """ + if self.minor is None: + raise errors.BlockDeviceError("Can't attach to dbrd8 during AddChildren") + if len(devices) != 2: + raise errors.BlockDeviceError("Need two devices for AddChildren") + info = self._GetDevInfo(self._GetShowData(self.minor)) + if "local_dev" in info: + raise errors.BlockDeviceError("DRBD8 already attached to a local disk") + backend, meta = devices + if backend.dev_path is None or meta.dev_path is None: + raise errors.BlockDeviceError("Children not ready during AddChildren") + backend.Open() + meta.Open() + if not self._CheckMetaSize(meta.dev_path): + raise errors.BlockDeviceError("Invalid meta device size") + self._InitMeta(self._FindUnusedMinor(), meta.dev_path) + if not self._IsValidMeta(meta.dev_path): + raise errors.BlockDeviceError("Cannot initalize meta device") + + if not self._AssembleLocal(self.minor, backend.dev_path, meta.dev_path): + raise errors.BlockDeviceError("Can't attach to local storage") + self._children = devices + + def RemoveChildren(self, devices): + """Detach the drbd device from local storage. + + """ + if self.minor is None: + raise errors.BlockDeviceError("Can't attach to drbd8 during" + " RemoveChildren") + # early return if we don't actually have backing storage + info = self._GetDevInfo(self._GetShowData(self.minor)) + if "local_dev" not in info: + return + if len(self._children) != 2: + raise errors.BlockDeviceError("We don't have two children: %s" % + self._children) + if self._children.count(None) == 2: # we don't actually have children :) + logging.error("Requested detach while detached") + return + if len(devices) != 2: + raise errors.BlockDeviceError("We need two children in RemoveChildren") + for child, dev in zip(self._children, devices): + if dev != child.dev_path: + raise errors.BlockDeviceError("Mismatch in local storage" + " (%s != %s) in RemoveChildren" % + (dev, child.dev_path)) + + if not self._ShutdownLocal(self.minor): + raise errors.BlockDeviceError("Can't detach from local storage") + self._children = [] + + def SetSyncSpeed(self, kbytes): + """Set the speed of the DRBD syncer. + + """ + children_result = super(DRBD8, self).SetSyncSpeed(kbytes) + if self.minor is None: + logging.info("Instance not attached to a device") + return False + result = utils.RunCmd(["drbdsetup", self.dev_path, "syncer", "-r", "%d" % + kbytes]) + if result.failed: + logging.error("Can't change syncer rate: %s - %s", + result.fail_reason, result.output) + return not result.failed and children_result + + def GetProcStatus(self): + """Return device data from /proc. + + """ + if self.minor is None: + raise errors.BlockDeviceError("GetStats() called while not attached") + proc_info = self._MassageProcData(self._GetProcData()) + if self.minor not in proc_info: + raise errors.BlockDeviceError("Can't find myself in /proc (minor %d)" % + self.minor) + return DRBD8Status(proc_info[self.minor]) + + def GetSyncStatus(self): + """Returns the sync status of the device. + + Returns: + (sync_percent, estimated_time, is_degraded) + + If sync_percent is None, it means all is ok + If estimated_time is None, it means we can't esimate + the time needed, otherwise it's the time left in seconds. + - @classmethod - def _ShutdownNet(cls, minor): - """Disconnect from the remote peer. + We set the is_degraded parameter to True on two conditions: + network not connected or local disk missing. - This fails if we don't have a local device. + We compute the ldisk parameter based on wheter we have a local + disk or not. """ - result = utils.RunCmd(["drbdsetup", cls._DevPath(minor), "disconnect"]) - logger.Error("Can't shutdown network: %s" % result.output) - return not result.failed + if self.minor is None and not self.Attach(): + raise errors.BlockDeviceError("Can't attach to device in GetSyncStatus") + stats = self.GetProcStatus() + ldisk = not stats.is_disk_uptodate + is_degraded = not stats.is_connected + return stats.sync_percent, stats.est_time, is_degraded or ldisk, ldisk + def Open(self, force=False): + """Make the local state primary. - def _SetFromMinor(self, minor): - """Set our parameters based on the given minor. + If the 'force' parameter is given, the '-o' option is passed to + drbdsetup. Since this is a potentially dangerous operation, the + force flag should be only given after creation, when it actually + is mandatory. - This sets our minor variable and our dev_path. + """ + if self.minor is None and not self.Attach(): + logging.error("DRBD cannot attach to a device during open") + return False + cmd = ["drbdsetup", self.dev_path, "primary"] + if force: + cmd.append("-o") + result = utils.RunCmd(cmd) + if result.failed: + msg = ("Can't make drbd device primary: %s" % result.output) + logging.error(msg) + raise errors.BlockDeviceError(msg) + + def Close(self): + """Make the local state secondary. + + This will, of course, fail if the device is in use. """ - if minor is None: - self.minor = self.dev_path = None + if self.minor is None and not self.Attach(): + logging.info("Instance not attached to a device") + raise errors.BlockDeviceError("Can't find device") + result = utils.RunCmd(["drbdsetup", self.dev_path, "secondary"]) + if result.failed: + msg = ("Can't switch drbd device to" + " secondary: %s" % result.output) + logging.error(msg) + raise errors.BlockDeviceError(msg) + + def Attach(self): + """Find a DRBD device which matches our config and attach to it. + + In case of partially attached (local device matches but no network + setup), we perform the network attach. If successful, we re-test + the attach if can return success. + + """ + for minor in self._GetUsedDevs(): + info = self._GetDevInfo(self._GetShowData(minor)) + match_l = self._MatchesLocal(info) + match_r = self._MatchesNet(info) + if match_l and match_r: + break + if match_l and not match_r and "local_addr" not in info: + res_r = self._AssembleNet(minor, + (self._lhost, self._lport, + self._rhost, self._rport), + "C") + if res_r: + if self._MatchesNet(self._GetDevInfo(self._GetShowData(minor))): + break + # the weakest case: we find something that is only net attached + # even though we were passed some children at init time + if match_r and "local_dev" not in info: + break + + # this case must be considered only if we actually have local + # storage, i.e. not in diskless mode, because all diskless + # devices are equal from the point of view of local + # configuration + if (match_l and "local_dev" in info and + not match_r and "local_addr" in info): + # strange case - the device network part points to somewhere + # else, even though its local storage is ours; as we own the + # drbd space, we try to disconnect from the remote peer and + # reconnect to our correct one + if not self._ShutdownNet(minor): + raise errors.BlockDeviceError("Device has correct local storage," + " wrong remote peer and is unable to" + " disconnect in order to attach to" + " the correct peer") + # note: _AssembleNet also handles the case when we don't want + # local storage (i.e. one or more of the _[lr](host|port) is + # None) + if (self._AssembleNet(minor, (self._lhost, self._lport, + self._rhost, self._rport), "C") and + self._MatchesNet(self._GetDevInfo(self._GetShowData(minor)))): + break + else: - self.minor = minor - self.dev_path = self._DevPath(minor) + minor = None + self._SetFromMinor(minor) + return minor is not None def Assemble(self): """Assemble the drbd. @@ -1287,16 +1306,16 @@ class DRBDev(BaseDRBD): """ self.Attach() if self.minor is not None: - logger.Info("Already assembled") + logging.info("Already assembled") return True - result = super(DRBDev, self).Assemble() + result = super(DRBD8, self).Assemble() if not result: return result minor = self._FindUnusedMinor() need_localdev_teardown = False - if self._children[0]: + if self._children and self._children[0] and self._children[1]: result = self._AssembleLocal(minor, self._children[0].dev_path, self._children[1].dev_path) if not result: @@ -1310,251 +1329,220 @@ class DRBDev(BaseDRBD): if not result: if need_localdev_teardown: # we will ignore failures from this - logger.Error("net setup failed, tearing down local device") + logging.error("net setup failed, tearing down local device") self._ShutdownAll(minor) return False self._SetFromMinor(minor) return True + @classmethod + def _ShutdownLocal(cls, minor): + """Detach from the local device. - def Shutdown(self): - """Shutdown the DRBD device. + I/Os will continue to be served from the remote device. If we + don't have a remote device, this operation will fail. """ - if self.minor is None and not self.Attach(): - logger.Info("DRBD device not attached to a device during Shutdown") - return True - if not self._ShutdownAll(self.minor): - return False - self.minor = None - self.dev_path = None - return True - + result = utils.RunCmd(["drbdsetup", cls._DevPath(minor), "detach"]) + if result.failed: + logging.error("Can't detach local device: %s", result.output) + return not result.failed - def Attach(self): - """Find a DRBD device which matches our config and attach to it. + @classmethod + def _ShutdownNet(cls, minor): + """Disconnect from the remote peer. - In case of partially attached (local device matches but no network - setup), we perform the network attach. If successful, we re-test - the attach if can return success. + This fails if we don't have a local device. """ - for minor in self._GetUsedDevs(): - info = self._GetDevInfo(minor) - match_l = self._MatchesLocal(info) - match_r = self._MatchesNet(info) - if match_l and match_r: - break - if match_l and not match_r and "local_addr" not in info: - res_r = self._AssembleNet(minor, - (self._lhost, self._lport, - self._rhost, self._rport), - "C") - if res_r and self._MatchesNet(self._GetDevInfo(minor)): - break - else: - minor = None + result = utils.RunCmd(["drbdsetup", cls._DevPath(minor), "disconnect"]) + if result.failed: + logging.error("Can't shutdown network: %s", result.output) + return not result.failed - self._SetFromMinor(minor) - return minor is not None + @classmethod + def _ShutdownAll(cls, minor): + """Deactivate the device. + This will, of course, fail if the device is in use. - def Open(self, force=False): - """Make the local state primary. + """ + result = utils.RunCmd(["drbdsetup", cls._DevPath(minor), "down"]) + if result.failed: + logging.error("Can't shutdown drbd device: %s", result.output) + return not result.failed - If the 'force' parameter is given, the '--do-what-I-say' parameter - is given. Since this is a pottentialy dangerous operation, the - force flag should be only given after creation, when it actually - has to be given. + def Shutdown(self): + """Shutdown the DRBD device. """ if self.minor is None and not self.Attach(): - logger.Error("DRBD cannot attach to a device during open") - return False - cmd = ["drbdsetup", self.dev_path, "primary"] - if force: - cmd.append("--do-what-I-say") - result = utils.RunCmd(cmd) - if result.failed: - logger.Error("Can't make drbd device primary: %s" % result.output) + logging.info("DRBD device not attached to a device during Shutdown") + return True + if not self._ShutdownAll(self.minor): return False + self.minor = None + self.dev_path = None return True + def Remove(self): + """Stub remove for DRBD devices. + + """ + return self.Shutdown() - def Close(self): - """Make the local state secondary. + @classmethod + def Create(cls, unique_id, children, size): + """Create a new DRBD8 device. - This will, of course, fail if the device is in use. + Since DRBD devices are not created per se, just assembled, this + function only initializes the metadata. """ - if self.minor is None and not self.Attach(): - logger.Info("Instance not attached to a device") - raise errors.BlockDeviceError("Can't find device") - result = utils.RunCmd(["drbdsetup", self.dev_path, "secondary"]) - if result.failed: - logger.Error("Can't switch drbd device to secondary: %s" % result.output) - raise errors.BlockDeviceError("Can't switch drbd device to secondary") - + if len(children) != 2: + raise errors.ProgrammerError("Invalid setup for the drbd device") + meta = children[1] + meta.Assemble() + if not meta.Attach(): + raise errors.BlockDeviceError("Can't attach to meta device") + if not cls._CheckMetaSize(meta.dev_path): + raise errors.BlockDeviceError("Invalid meta device size") + cls._InitMeta(cls._FindUnusedMinor(), meta.dev_path) + if not cls._IsValidMeta(meta.dev_path): + raise errors.BlockDeviceError("Cannot initalize meta device") + return cls(unique_id, children) - def SetSyncSpeed(self, kbytes): - """Set the speed of the DRBD syncer. + def Grow(self, amount): + """Resize the DRBD device and its backing storage. """ - children_result = super(DRBDev, self).SetSyncSpeed(kbytes) if self.minor is None: - logger.Info("Instance not attached to a device") - return False - result = utils.RunCmd(["drbdsetup", self.dev_path, "syncer", "-r", "%d" % - kbytes]) + raise errors.ProgrammerError("drbd8: Grow called while not attached") + if len(self._children) != 2 or None in self._children: + raise errors.BlockDeviceError("Cannot grow diskless DRBD8 device") + self._children[0].Grow(amount) + result = utils.RunCmd(["drbdsetup", self.dev_path, "resize"]) if result.failed: - logger.Error("Can't change syncer rate: %s " % result.fail_reason) - return not result.failed and children_result + raise errors.BlockDeviceError("resize failed for %s: %s" % + (self.dev_path, result.output)) + return - def GetSyncStatus(self): - """Returns the sync status of the device. +class FileStorage(BlockDev): + """File device. - Returns: - (sync_percent, estimated_time) + This class represents the a file storage backend device. - If sync_percent is None, it means all is ok - If estimated_time is None, it means we can't esimate - the time needed, otherwise it's the time left in seconds + The unique_id for the file device is a (file_driver, file_path) tuple. - """ - if self.minor is None and not self.Attach(): - raise errors.BlockDeviceError("Can't attach to device in GetSyncStatus") - proc_info = self._MassageProcData(self._GetProcData()) - if self.minor not in proc_info: - raise errors.BlockDeviceError("Can't find myself in /proc (minor %d)" % - self.minor) - line = proc_info[self.minor] - match = re.match("^.*sync'ed: *([0-9.]+)%.*" - " finish: ([0-9]+):([0-9]+):([0-9]+) .*$", line) - if match: - sync_percent = float(match.group(1)) - hours = int(match.group(2)) - minutes = int(match.group(3)) - seconds = int(match.group(4)) - est_time = hours * 3600 + minutes * 60 + seconds - else: - sync_percent = None - est_time = None - match = re.match("^ *[0-9]+: cs:([^ ]+).*$", line) - if not match: - raise errors.BlockDeviceError("Can't find my data in /proc (minor %d)" % - self.minor) - client_state = match.group(1) - is_degraded = client_state != "Connected" - return sync_percent, est_time, is_degraded + """ + def __init__(self, unique_id, children): + """Initalizes a file device backend. + """ + if children: + raise errors.BlockDeviceError("Invalid setup for file device") + super(FileStorage, self).__init__(unique_id, children) + if not isinstance(unique_id, (tuple, list)) or len(unique_id) != 2: + raise ValueError("Invalid configuration data %s" % str(unique_id)) + self.driver = unique_id[0] + self.dev_path = unique_id[1] - @staticmethod - def _MassageProcData(data): - """Transform the output of _GetProdData into a nicer form. + def Assemble(self): + """Assemble the device. - Returns: - a dictionary of minor: joined lines from /proc/drbd for that minor + Checks whether the file device exists, raises BlockDeviceError otherwise. """ - lmatch = re.compile("^ *([0-9]+):.*$") - results = {} - old_minor = old_line = None - for line in data: - lresult = lmatch.match(line) - if lresult is not None: - if old_minor is not None: - results[old_minor] = old_line - old_minor = int(lresult.group(1)) - old_line = line - else: - if old_minor is not None: - old_line += " " + line.strip() - # add last line - if old_minor is not None: - results[old_minor] = old_line - return results - + if not os.path.exists(self.dev_path): + raise errors.BlockDeviceError("File device '%s' does not exist." % + self.dev_path) + return True - def GetStatus(self): - """Compute the status of the DRBD device + def Shutdown(self): + """Shutdown the device. - Note that DRBD devices don't have the STATUS_EXISTING state. + This is a no-op for the file type, as we don't deacivate + the file on shutdown. """ - if self.minor is None and not self.Attach(): - return self.STATUS_UNKNOWN + return True - data = self._GetProcData() - match = re.compile("^ *%d: cs:[^ ]+ st:(Primary|Secondary)/.*$" % - self.minor) - for line in data: - mresult = match.match(line) - if mresult: - break - else: - logger.Error("Can't find myself!") - return self.STATUS_UNKNOWN + def Open(self, force=False): + """Make the device ready for I/O. - state = mresult.group(2) - if state == "Primary": - result = self.STATUS_ONLINE - else: - result = self.STATUS_STANDBY + This is a no-op for the file type. - return result + """ + pass + def Close(self): + """Notifies that the device will no longer be used for I/O. - @staticmethod - def _ZeroDevice(device): - """Zero a device. + This is a no-op for the file type. - This writes until we get ENOSPC. + """ + pass + + def Remove(self): + """Remove the file backing the block device. + + Returns: + boolean indicating wheter removal of file was successful or not. """ - f = open(device, "w") - buf = "\0" * 1048576 + if not os.path.exists(self.dev_path): + return True try: - while True: - f.write(buf) - except IOError, err: - if err.errno != errno.ENOSPC: - raise + os.remove(self.dev_path) + return True + except OSError, err: + logging.error("Can't remove file '%s': %s", self.dev_path, err) + return False + def Attach(self): + """Attach to an existing file. - @classmethod - def Create(cls, unique_id, children, size): - """Create a new DRBD device. + Check if this file already exists. - Since DRBD devices are not created per se, just assembled, this - function just zeroes the meta device. + Returns: + boolean indicating if file exists or not. """ - if len(children) != 2: - raise errors.ProgrammerError("Invalid setup for the drbd device") - meta = children[1] - meta.Assemble() - if not meta.Attach(): - raise errors.BlockDeviceError("Can't attach to meta device") - if not cls._IsValidMeta(meta.dev_path): - raise errors.BlockDeviceError("Invalid meta device") - logger.Info("Started zeroing device %s" % meta.dev_path) - cls._ZeroDevice(meta.dev_path) - logger.Info("Done zeroing device %s" % meta.dev_path) - return cls(unique_id, children) + if os.path.exists(self.dev_path): + return True + return False + @classmethod + def Create(cls, unique_id, children, size): + """Create a new file. - def Remove(self): - """Stub remove for DRBD devices. + Args: + children: + size: integer size of file in MiB + + Returns: + A ganeti.bdev.FileStorage object. """ - return self.Shutdown() + if not isinstance(unique_id, (tuple, list)) or len(unique_id) != 2: + raise ValueError("Invalid configuration data %s" % str(unique_id)) + dev_path = unique_id[1] + try: + f = open(dev_path, 'w') + except IOError, err: + raise errors.BlockDeviceError("Could not create '%'" % err) + else: + f.truncate(size * 1024 * 1024) + f.close() + + return FileStorage(unique_id, children) DEV_MAP = { constants.LD_LV: LogicalVolume, - constants.LD_MD_R1: MDRaid1, - constants.LD_DRBD7: DRBDev, + constants.LD_DRBD8: DRBD8, + constants.LD_FILE: FileStorage, } @@ -1568,7 +1556,7 @@ def FindDevice(dev_type, unique_id, children): if dev_type not in DEV_MAP: raise errors.ProgrammerError("Invalid block device type '%s'" % dev_type) device = DEV_MAP[dev_type](unique_id, children) - if not device.Attach(): + if not device.attached: return None return device @@ -1583,12 +1571,12 @@ def AttachOrAssemble(dev_type, unique_id, children): if dev_type not in DEV_MAP: raise errors.ProgrammerError("Invalid block device type '%s'" % dev_type) device = DEV_MAP[dev_type](unique_id, children) - if not device.Attach(): + if not device.attached: device.Assemble() - if not device.Attach(): - raise errors.BlockDeviceError("Can't find a valid block device for" - " %s/%s/%s" % - (dev_type, unique_id, children)) + if not device.attached: + raise errors.BlockDeviceError("Can't find a valid block device for" + " %s/%s/%s" % + (dev_type, unique_id, children)) return device