Zed Series (20.2.0 - 21.1.x) Release Notes¶
The Ironic team hereby announces the release of the Zed version of Ironic. This version, 21.1.0, represents the collaboration of Ironic’s contributors during the Zed release cycle, which first saw the release of Ironic 20.2.0, and Ironic 21.1.0. These versions saw improvements in functionality to better support infrastructure operators from the configuration of individual nodes, to support a greater separation of duties, and ultimately Self-Service Bare Metal as a Service, or “SSBMaaS”. Along with these features, these releases have seen numerous bug fixes. We sincerely hope you enjoy it!
vertivgest_pdusnmp drivers to support additional PDU models.
Adds an automatic switch to
urlfor the kickstart template when the source is a URL path as opposed to a
Adds a concurrency limiter for number of nodes in states related to Cleaning and Provisioning operations across the ironic deployment. These settings default to a maximum number of concurrent deployments to
250and a maximum number of concurrent deletes and cleaning operations to
50. These settings can be tuned using
[conductor]max_concurrent_clean, respectively. The defaults should generally be good for most operators in most cases. Large scale operators should evaluate the defaults and tune appropriately as this feature cannot be disabled, as it is a security mechanism.
Adds new clean steps
ilo5hardware types which allows users to create Certificate Signing Request(CSR) and adds signed HTTPS certificate to the iLO.
[dhcp]dhcp_providerconfiguration option can now be set to
dnsmasqas an alternative to
nonefor standalone deployments. This enables the same node-specific DHCP capabilities as the
neutronprovider. See the
[dnsmasq]section for configuration options.
Provides vendor passthru methods for
ilo5hardware types to create, delete and get subscriptions for BMC events. These methods are supported for
HPE ProLiant Gen10and
HPE ProLiant Gen10 Plusservers.
Adds the capability for a project scoped
adminuser to be able to create nodes in Ironic, which are then manageable by the project scoped
adminuser. Effectively, this is self service Bare Metal as a Service, however more advanced fields such as drivers, chassies, are not available to these users. This is controlled through an auto-population of the Node
ownerfield, and can be controlled through the
[api]project_admin_can_manage_own_nodessetting, which defaults to
True, and the new policy
Adds the capability for a project scoped
adminuser to be able to delete nodes from Ironic which their project owns. This can be contolled through the
[api]project_admin_can_manage_own_nodessetting, which defaults to
True, as well as the
Large scale operators should be aware that a new feature, referred to as “Concurrent Action Limit” was introduced as a security mechanism to provide a means to limit attackers, or faulty scripts, from potentially causing irreperable harm to an environment. This feature cannot be disabled, and operators are encouraged to tune the new settings
[conductor]max_concurrent_cleanto match the needs of their environment.
Operators who are upgrading should be aware that a bug was discovered with the automatic selection of
boot_interfacefor users of the
ilo5hardware types. This was an inconsistency, resulting in
pxebeing selected instead of
ipxeif both boot interfaces were enabled. Depending on the local configuration, this may, or may not have happened and will remain static on preexisting baremetal nodes. Some users may have been relying upon this incorrect behavior by having misalligned defaults by trying to use the
ipxe. Users wishing to continue this usage as it was previously will need to explicitly set a
boot_interfacevalue to either
ilo-ipxeby default, depending on the local configuration. Most operators have leveraged the default examples, and thus did not explicitly encounter this condition. Operators explicitly wishing to use
pxeboot interfaces with the
ipxetemplates and defaults set to override the defaults for
ironic.confwill need to either continue to leverage default override configurations in their
This release contains an improvement which, by default, allows users to create and delete baremetal nodes inside their own project. This can be disabled using the
Fixes detecting of allowable values for a BIOS settings enumeration in the
redfishBIOS interface when only
Adds a configuration option,
[anaconda]insecure_heartbeatto allow for TLS certificate validation to be disabled in the
anacondadeployment interface, which is needed for continious integration to be able to be performed without substantial substrate image customization. This option is not advised for any production usage.
Fixes an issue where image information retrieval would fail when a path was supplied when using the
anacondadeploy interface, as HTTP
HEADrequests on a URL path have no
Content-Length. We now consider if a path is used prior to attempting to collect additional configuration data from what is normally expected to be Glance.
Fixes an issue where the fallback to a default kickstart template value would result in error indicating “Scheme-less image href is not a UUID”. This was becaues the handling code falling back to the default did not explicitly indicate it was a file URL before saving the value.
Fixes an issue where cleaning operations could fail in such a way that was not easily recoverable when pre-cleaning network interface configuration was validated, yet contained invalid configuration. Now Ironic properly captures the error and exits from cleaning in a state which allows for cleaning to be retried.
delete_configurationstep to convert PERC 9 and PERC 10 controllers to RAID mode if it is not already set.
Fixes the default boot interface order for the
ilohardware type where previously it would prefer
ipxe. This created inconsistencies for operators using multiple hardware types, where both interfaces were enabled in the deployment.
Fixes API error messages with jsonschema>=4.8. A possible root cause is now detected for generic schema errors.
Fixes an issue where the Redfish session cache would continue using an old session when a password for a Redfish BMC was changed. Now the old session will not be found in this case, and a new session will be created with the latest credential information available.
The maximum disk erasure concurrency setting,
[deploy]disk_erasure_concurrencyhas been incremed to 4. Previously, this was kept at 1 in order to maintain continuity of experience, but operators have not reported any issues with an increased concurrency, and as such we feel comfortable upstream enabling concurrent disk erasure/cleaning. This setting applies to the
Adds a new feature to permit Ironic to automatically provide an instance requestor’s project,
lesseerights to the Bare Metal machine under the Role Based Access Control model implemented in Ironic. It does this by saving the project ID of the requestor to the Node
lesseefield automatically, and removing the rights when undeploying the machine. This feature, is normally disabled, but can be enabled using the
[conductor]automatic_lesseeconfiguration option. This option will not work in a mixed-version upgrade with older API services.
Adds a default
managerrole to the RBAC model. In the ironic model, access is generally explicitly delegated, and such the
managerrole is presently equivelent to project scoped
adminrole, however future delineation may occur as the new features and capabilities are added.
When an allocation is being processed, the randomized candidate list is now modified so that a node with a matching name to the allocation is moved to the beginning of the list. This greatly increases the chance of node name and allocation name matching in environments where the naming schemes align.
Adds driver_info/irmc_verify_ca option to specify certification file. Default value of driver_info/irmc_verify_ca is True.
Adds SNMPv3 message authentication and encryption features to iRMC driver. To enable these features, the following parameters should be used in the node’s
irmc_snmp_auth_proto(Optional, defaults to
irmc_snmp_priv_proto(Optional, defaults to
irmc_snmp_priv_protocan also be set through the following options in the
Nodes using virtual media can now specify their own external URL. This setting can be leveraged via the
driver_info\external_http_urlnode setting. When used, this setting overrides the
[deploy]external_http_urlsettings in the configuration file.
ramdiskdeploy interface is now enabled by default. When the default
directdeploy is also enabled, the
ramdiskdeploy must be explicitly requested on the node level.
jsonschema4.0.0 or newer, make sure to include a proper
$schemafield in your custom network data or RAID schemas.
The deprecated support for instance network booting (not to be confused with the
ramdiskdeploy, iSCSI boot or Anaconda deploy) has been removed. The
boot_optioncapability is no longer supported.
Support for trusted boot has been removed. This feature requires instance network booting, which is also removed this cycle.
Support for the syslinux and the often separately package isolinux and pxelinux. Legacy BIOS boot loaders, is deprecated and will be removed the future. This is for two reasons. The first is because it is a BIOS mode bootloader, and the shift to UEFI booting has reduced the need for these packages. The second reason is a lack of maintenance, which is ultimately the same reason Linux distributions are discussing dropping support and packaging. Syslinux has not been updated since 2019. Incidently, the file format it utilizes is supported by Power hardware, and that may result in the configuration template remaining in Ironic for the forseeable future.
Support for use of pxelinux is deprecated due to the deprecation of support for Syslinux.
Support for virtual media booting with x86 Hardware in Legacy BIOS mode is deprecated due to the dependency upon isolinux for use of Legacy BIOS boot mode.
isolinuxis from the
syslinuxpackage and source tree.
pxelinux, as a result of the deprecation of
syslinux, does ultimately mean the default for the
pxeboot_interface to carry defaults for the use of grub based network booting, specifically for operators who are unable to use iPXE.
driver_infofor iRMC driver, it will be removed in the future. Please use
irmchardware type to include a capability to control enforcement of HTTPS certificate verification. By default this is enforced. python-scciclient >= 0.12.0 is required.
Fixes an issue where
root_gbbecame a required field when using the
anacondadeployment interface, with a recent bug fix as the code path largely expected all deployment operations to utilize images, which is not the case. The case handling for non-image based deployments is now explicitly in internal parameter validation code.
Fixes handling of
image_sourceparameters where internal validations would not gracefully handle received redirects and treat it as a failure. We now no longer explicitly fail when a redirect is received.
Fixes an issue where an
image_sourcecould not be set to a mirror URL to facilitate deployments using a mirror with the
anacondadeployment interface. Ironic still presently has an explicit requirement on a
stage2parameter to be explicitly defined.
Fixes rebooting into the agent after changing BIOS settings in fast-track mode with the
redfish-virtual-mediaboot interface. Previously, the ISO would not be configured.
OSError: [Errno 36] File name too longwhen building a virtual media ISO from a long kernel, ramdisk or ESP URL.
Fixes an issue in the
anacondadeployment interface where PXE argument processing and preparation was erroneously directly connecting to Glance, potentially leading to an exception in the standalone use case.
delete_configurationclean and deploy steps to update node’s
raid_configfield at the end of the steps.
bootinterface to allow it with iDRAC firmware from 6.00.00.00 (released June 2022) as it has virtual media boot issue fixed that prevented iDRAC firmware to work with
redfish-virtual-mediabefore. Consider upgrading iDRAC firmware if not done already, otherwise will still get an error when trying to use
Fixes compatibility with
jsonschemapackage version 4.0.0 or newer by providing a proper schema version (Draft-07 currently).
Fixes a race condition in PXE initialization where the logic to retry what we suspect as potentially failed PXE boot operations was not consulting if an
agent tokenhad been established, which is the very first step in agent initialization.
ramdiskdeploy interface is used and automated cleaning is disabled, the
redfish-virtual-mediaboot interfaces no longer require a deploy kernel/ramdisk to be provided.
Anaconda supports the ability to explicitly pass a URL instead of a
stage2ramdisk parameter. This has resulted in confusion in use of the
anacondadeployment interface, as a
stage2ramdisk is typically not used, but made sense with Glance images in a fully integrated OpenStack deployment. Now a URL to a path can be supplied to the
anacondadeployment interface to simplify the interaction and use, and a redundant
stage2parameter is no longer required.
reset_idracverify step failures which occur when the functionality is not supported by the iDRAC. When this condition is detected, the code in the step handles the exception and logs a warning and completes successfully in case of verification steps but fails in case of cleaning steps.
Fixes an issue where an API user, when requesting a node list or single node object, could get an error indicating that the request was bad as the chassis was not found. This can occur when in-flight delete operations are in progress on another thread. Instead of surfacing a request breaking error, the API now suppresses the error and just treats it as if there is no Chassis.
enable_netboot_fallbackto cause iPXE config to exit 0 when “sanboot –no-describe” fails. Allowing the firmware to move onto the next device in the boot order.
Adds documentation of standalone deployment use case with the
Updates the minimum version of
Known issue when using iDRAC with Swift to stage firmware update files in Management interface
firmware_updateclean step of
idrachardware type has been fixed in iDRAC firmware 6.00.00.00. Upgrade when possible or use HTTP service to stage firmware files for iDRAC.
When using per-node kernel parameters, i.e.
kernel_append_paramsin the node’s
driver_info, it is now possible to insert the value of the driver’s configuration option (e.g.
[pxe]kernel_append_paramsvia the special
baremetal node set node-0 \ --driver-info kernel_append_params="%default% foo=bar"
ironicexecutable now starts the API only after the built-in conductor starts. This avoids error 500 on requests while the conductor is starting.
Fixes an issue where a conductor would attempt local takeover. In case of heartbeat failure due to resource starvation, the current conductor was detected as offline when querying the database. In this scenario the conductor would forcibly remove reservations of it’s own and initiate takeover. Current conductor is now excluded from the list of offline conductors, so that local takeover does not occur for this case. A warning is logged to highlight the potential resource starvation issue. See bug: 2010016.
Fix a bug when configuring RAID caused by not converting the port value to int type when the node managed by the irmc hardware type.