Open Stack

We are chuffed to announce the release of:

ironic-python-agent 9.5.0: =================== Ironic Python Agent
===================

Team and repository tags ========================

.. image:: https://governance.openstack.org/tc/badges/ironic-python-
agent.svg     :target:
https://governance.openstack.org/tc/reference/tags/index.html

Overview ========

An agent for controlling and deploying Ironic controlled baremetal
nodes.

The ironic-python-agent works with the agent driver in Ironic to
provision the node.  Starting with ironic-python-agent running on a
ramdisk on the unprovisioned node, Ironic makes API calls to ironic-
python-agent to provision the machine.  This allows for greater
control and flexibility of the entire deployment process.

The ironic-python-agent may also be used with the original Ironic pxe
drivers as of the Kilo OpenStack release.

Building the IPA deployment ramdisk
===================================

For more information see the `Image Builder
<https://docs.openstack.org/ironic-python-
agent/latest/install/index.html#image-builders>`_ section of the
Ironic Python Agent developer guide.

Using IPA with devstack =======================

This is covered in the `Deploying Ironic with DevStack
<https://docs.openstack.org/ironic/latest/contributor/dev-
quickstart.html#deploying-ironic-with-devstack>`_ section of the
Ironic dev-quickstart guide.

Project Resources ================= Project bugs are tracked on
Launchpad:

  https://bugs.launchpad.net/ironic-python-agent/+bugs

Developer documentation can be found here:

  https://docs.openstack.org/ironic-python-agent/latest/

Release notes for the project are available at:

  https://docs.openstack.org/releasenotes/ironic-python-agent/

Source code repository for the project is located at:

  https://opendev.org/openstack/ironic-python-agent/

IRC channel:     #openstack-ironic on irc.oftc.net

To contribute, start here: `Openstack: How to contribute
<https://docs.openstack.org/infra/manual/developers.html>`_.

This release is part of the bobcat release series.

The source is available from:

    https://opendev.org/openstack/ironic-python-agent

Download the package from:

    https://tarballs.openstack.org/ironic-python-agent/

Please report issues through:

    https://storyboard.openstack.org/#!/project/openstack/ironic-
python-agent

For more details, please see below.

9.5.0
^^^^^


New Features
************

* The hardware inventory now contains information about the system
  firmware: vendor, version and the build date.

* The "ironic-python-agent" will now attempt to determine a checksum
  type by evaluating the length of the supplied checksum. This allows
  SHA512 (SHA-2) and SHA256 (SHA-2) checksums to be identified and
  utilized without an explicit declaration of the checksum type
  utilizing the "os_hash_algo" value.

* Improved parsing of checksum files.

  * Added support for the "ALGORITHM (FILENAME) = CHECKSUM" format
    used by CentOS Stream.

  * Lines starting with "#" are ignored as comments.

  * If checksum file contain only the checksum itself, the content
    is validated to ensure it is one of the known checksum types.

* Adds a new inspection collector "lldp" that collects LLDP
  information into the "lldp_raw" field.

* The hardware inventory now contains supported network interface
  speed in Mbit/s.


Deprecation Notes
*****************

* Support for MD5 checksums have been deprecated and will be removed
  after the 2024 Release.

* The LLDP information as part of the general inventory is
  deprecated. Use the new "lldp" inspection collector to retrieve it.

* The "ipa-collect-lldp" kernel parameter and the corresponding
  option are now deprecated.


Bug Fixes
*********

* Fixes UEFI NVRAM record handling with efibootmgr so we can accept
  and handle UTF-16 encoded data which is to be expected in UEFI NVRAM
  as the records are UTF-16 encoded.

* Fixes handling of UEFI NVRAM records to allow for unexpected
  characters in the response, so it is non-fatal to Ironic.

Changes in ironic-python-agent 9.4.0..9.5.0
-------------------------------------------

406c844 Follow-up Add documentation for MellanoxDeviceHardwareManager
6098747 Ironic (and IPA) use launchpad now
c1c5537 Revert disabling MD5 checksums
e7a048e Add support for CentOS SUM files
9ed232e Add network interface speed to the inventory
c05fdf7 Fix checksum validation logic
3e05a03 Deprecate LLDP in inventory in favour of a new collector
32df26a Disable MD5 image checksums
d7234c2 Upgrade to latest hacking - v6
76accfb Fix UTF-16 result handling for efibootmgr
0304c73 Report system firmware information in the inventory
2ddb693 Trivial: formatting issue in the inventory docs
b32f6c6 [Trivial] Fix typo in efi_utils
9f09b88 Update master for stable/2023.1


Diffstat (except docs and test files)
-------------------------------------

CONTRIBUTING.rst                                   |    4 +-
README.rst                                         |    6 +-
ironic_python_agent/agent.py                       |    2 +
ironic_python_agent/config.py                      |    8 +-
ironic_python_agent/efi_utils.py                   |   17 +-
ironic_python_agent/extensions/standby.py          |  157 ++-
ironic_python_agent/hardware.py                    |  229 ++--
ironic_python_agent/inspector.py                   |    9 +
ironic_python_agent/netutils.py                    |   24 +
ironic_python_agent/utils.py                       |   27 +
releasenotes/notes/bmo-extra-147559c8d1776e8c.yaml |    5 +
...isable-md5-image-checksum-7def176928d36e75.yaml |   12 +
...support-additional-format-4b29c5cdaa6b8d16.yaml |   11 +
...ootmgr-character-encoding-19e531ba694824c1.yaml |    9 +
releasenotes/notes/lldp-raw-a09174cb930bca97.yaml  |   12 +
releasenotes/notes/net-speed-8854901e2051bb79.yaml |    5 +
releasenotes/source/2023.1.rst                     |    6 +
releasenotes/source/conf.py                        |    2 +-
releasenotes/source/index.rst                      |    1 +
setup.cfg                                          |    1 +
tox.ini                                            |    2 +-
29 files changed, 1710 insertions(+), 875 deletions(-)