- Release Notes for Bacula 1.31
+ Release Notes for Bacula 1.37.18
- Bacula code: Total files = 253 Total lines = 75,240 (*.h *.c *.in)
+ Bacula code: Total files = 425 Total lines = 137,071 (*.h *.c *.in)
-Major Changes this Release:
-- The database format has changed from version 1.30a. Please see below.
-- Support to save and restore all files on WinNT/2K/XP systems
- including the permissions. Unfortunately files that are in use by another
- program cannot be saved.
-- Support for Win95 systems (untested since I don't have Win95).
-- Heartbeat every 20 minutes between daemons to prevent network
- timeouts. The heartbeat interval can be set.
-- Volume names may now only contain letters, numbers, colon, period, dash,
- and underscore.
-- Added readline to depkgs (removed from depkgs1) and fixed configuration if
- it is not installed in your system libraries.
-- Implemented generalized tape label formats including counter variables
- for automatic naming of Volumes.
-- Multiple simultaneous jobs now work. However, I still don't highly
- recommend it.
-- Implemented tape block rejection, which means that restores with
- several incremental backups will run orders of magnitude faster.
+Note! The DB has been upgraded from version 8 to 9 and requres
+a DB upgrade.
+Major Changes:
+- This version has a new DIR <--> SD protocol. Both must be
+ upgraded at the same time. Deamons are not compatible with
+ prior versions. All FDs must be upgraded.
+- There is a new database format that is not compatible
+ with previous databases.
+- SQLite3 support, but it seems to run at 1/2 to 1/4 the speed of
+ SQLite2.
+- Multiple drive autochanger support.
+- Support for ANSI/IBM labels.
+- New communications protocol between DIR and SD to reserve
+ drives.
+- Python Event support has been added. See below for
+ configuration and details. Unfortunately, it is not yet complete
+ and the only really useful function is defining a new
+ Volume name.
+- DVD writing support, using parts, and a lot of new directives in
+ the Device resource of the Storage configuration file thanks
+ to Nicolas Boichat.
+- Seven new options keywords in a FileSet resource:
+ ignorecase, fstype, hfsplussupport, wilddir, wildfile, regexdir,
+ and regexfile thanks to Pruben Guldberg). See below for details.
+- Restore of all files for a Job or set of jobs even if the file
+ records have been removed from the catalog.
+- Restore of a directory (non-recursive, i.e. only one level).
+- Support for TLS (ssl) between all the daemon connections thanks
+ to Landon Fuller.
+- Any Volume in the Pool named Scratch may be reassigned to any
+ other Pool when a new Volume is needed.
+- You may clone a Job and thus write (almost) the same data
+ to multiple Volumes simultaneously (see below). Actually,
+ any Job may start any other Job with this mechanism, so it
+ also be used to group jobs.
+- Unicode filename support for Win32 (thanks to Thorsten Engel)
+- New manual format with an index (thanks to Karl Cunningham).
+- New Web site format (thanks to Michael Scherer).
+- Seeking on disk Volumes during restore.
-Other Changes this Release:
-- Restore checks block numbers to ensure that no block is lost.
-- The new console var command allows testing variable expansion
- used in automatic tape name generation.
-- The new console estimate command allows you to test FileSets
- to see how many files and bytes will be saved and optionally
- to have an "ls -l" style listing of the files.
-- During a normal restore (replace = yes), any existing file is deleted
- and the restored file is then created. This corrects links and other
- wierd files that changed between the backup and the restore.
-- Preliminary support for BSDi.
-- Use smtp instead of mail to send the traceback message.
-- Fixed a race condition in the "list" command while a backup is
- in progress.
-- Improvements to gnome-console.
-- Prune orphaned jobs (no files saved, no Volume used).
-- Added non-fatal errors to Job reports.
-- Eliminate need for SubsysDirectory in each daemon -- please remove
- these records from your .conf files.
-- Add a lot more "command line" options to console commands.
-- More info in traceback (database type, ...).
-- Better handling of errors with autochangers during restore.
-- Better cancellation of jobs in Storage daemon (doesn't try
- to cleanup twice).
-- Better cancellation of File daemon (except on Cygwin systems).
-- SD error messages such as autochanger errors are now properly
- directed back to Console -- previously some were lost.
-- A Storage daemon crash on FreeBSD systems (due to a different FreeBSD
- pthreads implementation) is fixed.
-- Better Job termination report particularly for Verify and Restore jobs.
-- Update Verify VolumeToCatalog to use new BSR records.
-- Fixed list last 20 jobs in restore command (previously reported any
- 20 jobs).
-- Gnome command line history works better.
-- Better messages if a job is upgraded from Diff or Inc to Full.
-- Replaced FileSet MD5 with date created -- more aestetic and readable.
-- Fixed a FD crash on long directory names (Win32 specific).
+New Directives:
+- New Run directive in Job resource of DIR. It permits
+ cloning of jobs. To clone a copy of the current job, use
+ Run = "job-name level=%l since=\"%s\""
+ Note, job-name is normally the same name as the job that
+ is running but there is no restriction on what you put. If you
+ want to start the job by hand and use job overrides such as
+ storage=xxx, realize that the job will be started with the
+ default storage values not the overrides. The level=%l guarantees
+ that the chosen level of the job is the same, and the since=...
+ ensures that the job uses *exactly* the same time/date for incremental
+ and differential jobs. The since=... is ignored when level=Full.
+ A cloned job will not start additional clones, so it is not possible
+ to recurse.
+- New Options keywords in a FileSet directive:
+ - WildDir xxx
+ Will do a wild card match against directories (files will not
+ be matched).
+ - WildFile xxx
+ Will do a wild card match against files (directories will not
+ be matched).
+ - RegexDir xxx
+ Will do a regular expression match against directories (files
+ will not be matched).
+ - RegexFile xxx
+ Will do a regular expression match against files( directories
+ will not be matched).
+ - IgnoreCase = yes | no
+ Will ignore case in wild card and regular expression matches.
+ This is handy for Windows where filename case is not significant.
+ - FsType = string
+ where string is a filesystem type: ext2, jfs, ntfs, proc,
+ reiserfs, xfs, usbdevfs, sysfs, smbfs, iso9660. For ext3
+ systems, use ext2. You may have multiple fstype directives
+ and thus permit multiple filesystem types. If the type
+ specified on the fstype directive does not match the
+ filesystem for a particular directive, that directory will
+ not be backed up. This directive can be used to prevent
+ backing up non-local filesystems.
+ - HFS Plus Support = yes | no
+ If set, Mac OS X resource forks will be saved and restored.
+- Label Type = ANSI | IBM | Bacula
+ Implemented in Director Pool resource and in SD Device resource.
+ If it is specified in the SD Device resource, it will take
+ precedence over the value passed from the Director to the SD.
+- Check Labels = yes | no
+ Implemented in the SD Device resource. If you intend to read
+ ANSI or IBM labels, this *must* be set. Even if the volume
+ is not ANSI labeled, you can set this to yes, and Bacula will
+ check the label type.
+- Scripts Directory = <directory> name. Defines the directory from
+ which Bacula scripts will be called for events. In fact, Bacula
+ appends this name to the standard Python list of search directories,
+ so the script could also be in any of the Python system directories.
+- In FileSet, you can exclude backing up of hardlinks (if you have
+ a lot, it can be very expensive), by using:
+ HardLinks = no
+ in the Options section. Patch supplied by David R Bosso. Thanks.
+- MaximumPartSize = bytes (SD, Device resource)
+ Defines the maximum part size.
+- Requires Mount = Yes/No (SD, Device resource)
+ Defines if the device require to be mounted to be read, and if it
+ must be written in a special way. If it set, the following directives
+ must be defined in the same Device resource:
+ + Mount Point = directory
+ Directory where the device must be mounted.
+ + Mount Command = name-string
+ Command that must be executed to mount the device. Before the command
+ is executed, %a is replaced with the Archive Device, and %m with the
+ Mount Point.
+ + Unmount Command = name-string
+ Command that must be executed to unmount the device. Before the
+ command is executed, %a is replaced with the Archive Device, and
+ %m with the Mount Point.
+ + Write Part Command = name-string
+ Command that must be executed to write a part to the device. Before
+ the command is executed, %a is replaced with the Archive Device, %m
+ with the Mount Point, %n with the current part number (0-based),
+ and %v with the current part filename.
+ + Free Space Command = name-string
+ Command that must be executed to check how much free space is left
+ on the device. Before the command is executed, %a is replaced with
+ the Archive Device, %m with the Mount Point, %n with the current part
+ number (0-based), and %v with the current part filename.
+- Write Part After Job = Yes/No (DIR, Job Resource, and Schedule Resource)
+ If this directive is set to yes (default no), a new part file will be
+ created after the job is finished.
+New Commands:
+- "python restart" restarts the Python interpreter. Rather brutal, make
+ sure no Python scripts are running. This permits you to change
+ a Python script and get Bacula to use the new script.
+Items to note!!!
+- You must add --with-python=[DIR] to the configure command line
+ if you want Python support. Python 2.2 and 2.3 should be automatically
+ detected if in the standard place.
+- With Python 2.2 version, the link of the Director gets a few linker
+ warnings due to the fact that Python pulls in some old non-secure
+ libraries.
+- With Python 2.3, there are a few compiler warnings.
+- You must either create a new catalog database or upgrade your
+ old database (the PostgreSQL upgrade scripts not yet tested).
+- You must add --with-openssl to the configure command line if
+ you want TLS communications encryption support.
-Items to note: !!!!!
-- Recycle Oldest Volume has changed to be Purge Oldest Volume
- Please change your Director's .conf file.
-- The default time interval is now days instead of seconds. Please
- check your .conf files!
-- For MySQL users, you must have the thread safe client libraries
- available. If you build MySQL yourself, add the --enable-thread-safe-client
- option on the ./configure. You will most likely need to do an ldconfig.
- Please see the installation documentation for building MySQL.
-- Version 1.31 and 1.30 daemons/Director are not compatible. You must
- upgrade all or nothing.
+Other Items:
+- 2 new scripts, dvd-writepart and dvd-freespace, in the scripts directory,
+ which are designed to be used as parameters to Write Part Command and
+ Free Space Command. They need the dvd+rw-tools to be installed
+ (http://fy.chalmers.se/~appro/linux/DVD+RW/).
+- Part files support: File volumes can now be splitted in multiple
+ files, called "parts".
-- The format of the catalog database has changed, so you must either
- re-initialize your database (losing all the old info) with:
-
- ./drop_bacula_tables
- ./make_bacula_tables
-
- or you can use the appropriate script (you must choose the name according
- to which database you have) in the <bacula-source>/src/cats directory.
-
- BEFORE APPLYING THE ALTER SCRIPT PLEASE BACKUP YOUR DATABASE.
- If you have previously upgraded to version 1.31, please do not run
- this procedure a second time. Do one of the following only if you
- wish to keep your old tables (not doing the re-initialize documented
- above), and do this only after configuring an building the new Bacula,
- but before trying to run it:
-
- MySQL:
- cd working-directory (or where you want to backup the catalog)
- mysqladmin -f --opt bacula >bacula.sql
- cd <bacula-source>/src/cats
- ./alter_mysql_tables
-
- SQLite:
- cd working-directory
- echo '.dump' sqlite bacula.db >bacula.sql
- cd <bacula-source>/src/cats
- ./alter_sqlite_tables
-
- When you are sure that Bacula is running with your upgraded database,
- please delete the bacula.sql copy you made.
-
+- For the details of the Python scripting support, please see the new
+ Python Scripting chapter in the manual.