Release notes for Obnam2

2021-09-24 06:03

This file summarizes changes between releases of the second generation of Obnam, the backup software. The software is technically called “obnam2” to distinguish it from the first generation of Obnam, which ended in 2017 with version number 1.22.

1 Version 0.4.0, released 2021-06-06

1.1 Experimental version

This is an experimental release, and is not meant to be relied on for recovery of important data. The purpose of this release is to get new features into the hands of intrepid people who want to try out new things.

1.2 Breaking changes

This release introduces use of encryption in Subplot. Encryption is not optional, and the new obnam init command must always be used before the first backup to generate an encryption key.

Starting with this version of Obnam, there is no support at all for cleartext backups any more. A backup, or backup repository, made with a previous version of Obnam will not work with this version: you can’t list backups in a repository, you can’t restore a backup, and you can’t make a new backup. You need to start over from scratch, by emptying the server’s chunk directory. Eventually, Obnam will stop having such breaking, throw-away-everything changes, but it will take time to build that functionality.

Note: this version add only a very rudimentary approach to encryption. It is only meant to protect the backups from the server operator snooping via the server file system. It doesn’t protect against most other threats, including the server operator replacing parts of backups on the server. Future versions of Obnam will add more protection.

1.3 New or changed features

1.4 Internal changes

1.5 Changes to documentation

1.6 Thank you

Several people have helped with this release, with changes or feedback. I want to especially mention the following, in order by first name, with apologies to anyone I have inadvertently forgotten: Alexander Batischev, Daniel Silverstone, Neal Walfield, Tigran Zakoyan.

2 Version 0.3.1, released 2021-03-23

This is a minor release to work around a bug in Subplot, which prevented the 0.3.0 release to have a Debian package built. The workaround is to rewrite a small table in the “Filenames” section as a list.

3 Version 0.3.0, released 2021-03-14

3.1 Breaking changes

3.2 New or changed features

3.3 Bugs fixed

3.4 Changes to documentation

The Obnam subplot (obnam.md), which describes the requirements, acceptance criteria, and architecture of the software, has some improvements:

3.5 Thank you

Several people have helped with this release, with changes or feedback. I want to especially mention the following, with apologies to anyone I have inadvertently forgotten: Alexander Batischev, Ossi Herrala, Daniel Silverstone, Neal Walfield.

4 Version 0.2.2, released 2021-01-29

This is the first release of Obnam2. It can just barely make and restore backups. It’s ready for a light trial, but not for real use. There’s no encryption, and backups can’t be deleted yet. Restores of the entire backup work.