From 49b84c39c3e99962fe03a81d5dfa5f450b8c7976 Mon Sep 17 00:00:00 2001 From: Lars Wirzenius Date: Sun, 14 Mar 2021 11:10:34 +0200 Subject: doc: update NEWS for 0.3.0 release --- NEWS | 86 +++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++- 1 file changed, 85 insertions(+), 1 deletion(-) diff --git a/NEWS b/NEWS index cdd50df..6073b5c 100644 --- a/NEWS +++ b/NEWS @@ -1,4 +1,4 @@ -# NEWS for Obnam2, the backup software +# Release notes for Obnam2, the backup software This file summarizes changes between releases of the second generation of Obnam, the backup software. The software is technically called @@ -6,6 +6,90 @@ of Obnam, the backup software. The software is technically called ended in 2017 with version number 1.22. +## Obnam2 version 0.3.0, released 2021-03-14 + +### Breaking changes + +* The format of the data stored on the backup repository has changed. + The new version can't restore old backups: old generations are now + useless. You'll have to start over. Sorry. + +### New or changed features + +* New `obnam config` sub-command writes out the actual configuration + that the program users, as read from the configuration file. + +* The client configuration now has default values for all + configuration fields that can reasonably have them. For example, it + is no longer necessary to explicitly set a chunk size. + +* Only known fields are now allowed in configuration files. Unknown + fields cause an error. + +* It is now possible to back up multiple, distinct directories with + one client configuration. The `root` configuration is now `roots`, + and is a list of directories. + +* Problems in backing up a file no longer terminate the backup run. + Instead, the problem is reported at the end of the backup run, as a + warning. + +* The client now requires an HTTPS URL for the server. Plain HTTP is + now rejected. The TLS certificate for the server is verified by + default, but that can be turned off. + +* The client progress reporting is now a little clearer. + +* Unix domain sockets and named pipes (FIFO files) are now backed up + and restored. + +* The names of the user and group owning a file are backed up, but not + restored. + +* On the Obnam server, the Ansible playbook now installs a cron job to + renew the Let's Encrypt TLS certificate. + +### Bugs fixed + +* Temporary files created during backup runs are now automatically + deleted, even if the Obnam client crashes. + +* Symbolic links are now backed up and restored correctly. Previously + Obnam followed the link when backing up and created the link + wrongly. + +* The Ansible playbook to provision an Obnam server now enables the + systemd unit so that the Obnam server process starts automatically + after a reboot. + +### Changes to documentation + +* A tutorial has been added. + +The Obnam subplot (`obnam.md`), which describes the requirements, +acceptance criteria, and architecture of the software, has some +improvements: + +* a discussion of why Obnam doesn't use content-addressable storage + +* a description of the logical structure of backups as stored on the + backup server + +* a rudimentary first sketch of a threat model: the operator of the + backup server reads the backed up data + +* an initial plan for adding support for encryption to backups; this + is known to be simplistic and inadequate, but the goal is to get + started, and then iterate to get something acceptable, even if that + takes months + +### 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. + ## Obnam2 version 0.2.2, released 2021-01-29 This is the first release of Obnam2. It can just barely make and -- cgit v1.2.1 From b62ce026392dd9b8bea06b04413931b0bbd75762 Mon Sep 17 00:00:00 2001 From: Lars Wirzenius Date: Sun, 14 Mar 2021 11:15:49 +0200 Subject: build: bump version number --- Cargo.toml | 2 +- debian/changelog | 6 ++++++ 2 files changed, 7 insertions(+), 1 deletion(-) diff --git a/Cargo.toml b/Cargo.toml index fb0403f..dcaacde 100644 --- a/Cargo.toml +++ b/Cargo.toml @@ -1,6 +1,6 @@ [package] name = "obnam" -version = "0.2.2" +version = "0.3.0" authors = ["Lars Wirzenius "] edition = "2018" description = "a backup program" diff --git a/debian/changelog b/debian/changelog index 136f47c..4433909 100644 --- a/debian/changelog +++ b/debian/changelog @@ -1,3 +1,9 @@ +obnam (0.3.0-1) UNRELEASED; urgency=medium + + * New release. + + -- Lars Wirzenius Sun, 14 Mar 2021 11:15:25 +0200 + obnam (0.2.2-1) unstable; urgency=low * Initial packaging. This is not intended to be uploaded to Debian, so -- cgit v1.2.1