def _quotas(cls, request, pool):
new_quota_state = cls._validate_new_quota_state(request)
# If no change from current pool quota state then do nothing
current_state = "Enabled"
if not pool.quotas_enabled:
current_state = "Disabled"
if new_quota_state == current_state:
return Response()
try:
if new_quota_state == "Enabled":
# Current issue with requiring enable to be executed twice !!!
# As of 4.12.4-1.el7.elrepo.x86_64
# this avoids "ERROR: quota rescan failed: Invalid argument"
# when attempting a rescan.
# Look similar to https://patchwork.kernel.org/patch/9928635/
enable_quota(pool)
enable_quota(pool)
# As of 4.12.4-1.el7.elrepo.x86_64
# The second above enable_quota() call currently initiates a
# rescan so the following is redundant; however this may not
# always be the case so leaving as it will auto skip if a scan
# in in progress anyway.
rescan_quotas(pool)
else:
disable_quota(pool)
except:
e_msg = ("Failed to Enable (and rescan) / Disable Quotas for "
"Pool ({}). Requested quota state "
"was ({}).".format(pool.name, new_quota_state))
handle_exception(Exception(e_msg), request)
return Response(PoolInfoSerializer(pool).data)
def _btrfs_disk_import(self, dname, request):
try:
disk = self._validate_disk(dname, request)
p_info = get_pool_info(dname)
# get some options from saved config?
po = Pool(name=p_info['label'], raid="unknown")
# need to save it so disk objects get updated properly in the for
# loop below.
po.save()
for d in p_info['disks']:
do = Disk.objects.get(name=d)
do.pool = po
do.parted = False
do.save()
mount_root(po)
po.raid = pool_raid('%s%s' % (settings.MNT_PT, po.name))['data']
po.size = pool_usage('%s%s' % (settings.MNT_PT, po.name))[0]
po.save()
enable_quota(po)
import_shares(po, request)
for share in Share.objects.filter(pool=po):
import_snapshots(share)
return Response(DiskInfoSerializer(disk).data)
except Exception, e:
e_msg = (
'Failed to import any pool on this device(%s). Error: %s' %
(dname, e.__str__()))
handle_exception(Exception(e_msg), request)
def _btrfs_disk_import(self, dname, request):
try:
disk = self._validate_disk(dname, request)
p_info = get_pool_info(dname)
# get some options from saved config?
po = Pool(name=p_info['label'], raid="unknown")
# need to save it so disk objects get updated properly in the for
# loop below.
po.save()
for d in p_info['disks']:
do = Disk.objects.get(name=d)
do.pool = po
do.parted = False
do.save()
mount_root(po)
po.raid = pool_raid('%s%s' % (settings.MNT_PT, po.name))['data']
po.size = pool_usage('%s%s' % (settings.MNT_PT, po.name))[0]
po.save()
enable_quota(po)
import_shares(po, request)
for share in Share.objects.filter(pool=po):
import_snapshots(share)
return Response(DiskInfoSerializer(disk).data)
except Exception, e:
e_msg = ('Failed to import any pool on this device(%s). Error: %s'
% (dname, e.__str__()))
handle_exception(Exception(e_msg), request)
def _quotas(cls, request, pool):
new_quota_state = cls._validate_new_quota_state(request)
# If no change from current pool quota state then do nothing
current_state = 'Enabled'
if not pool.quotas_enabled:
current_state = 'Disabled'
if new_quota_state == current_state:
return Response()
try:
if new_quota_state == 'Enabled':
# Current issue with requiring enable to be executed twice !!!
# As of 4.12.4-1.el7.elrepo.x86_64
# this avoids "ERROR: quota rescan failed: Invalid argument"
# when attempting a rescan.
# Look similar to https://patchwork.kernel.org/patch/9928635/
enable_quota(pool)
enable_quota(pool)
# As of 4.12.4-1.el7.elrepo.x86_64
# The second above enable_quota() call currently initiates a
# rescan so the following is redundant; however this may not
# always be the case so leaving as it will auto skip if a scan
# in in progress anyway.
rescan_quotas(pool)
else:
disable_quota(pool)
except:
e_msg = 'Failed to Enable (and rescan) / Disable Quotas for ' \
'Pool ({}). Requested quota state ' \
'was ({}).'.format(pool.name, new_quota_state)
handle_exception(Exception(e_msg), request)
return Response(PoolInfoSerializer(pool).data)
def _create_root_pool(self, d):
p = Pool(name=settings.ROOT_POOL, raid='single')
p.disk_set.add(d)
p.save()
d.pool = p
d.save()
p.size = pool_usage(mount_root(p))[0]
enable_quota(p)
p.uuid = btrfs_uuid(d.name)
p.save()
return p
def _update_disk_state():
disks = scan_disks(settings.MIN_DISK_SIZE)
for d in disks:
dob = None
if (Disk.objects.filter(name=d.name).exists()):
dob = Disk.objects.get(name=d.name)
dob.serial = d.serial
elif (Disk.objects.filter(serial=d.serial).exists()):
dob = Disk.objects.get(serial=d.serial)
dob.name = d.name
else:
dob = Disk(name=d.name, size=d.size, parted=d.parted,
btrfs_uuid=d.btrfs_uuid, model=d.model,
serial=d.serial, transport=d.transport,
vendor=d.vendor)
dob.size = d.size
dob.parted = d.parted
dob.offline = False
dob.model = d.model
dob.transport = d.transport
dob.vendor = d.vendor
dob.btrfs_uuid = d.btrfs_uuid
if (d.fstype is not None and d.fstype != 'btrfs'):
dob.btrfs_uuid = None
dob.parted = True
if (Pool.objects.filter(name=d.label).exists()):
dob.pool = Pool.objects.get(name=d.label)
else:
dob.pool = None
if (dob.pool is None and d.root is True):
p = Pool(name=settings.ROOT_POOL, raid='single')
p.disk_set.add(dob)
p.save()
dob.pool = p
dob.save()
p.size = pool_usage(mount_root(p))[0]
enable_quota(p)
p.uuid = btrfs_uuid(dob.name)
p.save()
dob.save()
for do in Disk.objects.all():
if (do.name not in [d.name for d in disks]):
do.offline = True
else:
try:
# for non ata/sata drives
do.smart_available, do.smart_enabled = smart.available(do.name)
except Exception, e:
logger.exception(e)
do.smart_available = do.smart_enabled = False
do.save()
def _btrfs_disk_import(self, dname, request):
try:
disk = self._validate_disk(dname, request)
disk_name = self._role_filter_disk_name(disk, request)
p_info = get_pool_info(disk_name)
# get some options from saved config?
po = Pool(name=p_info['label'], raid="unknown")
# need to save it so disk objects get updated properly in the for
# loop below.
po.save()
for device in p_info['disks']:
disk_name, isPartition = \
self._reverse_role_filter_name(device, request)
do = Disk.objects.get(name=disk_name)
do.pool = po
# update this disk's parted property
do.parted = isPartition
if isPartition:
# ensure a redirect role to reach this partition; ie:
# "redirect": "virtio-serial-3-part2"
if do.role is not None: # db default is null / None.
# Get our previous roles into a dictionary
roles = json.loads(do.role)
# update or add our "redirect" role with our part name
roles['redirect'] = '%s' % device
# convert back to json and store in disk object
do.role = json.dumps(roles)
else:
# role=None so just add a json formatted redirect role
do.role = '{"redirect": "%s"}' % device.name
do.save()
mount_root(po)
po.raid = pool_raid('%s%s' % (settings.MNT_PT, po.name))['data']
po.size = po.usage_bound()
po.save()
enable_quota(po)
import_shares(po, request)
for share in Share.objects.filter(pool=po):
import_snapshots(share)
return Response(DiskInfoSerializer(disk).data)
except Exception as e:
e_msg = (
'Failed to import any pool on this device(%s). Error: %s' %
(dname, e.__str__()))
handle_exception(Exception(e_msg), request)
def _update_disk_state():
"""
A db atomic method to update the database of attached disks / drives.
Works only on device serial numbers for drive identification.
Calls scan_disks to establish the current connected drives info.
Initially removes duplicate by serial number db entries to deal
with legacy db states and obfuscates all previous device names as they
are transient. The drive database is then updated with the attached
disks info and previously known drives no longer found attached are
marked as offline. All offline drives have their SMART availability and
activation status removed and all attached drives have their SMART
availability assessed and activated if available.
:return: serialized models of attached and missing disks via serial num
"""
# Acquire a list (namedtupil collection) of attached drives > min size
disks = scan_disks(settings.MIN_DISK_SIZE)
serial_numbers_seen = []
# Make sane our db entries in view of what we know we have attached.
# Device serial number is only known external unique entry, scan_disks
# make this so in the case of empty or repeat entries by providing
# fake serial numbers which are in turn flagged via WebUI as unreliable.
# 1) scrub all device names with unique but nonsense uuid4
# 1) mark all offline disks as such via db flag
# 2) mark all offline disks smart available and enabled flags as False
logger.info('update_disk_state() Called')
for do in Disk.objects.all():
# Replace all device names with a unique placeholder on each scan
# N.B. do not optimize by re-using uuid index as this could lead
# to a non refreshed webui acting upon an entry that is different
# from that shown to the user.
do.name = str(uuid.uuid4()).replace('-', '') # 32 chars long
# Delete duplicate or fake by serial number db disk entries.
# It makes no sense to save fake serial number drives between scans
# as on each scan the serial number is re-generated anyway.
if (do.serial in serial_numbers_seen) or (len(do.serial) == 48):
logger.info('Deleting duplicate or fake (by serial) Disk db '
'entry. Serial = %s' % do.serial)
do.delete() # django >=1.9 returns a dict of deleted items.
# Continue onto next db disk object as nothing more to process.
continue
# first encounter of this serial in the db so stash it for reference
serial_numbers_seen.append(deepcopy(do.serial))
# Look for devices (by serial number) that are in the db but not in
# our disk scan, ie offline / missing.
if (do.serial not in [d.serial for d in disks]):
# update the db entry as offline
do.offline = True
# disable S.M.A.R.T available and enabled flags.
do.smart_available = do.smart_enabled = False
do.save() # make sure all updates are flushed to db
# Our db now has no device name info as all dev names are place holders.
# Iterate over attached drives to update the db's knowledge of them.
# Kernel dev names are unique so safe to overwrite our db unique name.
for d in disks:
# start with an empty disk object
dob = None
# If the db has an entry with this disk's serial number then
# use this db entry and update the device name from our recent scan.
if (Disk.objects.filter(serial=d.serial).exists()):
dob = Disk.objects.get(serial=d.serial)
dob.name = d.name
else:
# We have an assumed new disk entry as no serial match in db.
# Build a new entry for this disk.
dob = Disk(name=d.name, serial=d.serial)
# Update the db disk object (existing or new) with our scanned info
dob.size = d.size
dob.parted = d.parted
dob.offline = False # as we are iterating over attached devices
dob.model = d.model
dob.transport = d.transport
dob.vendor = d.vendor
dob.btrfs_uuid = d.btrfs_uuid
# If attached disk has an fs and it isn't btrfs
if (d.fstype is not None and d.fstype != 'btrfs'):
dob.btrfs_uuid = None
dob.parted = True
# If our existing Pool db knows of this disk's pool via it's label:
if (Pool.objects.filter(name=d.label).exists()):
# update the disk db object's pool field accordingly.
dob.pool = Pool.objects.get(name=d.label)
else: # this disk is not known to exist in any pool via it's label
dob.pool = None
# If no pool has yet been found with this disk's label in and
# the attached disk is our root disk (flagged by scan_disks)
if (dob.pool is None and d.root is True):
# setup our special root disk db entry in Pool
p = Pool(name=settings.ROOT_POOL, raid='single')
p.disk_set.add(dob)
p.save()
# update disk db object to reflect special root pool status
dob.pool = p
dob.save()
p.size = pool_usage(mount_root(p))[0]
enable_quota(p)
p.uuid = btrfs_uuid(dob.name)
p.save()
# save our updated db disk object
dob.save()
# Update online db entries with S.M.A.R.T availability and status.
for do in Disk.objects.all():
# find all the not offline db entries
if (not do.offline):
# We have an attached disk db entry
if re.match('vd', do.name):
# Virtio disks (named vd*) have no smart capability.
# avoids cluttering logs with exceptions on these devices.
do.smart_available = do.smart_enabled = False
continue
# try to establish smart availability and status and update db
try:
# for non ata/sata drives
do.smart_available, do.smart_enabled = smart.available(
do.name)
except Exception, e:
logger.exception(e)
do.smart_available = do.smart_enabled = False
do.save()
def _update_disk_state():
"""
A db atomic method to update the database of attached disks / drives.
Works only on device serial numbers for drive identification.
Calls scan_disks to establish the current connected drives info.
Initially removes duplicate by serial number db entries to deal
with legacy db states and obfuscates all previous device names as they
are transient. The drive database is then updated with the attached
disks info and previously known drives no longer found attached are
marked as offline. All offline drives have their SMART availability and
activation status removed and all attached drives have their SMART
availability assessed and activated if available.
:return: serialized models of attached and missing disks via serial num
"""
# Acquire a list (namedtupil collection) of attached drives > min size
disks = scan_disks(settings.MIN_DISK_SIZE)
serial_numbers_seen = []
# Make sane our db entries in view of what we know we have attached.
# Device serial number is only known external unique entry, scan_disks
# make this so in the case of empty or repeat entries by providing
# fake serial numbers which are in turn flagged via WebUI as unreliable.
# 1) scrub all device names with unique but nonsense uuid4
# 1) mark all offline disks as such via db flag
# 2) mark all offline disks smart available and enabled flags as False
logger.info('update_disk_state() Called')
for do in Disk.objects.all():
# Replace all device names with a unique placeholder on each scan
# N.B. do not optimize by re-using uuid index as this could lead
# to a non refreshed webui acting upon an entry that is different
# from that shown to the user.
do.name = str(uuid.uuid4()).replace('-', '') # 32 chars long
# Delete duplicate or fake by serial number db disk entries.
# It makes no sense to save fake serial number drives between scans
# as on each scan the serial number is re-generated anyway.
if (do.serial in serial_numbers_seen) or (len(do.serial) == 48):
logger.info('Deleting duplicate or fake (by serial) Disk db '
'entry. Serial = %s' % do.serial)
do.delete() # django >=1.9 returns a dict of deleted items.
# Continue onto next db disk object as nothing more to process.
continue
# first encounter of this serial in the db so stash it for reference
serial_numbers_seen.append(deepcopy(do.serial))
# Look for devices (by serial number) that are in the db but not in
# our disk scan, ie offline / missing.
if (do.serial not in [d.serial for d in disks]):
# update the db entry as offline
do.offline = True
# disable S.M.A.R.T available and enabled flags.
do.smart_available = do.smart_enabled = False
do.save() # make sure all updates are flushed to db
# Our db now has no device name info as all dev names are place holders.
# Iterate over attached drives to update the db's knowledge of them.
# Kernel dev names are unique so safe to overwrite our db unique name.
for d in disks:
# start with an empty disk object
dob = None
# If the db has an entry with this disk's serial number then
# use this db entry and update the device name from our recent scan.
if (Disk.objects.filter(serial=d.serial).exists()):
dob = Disk.objects.get(serial=d.serial)
dob.name = d.name
else:
# We have an assumed new disk entry as no serial match in db.
# Build a new entry for this disk.
dob = Disk(name=d.name, serial=d.serial)
# Update the db disk object (existing or new) with our scanned info
dob.size = d.size
dob.parted = d.parted
dob.offline = False # as we are iterating over attached devices
dob.model = d.model
dob.transport = d.transport
dob.vendor = d.vendor
dob.btrfs_uuid = d.btrfs_uuid
# If attached disk has an fs and it isn't btrfs
if (d.fstype is not None and d.fstype != 'btrfs'):
dob.btrfs_uuid = None
dob.parted = True
# If our existing Pool db knows of this disk's pool via it's label:
if (Pool.objects.filter(name=d.label).exists()):
# update the disk db object's pool field accordingly.
dob.pool = Pool.objects.get(name=d.label)
else: # this disk is not known to exist in any pool via it's label
dob.pool = None
# If no pool has yet been found with this disk's label in and
# the attached disk is our root disk (flagged by scan_disks)
if (dob.pool is None and d.root is True):
# setup our special root disk db entry in Pool
p = Pool(name=settings.ROOT_POOL, raid='single')
p.disk_set.add(dob)
p.save()
# update disk db object to reflect special root pool status
dob.pool = p
dob.save()
p.size = pool_usage(mount_root(p))[0]
enable_quota(p)
p.uuid = btrfs_uuid(dob.name)
p.save()
# save our updated db disk object
dob.save()
# Update online db entries with S.M.A.R.T availability and status.
for do in Disk.objects.all():
# find all the not offline db entries
if (not do.offline):
# We have an attached disk db entry
if re.match('vd', do.name):
# Virtio disks (named vd*) have no smart capability.
# avoids cluttering logs with exceptions on these devices.
do.smart_available = do.smart_enabled = False
continue
# try to establish smart availability and status and update db
try:
# for non ata/sata drives
do.smart_available, do.smart_enabled = smart.available(do.name)
except Exception, e:
logger.exception(e)
do.smart_available = do.smart_enabled = False
do.save()
def _update_disk_state():
"""
A db atomic method to update the database of attached disks / drives.
Works only on device serial numbers for drive identification.
Calls scan_disks to establish the current connected drives info.
Initially removes duplicate by serial number db entries to deal
with legacy db states and obfuscates all previous device names as they
are transient. The drive database is then updated with the attached
disks info and previously known drives no longer found attached are
marked as offline. All offline drives have their SMART availability and
activation status removed and all attached drives have their SMART
availability assessed and activated if available.
:return: serialized models of attached and missing disks via serial num
"""
# Acquire a list (namedtupil collection) of attached drives > min size
disks = scan_disks(settings.MIN_DISK_SIZE)
serial_numbers_seen = []
# Make sane our db entries in view of what we know we have attached.
# Device serial number is only known external unique entry, scan_disks
# make this so in the case of empty or repeat entries by providing
# fake serial numbers which are in turn flagged via WebUI as unreliable.
# 1) scrub all device names with unique but nonsense uuid4
# 1) mark all offline disks as such via db flag
# 2) mark all offline disks smart available and enabled flags as False
# logger.info('update_disk_state() Called')
for do in Disk.objects.all():
# Replace all device names with a unique placeholder on each scan
# N.B. do not optimize by re-using uuid index as this could lead
# to a non refreshed webui acting upon an entry that is different
# from that shown to the user.
do.name = 'detached-' + str(uuid.uuid4()).replace('-', '')
# Delete duplicate or fake by serial number db disk entries.
# It makes no sense to save fake serial number drives between scans
# as on each scan the serial number is re-generated (fake) anyway.
# Serial numbers beginning with 'fake-serial-' are from scan_disks.
if (do.serial in serial_numbers_seen) or (
re.match('fake-serial-', do.serial) is not None):
logger.info('Deleting duplicate or fake (by serial) Disk db '
'entry. Serial = %s' % do.serial)
do.delete() # django >=1.9 returns a dict of deleted items.
# Continue onto next db disk object as nothing more to process.
continue
# first encounter of this serial in the db so stash it for reference
serial_numbers_seen.append(deepcopy(do.serial))
# Look for devices (by serial number) that are in the db but not in
# our disk scan, ie offline / missing.
if (do.serial not in [d.serial for d in disks]):
# update the db entry as offline
do.offline = True
# disable S.M.A.R.T available and enabled flags.
do.smart_available = do.smart_enabled = False
do.save() # make sure all updates are flushed to db
# Our db now has no device name info as all dev names are place holders.
# Iterate over attached drives to update the db's knowledge of them.
# Kernel dev names are unique so safe to overwrite our db unique name.
for d in disks:
# start with an empty disk object
dob = None
# Convert our transient but just scanned so current sda type name
# to a more useful by-id type name as found in /dev/disk/by-id
byid_disk_name, is_byid = get_dev_byid_name(d.name, True)
# If the db has an entry with this disk's serial number then
# use this db entry and update the device name from our recent scan.
if (Disk.objects.filter(serial=d.serial).exists()):
dob = Disk.objects.get(serial=d.serial)
#dob.name = d.name
dob.name = byid_disk_name
else:
# We have an assumed new disk entry as no serial match in db.
# Build a new entry for this disk.
#dob = Disk(name=d.name, serial=d.serial)
# N.B. we may want to force a fake-serial here if is_byid False,
# that way we flag as unusable disk as no by-id type name found.
# It may already have been set though as the only by-id
# failures so far are virtio disks with no serial so scan_disks
# will have already given it a fake serial in d.serial.
dob = Disk(name=byid_disk_name, serial=d.serial)
# Update the db disk object (existing or new) with our scanned info
dob.size = d.size
dob.parted = d.parted
dob.offline = False # as we are iterating over attached devices
dob.model = d.model
dob.transport = d.transport
dob.vendor = d.vendor
dob.btrfs_uuid = d.btrfs_uuid
# If attached disk has an fs and it isn't btrfs
if (d.fstype is not None and d.fstype != 'btrfs'):
dob.btrfs_uuid = None
dob.parted = True # overload use of parted as non btrfs flag.
# N.B. this overload use may become redundant with the addition
# of the Disk.role field.
# Update the role field with scan_disks findings, currently only
# mdraid membership type based on fstype info. In the case of
# these raid member indicators from scan_disks() we have the
# current truth provided so update the db role status accordingly.
# N.B. this if else could be expanded to accommodate other
# roles based on the fs found
if d.fstype == 'isw_raid_member' or d.fstype == 'linux_raid_member':
# We have an indicator of mdraid membership so update existing
# role info if any.
# N.B. We have a minor legacy issue in that prior to using json
# format for the db role field we stored one of 2 strings.
# if these 2 strings are found then ignore them as we then
# overwrite with our current finding and in the new json format.
# I.e. non None could also be a legacy entry so follow overwrite
# path when legacy entry found by treating as a None entry.
# TODO: When we reset migrations the following need only check
# TODO: "dob.role is not None"
if dob.role is not None and dob.role != 'isw_raid_member' \
and dob.role != 'linux_raid_member':
# get our known roles into a dictionary
known_roles = json.loads(dob.role)
# create or update an mdraid dictionary entry
known_roles['mdraid'] = str(d.fstype)
# return updated dict to json format and store in db object
dob.role = json.dumps(known_roles)
else: # We have a dob.role = None so just insert our new role.
# Also applies to legacy pre json role entries.
dob.role = '{"mdraid": "' + d.fstype + '"}' # json string
else: # We know this disk is not an mdraid raid member.
# No identified role from scan_disks() fstype value (mdraid
# only for now )so we preserve any prior known roles not
# exposed by scan_disks but remove the mdraid role if found.
# TODO: When we reset migrations the following need only check
# TODO: "dob.role is not None"
if dob.role is not None and dob.role != 'isw_raid_member' \
and dob.role != 'linux_raid_member':
# remove mdraid role if found but preserve prior roles
# which should now only be in json format
known_roles = json.loads(dob.role)
if 'mdraid' in known_roles:
if len(known_roles) > 1:
# mdraid is not the only entry so we have to pull
# out only mdraid from dict and convert back to json
del known_roles['mdraid']
dob.role = json.dumps(known_roles)
else:
# mdraid was the only entry so we need not bother
# with dict edit and json conversion only to end up
# with an empty json {} so revert to default 'None'.
dob.role = None
else: # Empty or legacy role entry.
# We have either None or a legacy mdraid role when this disk
# is no longer an mdraid member. We can now assert None.
dob.role = None
# If our existing Pool db knows of this disk's pool via it's label:
if (Pool.objects.filter(name=d.label).exists()):
# update the disk db object's pool field accordingly.
dob.pool = Pool.objects.get(name=d.label)
#this is for backwards compatibility. root pools created
#before the pool.role migration need this. It can safely be
#removed a few versions after 3.8-11 or when we reset migrations.
if (d.root is True):
dob.pool.role = 'root'
dob.pool.save()
else: # this disk is not known to exist in any pool via it's label
dob.pool = None
# If no pool has yet been found with this disk's label in and
# the attached disk is our root disk (flagged by scan_disks)
if (dob.pool is None and d.root is True):
# setup our special root disk db entry in Pool
# TODO: dynamically retrieve raid level.
p = Pool(name=d.label, raid='single', role='root')
p.disk_set.add(dob)
p.save()
# update disk db object to reflect special root pool status
dob.pool = p
dob.save()
p.size = pool_usage(mount_root(p))[0]
enable_quota(p)
p.uuid = btrfs_uuid(dob.name)
p.save()
# save our updated db disk object
dob.save()
# Update online db entries with S.M.A.R.T availability and status.
for do in Disk.objects.all():
# find all the not offline db entries
if (not do.offline):
# We have an attached disk db entry.
# Since our Disk.name model now uses by-id type names we can
# do cheap matches to the beginnings of these names to find
# virtio, md, or sdcard devices which are assumed to have no
# SMART capability.
# We also disable devices smart support when they have a
# fake serial number as ascribed by scan_disks as any SMART
# data collected is then less likely to be wrongly associated
# with the next device that takes this temporary drive's name.
# Also note that with no serial number some device types will
# not have a by-id type name expected by the smart subsystem.
# This has only been observed in no serial virtio devices.
if (re.match('fake-serial-', do.serial) is not None) or \
(re.match('virtio-|md-|mmc-|nvme-', do.name) is not None):
# Virtio disks (named virtio-*), md devices (named md-*),
# and an sdcard reader that provides devs named mmc-* have
# no smart capability so avoid cluttering logs with
# exceptions on probing these with smart.available.
# nvme not yet supported by CentOS 7 smartmontools:
# https://www.smartmontools.org/ticket/657
# Thanks to @snafu in rockstor forum post 1567 for this.
do.smart_available = do.smart_enabled = False
continue
# try to establish smart availability and status and update db
try:
# for non ata/sata drives
do.smart_available, do.smart_enabled = smart.available(
do.name, do.smart_options)
except Exception, e:
logger.exception(e)
do.smart_available = do.smart_enabled = False
do.save()
def _create_root_pool(self, d):
p = Pool(name=settings.ROOT_POOL, raid='single')
p.size = pool_usage(mount_root(p, d.name))[0]
enable_quota(p, '/dev/%s' % d.name)
p.uuid = btrfs_uuid(d.name)
return p
def _update_disk_state():
"""
A db atomic method to update the database of attached disks / drives.
Works only on device serial numbers for drive identification.
Calls scan_disks to establish the current connected drives info.
Initially removes duplicate by serial number db entries to deal
with legacy db states and obfuscates all previous device names as they
are transient. The drive database is then updated with the attached
disks info and previously known drives no longer found attached are
marked as offline. All offline drives have their SMART availability and
activation status removed and all attached drives have their SMART
availability assessed and activated if available.
:return: serialized models of attached and missing disks via serial num
"""
# Acquire a list (namedtupil collection) of attached drives > min size
disks = scan_disks(settings.MIN_DISK_SIZE)
serial_numbers_seen = []
# Make sane our db entries in view of what we know we have attached.
# Device serial number is only known external unique entry, scan_disks
# make this so in the case of empty or repeat entries by providing
# fake serial numbers which are flagged via WebUI as unreliable.
# 1) Scrub all device names with unique but nonsense uuid4.
# 2) Mark all offline disks as such via db flag.
# 3) Mark all offline disks smart available and enabled flags as False.
for do in Disk.objects.all():
# Replace all device names with a unique placeholder on each scan
# N.B. do not optimize by re-using uuid index as this could lead
# to a non refreshed webui acting upon an entry that is different
# from that shown to the user.
do.name = 'detached-' + str(uuid.uuid4()).replace('-', '')
# Delete duplicate or fake by serial number db disk entries.
# It makes no sense to save fake serial number drives between scans
# as on each scan the serial number is re-generated (fake) anyway.
# Serial numbers beginning with 'fake-serial-' are from scan_disks.
if (do.serial in serial_numbers_seen) or (re.match(
'fake-serial-', do.serial) is not None):
logger.info('Deleting duplicate or fake (by serial) Disk db '
'entry. Serial = %s' % do.serial)
do.delete() # django >=1.9 returns a dict of deleted items.
# Continue onto next db disk object as nothing more to process.
continue
# first encounter of this serial in the db so stash it for
# reference
serial_numbers_seen.append(deepcopy(do.serial))
# Look for devices (by serial number) that are in the db but not in
# our disk scan, ie offline / missing.
if (do.serial not in [d.serial for d in disks]):
# update the db entry as offline
do.offline = True
# disable S.M.A.R.T available and enabled flags.
do.smart_available = do.smart_enabled = False
do.save() # make sure all updates are flushed to db
# Our db now has no device name info: all dev names are place holders.
# Iterate over attached drives to update the db's knowledge of them.
# Kernel dev names are unique so safe to overwrite our db unique name.
for d in disks:
# start with an empty disk object
dob = None
# an empty dictionary of non scan_disk() roles
non_scan_disks_roles = {}
# and an empty dictionary of discovered roles
disk_roles_identified = {}
# Convert our transient but just scanned so current sda type name
# to a more useful by-id type name as found in /dev/disk/by-id
byid_disk_name, is_byid = get_dev_byid_name(d.name, True)
# If the db has an entry with this disk's serial number then
# use this db entry and update the device name from our new scan.
if (Disk.objects.filter(serial=d.serial).exists()):
dob = Disk.objects.get(serial=d.serial)
dob.name = byid_disk_name
else:
# We have an assumed new disk entry as no serial match in db.
# Build a new entry for this disk. N.B. we may want to force a
# fake-serial here if is_byid False, that way we flag as
# unusable disk as no by-id type name found. It may already
# have been set though as the only by-id failures so far are
# virtio disks with no serial so scan_disks will have already
# given it a fake serial in d.serial.
dob = Disk(name=byid_disk_name, serial=d.serial, role=None)
# Update the db disk object (existing or new) with our scanned info
dob.size = d.size
dob.parted = d.parted
dob.offline = False # as we are iterating over attached devices
dob.model = d.model
dob.transport = d.transport
dob.vendor = d.vendor
# N.B. The Disk.btrfs_uuid is in some senses becoming misleading
# as we begin to deal with Disk.role managed drives such as mdraid
# members and full disk LUKS drives where we can make use of the
# non btrfs uuids to track filesystems or LUKS containers.
# Leaving as is for now to avoid db changes.
dob.btrfs_uuid = d.uuid
# If attached disk has an fs and it isn't btrfs
if (d.fstype is not None and d.fstype != 'btrfs'):
# blank any btrfs_uuid it may have had previously.
dob.btrfs_uuid = None
# ### BEGINNING OF ROLE FIELD UPDATE ###
# Update the role field with scan_disks findings.
# SCAN_DISKS_KNOWN_ROLES a list of scan_disks identifiable roles.
# Deal with legacy non json role field contents by erasure.
# N.B. We have a minor legacy issue in that prior to using json
# format for the db role field we stored one of 2 strings.
# If either of these 2 strings are found reset to db default of
# None
if dob.role == 'isw_raid_member'\
or dob.role == 'linux_raid_member':
# These are the only legacy non json formatted roles used.
# Erase legacy role entries as we are about to update the role
# anyway and new entries will then be in the new json format.
# This helps to keeps the following role logic cleaner and
# existing mdraid members will be re-assigned if appropriate
# using the new json format.
dob.role = None
# First extract all non scan_disks assigned roles so we can add
# them back later; all scan_disks assigned roles will be identified
# from our recent scan_disks data so we assert the new truth.
if dob.role is not None: # db default null=True so None here.
# Get our previous roles into a dictionary
previous_roles = json.loads(dob.role)
# Preserve non scan_disks identified roles for this db entry
non_scan_disks_roles = {
role: v
for role, v in previous_roles.items()
if role not in SCAN_DISKS_KNOWN_ROLES
}
if d.fstype == 'isw_raid_member' \
or d.fstype == 'linux_raid_member':
# MDRAID MEMBER: scan_disks() can informs us of the truth
# regarding mdraid membership via d.fstype indicators.
# create or update an mdraid dictionary entry
disk_roles_identified['mdraid'] = str(d.fstype)
if d.fstype == 'crypto_LUKS':
# LUKS FULL DISK: scan_disks() can inform us of the truth
# regarding full disk LUKS containers which on creation have a
# unique uuid. Stash this uuid so we might later work out our
# container mapping.
disk_roles_identified['LUKS'] = str(d.uuid)
if d.type == 'crypt':
# OPEN LUKS DISK: scan_disks() can inform us of the truth
# regarding an opened LUKS container which appears as a mapped
# device. Assign the /dev/disk/by-id name as a value.
disk_roles_identified['openLUKS'] = 'dm-name-%s' % d.name
if d.fstype == 'bcache':
# BCACHE: scan_disks() can inform us of the truth regarding
# bcache "backing devices" so we assign a role to avoid these
# devices being seen as unused and accidentally deleted. Once
# formatted with make-bcache -B they are accessed via a virtual
# device which should end up with a serial of bcache-(d.uuid)
# here we tag our backing device with it's virtual counterparts
# serial number.
disk_roles_identified['bcache'] = 'bcache-%s' % d.uuid
if d.fstype == 'bcache-cdev':
# BCACHE: continued; here we use the scan_disks() added info
# of this bcache device being a cache device not a backing
# device, so it will have no virtual block device counterpart
# but likewise must be specifically attributed (ie to fast
# ssd type drives) so we flag in the role system differently.
disk_roles_identified['bcachecdev'] = 'bcache-%s' % d.uuid
if d.root is True:
# ROOT DISK: scan_disks() has already identified the current
# truth regarding the device hosting our root '/' fs so update
# our role accordingly.
# N.B. value of d.fstype here is essentially a place holder as
# the presence or otherwise of the 'root' key is all we need.
disk_roles_identified['root'] = str(d.fstype)
if d.partitions != {}:
# PARTITIONS: scan_disks() has built an updated partitions dict
# so create a partitions role containing this dictionary.
# Convert scan_disks() transient (but just scanned so current)
# sda type names to a more useful by-id type name as found
# in /dev/disk/by-id for each partition name.
byid_partitions = {
get_dev_byid_name(part, True)[0]:
d.partitions.get(part, "")
for part in d.partitions
}
# In the above we fail over to "" on failed index for now.
disk_roles_identified['partitions'] = byid_partitions
# Now we join the previous non scan_disks identified roles dict
# with those we have identified from our fresh scan_disks() data
# and return the result to our db entry in json format.
# Note that dict of {} isn't None
if (non_scan_disks_roles != {}) or (disk_roles_identified != {}):
combined_roles = dict(non_scan_disks_roles,
**disk_roles_identified)
dob.role = json.dumps(combined_roles)
else:
dob.role = None
# END OF ROLE FIELD UPDATE
# If our existing Pool db knows of this disk's pool via it's label:
if (Pool.objects.filter(name=d.label).exists()):
# update the disk db object's pool field accordingly.
dob.pool = Pool.objects.get(name=d.label)
# this is for backwards compatibility. root pools created
# before the pool.role migration need this. It can safely be
# removed a few versions after 3.8-11 or when we reset
# migrations.
if (d.root is True):
dob.pool.role = 'root'
dob.pool.save()
else: # this disk is not known to exist in any pool via it's label
dob.pool = None
# If no pool has yet been found with this disk's label in and
# the attached disk is our root disk (flagged by scan_disks)
if (dob.pool is None and d.root is True):
# setup our special root disk db entry in Pool
# TODO: dynamically retrieve raid level.
p = Pool(name=d.label, raid='single', role='root')
p.save()
p.disk_set.add(dob)
# update disk db object to reflect special root pool status
dob.pool = p
dob.save()
p.size = p.usage_bound()
enable_quota(p)
p.uuid = btrfs_uuid(dob.name)
p.save()
# save our updated db disk object
dob.save()
# Update online db entries with S.M.A.R.T availability and status.
for do in Disk.objects.all():
# find all the not offline db entries
if (not do.offline):
# We have an attached disk db entry.
# Since our Disk.name model now uses by-id type names we can
# do cheap matches to the beginnings of these names to find
# virtio, md, or sdcard devices which are assumed to have no
# SMART capability.
# We also disable devices smart support when they have a
# fake serial number as ascribed by scan_disks as any SMART
# data collected is then less likely to be wrongly associated
# with the next device that takes this temporary drive's name.
# Also note that with no serial number some device types will
# not have a by-id type name expected by the smart subsystem.
# This has only been observed in no serial virtio devices.
if (re.match('fake-serial-', do.serial)
is not None) or (re.match(
'virtio-|md-|mmc-|nvme-|dm-name-luks-|bcache',
do.name) is not None):
# Virtio disks (named virtio-*), md devices (named md-*),
# and an sdcard reader that provides devs named mmc-* have
# no smart capability so avoid cluttering logs with
# exceptions on probing these with smart.available.
# nvme not yet supported by CentOS 7 smartmontools:
# https://www.smartmontools.org/ticket/657
# Thanks to @snafu in rockstor forum post 1567 for this.
do.smart_available = do.smart_enabled = False
continue
# try to establish smart availability and status and update db
try:
# for non ata/sata drives
do.smart_available, do.smart_enabled = smart.available(
do.name, do.smart_options)
except Exception as e:
logger.exception(e)
do.smart_available = do.smart_enabled = False
do.save()
ds = DiskInfoSerializer(Disk.objects.all().order_by('name'), many=True)
return Response(ds.data)
def _update_disk_state():
"""
A db atomic method to update the database of attached disks / drives.
Works only on device serial numbers for drive identification.
Calls scan_disks to establish the current connected drives info.
Initially removes duplicate by serial number db entries to deal
with legacy db states and obfuscates all previous device names as they
are transient. The drive database is then updated with the attached
disks info and previously known drives no longer found attached are
marked as offline. All offline drives have their SMART availability and
activation status removed and all attached drives have their SMART
availability assessed and activated if available.
:return: serialized models of attached and missing disks via serial num
"""
# Acquire a list (namedtupil collection) of attached drives > min size
disks = scan_disks(settings.MIN_DISK_SIZE)
serial_numbers_seen = []
# Make sane our db entries in view of what we know we have attached.
# Device serial number is only known external unique entry, scan_disks
# make this so in the case of empty or repeat entries by providing
# fake serial numbers which are in turn flagged via WebUI as unreliable.
# 1) scrub all device names with unique but nonsense uuid4
# 1) mark all offline disks as such via db flag
# 2) mark all offline disks smart available and enabled flags as False
# logger.info('update_disk_state() Called')
for do in Disk.objects.all():
# Replace all device names with a unique placeholder on each scan
# N.B. do not optimize by re-using uuid index as this could lead
# to a non refreshed webui acting upon an entry that is different
# from that shown to the user.
do.name = 'detached-' + str(uuid.uuid4()).replace('-', '')
# Delete duplicate or fake by serial number db disk entries.
# It makes no sense to save fake serial number drives between scans
# as on each scan the serial number is re-generated (fake) anyway.
# Serial numbers beginning with 'fake-serial-' are from scan_disks.
if (do.serial in serial_numbers_seen) or (re.match(
'fake-serial-', do.serial) is not None):
logger.info('Deleting duplicate or fake (by serial) Disk db '
'entry. Serial = %s' % do.serial)
do.delete() # django >=1.9 returns a dict of deleted items.
# Continue onto next db disk object as nothing more to process.
continue
# first encounter of this serial in the db so stash it for reference
serial_numbers_seen.append(deepcopy(do.serial))
# Look for devices (by serial number) that are in the db but not in
# our disk scan, ie offline / missing.
if (do.serial not in [d.serial for d in disks]):
# update the db entry as offline
do.offline = True
# disable S.M.A.R.T available and enabled flags.
do.smart_available = do.smart_enabled = False
do.save() # make sure all updates are flushed to db
# Our db now has no device name info as all dev names are place holders.
# Iterate over attached drives to update the db's knowledge of them.
# Kernel dev names are unique so safe to overwrite our db unique name.
for d in disks:
# start with an empty disk object
dob = None
# Convert our transient but just scanned so current sda type name
# to a more useful by-id type name as found in /dev/disk/by-id
byid_disk_name, is_byid = get_dev_byid_name(d.name, True)
# If the db has an entry with this disk's serial number then
# use this db entry and update the device name from our recent scan.
if (Disk.objects.filter(serial=d.serial).exists()):
dob = Disk.objects.get(serial=d.serial)
#dob.name = d.name
dob.name = byid_disk_name
else:
# We have an assumed new disk entry as no serial match in db.
# Build a new entry for this disk.
#dob = Disk(name=d.name, serial=d.serial)
# N.B. we may want to force a fake-serial here if is_byid False,
# that way we flag as unusable disk as no by-id type name found.
# It may already have been set though as the only by-id
# failures so far are virtio disks with no serial so scan_disks
# will have already given it a fake serial in d.serial.
dob = Disk(name=byid_disk_name, serial=d.serial)
# Update the db disk object (existing or new) with our scanned info
dob.size = d.size
dob.parted = d.parted
dob.offline = False # as we are iterating over attached devices
dob.model = d.model
dob.transport = d.transport
dob.vendor = d.vendor
dob.btrfs_uuid = d.btrfs_uuid
# If attached disk has an fs and it isn't btrfs
if (d.fstype is not None and d.fstype != 'btrfs'):
dob.btrfs_uuid = None
dob.parted = True # overload use of parted as non btrfs flag.
# N.B. this overload use may become redundant with the addition
# of the Disk.role field.
# Update the role field with scan_disks findings, currently only
# mdraid membership type based on fstype info. In the case of
# these raid member indicators from scan_disks() we have the
# current truth provided so update the db role status accordingly.
# N.B. this if else could be expanded to accommodate other
# roles based on the fs found
if d.fstype == 'isw_raid_member' or d.fstype == 'linux_raid_member':
# We have an indicator of mdraid membership so update existing
# role info if any.
# N.B. We have a minor legacy issue in that prior to using json
# format for the db role field we stored one of 2 strings.
# if these 2 strings are found then ignore them as we then
# overwrite with our current finding and in the new json format.
# I.e. non None could also be a legacy entry so follow overwrite
# path when legacy entry found by treating as a None entry.
# TODO: When we reset migrations the following need only check
# TODO: "dob.role is not None"
if dob.role is not None and dob.role != 'isw_raid_member' \
and dob.role != 'linux_raid_member':
# get our known roles into a dictionary
known_roles = json.loads(dob.role)
# create or update an mdraid dictionary entry
known_roles['mdraid'] = str(d.fstype)
# return updated dict to json format and store in db object
dob.role = json.dumps(known_roles)
else: # We have a dob.role = None so just insert our new role.
# Also applies to legacy pre json role entries.
dob.role = '{"mdraid": "' + d.fstype + '"}' # json string
else: # We know this disk is not an mdraid raid member.
# No identified role from scan_disks() fstype value (mdraid
# only for now )so we preserve any prior known roles not
# exposed by scan_disks but remove the mdraid role if found.
# TODO: When we reset migrations the following need only check
# TODO: "dob.role is not None"
if dob.role is not None and dob.role != 'isw_raid_member' \
and dob.role != 'linux_raid_member':
# remove mdraid role if found but preserve prior roles
# which should now only be in json format
known_roles = json.loads(dob.role)
if 'mdraid' in known_roles:
if len(known_roles) > 1:
# mdraid is not the only entry so we have to pull
# out only mdraid from dict and convert back to json
del known_roles['mdraid']
dob.role = json.dumps(known_roles)
else:
# mdraid was the only entry so we need not bother
# with dict edit and json conversion only to end up
# with an empty json {} so revert to default 'None'.
dob.role = None
else: # Empty or legacy role entry.
# We have either None or a legacy mdraid role when this disk
# is no longer an mdraid member. We can now assert None.
dob.role = None
# If our existing Pool db knows of this disk's pool via it's label:
if (Pool.objects.filter(name=d.label).exists()):
# update the disk db object's pool field accordingly.
dob.pool = Pool.objects.get(name=d.label)
#this is for backwards compatibility. root pools created
#before the pool.role migration need this. It can safely be
#removed a few versions after 3.8-11 or when we reset migrations.
if (d.root is True):
dob.pool.role = 'root'
dob.pool.save()
else: # this disk is not known to exist in any pool via it's label
dob.pool = None
# If no pool has yet been found with this disk's label in and
# the attached disk is our root disk (flagged by scan_disks)
if (dob.pool is None and d.root is True):
# setup our special root disk db entry in Pool
# TODO: dynamically retrieve raid level.
p = Pool(name=d.label, raid='single', role='root')
p.save()
p.disk_set.add(dob)
# update disk db object to reflect special root pool status
dob.pool = p
dob.save()
p.size = p.usage_bound()
enable_quota(p)
p.uuid = btrfs_uuid(dob.name)
p.save()
# save our updated db disk object
dob.save()
# Update online db entries with S.M.A.R.T availability and status.
for do in Disk.objects.all():
# find all the not offline db entries
if (not do.offline):
# We have an attached disk db entry.
# Since our Disk.name model now uses by-id type names we can
# do cheap matches to the beginnings of these names to find
# virtio, md, or sdcard devices which are assumed to have no
# SMART capability.
# We also disable devices smart support when they have a
# fake serial number as ascribed by scan_disks as any SMART
# data collected is then less likely to be wrongly associated
# with the next device that takes this temporary drive's name.
# Also note that with no serial number some device types will
# not have a by-id type name expected by the smart subsystem.
# This has only been observed in no serial virtio devices.
if (re.match('fake-serial-', do.serial) is not None) or \
(re.match('virtio-|md-|mmc-|nvme-', do.name) is not None):
# Virtio disks (named virtio-*), md devices (named md-*),
# and an sdcard reader that provides devs named mmc-* have
# no smart capability so avoid cluttering logs with
# exceptions on probing these with smart.available.
# nvme not yet supported by CentOS 7 smartmontools:
# https://www.smartmontools.org/ticket/657
# Thanks to @snafu in rockstor forum post 1567 for this.
do.smart_available = do.smart_enabled = False
continue
# try to establish smart availability and status and update db
try:
# for non ata/sata drives
do.smart_available, do.smart_enabled = smart.available(
do.name, do.smart_options)
except Exception, e:
logger.exception(e)
do.smart_available = do.smart_enabled = False
do.save()
def _create_root_pool(self, d):
p = Pool(name=settings.ROOT_POOL, raid='single')
p.size = pool_usage(mount_root(p, d.name))[0]
enable_quota(p, '/dev/%s' % d.name)
p.uuid = btrfs_uuid(d.name)
return p
