# Copyright 2019 Red Hat, Inc. # All Rights Reserved. # Copyright (c) 2019 Dell Inc. or its subsidiaries. # # Licensed under the Apache License, Version 2.0 (the "License"); you may # not use this file except in compliance with the License. You may obtain # a copy of the License at # # http://www.apache.org/licenses/LICENSE-2.0 # # Unless required by applicable law or agreed to in writing, software # distributed under the License is distributed on an "AS IS" BASIS, WITHOUT # WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the # License for the specific language governing permissions and limitations # under the License. from oslo_log import log from oslo_utils import importutils from ironic.common import boot_devices from ironic.common import exception from ironic.common.i18n import _ from ironic.drivers.modules.redfish import boot as redfish_boot from ironic.drivers.modules.redfish import utils as redfish_utils LOG = log.getLogger(__name__) sushy = importutils.try_import('sushy') class DracRedfishVirtualMediaBoot(redfish_boot.RedfishVirtualMediaBoot): """iDRAC Redfish interface for virtual media boot-related actions. Virtual Media allows booting the system from "virtual" CD/DVD drive containing user image that BMC "inserts" into the drive. The CD/DVD images must be in ISO format and (depending on BMC implementation) could be pulled over HTTP, served as iSCSI targets or NFS volumes. The baseline boot workflow is mostly based on the standard Redfish virtual media boot interface, which looks like this: 1. Pull kernel, ramdisk and ESP if UEFI boot is requested (FAT partition image with EFI boot loader) images 2. Create bootable ISO out of images (#1), push it to Glance and pass to the BMC as Swift temporary URL 3. Optionally create floppy image with desired system configuration data, push it to Glance and pass to the BMC as Swift temporary URL 4. Insert CD/DVD and (optionally) floppy images and set proper boot mode For building deploy or rescue ISO, redfish boot interface uses `deploy_kernel`/`deploy_ramdisk` or `rescue_kernel`/`rescue_ramdisk` properties from `[instance_info]` or `[driver_info]`. For building boot (user) ISO, redfish boot interface seeks `kernel_id` and `ramdisk_id` properties in the Glance image metadata found in `[instance_info]image_source` node property. iDRAC virtual media boot interface only differs by the way how it sets the node to boot from a virtual media device - this is done via OEM action call implemented in Dell sushy OEM extension package. """ if sushy: VIRTUAL_MEDIA_DEVICES = { boot_devices.FLOPPY: sushy.VIRTUAL_MEDIA_FLOPPY, boot_devices.CDROM: sushy.VIRTUAL_MEDIA_CD } @classmethod def _set_boot_device(cls, task, device, persistent=False): """Set boot device for a node. Dell iDRAC Redfish implementation does not support setting boot device to virtual media via standard Redfish means. Instead, Dell BMC sets boot device to local physical CD/floppy. However, it is still feasible to boot from a virtual media device by invoking Dell OEM extension. :param task: a TaskManager instance. :param device: the boot device, one of :mod:`ironic.common.boot_devices`. :param persistent: Whether to set next-boot, or make the change permanent. Default: False. :raises: InvalidParameterValue if the validation of the ManagementInterface fails. """ # NOTE(etingof): always treat CD/floppy as virtual if device not in cls.VIRTUAL_MEDIA_DEVICES: LOG.debug( 'Treating boot device %(device)s as a non-virtual ' 'media device for node %(node)s', {'device': device, 'node': task.node.uuid}) super(DracRedfishVirtualMediaBoot, cls)._set_boot_device( task, device, persistent) return device = cls.VIRTUAL_MEDIA_DEVICES[device] system = redfish_utils.get_system(task.node) for manager in system.managers: # This call makes Sushy go fishing in the ocean of Sushy # OEM extensions installed on the system. If it finds one # for 'Dell' which implements the 'Manager' resource # extension, it uses it to create an object which # instantiates itself from the OEM JSON. The object is # returned here. # # If the extension could not be found for one manager, it # will not be found for any others until it is installed, so # abruptly exit the for loop. The vendor and resource name, # 'Dell' and 'Manager', respectively, used to search for the # extension are invariant in the loop. try: manager_oem = manager.get_oem_extension('Dell') except sushy.exceptions.OEMExtensionNotFoundError as e: error_msg = (_("Search for Sushy OEM extension Python package " "'sushy-oem-idrac' failed for node %(node)s. " "Ensure it is installed. Error: %(error)s") % {'node': task.node.uuid, 'error': e}) LOG.error(error_msg) raise exception.RedfishError(error=error_msg) try: manager_oem.set_virtual_boot_device( device, persistent=persistent, manager=manager, system=system) except sushy.exceptions.SushyError as e: LOG.debug("Sushy OEM extension Python package " "'sushy-oem-idrac' failed to set virtual boot " "device with system %(system)s manager %(manager)s " "for node %(node)s. Will try next manager, if " "available. Error: %(error)s", {'system': system.uuid if system.uuid else system.identity, 'manager': manager.uuid if manager.uuid else manager.identity, 'node': task.node.uuid, 'error': e}) continue LOG.info("Set node %(node)s boot device to %(device)s via OEM", {'node': task.node.uuid, 'device': device}) break else: error_msg = (_('iDRAC Redfish set boot device failed for node ' '%(node)s, because system %(system)s has no ' 'manager%(no_manager)s.') % {'node': task.node.uuid, 'system': system.uuid if system.uuid else system.identity, 'no_manager': '' if not system.managers else ' which could'}) LOG.error(error_msg) raise exception.RedfishError(error=error_msg)