Current Series Release Notes

18.0.0-22

New Features

  • Added support for dynamic backup name templates in the Freezer agent. Administrators can now use placeholders such as {mode}, {hostname}, {resource_id}, {container}, and {storage} in –backup-name. If not configured, the agent automatically defaults to mode-specific template names (e.g. freezer_{mode}_{resource_id}).

  • Unified backup naming so that the resolved backup name is used for both the backend (e.g., the Cinder volume backup created in OpenStack) and the metadata payload registered in the Freezer API.

  • Cinder native backup jobs now support the cindernative_backup_az (CLI option --cindernative-backup-az) parameter, allowing users to specify the availability zone for backup operations.

  • Add –cindernative-backup-container parameter to the backup command for cindernative volume backups. This allows users to specify a custom container name or container template (supporting {project_id}, {volume_id}, and {backup_name}) separately from the global default container name.

  • A new configuration group scheduler has been introduced. All options related to the freezer-scheduler have been moved to this group. Previous options under DEFAULT group are still respected, though are considered deprecated.

  • A new configuration section [service_auth] has been introduced and configuration of connection to Keystone is expected to be defined there.

Upgrade Notes

  • The default value for the –backup-name configuration option has been changed from None to "freezer_{mode}_{resource_id}". This means that if –backup-name is omitted, backups will be dynamically named using this template instead of failing validation or using static fallbacks.

  • Make the –container CLI option optional for Cinder native restore jobs (–backup-media cindernative), as Cinder resolves the backup storage container internally from its database.

  • Please, make sure you are using OpenStack Identity API v3 before upgrading.

Deprecation Notes

  • The DEFAULT group options related to the freezer-scheduler are considered deprecated. Please refer to the scheduler group options for more information.

  • Support for OpenStack Identity API versions except 3 has been dropped.

  • Definition of keystone connection details in the [DEFAULT] section of freezer.conf is deprecated and will be removed in next releases.

Bug Fixes

  • Resolved multiple integration issues in the native Cinder backup driver (cindernative mode), including timezone-aware UTC datetime and timestamp comparison for rotation/cleanup, and fixing generator length check errors.