summaryrefslogtreecommitdiff
path: root/blog/2022/07/24/obnam-0.8.0.mdwn
blob: 9889725c89816590d5284342db92c2fa815c6d8b (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
[[!tag announcement obnam]]
[[!meta date="Sun, 24 Jul 2022 12:32:51 +0300"]]
[[!meta title="Obnam 0.8.0 - encrypting backup program"]]

I've just pushed out version 0.8.0 of [Obnam](https://obnam.org/), an
encrypting backup program. Below are the release notes.

# Version 0.8.0, released 2022-07-24

## Breaking changes

Breaking changes are ones that mean existing backups can't be
restored, or new backups can't be created.

* The list of backups is stored in a special "root chunk". This means
  backups are explicitly ordered. This also paves way for a future
  feature to backups: only the root chunk will need to be updated.
  Without a root chunk, the backups formed a linked list, and deleting
  from the middle of the list would updating the whole list.

* The server chunk metadata field `sha256` is now called `label`.
  Labels include a type prefix, to allow for other chunk checksum
  types in the future.

* The server API is now explicitly versioned, to allow future changes
  to cause less breakage.

## New features

* Users can now choose the backup schema version for new backups. A
  repository can have backups with different schemas, and any existing
  backup can be restored. The schema version only applies to new
  backups.

* New command `obnam inspect` shows metadata about a backup. Currently
  only the schema version is shown.

* New command `obnam list-backup-versions` shows all the backup schema
  versions that this version of Obnam supports.

* Obnam now logs some basic performance measurement for each run: how
  many live files were found in total, backed up, chunks uploaded,
  existing chunks reused, and how long various parts of the process
  took.

## Other changes

* The `obnam show-generation` command now outputs data in the JSON
  format. The output now includes data about the generation's SQLite
  database size.

## Thank you

Several people have helped with this release, with changes or
feedback.

* Alexander Batischev
* Lars Wirzenius