]> git.sur5r.net Git - bacula/bacula/blobdiff - bacula/ReleaseNotes
- Add Scratch to PoolType in PostgreSQL make...tables and do not
[bacula/bacula] / bacula / ReleaseNotes
index 99d6eb5005f65b0258e20ac1449ae2a302fce510..79a92c1dcdbda42f35c8af9190b37adf7d87af09 100644 (file)
 
-          Release Notes for Bacula 1.36.0
+          Release Notes for Bacula 1.37.18
 
-  Bacula code: Total files = 396 Total lines = 116,418 (*.h *.c *.in)
+  Bacula code: Total files = 425 Total lines = 137,071 (*.h *.c *.in)
 
+Note! The DB has been upgraded from version 8 to 9 and requres
+a DB upgrade.
 
 Major Changes:
-- Tray monitor program (really cool)
-- Bacula Rescue CDROM (easy to make and essential for emergencies)
-- Bacula CD Image Manager
-- General bug fixes/stabilization
-- French translation of manual by Ludovic Strappazon well    
-  underway.
-- UTF-8 is supported in conio.
-- Improved conf scanning code allowing FileSet components to
-  be put on a single line (previously everything had to be on
-  a different line).
-- Win32 files restored to an alternate directory will have the
-  colon following the drive letter turned into a / e.g. c: 
-  becomes c/. Previously the c: was stripped. This applies only
-  to files written to an alternate directory (i.e. using a where=).
-- Certain open files (Word for example) can now be saved on
-  Win32 systems.
-- Default for Wild-cards on Win32 systems is to fold case this       
-  should correct most of the problems users are having with
-  exclusion on Win32.
-- Lots of improvements in the Rescue scripts -- better 
-  network detection, better mounting code, ...
-- The attributes spool file can now exceed 2GB.
-- Significant speed improvements when running PostgreSQL.
-- Significantly faster restore command with very large 
-  FileSets while building the in memory directory tree.
-- Patches directory in the source will have all patches
-  that have not been applied and released (new releases are
-  only generated when really critical bugs are found).
-- Bacula forces the tape drive into variable block mode
-  on most systems (providing Bacula is running in variable
-  block mode).
-- dbcheck updated to remove many more orphaned records.
-- Support for IPv6 (untested).
-- Modifications to the license to termination clause for
-  more protection from SCO type predators. No change for
-  normal users.
-- SIGHUP to Director causes it to reload conf file.
-
-- Many improvements in the documentation.
+- 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.
 
 New Directives:
-- Added "Rerun Failed levels = yes/no" in the Job resource
-  of the Director. It will upgrade the current job to a 
-  higher level (Full or Differential) if a previous job
-  of that level failed.
-- Added "Ignore FileSet Changes = yes/no" in the FileSet
-  directive of the Director. It prevents the Director from
-  immediately upgrading the job to a Full save if you modify
-  the contents of the FileSet. Not recommended. 
-- Added "Block positioning = yes/no" in Device resource in SD.
-  If set to no, Bacula should (as yet untested) be able to
-  recover data from tapes where the drive was set to fixed
-  blocksize but Bacula is in variable block size.
-- Added "Multiple connections = yes/no" in Catalog record for
-  allowing multiple simultaneous connections to the database.
-  This is a major performance improvement for PostgreSQL and
-  SQLite, but it is untested, so please test before putting
-  it into production.
-- Alert Command in SD permits checking for tape drive 
-  alerts at the end of every job (or doing anything you want).
-  An example of the command is in the default bacula-sd.conf
-  file as well as in the Storage Configuration chapter of
-  the manual.
+- 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:
-- umount -- same as unmount.
-- delete job now permits multiple jobids and ranges, e.g.:
-    delete job jobid=1,3,5,11-16
-- reload -- reloads bacula-dir.conf in Director.
+- "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!!!
-- As of 1.35.5 you MUST do a database update.
-  
-  cd scripts-dir (or src/cats)
-  ./update_bacula_tables
-   
-- All daemons should be compatible with 1.34 with the exception
-  of the new FileSet features such as regular expressions.
-- Regular expressions are not supported in the Win32 FD.
+- 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.
 
 Other Items:
-- Much better error messages from system errors particularly
-  on Win32 and in running scripts.
-- Many improvements in the SD.
-- Full support for 64 bit machines.
-- btape improved test and fill commands.
-- See the ChangeLog for additional details.
+- 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".
 
+- For the details of the Python scripting support, please see the new
+  Python Scripting chapter in the manual.