File benji.changes of Package benji

Wed Nov 20 11:21:18 UTC 2019 - Michael Vetter <>

- Update to 0.8.0:
  * This release contains significant changes related to the naming, format and
    structure of internal and external data representations. They derive from the
    experience of using Benji in the last few months and from the challenges
    uncovered by the ongoing Kubernetes integration efforts. The changes have been
    bundled to avoid multiple metadata version changes and migrations.

  * Old metadata backups and exports and old object metadata can still be read by
    this version of Benji. Existing databases can be migrated to the new database
    structure with benji database-migrate. While this process has been tested with
    both PostgreSQL and SQLite it is strongly recommended to make a consistent
    backup of the database before attempting the migration. The migration process
    requires a significant amount of time and disk space when there are a lot of old
    backups in the database. The versions and blocks tables are completely recreated
    and the old data is moved over. Expect the disk usage to more than double during
    the migration.
  Database and metadata changes:
  * The version of metadata exports has changed from 1.1.0 to 2.0.0. Old
    exports (1.0.0 and 1.1.0) can still be imported.
  * snapshot_name in the versions table has been renamed to snapshot in the
    database and in metadata exports. The long version of the corresponding command
    line option has also been renamed from --snapshot-name to --snapshot.
  * name in the versions table has been renamed to volume in the database and in metadata exports.
  * bytes_dedup in the versions table has been renamed to bytes_deduplicated in the database and in metadata exports.
  * id in the blocks table has been renamed to idx in the database and in metadata exports.
  * The type of uid in the versions table has been changed from integer to
    string. This also affects any metadata exports. This removes the inconsistency
    where uid was represented as a string in some places and as an integer in
    others. uids are automatically generated for new versions, but there is also
    the option to set the uid of a version on backup via the new -u/--uid option.
  * Storages are now always represented by their name. This changes the key
    name in metadata exports from storage_id to storage and the corresponding value
    is now of type string and not of type integer anymore.
  * A new table storages is introduced to hold the internal mapping of storage
    ids to storage names. It is no longer necessary to specify a storage id in the
    configuration but existing storage ids are imported from the configuration into
    the database.
  * Labels are now exported as a dictionaries instead of lists.
  * The letter Z has been appended to the date value in metadata exports to signify the UTC timezone.
  * These name changes also affect the specification of version filters on the command line and custom scripts might need simple adjustments.
  * The format of metadata exports is now more compact and has been optimized
    to facilitate efficient imports in a future version of Benji by ordering the
    entries in a specific way.

  Object metadata changes:
  * The object metadata version has been changed from 1.0.0 to 2.0.0. Benji can still read version 1.0.0 object metadata.
  * The timestamps in the created and modified fields of the object metadata
    have also been augmented with timezone information by appending a Z to the timestamp.
    The naming of automatically generated copy-on-write versions for writable NBD exports has changed.
  * A workaround for a bug in various versions of nbd-clinet has been added.
    This bug leads to aborted NBD connections just after the negotiation phase was
    completed and leaves the NBD block device unusable. With the workaround implemented this is no longer the case.
  * benji-k8s: benji-restore-pvc has been converted from Bash to Python and now
    runs in-cluster only. To execute it and other commands connect to the Benji maintenance pod.
  * benji-k8s: Rook persistent volumes provisioned by the FlexVolume
    provisioner are now detected by benji-backup-pvc and can be backed up with
    Benji. (Contributed by @q3k. Thanks!)
  * benji-k8s: The Prometheus label version_name has been renamed to volume.

Thu Oct 17 14:33:24 UTC 2019 - Richard Brown <>

