X-Git-Url: https://git.sur5r.net/?a=blobdiff_plain;f=bacula%2FReleaseNotes;h=13e985bfe604834704970a06c9fac359db6fedcf;hb=b133900de3e3ca2a7c4422b3e76aa116f39603c5;hp=a644726239fb520084aa3d328e1c23d4d509114c;hpb=7f3b2717d08ce3a7618c0cf0dc5bf6a5f8ddbe76;p=bacula%2Fbacula diff --git a/bacula/ReleaseNotes b/bacula/ReleaseNotes index a644726239..13e985bfe6 100644 --- a/bacula/ReleaseNotes +++ b/bacula/ReleaseNotes @@ -1,179 +1,217 @@ - Release Notes for Bacula 1.33.4 - - Bacula code: Total files = 306 Total lines = 90,715 (*.h *.c *.in) - -Major Features: -- Data spooling which eliminates tape shoe-shine during Inc backups, - and permits multiple simultaneous backups without interleaved blocks. -- Native Win32 client -- much faster and restores permissions correctly - (thanks to Christopher Hull) -- PostgreSQL database driver (thanks to Dan Langille). -- Polling of devices eliminating need to unmount and mount from - console. -- Improved Autochange support of Slots (update slots scan). -- Autochanger support for multiple drives. -- New conio code to implement Console command line editing and history. -- JobDefs resource permits smaller .conf files for Director -- Access console lists for the Console -- Pool level overrides. -- Daemon statistics memory. -- Improved btape "test" and "fill" commands. - - -Items to note: !!!!! -- The restore default is changed to have nothing selected by default. - You must either enter: "restore all" or after getting into the tree - selection prompt enter "mark *" to have everything selected. -- In previous versions the "all" keyword on the restore command caused - it to return without user interaction after selecting everything. - This function is now replaced by the "done" keyword (more logical). - The "all" keyword now causes everything to be selected by default. -- The default tape driver behavior is now to write only a single EOF - at the end of the tape. For most tape drives, this is totally - transparent and nothing needs to be done. For FreeBSD see below. -- FreeBSD users NOTE!!!!! - You MUST add the following two records to your SD Device resource for - tape drives. - - TWOEOF = yes - Fast Forward Space File = no - -- The daemon protocol has changed, you must update everything at once. -- The database level has been updated. You must either re-initialize - your databases with: - - ./drop_bacula_tables - ./make_bacula_tables - - which will delete ALL prior catalog information, or you can - update your database with: - - ./update_bacula_tables - - Please save your old database before dropping the tables or doing - an upgrade or you may regret it later. - -- smtp has now become bsmtp -- you *must* modify your .conf files. -- console has now become bconsole. -- console.conf is now bconsole.conf -- Please don't underestimate the repercussions of the bsmtp and bconsole - name changes! - - -New directives: -- "Close on Poll = yes/no" in SD Device resource. -- "Volume Poll Interval = time-interval" in SD Device resource. -- "Two EOF = yes/no" in SD Device resource. -- "Maximum Network Buffer Size = size" in SD Device resource. -- "Maximum Network Buffer Size = size" in FD FileDaemon (or Client) resource. -- "Console" new resource in Director conf file. - New directives: Name, Description, Password, JobACL, ClientACL, - StorageACL, ScheduleACL, RunACL, PoolACL, CommandACL, - FileSetACL, CatalogACL. -- "Max Run Time = duration" in Director Job resource. -- "Max Wait Time = duration" in Director Job resource (not fully implemented). -- "JobDefs = name-of-resource" in Director Job resource. -- "Jobdefs" new resource in Director. Same directives as for a Job. -- "Full Backup Pool = xxx" in Job resource in the Director. -- "Incremental Backup Pool = xxx" in Job resource in the Director. -- "Differential Backup Pool = xxx" in Job resource in the Director. -- Three new options on the Run override statement in a Schedule resource: - FullPool=xxx - IncrementalPool=xxx - DifferentialPool=xxx -- SpoolData=yes/no in DIR Job resource -- SpoolData=yes/no in Run override directive. -- MaximumSpoolSize in SD Device resource -- MaximumSpoolJobSize in SD Device resource -- SpoolDirectory in SD Device resource. + Release Notes for Bacula 1.37.6 + + Bacula code: Total files = 414 Total lines = 123,723 (*.h *.c *.in) + + +Major Changes: +- This version has a new database format that is not compatible + with previous databases. The upgrade scripts should work, but + they are not yet tested. +- SQLite3 support, but it seems to run at 1/2 to 1/4 the speed of + SQLite2. +- First cut at ANSI labels. +- New communications protocol between DIR and SD to reserve + drives. The DIR and SD are no longer compatible with 1.36 or + lower versions. +- Preliminary Python Event support has been added. See below for + configuration and details. +- DVD writing support, using parts, and a lot of new directives in + the Device resource of the Storage configuration file. +- Seven new options keywords in a FileSet resource: + ignorecase, fstype, hfsplussupport, wilddir, wildfile, regexdir, + and regexfile. See below for details. + +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. + IBM is not yet implemented. +- 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 = 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: -- "SetIP" -- Added "pool=xxx" to restore command line. -- Added "fileset=xxx" to restore command line. -- Fixed "storage=xxx" on restore command line. -- "markdir" command in restore tree. -- "unmarkdir" command in restore tree. -- "quit" command in restore tree. -- Trace option on "setdebug trace=1/0 ..." -- Update slots scan -- The "all" keyword on the restore command marks all files by default. -- The "done" keyword prevents user interaction with the tree -- used - mostly for batch scripting. - - -Additional changes: -- Implement Gnome 2.0 restore GUI -- Add a missing unlock in the jobq handler. -- Fix bug where a soft linked file and a directory had the same name - by treating the soft link as a directory and putting the entries under - it. This fixes the bug reported by Alexander Mueller. -- Apply Jess Guardiani's second fix to list autochanger volumes without - opening the drive (necessary on FreeBSD if no tape is in the drive). -- Reworked the command line handler in restore to walk through the - arguments one at a time. This makes the file= entries work correctly. - Also reworked the code that takes the MediaType and finds a - storage device. -- Add quit command to restore tree handler. -- Make restore tree handler remember if a hard link is present, and - in doing a mark, only get database entry if there is a hard link. - mark commands thus run at least 2 orders of magnitude faster. -- Add files=xxx field to run command submitted for restore. -- Add yes to restore run command if either yes or run is command line - argument. -- Make "yes" on command line argument skip prompt for modification of - run job. -- Add markdir and unmarkdir -- both affect only the directory in - question and do not do a recursive descent. -- Make tree command automatically mark all higher level directories to - be restored when a directory or a file is selected. Such directories - are indicated by preceding the name with a + to indicate that only - the directory entry is selected and not the whole directory tree. -- Modify a few tree commands to walk through all arguments rather than - just taking the first one. -- Improved btape "test" and "fill" commands. -- The ability to ask the Storage daemon on a device by device basis - to "poll" the tape drive at a given interval (minimum 1 minute). If - a tape is found, its label is read and if appropriate it is used. - This eliminates the need to do "mount" commands. -- The ability to close and re-open the device when a poll occurs. - This permits dealing with certain recalcitrant autochangers that - invalidate devices (typically on FreeBSD). -- Dan Langille has written a PostgreSQL driver for Bacula. -- Implement "update slots scan" that reads the volume label(s). -- The full form of the scan is "scan=1,2,4-5,7". With no specification, - all occupied slots are scanned. -- Turn off changer Volumes that are not current in the changer when - an "update slots" is done, or if any tape operation discovers that - the right volume is not in the slot. -- The console program will run all commands it finds in ~/.bconsolerc - at startup. -- Add Dan Langille's changes to the bacula start/stop script that - permit dropping root permissions just after startup. -- New version 1.5.5-1 Cygwin. -- Modify SD to update the catalog database when it is shutdown, - even if the job is canceled. -- Fixed seg fault in restore of multiple simultaneous jobs to - a single Volume. -- Fixed thread race problem in multiple simultaneous jobs to - a single Volume where the volume label is not in the first - tape block, so the tape is not recognized. -- Restore directory tree automatically selects all higher level - directories to be restored. -- Implement conio.c to use in console program -- mini-readline. -- Enhance "fill" command of btape -- simpler output. Use -v to - cause last block to be dumped after write and after re-read. -- Added an autochanger test to the btape "test" command. It is - automatically invoked if the autochanger is properly configured. It - is still a bit primitive but covers the essential of testing - the mtx-changer script with your autochanger. -- Select the oldest LastWritten volume during recycling. -- Added forward space file test to btape "test" command. -- All 1.32d patches applied. -- Fixed seg fault in restore of multiple simultaneous jobs to - a single Volume. -- Fixed thread race problem in multiple simultaneous jobs to - a single Volume where the volume lable is not in the first - tape block, so the tape is not recognized. +- "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 (upgrade scripts not yet tested). + +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". +- Python scripting support: + A Python script will be called at particular points or conditions + in Bacula called Events. The currently defined Events are called: + + StartJob, EndJob, NewVolume + + Where StartJob is called before the RunBeforeJob, EndJob is called + after RunAfterJob, and NewVolume, is called before all other + "methods" of obtaining a new Volume name, when one is needed. + + The Python script of the same name as the Event name (but with a .py) + is called from the Scripts Directory (a directive defined in the + Director resource). Note, both the Filename, and the name of + the function in the file must correspond to the Event name. + + Once the Python script gets control, it can have access to Bacula + variables by doing: + + import bacula + + The script is called with one argument, typically called j. This + argument *must* be passed unchanged to each bacula function. The + format of the call is slightly different for reading Bacula + variable and for writing bacula variables. See below. + + Bacula variables can be read with: + + bacula.get(j, "Variable-name") + + where j is the argument passed to the function, and Variable-name + is on of the following: + + JobId, Client, Pool, Storage, Catalog, MediaType, NumVols, DirName, + Level, Type, Job, JobName, JobStatus + + Bacula varibles can be set using Python keyword arguments: + + bacula.set(jcr=j, VolumeName="xyz") + + The two currently implemented writable "variables" are: + + VolumeName and JobReport + + It is possible to submit a Bacula run command with the following: + + bacula.run(j, "run kernsave client=Matou storage=File") + + this function returns the JobId of the job that was started. If + there is an error, the return value is zero. + + Example: + +== File EndJob.py === +import bacula + +def EndJob(j): + jobid = bacula.get(j, "JobId") + client = bacula.get(j, "Client") + bacula.set(jcr=j, JobReport="EndJob output: JobId=%d Client=%s.\n" % (jobid, client)) + if (jobid < 5) : + startid = bacula.run(j, "run kernsave") + print "Python started jobid=", startid + + return 1 +==== + +== File NewVolume.py === +import bacula + +def NewVolume(j): + jobid = bacula.get(j, "JobId") + print "JobId=", jobid + client = bacula.get(j, "Client") + print "Client=" + client + numvol = bacula.get(j, "NumVols"); + print "NumVols=", numvol + bacula.set(jcr=j, JobReport="New Volume set for Job.\n") + bacula.set(jcr=j, VolumeName="TestA-001") + return 1 +====