Current Series Release Notes

17.0.0-19

Prelude

Up to now, Freezer offered two options for job configurations called incremental and no_incremental. Both options could be set independently from one another and defaulted to conflicting values. The freezer-agent CLI offered conflicting --noincremental and --no-incremental flags, which were interpreted differently. Parts of the backup and restore procedures were using one option and other parts the other option, leading to inconsistent behavior. With this release the no_incremental option and corresponding --no-incremental flag are removed. Users can instead set incremental to false in jobs or use the --noincremental flag in the agent to achieve the same behavior.

New Features

• Add [os_brick]/lock_path configuration option to define temporary lock file location. This option is required when engine is set to osbrick.

Upgrade Notes

• Starting with this release, the naming of OpenStack resources created during backup and restore procedures changes. This affects both temporary resources as well as final resources resulting from restore actions.

  Server, volume and image resources restored from backup will receive a timestamp suffix to their name, preceeded by a tilde (~) character, e.g., “my-server~1769185234”. The timestamp is the backup timestamp of the backup that has been restored. This avoids duplicate names of resources with different historical states and makes restored resources easier to discern.

  A new job configuration option temp_resource_prefix and corresponding freezer-agent command-line flag --temp-resource-prefix is introduced. It defaults to freezer_.

  Temporary resources (snapshots, images, volumes) created during backup operations will receive a freezer_backup_ prefix to their name. Temporary resources (snapshots, images, volumes) created during restore operations will receive a freezer_restore_ prefix to their name. The freezer_ part can be configured using the new temp_resource_prefix option.

  All temporary resources created by Freezer that historically did not receive a name (resulting in the name being “None”) will now receive proper naming as described above.

• For deployment using engine=osbrick the lock_path option in [os_brick] section has to be defined.

• The no_incremental option for Freezer jobs and the --no-incremental flag for the freezer-agent CLI have been removed. They are functionally replaced with setting the existing incremental job option to false or using the existing --noincremental flag respectively.

• Support for Python 3.9 has been removed. Now the minimum python version supported is 3.10.

Bug Fixes

• Fixes behavor of restore-from-date option which had an opposite logic. Now it restores the most recent backup previous to the specified date (included).