X-Git-Url: https://git.sur5r.net/?a=blobdiff_plain;f=bacula%2FReleaseNotes;h=bac38a20ddf79d9d63ab7c11e624cb06d12e4879;hb=d50677b237e824dc645471bed89d077762e7c32c;hp=1aa986dc8a34bcd9c98e825fdd2113ce7c6a503d;hpb=022c28df426a6c763429b622c22e6f4ebebe70a6;p=bacula%2Fbacula diff --git a/bacula/ReleaseNotes b/bacula/ReleaseNotes index 1aa986dc8a..bac38a20dd 100644 --- a/bacula/ReleaseNotes +++ b/bacula/ReleaseNotes @@ -1,299 +1,534 @@ - Release Notes for Bacula 1.35.2 - - Bacula code: Total files = 395 Total lines = 115,062 (*.h *.c *.in) - -Changes for 1.35.1 -Major Changes: -- Tray monitor program -- Bacula Rescue CDROM -- General bug fixes/stabilization -- French translation of manual by Ludovic Strappazon well - underway. - -New Directives: -- Added Ignore FileSet Changes = yes - -Items to note!!! -- All daemons should be compatible with 1.34 with the exception - of the new FileSet features such as regular expressions. -- Regular expressions are not implemented in the Win32 FD. - -Other Items: -- Inhibit printing of FileSet for a restore as it is misleading. -- Cleaned up a number of minor scripting problems with the CDROM - creation. -- Fixed a race condition causing a Director crash on termination, - if a large number of SIGHUPs were sent during a multiple concurrent - set of backups. -- Completed integration of Rescue CD scripts with Bacula source. -- Added Ignore FileSet Changes = yes -- Added more error checking to the spooling code. -- Applied a patch from Peter Eriksson that removes a dynamic stack - allocation (replaced by alloca) and fixes some const problems. -- Fixed a free() of a static variable in the new IP code bnet.c -- Got the new Bacula Rescue CDROM booting. -- Replaced a dynamic template by a simple store when using the - native C compiler. -- Reworked some of the block.c error handling. -- Changed a Dmsgx(000, to Dmsgx(100 in dev.c that was dumping - debug output on a user. -- Integrated patch from 1.34.6 block.c to 1.35 -- Fix conio.c problem on Solaris. -- Add debug code to lock_jcr_chain(). -- Lock jcr chain around less code. -- Implement call by reference for Mmsg() and pm_strxxx() to - simplify calls. - - -Release 1.35.1 16 August 2004: -- Added Tape Alert feature (see Alert Command). -- New IPv6 code (untested) -- New way of specifying Addresses and Ports -- permits having - server listen on multiple ports. -- Regular expressions in Options directive. -- Reader/writer programs in Options (not yet fully implemented, - please do not use). -- Fixed specification of bind address on Win32 (thanks to - Martin Simmons). -- Update all Volumes from Pool record. -- Update License to terminate rights of anyone suing a GPL licensor. -- Improved error messages for Win32 and when running external - programs (e.g. RunBeforeJob). -- Implement reload of conf file in Directory on SIGHUP. -- Building restore tree is much faster on large filesets - due to binary insert. -- Alert Command in Device resource of Storage Daemon. -- New IP address and port directives. -- reader = xxx, writer = yyy in Options within FileSet of - Director's conf file. -- regex = xxx in Options within FileSet of Director's - conf file. -- New command options: update AllFromPool updates all - Volumes with Pool defaults. -- .backups client=xxx (for GUI programs). -- A duration specification may have any number of integer/modificator - specifications. E.g.: - 1 week 2 days 3 hours 10 mins - 1 month 2 days 30 sec -- Print error message if Alert Command fails in bpipe_open(). -- Doc Alert command. -- Eliminate unnecessary class in findlib/attribs.c -- Add necessary empty files to new tray-monitor directory. -- Implement Class with template in findlib/attribs.c to do casting - of uint64_t into stat packet types to avoid compiler warnings. - Thanks to Meno for this idea. -- Make some modifications to satisfy VC++. -- Apply Martin Simmons' second patch to compat.cpp to fix the line - I previously missed. -- Apply Meno's fix to bnet that corrects use of ipaddr after free_addresses, - back out my kludges, and it works. -- Modified configure.in to by default add -Wall. -- Found some problems with printing IP addresses -- will notify Meno. -- Added printing Pool to Job report. -- Fixed several places where dlists were not being released - (term_job_server, ...) -- Started implementing New() for dlists. Spent a lot of time, - but could not get it to work. -- Fixed a mutex deadlock between the job queue scheduler and the - watchdog. -- Made add_address() static. -- Added bsnprintf to address_conf.c -- Apply Marin Simmons patch to inet_aton() in compat. -- Build on Win32 -- required a few changes because of new IP code. -- Implement program reader code in Dir and FD -- not tested, and - a few corrections for writer code are needed in FD. -- Rework SQL for pruning. Add Admin pruning. Prune failed - jobs in Verify and Restore. -- Don't put commas in listing produced in restore so that users - can cut and past JobIds without having commas in the way. -- Change size_t to socklen_t in filed.c -- reindent a bit. -- Remove addr_list->size from buf size definition in bnet.c -- Create a Developer's document. -- Add prompt for Update volume from pool and update all - Volumes from pool. -- Implement user friendly time duration input editing. -- Add buf len argument to edit_utime(). -- Added eliminate orphaned Client records to dbcheck. -- Implement Alert Command in SD Device conf. -- Fix updating a Volume from the pool record -- it never changed - anything. -- Implement updating all Volumes from pool record. -- Add patch by Denis Shaposhnikov that fixes excludes of directories - in new style FileSets. -- Merge Meno's IPv6-1 code. -- Update License to terminate rights of anyone suing a GPL licensor. -- Add Pruning doc sent by Bryce Denney -- Correct inconsistencies in restore command doc pointed out by user. -- Don't edit commas in SQL intergers if they are not stricly integer. -- Update all pools in all DBs when starting the Director. -- Implement final cut of berrno and update Win32 code. -- Update copyright to include a termination clause. Add copyright to - binaries. -- Implement .backups client=xxx for Nicolas. -- Make first cut at implementing berrno class to handle Unix, Win32 - and bpipe errors. Bpipe still needs to be implemented. - This fixes (not yet tested) the Win32 errno problems in the compat lib. -- Fix btape compile problem reported by Martin Simmons -- thanks. -- Add ./configure detection of sys/tape.h -- Apply two fixes to recent changes to dev.c submitted by - Martin Simmons. -- Add checks in btape for correct size of off_t, and correct editing - of 32 and 64 bit values. -- Move supported OS/hardware into a chapter by itself. -- Fix bscan, which did not handle walking dcr list. -- Remove old attach_jcr_to_device() code. -- Fix config from Andy Wettstein's patch to use bitypes.h and detect - uint32_t, ... definitions. -- Fix a few compiler warnings because of casting pointers to int and - vise versa. -- Do some minor cosmetics to query.sql. nothing changed. -- Don't call stop_thread_timer() in backup.c if timer not started. -- Fix bug with out of order JobIds on restore. -- Make watchdog examine queues once every 10 seconds instead of once - a second. -- Add more bools to dev.c -- Fix walking attached DCRs in bscan.c -- Doc updates -- Start work on rescue files. Integrated RAID changes. -- Print a message when query.sql moved to query.sql.old during install. -- Move setting of FreeBSD chflags() to after utime() to avoid error - messages is immutable bit is set. -- Turn off heartbeat in FD when -s is given so that we can - debug without a flood of signals. -- Close and reopen the device during an append test in - btape. This better tests appending as if Bacula stops/restarts. -- Remove old attach/detach_jcr_to_device() code -- Add new attached_dcrs code. -- Remove unnecessary subroutine for bsnprintf. -- Replace sprintf() by home-grown code in edit_uint64 ... -- Begin implementation of dev->attached_dcrs. -- Remove scripts/fd.in from configure.in -- Add printing of JobId when a Job is started from the console. -- Remove fd/fd.in from scripts directory. -- Fix a number of bugs in dbcheck concerning the -c option - (i.e. with a config file). -- Made RH start scripts use -u and -g options. -- Many more DCR changes. -- Add job message indicating that the job has been rescheduled - and when. -- Fix job end time so that it is always updated. Previously it - was not updated when a job was rescheduled. -- Correct SQL for restoring job by path/name. It could sometimes - pickup the wrong JobId -- submitted by a user. -- Add a number of "%s" in editing database errors -- security issue. -- Ensure that the NumVols is incremented and decremented in the - pool record when Volumes are created or deleted. -- Cleanup error handling when labeling a tape. If vol was read-only, - the device would still be marked as having found a label. -- Put ftCreationTime into st_ctime of stat packet. Hopefully - this will fix the problem of noticing files have been moved - into the save path after a Full save. -- Fix bug in "status dir" where not all entries are listed. -- Cleanup some improper result printing in configure. -- Optimize a couple of insertions in binary_insert of dlists. - -Release 1.35.0 08 July 2004: -- Apply Christopher Hull's const patch for PostgreSQL -- Add code to block.c to detect if block header is destroyed. -- Add debug code for memset checking for zeroing 1900-3000 bytes - which is what happened to the block headers. -- If block header is destroyed, read the next block. Probably - should return with new status similar to the SHORT block - return. -- Add more debug info to bls for bad blocks. -- More implementation of DCRs. -- Eliminate argument passing in SD by using dcr. -- More int->bool conversions. -- Add file:block to a number of read/write error messages. -- More int -> bool conversions. -- Modify the SD piece by piece to use DCRs everywhere. -- Cleanup some printout for query command. -- Fix typo in cats/mysql.c -- Work on cleaning up tape driver a bit (use bools, better calling - sequences). -- Attempt to fix multi-Volume disk backup. Needs to be tested. -- Add Regular expressions to FileSet options. -- Correct configure.in to use ${MAKE} for doing the dependencies. -- Make MySQL and PostgreSQL try for 30 seconds to connect before - giving up. -- Correct Gnome 1.4 Makefile to build without cats library. -- Correct a crash reported (with patch) by Jonathan Soong - when attempting to backup an ACL on a symlinked file. -- Fixed an off by one bug in the new resources pointer code. - res_head array was one too small. -- Added Errors to last_job list. This allows detecting jobs - that terminated in a warning. -- Implement setting the Win32 icon to yellow instead of red - when the job terminated OK but with warnings. -- Fix the Win32 makefile and VC project file. The links were - not including the Win32 dlls. -- Delete some old Win32 code that was turned off. -- Eliminate a few more Win32 compiler warnings. -- Reduce the output produced by NIS (Win32 install builder). -- Simplify some of the #ifdefing in compat.h -- Rewrite spooling error handling when I/O error occurs. It is - a bit tricky, requiring to truncate the file so that a despooling - will work correctly. Needs to be tested. -- Make better subroutines for setting up for a new job. -- Start putting all DB ids on #defines (going to 64 bits). -- Fix gnome-console Makefile.in to work again. -- All "level=Incremental/Decremental" to the estimate command. This - required some re-arrangement of subroutines at a fairly low level. -- Apply Piotr Jaworski's patch (patch-r-status.diff) to update the - catalog status when a backup job starts running. -- Add (char*) cast to readline call in console.c for old readlines. -- Copy Makefile.in from gnome2-console to gnome-console (to eliminate - need for cats library). -- Modify spooling code to handle write error (e.g. spooling disk full) - more gracefully. Previously despooling would fail. -- Reduce casting in smartall.c a bit and add counters for - bytes, max_bytes, buffers and max_buffers. -- Fixed reload algorithm to stack both job end callback and the - table id. -- Fixed the orphaned buffer after reload (job_end_push had to be - destroyed. -- Destroy cond var (jcr->term_wait) only if initialized. -- Sort the Scheduled Jobs list by start-time, priority. -- Implement resources on a pointer. -- Fix Gnome console crash on up/down arrow with no history. -- Finish first cut of SIGHUP code. To make really work need res - on a single pointer rather than in fixed memory. -- Fix a number of places in query.sql where multiple JobIds are - printed (due to JobMedia records). -- Add new query: List jobs on Volume given Volume name. -- Correct socket close on Win32 in bnet.c (in addition to compat.cpp). - Caused fd leak in Win32 for each connection. -- Remove vol labeled test in askdir update_volume_info so that non-labeled - Volume in catalog can be marked in error. -- Close socket in SD when connection rejected. Caused fd leaks. -- Initialize job_start_wait cond variable after every new_jcr() otherwise - NetBSD gets error in library when trying to delete it without being inited. -- Fix typo (9 instead of 0) return status in write_new_volume_label. -- Fix mount.c to call routine that correctly marks a volume in error. -- Move code to rewrite volume label to subroutine -- a bit cleaner. -- Finish implementation and testing of new restore tree code. -- Implement feedback while tree is loading. -- Eliminate printing INFO message in UpdateDB (cats) -- it generates - "false" error messages. -- Eliminate some GTK error messages when running the Gnome2 console. -- Begin restructuring tree.c for inclusion of the binary_insert() - routine. -- Apply Peter Eriksson's lib file order changes in linking for IRIX. -- Abort configure if Internal is selected as the database. -- Add testimonials to the Web page -- Add the bugs list to the Web page "lists". -- Clarify the English in SuSE and Slackware when SD not running. -- Applied another extern "C" patch from Peter Eriksson. -- Fixed a bunch of VC warning messages. -- Applied the patches sent by Andreas Jellinghaus: build Gnome and - wx-console in client-only build if configured; add ./configure option - to permit setting of sbin modes -- default is 0745 as before; remove - cats library from Gnome console build; remove old version from Gnome - About box. Thanks Andreas. -- Applied Peter Eriksson's const changes to the source code. Thanks Peter. -- Implemented a binary_insert() method for dlists -- intended to be used - in the restore tree routines. -- Turned on my bsscanf() code, which replaces sscanf() by my routines, which - are a subset of sscanf() used by Bacula, but which have known 32/64 bit - behavior rather than vendor dependent !@#$%*. + Release Notes for Bacula 5.2.0 + + Bacula code: Total files = 1,088 Total lines = 219,172 (Using SLOCCount) + +General: +-------- + +This 5.2.0 version is a major release since the last version 5.0.3. +It includes well over 50,000 lines of changes and a number of important +new features: + +Compatibility: +-------------- + As always, both the Director and Storage daemon must be upgraded at + the same time. + + Older 5.0.x and 3.0.x File Daemons are compatible with the 5.2.0 + Director and Storage daemons. There should be no need to upgrade older File + Daemons. + +Changes and New Features: +- Use of PostgreSQL cursor when doing large queries, should reduce the + memory usage during restore and accurate backups. +- Includes better handling for Windows repares points, mount points, and + junction points. +- A few path name length limits in Windows have been removed. +- New SQL backend and ./configure that permits building multiple catalog + backends in one build, and has the main Bacula core code totally independent + of the SQL backend, which should simplify packaging (only the libbacsql.so/dll + needs to be changed. +- New database format +- Director selection option in bconsole +- restorejob command in bconsole +- Checkpoint of jobs so that in many cases they can be restarted +- Maximum Bandwidth Per Job in several places +- Disable batch insert config item +- setbandwith command +- limit command +- Bacula Virtual File System for fast catalog access +- New Pruning algoritm -- safer and faster +- Additional security against injection of illegal characters +- New block delta backup/restore +- Indent lsmark during restore +- Additional script variable editing +- Improvements in ACL and xattr handling on additional platforms: + AIX, Darwind, FreeBSD, HPUX, IRIX, Solaris, Tru64 +- Many new plugin API features +- Faster crc32 algorithm +- Improved memory handling for restores +- Improved hash table for hard links +- Significant stability enhancements to bat +- Many additional features for bat +- Tray monitor for Windows +- New FTP device handler for Storage daemon + +Bug fixes + + +=========================================================================== + +This 5.0.3 version is significant bug fix update to version 5.0.2. +It includes new code and some new features. +There is no database change since prior versions of 5.0. + +Note, if you are running 5.0.0, read the 5.0.1 and 5.0.2 release notes below in + the 5.0.1 release section. + Important!!! + +Compatibility: +-------------- + As always, both the Director and Storage daemon must be upgraded at + the same time. + + Older 5.0.x and 3.0.x File Daemons are compatible with the 5.0.3 + Director and Storage daemons. There should be no need to upgrade older File + Daemons. + +Changes and New Features: +- If a VSS (Windows) snapshot fails, the whole Job is failed, previously + it printed a warning message and continued. +- New editing codes %b = Job Bytes and %f = Job Files for runscripts +- Any non-Bacula project plugins (i.e. third party plugins) + must be upgraded to specify AGPLv3 in place of the GPLv2 used previously + for the PLUGIN_LICENSE. +- The bat Media page text columns can be sorted by clicking on the column. +- If possible, the SD will automatically update the catalog Volume size if + it does not match the Volume size. The mismatch between the Volume sizes + typically occurs when the FD has a comm line drop or the FD crashes. + + +Bug fixes +1538 1554 1564 1567 1568 1569 1571 1577 1581 1582 1587 1594 1595 1606 1610 + +- Change license from GPLv2 to AGPLv3 +- Make Win32 no filesystem change more explicit +- Backport Branch-4.0 release to Branch-5.0 +- Massive backport from Branch-5.1 to Branch-5.0 +- Fix postgresql catalog creation when version is not on the first line +- Fix bug #1610 handle empty xattr values on Linux and xBSD. +- Garbage collect memory pool at end of job and before sm_dump +- Add xattr seg fault protection suggested by Marco for bug #1610 +- Add archlinux to os.m4 +- More fixes for 32/64 bit problems in smartall +- Fix 32/64 bit problem in smartalloc dump routine +- Fix bad copy/paste in commit c88dccb88 prably a seg fault +- Add .dump and .exit commands for daemons +- Make SD automatically fix the Volume size in the Catalog when out of sync +- Use Pmsg in smartall.c rather than printf for tracing Windows +- Up maximum block size to 20M +- Fix for TLS bugs #1568 and #1599 +- Improve comm line error handling for TLS, may fix bug #1568 and #1599 +- Fix problem when sending Cancel event to plugin +- Convert all Jmsg on the watchdog thread to Qmsg +- Fix SD crash due to mismatched lock/unlock in error condition +- Fix bug #1587 if you have clients with different catalogs configured, both + catalogs contains all clients after a reload or restart of the dir +- Fix bug #1577 During migration: ERROR in block.c:950 Failed ASSERT: dev->is_open() + by moving and commenting out the ASSERT() +- Skip HB kill in FD if HB thread terminated +- Fix crash from unequal volume_lock/unlock calls +- New prunning algorithm -- should be more accurate +- Save any dumps during regression to dumps directory +- Fix crash from rw_lock/unlock miss match +- Attempt to fix duplicate job kill seg fault +- Replace pthread_kill by my_thread_send_signal() in jcr.c +- fix #1595 about batch mode detection problem for postgresql with non standard + install dir +- Fix #1594 about prune copy jobs +- Apply literal string fix in printf submitted by Luca Berra +- Fix bug #1582 Restore from multiple storage daemons breaks subsequent backups +- Fix segfault on "cancel jobid=" command +- Fix bug #1554 Windows installer doesn't honor /S flag +- Remove pool zap code that breaks 2drive-concurrent-test +- Fix #1571 and install libraries with 755 perms +- Fix bug #1581 ASSERTs in src/dird/jobq.c can never trigger +- Fix problem with BaseJob and Accurate FileSet options on client side +- Fix for bug #1569 deadlock/crash in Dir +- Fix segfault when loading Plugins +- Fix #1567 about display of long volume names truncated during restore +- Added new bacula-libs package. +- Fix bug #1538 Start Scripts return incorrect value +- Fix bug #1564 init scripts not LSB compliant + +See ChangeLog for more details. + +============================================================================= + + +============= Release 5.0.2 ======================== + +Changes since 5.0.1 +------------------- + +Bug fixes +1502 1511 1517 1524 1527 1532 1536 1541 1549 1551 1553 1559 1560 + +- Probable fix for SD crash bug #1553 +- Fix #1559 problem when restoring pruned jobs with a regexp +- Fix for bug #1560 bcopy cannot find Volume +- Fix cancel crash bug #1551 +- Check if sql backend is thread-safe +- Correct Pool display in SD status. Fixes bug #1541 +- Fix cancel crash reported by Stephen Thompson +- Rewind on close to fix #1549 +- Remove closelog() in bpipe fixes bug #1536 +- Fix #1517 about missing Base level in .level command +- Replace ASSERT in block.c with fail Job +- Fix database locking calling db_lock and returning from function without + calling db_unlock. +- Add missing db_unlock to bvfs_update_cache. +- Fix #1532 about permission on binaries +- Fix #1527 about deadlock during migration +- Another fix for OpenSSLv1 +- Add -lrt to Solaris links +- Fix tls.c for OpenSSLv1 +- Fix #1511 when trying to insert more than 50.000 directories in bvfs +- Fix plugin load not to stop if one plugin bad -- pointed out by James +- Remove --without-qwt from configure statement. +- Second correct fix to bug #1524 verify fails after adding or removing files +- Fix bug #1524 verify fails after adding or removing files +- Apply fix suggested by Andreas in bug #1502 for mediaview column sort problem +- Fix OpenSSL 1.x problem in crypto.c on Fedora 12 +- Display AllowCompress warning message only if compression used in FileSet + +============================================================================= + + +============= Release 5.0.1 ======================== + +!!!!!!!!!!!!!!! NOTE FOR 5.0.0 USERS !!!!!!!!!!!!!!!!!!!! +The Allow Duplicate Jobs directive has been significantly +reworked, and the default value has changed. See below. + +Truncate On Purge has been totally rewritten. See the new +features section of the manual. + +When Volume Poll Interval is set in the SD DEVICE configuration, +(default 5 mins), after a certain number of polling tries (approx +10) polling will stop and the operator will be asked to +resolve the problem. Previously there was no limit, and an +error message could be produced at each poll attempt. +!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!! + +Changes since 5.0.0 +------------------- +- We believe that we have resolved most of the problems + concerning canceled or failed jobs being "stuck" in the + Director. There is one outstanding problem in the SD when + canceling jobs that we will fix in the next major release. + If you see jobs that seem to be stuck, in general issuing + a cancel command in bconsole should now make them go away. + +Directives: +- The default for "Allow Duplicate Jobs" has been changed from + no to yes. If you use this directive, please check your + conf file, and note the next two items !!!!!!!!!!!!!!!!!!! +- AllowHigherDuplicates disabled. It did not work as documented + and was confusing. +- New directive "CancelLowerLevelDuplicates" See New Features + section in the manual. +- Truncate on Purge rewritten. See New Features section in the manual. + +Bug fixes: +1448 1466 1467 1468 1476 1481 1486 1488 1494 1497 +1499 1501 1505 1509 1513 + +- Ensure SD asks for help when looping even if poll set. Fixes bug #1513. +- Fix three-pool regress bug +- Modify bacula.spec fixes bug #1505 +- This version fixes an issue where the console window would start out + docked. It is fixed by initiating the variables in the Pages class wi + constructor. +- Fix make_catalog_backup.pl fails when catalog db is on other host +- Apply MacOSX installer patch from bug #1509 +- Apply fix to previous fix of Copy problem. Fix proposed by reporter o + #1476 +- Fix bug #1501 -t does not print errors +- Apply SQLite3 update fix from bug #1497 +- Apply bashism fix for diskchanger.in script from bug #1499 +- Apply rpm fix for Sci Linux from bug #1494 +- Take most recent Ukranian po from bug #1448 +- Probable fix for Copy/Migration bug #1476 +- Fix bug #1488 -- avoid recursion and race conditions in messages.c +- Upgrade cats library also to 5.0.0 +- Fix missing console page in bat +- Add bat help files to Window install +- Improve Windows upgrade to ensure old FD is shutdown +- Fix bug #1481 -- bat consumes all console file descriptors +- Backport truncate on purge from 5.1.x +- Fix bug #1486 -- bat doesn't show any errors on command-line +- Update the bsock error URL +- Correct .my.cnf umask in make_catalog_backup.pl +- Apply fix for dbcheck use by make_catalog_backup.pl +- Fix seg fault in bscan from new comment field +- Allow multiple CNs when using TLS +- Fix seg fault in SQlite driver +- Make shared libs version the same as the Bacula release version +- Remove file_index sequential check +- Fix #1466 about Bogus pruning message + +For Packagers: +1. The default query.sql file is now, except for some comments, empty. +The old file, which we no longer support (it is impossible or difficult to +make it work on every backend, and the queries are mostly contributed) can +be found in /examples/sample-query.sql. The sample file is +not installed by the Makefiles + +2. When you install the mtx-changer script, you must also install +mtx-changer.conf if it does not exist. This new file (mtx-changer.conf) is +required for mtx-changer to work, but it is a user configurable file, so on +any update, any existing file should not be overwritten. + +3. Bat should be built on every platform that is capabable of running Qt. +However, the Qt code is changing rather quickly and is not always +compatible from version to version. We have built and verified bat on Qt +4.3.4. We strongly recommend that you do not build and distribute bat with +any other version of Qt unless you personally test it. To build against Qt +4.3.4, download the depkgs-qt package from the Bacula Source Forge download +location, read the README file and follow the instructions. + +If you are building for Bacula version 5.0.0, please ensure that you do not +have qmake-qt4 loaded on your system. If you do, either remove it or +rename it before trying to build bat. If you do not, bat will probably be +built using the shared objects on your system. For Bacula 5.0.1 and later, +this problem (bug) does not exist. + +depkgs-qt does not install Qt on your system, nor does it interfere with +you having any other version of Qt installed on your system. Once you +build bat with depkgs-qt, it should *not* use the Qt shared objects, but +rather they will be linked into the program. After fully installing bat +(make install), you can run "ldd bat" to see what shared objects it will +use. If any Qt shared objects are referenced, something has gone wrong. + +4. Unless absolutely necessary, we recommend that you do not define any +special library environment variables that apply to the ./configure -- for +example: LIBDIR=/... ./configure is strongly discouraged. +Doing so, could potentially cause Bacula to be linked against the wrong +shared objects. + +5. The Bacula project strongly recommends that you install Bacula into a +single directory, with a few minor exceptions such as the MySQL or +PostgreSQL databases. Preferrably this should be /opt/bacula. The full +recommendation is: + +#!/bin/sh +# Recommended configure script for Bacula +prefix=/opt/bacula +email=xxx@yyy.zz +CFLAGS="-g -O2 -Wall" \ + ./configure \ + --sbindir=${prefix}/bin \ + --sysconfdir=${prefix}/etc \ + --docdir=${prefix}/html \ + --htmldir=${prefix}/html \ + --with-working-dir=${prefix}/working \ + --with-pid-dir=${prefix}/working \ + --with-subsys-dir=${prefix}/working \ + --with-scriptdir=${prefix}/scripts \ + --with-plugindir=${prefix}/plugins \ + --libdir=${prefix}/lib \ + --enable-smartalloc \ + --enable-tray-monitor \ + --enable-bat \ + --with-mysql \ + --with-dump-email=${email} \ + --with-job-email=${email} \ + --with-smtp-host=localhost \ + --with-baseport=9101 + +Obviously, the email, and some of the minor options (mysql, postgresql, +...) can be changed to suit your distribution, but the directory names +defined above are strongly recommended, and over time the default values in +the bacula-dir.conf and bacula-sd.conf will reflect these choices. + +If you have any questions about this or would like a detailed document +describing our recommendations including packaging requirements, please +send an email to the bacula-devel list. + +6. Starting with Bacula version 3.0.0 up to Bacula 5.0.0, the shared +libraries that Bacula uses by default are named xxx-1.0.0. Starting with +Bacula 5.0.1, we are going to name the libraries using the Bacula version. +So in Bacula 5.0.1, the libraries will be named xxx-5.0.1. With future +versions, the last digit may or may not change when we distribute patch +updates (i.e. the last digit of the version changes). This will depend on +whether or not we have changed something in the library. Hopefully this +new procedure will resolve some of the incompatibility problems between +different versions of the shared objects. + +7. The default build option for bconsole is conio (my own little console +routines). I did this because some years ago, readline was very difficult +to maintain -- it and where it was found seemed to change on every release. +This generated at the time a number of support problems. It seems to me +that since then there have been very few problems with readline. As a +consequence, I have no problem if you want to make bconsole with readline +enabled. It will actually give some very nice new bconsole command +completion functionality that Eric has written. Bottom line: feel free to +use readline or not as you please. + +========================================================== + + + +Release Notes for Bacula 5.0.0 + +Release Numbering: +----------------------------------------------------------- +You might be wondering why this release jumps from 3.0.x to +5.0.0 thus skipping version 4.0.0. We have done this for +several reasons: first, we wanted a way of distinguishing +the numbering system for the Bacula System Enterprise version +and the Bacula Project version. So, to do so, we have decided +that the first number of the Bacula Project version will always +be odd, and the first number of the Enterprise version will always +be even. Thus the Bacula Project now moves from 3.0.x to 5.0.x. +In addition, we want to keep the Bacula Project version larger +than the Enterprise version to indicate that the Bacula Project +version is more advanced or has more features than the +Enterprise version. For memory, the current Enterprise version +is 2.6.1, and the next release (in a few months -- before June 2010) +will be version 4.0.0. + +Warning: +-------------------------------------------------------------- +Please note the three Warnings below before doing any install or +upgrade. + + +Changes since 3.0.3a (the last Bacula Project release): +------------------------------------------------------- + +Bug fixes: +1337 1351 1352 1354 1357 1361 1367 1369 1370 1373 +1376 1391 1403 1409 1420 1422 1427 1428 1431 1450 +1454 1455 1458 1456 + +Fixed: + - Problem that locks the Director when the SMTP server wasn't + responding to the bsmtp program + - Restore's dir command shows incorrect file sizes + - Fix various problems with the reload command + - Fix problems with conio + - Eliminate several deadlocks or potential race conditions from SD + +Enhancements: + - Project 5: Truncate volume after purge + - Project 6: File Deduplication using Base Jobs + - Project 10: Restore from Multiple Storage Daemons + - Project 11: AllowCompression per Device + - Project 23: Add Maximum Concurent Jobs for Devices to balance load + between drives + - Add Accurate Fileset Options to configure accurate detection. Can use + checksum verification for example. + - Allow FD to keep root read but drop write permission (CAP) + - Secure handling of passwords for catalog backup + - Add Tab-completion for Bconsole when using Readline + - Add Bvfs API to query the catalog without building a memory tree + - Add new speed test to btape program + - Add new Bat screens (Autochanger content, Job view, Media view, ...) + - Windows version of Bat + - Added Spanish Bacula translation + - New bconsole -u nnn option to have timeout on commands + - Allow Migrate, Copy, and Virtual Full to read and write + to the same Pool + - show disabled -- shows disabled Jobs + - Add Pool File and Job retention periods (take precedence over Client) + - Many ACL improvements + - Level added to FD status Job entry + - Allow turning on/off Block Checksum per device + - Set Device Poll interval to 5 minutes -- previously did not poll + - Implement lock manager with bad order protection + +Compatibility: +As always, both the Director and Storage daemon must be upgraded at +the same time, and on any given machine, you must run only one version +of Bacula. This means that on the Director and Storage daemon machines, +you *must* upgrade your File daemon as well. + +Older 3.0.x and possibly 2.4.x File Daemons are compatible with the 5.0.0 +Director and Storage daemons. There should be no need to upgrade older File +Daemons immediately. However, we recommend that you do so as soon +as is reasonable for your situation. + +================== Warning !!!!!! ========================== + +New Catalog format in version 5.0.0 (3.1.9 or later) +----------------------------------------------------- + +This release of Bacula uses a new catalog format. We provide a set of +scripts that permit to convert a 3.0.x (version 11) catalog to 5.0.0 (version +12). The Bacula project rpms distributed on Source Forge will automatically +detect the database change and do the upgrade for you. We strongly +recommend that you save a copy of your existing database before upgrading +using rpms. + +The simplest way to upgrade the database assuming you are building from +source: +1. Stop any current version of Bacula from running. +2. Save a copy of your existing database. +3. Configure, build, and install the 5.0.0 version of Bacula + Note the new ./configure options in the manuals see the link + at the bottom of this file. +4. cd +5. ./update_bacula_tables +6. If you have multiple catalogs, edit the update_bacula_tables + script and put the name of another database, and then + execute the script again. Repeat this until all Bacula + catalogs have been updated. +7. Start the new Bacula. If everything worked, it should + not print any error messages. + +If you start from scratch, you don't need to run the update_bacula_tables +script because the create_bacula_tables script automatically creates the new +table format. However, if you are using a version of Bacula older than 3.1.9 +(e.g. 3.0.3) then you need to run the update_bacula_tables script that will +be found in the /src/cats directory after you run the ./configure +command. As mentioned above, before running this script, please backup your +catalog database, and when you do running it, be sure shutdown Bacula and be +aware that running the script can take some time depending on your database +size. +================================================================ + + +================== Warning !!!!!! ========================== +If you upgrade a previous Win32 client installation, you must +first stop the File daemon, then uninstall it before attempting +the upgrade. If you do not do so, the upgrade will probably +fail and you will need to manually find and run the +Uninstall.exe file, before you can upgrade to the new version. +This is because the file locations are different. If you want +to save your previous bacula-fd.conf file, please do so before +uninstalling it. +================================================================ + +================== Warning !!!!!! ========================== +Due to permissions problems on Windows Vista and later systems, +we no longer require SYSTEM or Administrator permissions to +access the binaries and configuation files. If you wish +to restrict access to these files, please see the New Features +section of the manual for how to set access control lists. +================================================================ + +Note, the Win32 Installer no longer installs the Bacula Servers +(Director and Storage daemon). See the New Features section of +the manual for more details. + +============ Documentation improvements needed ================== + +Note!!!!! The 5.0.0+ documentation has a number of known problems: + +1. We have reduced the number of manuals, which has fixed many + of the broken links found in the old 3.0.x version, but there + are still some that need fixing. + +2. Integration of the 3.0.x features into the main manuals has + not yet been done. + +The documentation will not be completed in the near future due to lack +manpower. If you are unhappy with this situation as we are, we suggest +you help by submitting patches to the documentation. Thanks. +===== + + +This release includes large number of new features and changes. +It should be more or less compatible with previous xx.conf files +and File daemons providing that you are not using any of the new +features. + +Please see the New Features chapter of the new manual, which documents +some but not all the new features (we are still working on it): + +http://www.bacula.org/5.0.x-manuals/en/main/main/New_Features_in_5_0_1.html + +The ChangeLog has more details.