- Remove obsolete Groups tag (fate#326485)

Fri Aug 30 08:53:26 UTC 2019 -

- Update to 0.7.1:
  * This release pins two package dependencies to older versions
    as newer releases of these dependencies broke Benji.
  * Fixes #49.
  * Fixes #51.

Mon Jul 29 05:48:46 UTC 2019 -

- Update to 0.7.0:
  * Added a new I/O module rbdaio which uses the asynchronous API of librbd.
    Performance results in relation to rbd have been mixed but performance
	should be at least 10-20% higher on restore. In one case performance has
	been increased tenfold.
  * Almost all Bash helper scripts have been rewritten in Python.
    The new scripts are calling Benji via the command line just like before.
	This is intentional to minimize the interdependence between Benji and these
	helpers. The scripts are examples only and not part of the API.
	There still is one example Bash script at scripts/ to show how to
	interact with Benji via Bash. The helpers have additional dependencies
	which can be installed with pip install benji[helpers].
  * The Prometheus metrics exported by benji-k8s have changed:
  * Backup metrics now longer include the auxiliary_data label.
  * Command metrics now longer include the arguments label. The arguments
    have been folded into the command label.
  * benji-k8s: The included scripts have been replaced by Python scripts and
    are using the new helper modules. They should be calling compatible.
  * benji-k8s: All calls to kubectl have been replaced with direct API requests.
    The official Python client for Kubernetes is used. kubectl is still included
	in the image.
  * Helm chart: Volumes and volume mounts are now configurable via values.yaml.
    This is mostly for getting the Ceph credentials into the container but could
	also be used to mount file-based storage.
  * Helm chart: The PostgreSQL chart dependency was updated from 2.7.6 to 4.2.2.
    This is the last chart which uses PostgreSQL 10 and requires no upgrade of the
	database data structures.
  * benji-k8s and Helm chart: The image was simplified to only include the
    Kubernetes specific scripts and kubectl. Instead of running backups or other
	jobs via crond inside the container, the Helm chart now generates separate
	CronJobs inside of Kubernetes. This is in preparation of the move to custom
	resources and an operator.
  * An experimental and as of yet unfinished REST API has been added.
    The environment variable BENJI_EXPERIMENTAL has to be set to 1 to enable the
	new rest-api subcommand. The API currently only services one request at a time,
	which limits its usefulness. The REST API has additional dependencies, they can
	be installed with pip install benji[rest-api].

Thu May 23 04:31:24 UTC 2019 -

- Update to 0.6.0:
  * URL parsing of I/O resources is now conforming to standards.
    Especially for the RBD I/O module the two slashes directly after
    the colon are no longer valid and have to be removed
    (rbd://pool/image -> rbd:pool/image).
  * Added I/O module for iSCSI. It is based on libiscsi and requires
    no elevated permissions. Please see the documentation as Benji
    requires a special version of the libiscsi Python bindings.
    The module is single-threaded and synchronous, so performance
    will be limited. Contributions are welcome!
  * The algorithm used by benji enforce has seen an overhaul and
    should be more comprehensible as the time categories are based
    on natural time boundaries (start of the hour, day, week,
    month, and year) now.
  * Added a restore helper script (images/benji-k8s/scripts/benji-restore-pvc)
    for Kubernetes. This script is intended to be run on a management
    system with access to the Kubernetes cluster and can restore
    a version into a new or an existing PVC/PV pair.
  * The container images are now based on the Python 3.6 included in EPEL.
    The RBD support has been updated to Ceph Nautilus. Nautilus also
    added RADOS and RBD Python bindings for Python 3.6 which are now
    used instead of building them themselves.
- Add requires on python3-diskcache

Tue Apr  2 11:16:12 UTC 2019 -

- Update to 0.5.0:
  * Added fsfreeze support to the benji-k8s Docker image. Just add
    the yes annotation to the PVC.
    Kubernetes hosts are accessed via pods which are deployed by
    a DaemonSet, see the Helm chart for details.
  * Use bulk inserts to speed up backups of images based on a
    previous version. This also decreases memory usage.
  * Switched from in-memory block lists to an iterator based approach.
    This will increase performance and decrease memory usage when
    backing up large images.
  * Fixed a wrong index on the blocks table. This should also increase
    performance. The database will need to be migrated with benji
  * Laid the foundation for structured logging.
  * Removed database table stats and assorted code and commands.
    Statistics are now kept together with the other version metadata
    in the versions table. This means they are also removed when the
    version is removed. If you want to keep historic statistics you
    need to export them beforehand with benji -m ls or benji
    metadata-export. This is a breaking change and you might need
    adjust your scripts. As statistics are now included in a
    version's metadata the metadata version is now 1.1.0.
    Old metadata backups and exports with a metadata version of
    1.0.0 can be imported by the current version. The statistics will be
    empty in that case. The database will need to be migrated with
    benji database-migrate.
  * Fixed a bug in the time calculation of benji enforce which
    could lead to a late expiration of versions, the timing was
    a few hours off.
- Remove dependency on colorlog
- Add dependency on colorama and structlog

Thu Mar 21 08:04:13 UTC 2019 -

- Update to 0.4.0:
  * Documentation updates
  * Added new CLI command benji storage-stats to get storage usage information
  * Fixed backup progress reporting on console
  * Added fdatasync() calls to the file module to ensure backup integrity
    in case of a system crash or a power failure (will impact performance when using the file I/O module)
  * Speed up command line completion
  * Added benji completion CLI command

Tue Feb 26 11:53:55 UTC 2019 -

- Mark benji.yaml as config file

Tue Feb 26 08:15:37 UTC 2019 -

- Update to 0.3.1:
  * Fix a naming problem with the --override-lock CLI option of
    benji rm and benji cleanup

Mon Feb 25 14:44:42 UTC 2019 -

- Update to 0.3.0:
  * Restores are now multi-threaded just like backups. This should speed things up quite a bit.
  * Multi-threaded removal of blocks was implemented.
  * The default for simultaneous read and writes was increased from one to three to get better out-of-the-box
  * Left over locks due to power outages are similar events can now be overridden. This applies to benji rm and
    benji cleanup
  * A typo was fixed in the metadata-backup command. It is now correctly spelled metadata-backup and
    not netadata-backup
  * A bug was fixed where blocks where not properly cleaned up when multiple storages were in use.
  * The documentation was updated, but we're still not up-to-date at all fronts.
  Backup scripts:
  * It is now possible to hook into strategic points in the backup process with custom bash functions.
  * Prometheus metrics were reimplemented with these hooks and are now specific to the benji-k8s Docker image.
  * The foundations for freezing the filesystem before a Ceph snapshot were laid.
  * The scripts in the benji-k8s Docker image now generate Kubernetes events about backup failure or
    success. These events are attached to the affected PersistentVolumeClain and can for example be
    viewed with kubectl describe pvc.
  * benji-backup-pvc was renamed to benji-pvc-backup.
  * Support for the try/catch construct based on the bash-oo-framework was removed. It had limitations
    and was causing problems with certain IDEs.

Mon Feb 18 11:56:48 UTC 2019 -

- Use python3 macros for build and install

Mon Feb 18 09:51:26 UTC 2019 -

- Update to 0.2.0:
  * Fix a big locking design problem.
  * Convert valid boolean flag into a status field in versions table.
    This solves a problem where incomplete backups where marked as valid
    by a deep-scrub. The new status field can be queried in filter 
    expressions like so: status == "valid". Third party scripts
    might need adjustments.
  * All binary keys and salts in the configuration file are now
    BASE64 encoded instead of using the !!binary YAML extension.
    This is for better compatibility with 3rd party tools like Helm.
    User action needed.
  * Implement proper handling of datetime columns in filter expressions.
    Things like date < "1 day ago" are now possible.
  * Make database migrations work properly again. Database migrations
    are now an explicit process and not automatic anymore. Use the
    new database-migrate command.
  * When restoring to an existing RBD image discard all existing
    data before the restore so as not to use more space then needed.
  * Increase standards conformance of Benji's NBD server (a little bit).
  * Convert read cache to use a sharded design to increase scalability.
  * Optimize database access pattern when backing up an image with
    a lot of sparse blocks.
  * Optimize database commit handling.
  * Implement workaround for SQLite database write access contention problem.
    Please use PostgreSQL if you're planning on having multiple Benji
    processes running at the same time, SQLite wasn't designed for this.

Mon Feb 18 09:49:43 UTC 2019 -

- Fix build: use python_sitelib macro

Tue Jan 15 20:47:54 UTC 2019 - Michael Vetter <>

- Update to first benji release: 0.1.1
- Add Requires: python3-semantic_version, python3-ruamel.yaml
- Add versions to Requires

Mon Aug 13 10:56:26 UTC 2018 -

- Create /var/lib/benji
- Install sample config file

Mon Aug 13 09:51:00 UTC 2018 -

- Rename from backy2 to benji as this fork is actively maintained

Thu Aug  2 12:03:53 UTC 2018 -

- Recommend python3-psycopg2 and python3-boto3

Thu Aug  2 11:53:05 UTC 2018 -

- Initial package backy2 for openSUSE in version 2.9.17