summaryrefslogtreecommitdiff
path: root/debian/NEWS.upstream
blob: 2ae473dd62bd4b23f3295d2fcc733c7314aab40f (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
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
The following notes have been copied from the boxbackup trac wiki at
http://www.boxbackup.org/trac/wiki/011?format=txt

== Changes in This Release ==

 * Fixed some bugs with backing up, restoring and comparing [#2 files over 2GB] in compressed size.
 * Added new logging infrastructure, allows more control over whether messages are sent to the console or system logs, and at what level of detail.
 * Changed keepalive and diff timers to run in real time, not CPU time.
 * Enable KeepAlive time by default on new installations, set to 120 seconds.
 * Added bbackupctl commands for improved scripting of syncs.
 * Fixed a bug with restoring symlinks to directories outside of the backed-up location (thanks to Hans-Joachim Baader)
 * Ported unit tests for Windows.
 * Added full unit tests for keep-alives and diff timer on most platforms.
 * Fixed a number of bugs in the Windows port.
 * Added option to send Extended Logs to a file instead of to system logs.
 * Added option to log all file access, for debugging when a file is not backed up or causes the backup to fail mysteriously.
 * Improved error messages to identify the causes of some errors which were difficult to track down before.
 * Added bbackupd option to set the length of time before unused locations are deleted.
 * Changed default location of bbackupd.conf on Windows to the same directory as bbackupd.exe.
 * Fixed a bug where bbstoreaccounts could modify an account while it was locked by a running backup.
 * Improved command-line option handling.
 * Added command-line help (-h option) to bbackupd and bbstored.
 * Add a new -F option for daemons, which runs in the foreground but still accepts multiple connections, which is what SINGLEPROCESS used to do.
 * Fixed compare of timestamps on filesystems which cannot set them more accurately than 1 second.
 * Added new backup-start and backup-finish events to the NotifyScript, which can be used to implement more advanced functionality such as snapshotting databases.
 * Added a new sample !NotifySysAdmin script for Windows, written by James O'Gorman in VBscript.
 * Added support for multiple Box Backup (bbackupd) services on Windows, with different service names and named pipe names, to implement redundancy.
 * Fixed bbackupd mysteriously failing to back up if one of the location paths did not exist.
 * Fixed entering of international characters into bbackupquery on Windows (instructions) and Unixes with editline.
 * Improve Makefiles by reducing verbosity during build, so that any errors and warnings can be seen more easily.
 * Added saving of the list of unused root directory entries to the !StoreObjectInfoFile, so that they will persist across restarts of bbackup (thanks to Gary Niemcewicz).
 * Updated built-in documentation (program manuals, installation guide and administrator's guide).
 * Improved build targets (thanks to James O'Gorman).
 * On Unix platforms, all commands have moved from bin to sbin.

== Source Code ==

The source code for all platforms can be downloaded 
[http://www.boxbackup.org/svn/box/packages/boxbackup-0.11rc2.tgz here], although for Windows Native builds please read the [wiki:Installation#Windows Windows installation] notes.

== Upgrading ==

Upgrade all clients and servers to [wiki:010 0.10] first.

Remove any Windows services before upgrading (with `bbackupd -r`) and reinstall after upgrading (with `bbackupd -i`).

New logging options (LogAllFileAccess, ExtendedLogging and [wiki:ManualPages command-line options]) are useful but not required. To use LogAllFileAccess you need to start the daemon with the `-V` option as well.

The protocol is the same, so it shouldn't require the store server to be updated at the same time as the clients, or even fix the order of updating them. We would recommend that you upgrade the store server first, and then the clients one at a time.

You might want to either regenerate their configs, or look at the difference between a fresh config and their current one, to enable some useful options like KeepAliveTime (which is enabled by default in new installations) and to think about enabling StoreObjectInfoFile.

Most syslog messages have changed their format, so any scripts which parse syslog will have to be updated.

Anyone using SINGLEPROCESS in anger (e.g. to run bbstored as a managed service under daemontools or similar) should shoot themselves quietly in the foot and prepare to change it to '''-F''' after the upgrade. (this was never a documented option, and now behaves a little differently).

If you have problems with large files (over 2GB compressed) not being backed up, restored or compared, you will need to delete them from the store server to fix them properly. You can do this before or after upgrading, but if they are uploaded again by the 0.10 client then the problem will not be solved.

You will probably get this error message every backup run:

{{{
BACKUP PROBLEM on host your.client.host (unknown)
}}}

To fix this, edit the !NotifyScript (usually `/etc/box/bbackupd/NotifyScript.sh`), find the line that starts with the word `else`, and add these three lines immediately before it:

{{{
elif [ "$1" = backup-start -o "$1" = backup-finish -o "$1" = backup-ok ]; then
        # do nothing by default
        true
}}}

== Known Issues ==

[[TicketQuery(status!=closed)]]

== Credits ==

 * '''Martin Ebourne''' reviewed code from Windows port for merge;

 * '''Pierre-Henri Lavigne''' created and started maintaining fink packages for MacOS X;

 * '''Stuart Hickinbottom''', '''Mark''', '''Nestor Arocha Rodriguez''' and '''James Stark''' contributed code;

 * '''Pete Jalajas''' contributed the Windows installer

 * '''Charles Lecklider''' reviewed code from Windows port for merge;

 * '''Kenny Millington''' provided the bbreporter.py Python script;

 * '''Gary Niemcewicz''' tested and fixed support for Microsoft Visual Studio as a compiler;

 * '''James O'Gorman''' hosts our website, wrote a lot of documentation, bought us a real SSL certificate and fixed autoconf problems;

 * '''Ben Summers''' contributed ideas and reviewed code from Windows port for merge;

 * '''Reinhard Tartler''' created and started maintaining Debian packages;

 * '''Per Thomsen''' wrote the Docbook documentation;

 * '''Chris Wilson''' implemented most of the new features, tested Solaris, FreeBSD and MacOS X and helped out on the mailing list;

 * Testing and bug reports (in alphabetical order)
  * Tom Albers
  * Tobias Balle-Petersen
  * Damien B
  * Dave Bamford
  * Torsten Boob
  * Matt Brown (who also lent us a MacOS X laptop for testing)
  * Eric Cronin
  * Johann Glaser
  * Alex Harper
  * Guno Heitman
  * Stuart Hickinbottom
  * Richard Hurt
  * Pete Jalajas
  * David Kaufman
  * kiru
  * Paul MacKenzie
  * Mitja Muzenic
  * Tuukka Pasanen
  * Phil Shelley

 * Please let us know if we've missed you out!