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 _wipe(self, dname, request):
disk = self._validate_disk(dname, request)
wipe_disk(disk.name)
disk.parted = False
disk.btrfs_uuid = None
disk.save()
return Response(DiskInfoSerializer(disk).data)
def get(self, *args, **kwargs):
if 'dname' in self.kwargs:
try:
data = Disk.objects.get(name=self.kwargs['dname'])
serialized_data = DiskInfoSerializer(data)
return Response(serialized_data.data)
except:
return Response()
def _smartcustom_drive(self, dname, request):
disk = self._validate_disk(dname, request)
# TODO: Check on None, null, or '' for default in next command
custom_smart_options = str(request.data.get('smartcustom_options', ''))
# strip leading and trailing white space chars before entry in db
disk.smart_options = custom_smart_options.strip()
disk.save()
return Response(DiskInfoSerializer(disk).data)
class DiskMixin(object):
serializer_class = DiskInfoSerializer
@staticmethod
@transaction.atomic
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()
ds = DiskInfoSerializer(Disk.objects.all().order_by('name'), many=True)
return Response(ds.data)
def _toggle_smart(cls, dname, request, enable=False):
disk = cls._validate_disk(dname, request)
if (not disk.smart_available):
e_msg = ('S.M.A.R.T support is not available on this Disk(%s)' % dname)
handle_exception(Exception(e_msg), request)
smart.toggle_smart(disk.name, enable)
disk.smart_enabled = enable
disk.save()
return Response(DiskInfoSerializer(disk).data)
def post(self, request):
disks = scan_disks(settings.MIN_DISK_SIZE)
for k,v in disks.items():
if (Disk.objects.filter(name=v['name']).exists()):
continue
new_disk = Disk(name=v['name'], size=v['size'], free=v['free'],
parted=v['parted'])
new_disk.save()
disks = Disk.objects.all()
ds = DiskInfoSerializer(disks)
return Response(ds.data)
class DiskView(rfc.GenericView):
serializer_class = DiskInfoSerializer
def _validate_disk(self, dname, request):
try:
return Disk.objects.get(name=dname)
except:
e_msg = ('Disk: %s does not exist' % dname)
handle_exception(Exception(e_msg), request)
def get_queryset(self, *args, **kwargs):
if ('dname' in kwargs):
self.paginate_by = 0
try:
return Disk.objects.get(name=kwargs['dname'])
except:
return []
return Disk.objects.all()
@transaction.commit_on_success
def _scan(self):
disks = scan_disks(settings.MIN_DISK_SIZE)
for k, v in disks.items():
if (Disk.objects.filter(name=v['name']).exists()):
d = Disk.objects.get(name=v['name'])
if (d.size != v['size'] or d.parted != v['parted']):
d.size = v['size']
d.parted = v['parted']
d.save()
continue
new_disk = Disk(name=v['name'], size=v['size'], parted=v['parted'])
new_disk.save()
for d in Disk.objects.all():
if (d.name not in disks.keys()):
d.offline = True
d.save()
disks = Disk.objects.all()
ds = DiskInfoSerializer(disks)
return Response(ds.data)
@transaction.commit_on_success
def _wipe(self, dname, request):
disk = self._validate_disk(dname, request)
try:
wipe_disk(disk.name)
except Exception, e:
logger.exception(e)
e_msg = ('Failed to wipe the disk due to a system error.')
handle_exception(Exception(e_msg))
disk.parted = False
disk.save()
return Response(DiskInfoSerializer(disk).data)
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 _scan(self):
disks = scan_disks(settings.MIN_DISK_SIZE)
for k, v in disks.items():
if (Disk.objects.filter(name=v['name']).exists()):
d = Disk.objects.get(name=v['name'])
if (d.size != v['size'] or d.parted != v['parted']):
d.size = v['size']
d.parted = v['parted']
d.save()
continue
new_disk = Disk(name=v['name'], size=v['size'], parted=v['parted'])
new_disk.save()
for d in Disk.objects.all():
if (d.name not in disks.keys()):
d.offline = True
d.save()
disks = Disk.objects.all()
ds = DiskInfoSerializer(disks)
return Response(ds.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")
for d in p_info['disks']:
do = Disk.objects.get(name=d)
do.pool = po
do.save()
mount_root(po, d)
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()
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 _wipe(self, dname, request):
disk = self._validate_disk(dname, request)
disk_name = self._role_filter_disk_name(disk, request)
# Double check sanity of role_filter_disk_name by reversing back to
# whole disk name (db name). Also we get isPartition in the process.
reverse_name, isPartition = self._reverse_role_filter_name(
disk_name, request)
if reverse_name != disk.name:
e_msg = ('Wipe operation on whole or partition of device (%s) was '
'aborted as there was a discrepancy in device name '
'resolution. Wipe was called with device name (%s) which '
'redirected to (%s) but a check on this redirection '
'returned device name (%s), which is not equal to the '
'caller name as was expected. A Disks page Rescan may '
'help.' % (dname, dname, disk_name, reverse_name))
raise Exception(e_msg)
wipe_disk(disk_name)
disk.parted = isPartition
# The following value may well be updated with a more informed truth
# from the next scan_disks() run via _update_disk_state()
disk.btrfs_uuid = None
disk.save()
return Response(DiskInfoSerializer(disk).data)
class DiskMixin(object):
serializer_class = DiskInfoSerializer
@staticmethod
@transaction.atomic
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()
ds = DiskInfoSerializer(Disk.objects.all().order_by('name'), many=True)
return Response(ds.data)
def _role_disk(self, dname, request):
"""
Resets device role db entries and wraps _wipe() but will only call
_wipe() if no redirect role changes are also requested. If we fail
to associate these 2 tasks then there is a risk of the redirect not
coming into play prior to the wipe.
:param dname: disk name
:param request:
:return:
"""
# Until we find otherwise:
prior_redirect = ''
redirect_role_change = False
try:
disk = self._validate_disk(dname, request)
# We can use this disk name directly as it is our db reference
# no need to user _role_filter_disk_name as we only want to change
# the db fields anyway.
# And when we call _wipe() it honours any existing redirect role
# so we make sure to not wipe and redirect at the same time.
new_redirect_role = str(request.data.get('redirect_part', ''))
is_delete_ticked = request.data.get('delete_tick', False)
# Get our previous roles into a dictionary.
if disk.role is not None:
roles = json.loads(disk.role)
else:
# roles default to None, substitute empty dict for simplicity.
roles = {}
# If we have received a redirect role then add/update our dict
# with it's value (the by-id partition)
# First establish our prior_redirect if it exists.
# A redirect removal is indicated by '', so our prior_redirect
# default is the same to aid comparison.
if 'redirect' in roles:
prior_redirect = roles['redirect']
if new_redirect_role != prior_redirect:
redirect_role_change = True
if new_redirect_role != '':
# add or update our new redirect role
roles['redirect'] = new_redirect_role
else:
# no redirect role requested (''), so remove if present
if 'redirect' in roles:
del roles['redirect']
# Having now checked our new_redirect_role against the disks
# prior redirect role we can perform validation tasks.
if redirect_role_change:
if is_delete_ticked:
# changing redirect and wiping concurrently are blocked
e_msg = ("Wiping a device while changing it's redirect "
"role is not supported. Please do one at a time")
raise Exception(e_msg)
# We have a redirect role change and no delete ticked so
# return our dict back to a json format and stash in disk.role
disk.role = json.dumps(roles)
disk.save()
else:
# no redirect role change so we can wipe if requested by tick
if is_delete_ticked:
if disk.pool is not None:
# Disk is a member of a Rockstor pool so refuse to wipe
e_msg = ('Wiping a Rockstor pool member is '
'not supported. Please use pool resize to '
'remove this disk from the pool first.')
raise Exception(e_msg)
# Not sure if this is the correct way to call our wipe.
return self._wipe(dname, request)
return Response(DiskInfoSerializer(disk).data)
except Exception as e:
e_msg = ('Failed to configure drive role or wipe existing '
'filesystem on 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 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)
class DiskMixin(object):
serializer_class = DiskInfoSerializer
@staticmethod
@transaction.atomic
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()
ds = DiskInfoSerializer(Disk.objects.all().order_by('name'), many=True)
return Response(ds.data)
class DiskListView(rfc.GenericView):
serializer_class = DiskInfoSerializer
def get_queryset(self, *args, **kwargs):
#do rescan on get.
with self._handle_exception(self.request):
self._scan()
return Disk.objects.all().order_by('name')
@transaction.atomic
def _scan(self):
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)
if (dob.pool is None and d.root is True):
p = self._create_root_pool(d)
p.disk_set.add(dob)
p.save()
dob.pool = p
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()
ds = DiskInfoSerializer(Disk.objects.all().order_by('name'), many=True)
return Response(ds.data)
