]> git.sur5r.net Git - bacula/bacula/blob - kernstodo
c2ca15ec94cc5f0b225616e607386ec09ff1f84d
[bacula/bacula] / kernstodo
1                     Kern's ToDo List
2                     14 December 2007
3
4
5 Document:
6 - !!! Cannot restore two jobs a the same time that were
7   written simultaneously unless they were totally spooled.
8 - Document cleaning up the spool files:
9   db, pid, state, bsr, mail, conmsg, spool
10 - Document the multiple-drive-changer.txt script.
11 - Pruning with Admin job.
12 - Does WildFile match against full name?  Doc.
13 - %d and %v only valid on Director, not for ClientRunBefore/After.
14 - During tests with the 260 char fix code, I found one problem:
15   if the system "sees" a long path once, it seems to forget it's
16   working drive (e.g.  c:\), which will lead to a problem during
17   the next job (create bootstrap file will fail).  Here is the
18   workaround: specify absolute working and pid directory in
19   bacula-fd.conf (e.g.  c:\bacula\working instead of
20   \bacula\working).
21 - Document techniques for restoring large numbers of files.
22 - Document setting my.cnf to big file usage.
23 - Add example of proper index output to doc. show index from File;
24 - Correct the Include syntax in the m4.xxx files in examples/conf
25 - Document JobStatus and Termination codes.
26 - Fix the error with the "DVI file can't be opened" while
27   building the French PDF.
28 - Document more DVD stuff
29 - Doc
30    { "JobErrors",  "i"},
31    { "JobFiles",   "i"},
32    { "SDJobFiles", "i"},
33    { "SDErrors",   "i"},
34    { "FDJobStatus","s"},
35    { "SDJobStatus","s"},
36 - Document all the little details of setting up certificates for
37   the Bacula data encryption code.
38 - Document more precisely how to use master keys -- especially
39   for disaster recovery.
40  
41 Professional Needs:
42 - Migration from other vendors
43   - Date change
44   - Path change
45 - Filesystem types
46 - Backup conf/exe (all daemons) 
47 - Backup up system state
48 - Detect state change of system (verify)
49 - Synthetic Full, Diff, Inc (Virtual, Reconstructed)
50 - SD to SD
51 - Modules for Databases, Exchange, ...
52 - Novell NSS backup http://www.novell.com/coolsolutions/tools/18952.html
53 - Compliance norms that compare restored code hash code.
54 - When glibc crash, get address with
55     info symbol 0x809780c
56 - How to sync remote offices.
57 - Exchange backup:
58   http://www.microsoft.com/technet/itshowcase/content/exchbkup.mspx
59 - David's priorities
60    Copypools
61    Extract capability (#25)
62    Continued enhancement of bweb
63    Threshold triggered migration jobs (not currently in list, but will be
64     needed ASAP)
65    Client triggered backups
66    Complete rework of the scheduling system (not in list)
67    Performance and usage instrumentation (not in list)
68    See email of 21Aug2007 for details.
69 - Implement Diff,Inc Retention Periods
70 - Look at: http://tech.groups.yahoo.com/group/cfg2html
71    and http://www.openeyet.nl/scc/ for managing customer changes
72
73 Priority:
74 - Complete Catalog in Pool
75 - Implement Bacula plugins -- design API
76 - Scripts
77 - Prune by Job
78 - Prune by Job Level
79 - True automatic pruning 
80 - Duplicate Jobs
81   Run, Fail, Skip, Higher, Promote, CancelLowerLevel
82   Proximity
83 - Auto update of slot:
84    rufus-dir: ua_run.c:456-10 JobId=10 NewJobId=10 using pool Full priority=10
85    02-Nov 12:58 rufus-dir JobId 10: Start Backup JobId 10, Job=kernsave.2007-11-02_12.58.03
86    02-Nov 12:58 rufus-dir JobId 10: Using Device "DDS-4"
87    02-Nov 12:58 rufus-sd JobId 10: Invalid slot=0 defined in catalog for Volume "Vol001" on "DDS-4" (/dev/nst0). Manual load my be required.
88    02-Nov 12:58 rufus-sd JobId 10: 3301 Issuing autochanger "loaded? drive 0" command.
89    02-Nov 12:58 rufus-sd JobId 10: 3302 Autochanger "loaded? drive 0", result is Slot 2.
90    02-Nov 12:58 rufus-sd JobId 10: Wrote label to prelabeled Volume "Vol001" on device "DDS-4" (/dev/nst0)
91    02-Nov 12:58 rufus-sd JobId 10: Alert: TapeAlert[7]:   Media Life: The tape has reached the end of its useful life.
92    02-Nov 12:58 rufus-dir JobId 10: Bacula rufus-dir 2.3.6 (26Oct07): 02-Nov-2007 12:58:51
93 - Eliminate:  /var is a different filesystem. Will not descend from / into /var
94 - Separate Files and Directories in catalog
95 - Create FileVersions table
96 - Look at rsysnc for incremental updates and dedupping
97 - Add MD5 or SHA1 check in SD for data validation
98 - modify pruning to keep a fixed number of versions of a file, 
99   if requested.
100 - finish implementation of fdcalled -- see ua_run.c:105
101 - Fix problem in postgresql.c in my_postgresql_query, where the
102   generation of the error message doesn't differentiate result==NULL
103   and a bad status from that result.  Not only that, the result is
104   cleared on a bail_out without having generated the error message.
105 - KIWI
106 - Implement SDErrors (must return from SD)
107 - Implement USB keyboard support in rescue CD.
108 - Implement continue spooling while despooling.
109 - Remove all install temp files in Win32 PLUGINSDIR.
110 - Audit retention periods to make sure everything is 64 bit.
111 - Use E'xxx' to escape PostgreSQL strings.
112 - No where in restore causes kaboom.
113 - Performance: multiple spool files for a single job.
114 - Performance: despool attributes when despooling data (problem
115   multiplexing Dir connection).
116 - Make restore use the in-use volume reservation algorithm.
117 - Look at mincore: http://insights.oetiker.ch/linux/fadvise.html
118 - Unicode input http://en.wikipedia.org/wiki/Byte_Order_Mark
119 - Add TLS to bat (should be done).
120 - When Pool specifies Storage command override does not work.
121 - Implement wait_for_sysop() message display in wait_for_device(), which
122   now prints warnings too often.
123 - Ensure that each device in an Autochanger has a different
124   Device Index.
125 - Add Catalog = to Pool resource so that pools will exist
126   in only one catalog -- currently Pools are "global".
127 - Look at sg_logs -a /dev/sg0 for getting soft errors.
128 - btape "test" command with Offline on Unmount = yes
129
130    This test is essential to Bacula.
131
132    I'm going to write one record  in file 0,
133    two records in file 1,
134    and three records in file 2
135
136    02-Feb 11:00 btape: ABORTING due to ERROR in dev.c:715
137    dev.c:714 Bad call to rewind. Device "LTO" (/dev/nst0) not open
138    02-Feb 11:00 btape: Fatal Error because: Bacula interrupted by signal 11: Segmentation violation
139    Kaboom! btape, btape got signal 11. Attempting traceback.
140
141 - Encryption -- email from Landon
142    > The backup encryption algorithm is currently not configurable, and is  
143    > set to AES_128_CBC in src/filed/backup.c. The encryption code  
144    > supports a number of different ciphers (as well as adding arbitrary  
145    > new ones) -- only a small bit of code would be required to map a  
146    > configuration string value to a CRYPTO_CIPHER_* value, if anyone is  
147    > interested in implementing this functionality.
148
149 - Why doesn't @"xxx abc" work in a conf file?
150 - Figure out some way to "automatically" backup conf changes.
151 - Add the OS version back to the Win32 client info.
152 - Restarted jobs have a NULL in the from field.
153 - Modify SD status command to indicate when the SD is writing
154   to a DVD (the device is not open -- see bug #732).
155 - Look at the possibility of adding "SET NAMES UTF8" for MySQL,
156   and possibly changing the blobs into varchar.
157 - Ensure that the SD re-reads the Media record if the JobFiles
158   does not match -- it may have been updated by another job.
159 - Look at moving the Storage directive from the Job to the
160   Pool in the default conf files.
161 - Doc items
162 - Test Volume compatibility between machine architectures
163 - Encryption documentation
164 - Wrong jobbytes with query 12 (todo)
165 - Bare-metal recovery Windows (todo)
166    
167
168 Projects:
169 - Pool enhancements
170   - Access Mode = Read-Only, Read-Write, Unavailable, Destroyed, Offsite
171   - Pool Type = Copy
172   - Maximum number of scratch volumes
173   - Maximum File size
174   - Next Pool (already have)
175   - Reclamation threshold
176   - Reclamation Pool
177   - Reuse delay (after all files purged from volume before it can be used)
178   - Copy Pool = xx, yyy (or multiple lines).
179   - Catalog = xxx
180   - Allow pool selection during restore.
181
182 - Average tape size from Eric
183     SELECT COALESCE(media_avg_size.volavg,0) * count(Media.MediaId) AS volmax,                                                              GROUP BY Media.MediaType, Media.PoolId, media_avg_size.volavg
184            count(Media.MediaId)  AS volnum,
185            sum(Media.VolBytes)   AS voltotal,
186            Media.PoolId          AS PoolId,
187            Media.MediaType       AS MediaType
188     FROM Media
189     LEFT JOIN (SELECT avg(Media.VolBytes) AS volavg,
190                       Media.MediaType     AS MediaType
191                FROM Media
192               WHERE Media.VolStatus = 'Full'
193               GROUP BY Media.MediaType
194                ) AS media_avg_size ON (Media.MediaType = media_avg_size.MediaType)
195     GROUP BY Media.MediaType, Media.PoolId, media_avg_size.volavg
196 - GUI
197   - Admin
198   - Management reports
199   - Add doc for bweb -- especially Installation
200   - Look at Webmin
201      http://www.orangecrate.com/modules.php?name=News&file=article&sid=501
202 - Performance
203   - Despool attributes in separate thread
204   - Database speedups
205   - Embedded MySQL
206   - Check why restore repeatedly sends Rechdrs between
207     each data chunk -- according to James Harper 9Jan07.
208 - Features
209   - Better scheduling  
210   - Full at least once a month, ...
211   - Cancel Inc if Diff/Full running
212   - More intelligent re-run
213   - New/deleted file backup   
214   - FD plugins
215   - Incremental backup -- rsync, Stow
216
217
218 For next release:
219 - Try to fix bscan not working with multiple DVD volumes bug #912.
220 - Look at mondo/mindi
221 - Don't restore Solaris Door files:
222    #define   S_IFDOOR   in st_mode.
223   see: http://docs.sun.com/app/docs/doc/816-5173/6mbb8ae23?a=view#indexterm-360
224 - Make Bacula by default not backup tmpfs, procfs, sysfs, ...
225 - Fix hardlinked immutable files when linking a second file, the
226   immutable flag must be removed prior to trying to link it.
227 - Implement Python event for backing up/restoring a file.
228 - Change dbcheck to tell users to use native tools for fixing
229   broken databases, and to ensure they have the proper indexes.
230 - add udev rules for Bacula devices.
231 - If a job terminates, the DIR connection can close before the
232   Volume info is updated, leaving the File count wrong.
233 - Look at why SIGPIPE during connection can cause seg fault in
234   writing the daemon message, when Dir dropped to bacula:bacula
235 - Look at zlib 32 => 64 problems.
236 - Possibly turn on St. Bernard code.
237 - Fix bextract to restore ACLs, or better yet, use common routines.
238 - Do we migrate appendable Volumes?
239 - Remove queue.c code.
240 - Print warning message if LANG environment variable does not specify
241   UTF-8.
242 - New dot commands from Arno.
243   .show device=xxx lists information from one storage device, including 
244      devices (I'm not even sure that information exists in the DIR...)
245   .move eject device=xxx mostly the same as 'unmount xxx' but perhaps with 
246      better machine-readable output like "Ok" or "Error busy"
247   .move eject device=xxx toslot=yyy the same as above, but with a new 
248      target slot. The catalog should be updated accordingly.
249   .move transfer device=xxx fromslot=yyy toslot=zzz
250
251 Low priority:
252 - Article: http://www.heise.de/open/news/meldung/83231
253 - Article: http://www.golem.de/0701/49756.html
254 - Article: http://lwn.net/Articles/209809/
255 - Article: http://www.onlamp.com/pub/a/onlamp/2004/01/09/bacula.html
256 - Article: http://www.linuxdevcenter.com/pub/a/linux/2005/04/07/bacula.html
257 - Article: http://www.osreviews.net/reviews/admin/bacula
258 - Article: http://www.debianhelp.co.uk/baculaweb.htm
259 - Article: 
260 - Wikis mentioning Bacula
261   http://wiki.finkproject.org/index.php/Admin:Backups
262   http://wiki.linuxquestions.org/wiki/Bacula
263   http://www.openpkg.org/product/packages/?package=bacula
264   http://www.iterating.com/products/Bacula
265   http://net-snmp.sourceforge.net/wiki/index.php/Net-snmp_extensions
266   http://www.section6.net/wiki/index.php/Using_Bacula_for_Tape_Backups
267   http://bacula.darwinports.com/
268   http://wiki.mandriva.com/en/Releases/Corporate/Server_4/Notes#Bacula
269   http://en.wikipedia.org/wiki/Bacula
270
271 - Bacula Wikis
272   http://www.devco.net/pubwiki/Bacula/
273   http://paramount.ind.wpi.edu/wiki/doku.php
274   http://gentoo-wiki.com/HOWTO_Backup
275   http://www.georglutz.de/wiki/Bacula
276   http://www.clarkconnect.com/wiki/index.php?title=Modules_-_LAN_Backup/Recovery
277   http://linuxwiki.de/Bacula   (in German)
278
279 - Possibly allow SD to spool even if a tape is not mounted.
280 - It appears to me that you have run into some sort of race
281   condition where two threads want to use the same Volume and they
282   were both given access.  Normally that is no problem.  However,
283   one thread wanted the particular Volume in drive 0, but it was
284   loaded into drive 1 so it decided to unload it from drive 1 and
285   then loaded it into drive 0, while the second thread went on
286   thinking that the Volume could be used in drive 1 not realizing
287   that in between time, it was loaded in drive 0.
288   I'll look at the code to see if there is some way we can avoid
289   this kind of problem.  Probably the best solution is to make the
290   first thread simply start using the Volume in drive 1 rather than
291   transferring it to drive 0.
292 - Fix re-read of last block to check if job has actually written
293   a block, and check if block was written by a different job
294   (i.e. multiple simultaneous jobs writing).
295 - Figure out how to configure query.sql.  Suggestion to use m4:
296     == changequote.m4 ===
297     changequote(`[',`]')dnl
298     ==== query.sql.in ===
299     :List next 20 volumes to expire
300     SELECT
301         Pool.Name AS PoolName,
302         Media.VolumeName,
303         Media.VolStatus,
304         Media.MediaType,
305     ifdef([MySQL],
306     [ FROM_UNIXTIME(UNIX_TIMESTAMP(Media.LastWritten) Media.VolRetention) AS Expire, ])dnl
307     ifdef([PostgreSQL],
308     [ media.lastwritten + interval '1 second' * media.volretention as expire, ])dnl
309       Media.LastWritten
310       FROM Pool
311       LEFT JOIN Media
312       ON Media.PoolId=Pool.PoolId
313       WHERE Media.LastWritten>0
314       ORDER BY Expire
315       LIMIT 20;
316     ====
317     Command: m4 -DmySQL changequote.m4 query.sql.in >query.sql
318
319   The problem is that it requires m4, which is not present on all machines
320   at ./configure time.
321 - Given all the problems with FIFOs, I think the solution is to do something a
322   little different, though I will look at the code and see if there is not some
323   simple solution (i.e. some bug that was introduced).  What might be a better
324   solution would be to use a FIFO as a sort of "key" to tell Bacula to read and
325   write data to a program rather than the FIFO.  For example, suppose you
326   create a FIFO named:
327
328      /home/kern/my-fifo
329
330   Then, I could imagine if you backup and restore this file with a direct
331   reference as is currently done for fifos, instead, during backup Bacula will
332   execute:
333
334     /home/kern/my-fifo.backup
335
336   and read the data that my-fifo.backup writes to stdout. For restore, Bacula
337   will execute:
338
339     /home/kern/my-fifo.restore
340
341   and send the data backed up to stdout. These programs can either be an
342   executable or a shell script and they need only read/write to stdin/stdout.
343
344   I think this would give a lot of flexibility to the user without making any
345   significant changes to Bacula.
346
347
348 ==== SQL
349 # get null file
350 select FilenameId from Filename where Name='';
351 # Get list of all directories referenced in a Backup.
352 select Path.Path from Path,File where File.JobId=nnn and
353   File.FilenameId=(FilenameId-from-above) and File.PathId=Path.PathId
354   order by Path.Path ASC;
355
356 - Look into using Dart for testing
357   http://public.kitware.com/Dart/HTML/Index.shtml
358
359 - Look into replacing autotools with cmake
360   http://www.cmake.org/HTML/Index.html
361
362 === Migration from David ===
363 What I'd like to see: 
364
365 Job {
366   Name = "<poolname>-migrate"
367   Type = Migrate
368   Messages = Standard
369   Pool = Default
370   Migration Selection Type = LowestUtil | OldestVol | PoolOccupancy |
371 Client | PoolResidence | Volume | JobName | SQLquery
372   Migration Selection Pattern = "regexp"
373   Next Pool = <override>
374 }
375
376 There should be no need for a Level (migration is always Full, since you
377 don't calculate differential/incremental differences for migration),
378 Storage should be determined by the volume types in the pool, and Client
379 is really a selection issue.  Migration should always occur to the
380 NextPool defined in the pool definition. If no nextpool is defined, the
381 job should end with a reason of "no place to go". If Next Pool statement
382 is present, we override the check in the pool definition and use the
383 pool specified. 
384
385 Here's how I'd define Migration Selection Types: 
386
387 With Regexes:
388 Client  -- Migrate data from selected client only. Migration Selection
389 Pattern regexp provides pattern to select client names, eg ^FS00* makes
390 all client names starting with FS00 eligible for migration. 
391
392 Jobname -- Migration all jobs matching name. Migration Selection Pattern
393 regexp provides pattern to select jobnames existing in pool. 
394
395 Volume -- Migrate all data on specified volumes. Migration Selection
396 Pattern regexp provides selection criteria for volumes to be migrated.
397 Volumes must exist in pool to be eligible for migration. 
398
399
400 With Regex optional:
401 LowestUtil -- Identify the volume in the pool with the least data on it
402 and empty it. No Migration Selection Pattern required. 
403
404 OldestVol -- Identify the LRU volume with data written, and empty it. No
405 Migration Selection Pattern required. 
406
407 PoolOccupancy -- if pool occupancy exceeds <highmig>, migrate volumes
408 (starting with most full volumes) until pool occupancy drops below
409 <lowmig>. Pool highmig and lowmig values are in pool definition, no
410 Migration Selection Pattern required.
411
412
413 No regex:
414 SQLQuery -- Migrate all jobuids returned by the supplied SQL query.
415 Migration Selection Pattern contains SQL query to execute; should return
416 a list of 1 or more jobuids to migrate.
417
418 PoolResidence -- Migrate data sitting in pool for longer than
419 PoolResidence value in pool definition. Migration Selection Pattern
420 optional; if specified, override value in pool definition (value in
421 minutes). 
422
423
424 [ possibly a Python event -- kes ]
425 ===
426 - Mount on an Autochanger with no tape in the drive causes:
427    Automatically selected Storage: LTO-changer
428    Enter autochanger drive[0]: 0
429    3301 Issuing autochanger "loaded drive 0" command.
430    3302 Autochanger "loaded drive 0", result: nothing loaded.
431    3301 Issuing autochanger "loaded drive 0" command.
432    3302 Autochanger "loaded drive 0", result: nothing loaded.
433    3902 Cannot mount Volume on Storage Device "LTO-Drive1" (/dev/nst0) because:
434    Couldn't rewind device "LTO-Drive1" (/dev/nst0): ERR=dev.c:678 Rewind error on "LTO-Drive1" (/dev/nst0). ERR=No medium found.
435    3905 Device "LTO-Drive1" (/dev/nst0) open but no Bacula volume is mounted.
436    If this is not a blank tape, try unmounting and remounting the Volume.
437 - If Drive 0 is blocked, and drive 1 is set "Autoselect=no", drive 1 will
438   be used.
439 - Autochanger did not change volumes.  
440    select * from Storage;
441    +-----------+-------------+-------------+
442    | StorageId | Name        | AutoChanger |
443    +-----------+-------------+-------------+
444    |         1 | LTO-changer |           0 |
445    +-----------+-------------+-------------+
446    05-May 03:50 roxie-sd: 3302 Autochanger "loaded drive 0", result is Slot 11.
447    05-May 03:50 roxie-sd: Tibs.2006-05-05_03.05.02 Warning: Director wanted Volume "LT
448     Current Volume "LT0-002" not acceptable because:
449     1997 Volume "LT0-002" not in catalog.
450    05-May 03:50 roxie-sd: Tibs.2006-05-05_03.05.02 Error: Autochanger Volume "LT0-002"
451     Setting InChanger to zero in catalog.
452    05-May 03:50 roxie-dir: Tibs.2006-05-05_03.05.02 Error: Unable to get Media record
453
454    05-May 03:50 roxie-sd: Tibs.2006-05-05_03.05.02 Fatal error: Error getting Volume i
455    05-May 03:50 roxie-sd: Tibs.2006-05-05_03.05.02 Fatal error: Job 530 canceled.
456    05-May 03:50 roxie-sd: Tibs.2006-05-05_03.05.02 Fatal error: spool.c:249 Fatal appe
457    05-May 03:49 Tibs: Tibs.2006-05-05_03.05.02 Fatal error: c:\cygwin\home\kern\bacula
458    , got
459      (missing)
460     llist volume=LTO-002
461               MediaId: 6
462            VolumeName: LTO-002
463                  Slot: 0
464                PoolId: 1
465             MediaType: LTO-2
466          FirstWritten: 2006-05-05 03:11:54
467           LastWritten: 2006-05-05 03:50:23
468             LabelDate: 2005-12-26 16:52:40
469               VolJobs: 1
470              VolFiles: 0
471             VolBlocks: 1
472             VolMounts: 0
473              VolBytes: 206
474             VolErrors: 0
475             VolWrites: 0
476      VolCapacityBytes: 0
477             VolStatus: 
478               Recycle: 1
479          VolRetention: 31,536,000
480        VolUseDuration: 0
481            MaxVolJobs: 0
482           MaxVolFiles: 0
483           MaxVolBytes: 0
484             InChanger: 0
485               EndFile: 0
486              EndBlock: 0
487              VolParts: 0
488             LabelType: 0
489             StorageId: 1
490
491    Note VolStatus is blank!!!!!
492    llist volume=LTO-003
493              MediaId: 7
494           VolumeName: LTO-003
495                 Slot: 12
496               PoolId: 1
497            MediaType: LTO-2
498         FirstWritten: 0000-00-00 00:00:00
499          LastWritten: 0000-00-00 00:00:00
500            LabelDate: 2005-12-26 16:52:40
501              VolJobs: 0
502             VolFiles: 0
503            VolBlocks: 0
504            VolMounts: 0
505             VolBytes: 1
506            VolErrors: 0
507            VolWrites: 0
508     VolCapacityBytes: 0
509            VolStatus: Append
510              Recycle: 1
511         VolRetention: 31,536,000
512       VolUseDuration: 0
513           MaxVolJobs: 0
514          MaxVolFiles: 0
515          MaxVolBytes: 0
516            InChanger: 0
517              EndFile: 0
518             EndBlock: 0
519             VolParts: 0
520            LabelType: 0
521            StorageId: 1
522 ===
523    mount
524    Automatically selected Storage: LTO-changer
525    Enter autochanger drive[0]: 0
526    3301 Issuing autochanger "loaded drive 0" command.
527    3302 Autochanger "loaded drive 0", result: nothing loaded.
528    3301 Issuing autochanger "loaded drive 0" command.
529    3302 Autochanger "loaded drive 0", result: nothing loaded.
530    3902 Cannot mount Volume on Storage Device "LTO-Drive1" (/dev/nst0) because:
531    Couldn't rewind device "LTO-Drive1" (/dev/nst0): ERR=dev.c:678 Rewind error on "LTO-Drive1" (/dev/nst0). ERR=No medium found.
532
533    3905 Device "LTO-Drive1" (/dev/nst0) open but no Bacula volume is mounted.
534    If this is not a blank tape, try unmounting and remounting the Volume.
535
536 - http://www.dwheeler.com/essays/commercial-floss.html
537 - Add VolumeLock to prevent all but lock holder (SD) from updating
538   the Volume data (with the exception of VolumeState).
539 - The btape fill command does not seem to use the Autochanger
540 - Make Windows installer default to system disk drive.
541 - Look at using ioctl(FIOBMAP, ...) on Linux, and 
542   DeviceIoControl(...,  FSCTL_QUERY_ALLOCATED_RANGES, ...) on
543   Win32 for sparse files.
544   http://www.flexhex.com/docs/articles/sparse-files.phtml
545   http://www.informatik.uni-frankfurt.de/~loizides/reiserfs/fibmap.html
546 - Directive: at <event> "command"
547 - Command: pycmd "command" generates "command" event.  How to
548   attach to a specific job?
549 - Integrate Christopher's St. Bernard code.
550 - run_cmd() returns int should return JobId_t
551 - get_next_jobid_from_list() returns int should return JobId_t
552 - Document export LDFLAGS=-L/usr/lib64
553 - Don't attempt to restore from "Disabled" Volumes.
554 - Network error on Win32 should set Win32 error code.
555 - What happens when you rename a Disk Volume?
556 - Job retention period in a Pool (and hence Volume).  The job would
557   then be migrated.
558 - Look at -D_FORTIFY_SOURCE=2
559 - Add Win32 FileSet definition somewhere
560 - Look at fixing restore status stats in SD.
561 - Look at using ioctl(FIMAP) and FIGETBSZ for sparse files.
562   http://www.informatik.uni-frankfurt.de/~loizides/reiserfs/fibmap.html
563 - Implement a mode that says when a hard read error is
564   encountered, read many times (as it currently does), and if the
565   block cannot be read, skip to the next block, and try again.  If
566   that fails, skip to the next file and try again, ...
567 - Add level table:
568   create table LevelType (LevelType binary(1), LevelTypeLong tinyblob);
569   insert into LevelType (LevelType,LevelTypeLong) values
570   ("F","Full"),
571   ("D","Diff"),
572   ("I","Inc");
573 - Show files/second in client status output.
574 - Add a recursive mark command (rmark) to restore.
575 - "Minimum Job Interval = nnn" sets minimum interval between Jobs
576   of the same level and does not permit multiple simultaneous
577   running of that Job (i.e. lets any previous invocation finish
578   before doing Interval testing).
579 - Look at simplifying File exclusions.
580 - New directive "Delete purged Volumes"
581 - new pool XXX with ScratchPoolId = MyScratchPool's PoolId and
582   let it fill itself, and RecyclePoolId = XXX's PoolId so I can
583   see if it become stable and I just have to supervise
584   MyScratchPool
585 - If I want to remove this pool, I set RecyclePoolId = MyScratchPool's
586   PoolId, and when it is empty remove it.
587 - Figure out how to recycle Scratch volumes back to the Scratch Pool.
588 - Add Volume=SCRTCH
589 - Allow Check Labels to be used with Bacula labels.
590 - "Resuming" a failed backup (lost line for example) by using the
591   failed backup as a sort of "base" job.
592 - Look at NDMP
593 - Email to the user when the tape is about to need changing x
594   days before it needs changing.
595 - Command to show next tape that will be used for a job even
596   if the job is not scheduled.
597 - From: Arunav Mandal <amandal@trolltech.com>
598   1. When jobs are running and bacula for some reason crashes or if I do a 
599   restart it remembers and jobs it was running before it crashed or restarted 
600   as of now I loose all jobs if I restart it.
601
602   2. When spooling and in the midway if client is disconnected for instance a 
603   laptop bacula completely discard the spool. It will be nice if it can write 
604   that spool to tape so there will be some backups for that client if not all.
605
606   3. We have around 150 clients machines it will be nice to have a option to 
607   upgrade all the client machines bacula version automatically.
608
609   4. Atleast one connection should be reserved for the bconsole so at heavy load 
610   I should connect to the director via bconsole which at sometimes I can't
611
612   5. Another most important feature that is missing, say at 10am I manually 
613   started  backup of client abc and it was a full backup since client abc has 
614   no backup history and at 10.30am bacula again automatically started backup of 
615   client abc as that was in the schedule. So now we have 2 multiple Full 
616   backups of the same client and if we again try to start a full backup of 
617   client backup abc bacula won't complain. That should be fixed.
618
619 - Fix bpipe.c so that it does not modify results pointer.
620   ***FIXME*** calling sequence should be changed.
621 - For Windows disaster recovery see http://unattended.sf.net/
622 - regardless of the retention period, Bacula will not prune the
623   last Full, Diff, or Inc File data until a month after the
624   retention period for the last Full backup that was done.
625 - update volume=xxx --- add status=Full
626 - Remove old spool files on startup.
627 - Exclude SD spool/working directory.
628 - Refuse to prune last valid Full backup. Same goes for Catalog.
629 - Python:
630   - Make a callback when Rerun failed levels is called.
631   - Give Python program access to Scheduled jobs.
632   - Add setting Volume State via Python.
633   - Python script to save with Python, not save, save with Bacula.
634   - Python script to do backup.
635   - What events?
636   - Change the Priority, Client, Storage, JobStatus (error) 
637     at the start of a job.
638 - Why is SpoolDirectory = /home/bacula/spool;  not reported
639   as an error when writing a DVD?
640 - Make bootstrap file handle multiple MediaTypes (SD)
641 - Remove all old Device resource code in Dir and code to pass it
642   back in SD -- better, rework it to pass back device statistics.
643 - Check locking of resources -- be sure to lock devices where previously
644   resources were locked. 
645 - The last part is left in the spool dir.
646
647
648 - In restore don't compare byte count on a raw device -- directory
649   entry does not contain bytes.
650 === rate design
651   jcr->last_rate
652   jcr->last_runtime
653   MA = (last_MA * 3 + rate) / 4
654   rate = (bytes - last_bytes) / (runtime - last_runtime)
655 - Max Vols limit in Pool off by one?
656 - Implement Files/Bytes,... stats for restore job.
657 - Implement Total Bytes Written, ... for restore job.
658 - Despool attributes simultaneously with data in a separate
659   thread, rejoined at end of data spooling.
660 - 7. Implement new Console commands to allow offlining/reserving drives,
661      and possibly manipulating the autochanger (much asked for).
662 - Add start/end date editing in messages (%t %T, %e?) ...
663 - Add ClientDefs similar to JobDefs.
664 - Print more info when bextract -p accepts a bad block.
665 - Fix FD JobType to be set before RunBeforeJob in FD.
666 - Look at adding full Volume and Pool information to a Volume 
667   label so that bscan can get *all* the info. 
668 - If the user puts "Purge Oldest Volume = yes" or "Recycle Oldest Volume = yes"
669   and there is only one volume in the pool, refuse to do it -- otherwise
670   he fills the Volume, then immediately starts reusing it.
671 - Implement copies and stripes.
672 - Add history file to console.
673 - Each file on tape creates a JobMedia record. Peter has 4 million
674   files spread over 10000 tape files and four tapes. A restore takes
675   16 hours to build the restore list.
676 - Add and option to check if the file size changed during backup.
677 - Make sure SD deletes spool files on error exit.
678 - Delete old spool files when SD starts.
679 - When labeling tapes, if you enter 000026, Bacula uses
680   the tape index rather than the Volume name 000026.
681 - Add offline tape command to Bacula console.
682 - Bug: 
683   Enter MediaId or Volume name: 32
684   Enter new Volume name: DLT-20Dec04
685   Automatically selected Pool: Default
686   Connecting to Storage daemon DLTDrive at 192.168.68.104:9103 ...
687   Sending relabel command from "DLT-28Jun03" to "DLT-20Dec04" ...
688   block.c:552 Write error at 0:0 on device /dev/nst0. ERR=Bad file descriptor.
689   Error writing final EOF to tape. This tape may not be readable.
690   dev.c:1207 ioctl MTWEOF error on /dev/nst0. ERR=Permission denied.
691   askdir.c:219 NULL Volume name. This shouldn't happen!!!
692   3912 Failed to label Volume: ERR=dev.c:1207 ioctl MTWEOF error on /dev/nst0. ERR=Permission denied.
693   Label command failed for Volume DLT-20Dec04.
694   Do not forget to mount the drive!!!
695 - Bug: if a job is manually scheduled to run later, it does not appear
696   in any status report and cannot be cancelled.
697
698 ==== Keeping track of deleted/new files ====
699 - To mark files as deleted, run essentially a Verify to disk, and
700   when a file is found missing (MarkId != JobId), then create
701   a new File record with FileIndex == -1. This could be done
702   by the FD at the same time as the backup.
703
704      My "trick" for keeping track of deletions is the following.
705      Assuming the user turns on this option, after all the files
706      have been backed up, but before the job has terminated, the
707      FD will make a pass through all the files and send their
708      names to the DIR (*exactly* the same as what a Verify job
709      currently does).  This will probably be done at the same
710      time the files are being sent to the SD avoiding a second
711      pass.  The DIR will then compare that to what is stored in
712      the catalog.  Any files in the catalog but not in what the
713      FD sent will receive a catalog File entry that indicates
714      that at that point in time the file was deleted. This
715      either transmitted to the FD or simultaneously computed in
716      the FD, so that the FD can put a record on the tape that
717      indicates that the file has been deleted at this point.
718      A delete file entry could potentially be one with a FileIndex
719      of 0 or perhaps -1 (need to check if FileIndex is used for
720      some other thing as many of the Bacula fields are "overloaded"
721      in the SD).
722
723      During a restore, any file initially picked up by some
724      backup (Full, ...) then subsequently having a File entry
725      marked "delete" will be removed from the tree, so will not
726      be restored.  If a file with the same name is later OK it
727      will be inserted in the tree -- this already happens.  All
728      will be consistent except for possible changes during the
729      running of the FD.
730
731      Since I'm on the subject, some of you may be wondering what
732      the utility of the in memory tree is if you are going to
733      restore everything (at least it comes up from time to time
734      on the list).  Well, it is still *very* useful because it
735      allows only the last item found for a particular filename
736      (full path) to be entered into the tree, and thus if a file
737      is backed up 10 times, only the last copy will be restored.
738      I recently (last Friday) restored a complete directory, and
739      the Full and all the Differential and Incremental backups
740      spanned 3 Volumes.  The first Volume was not even mounted
741      because all the files had been updated and hence backed up
742      since the Full backup was made.  In this case, the tree
743      saved me a *lot* of time.
744
745      Make sure this information is stored on the tape too so
746      that it can be restored directly from the tape.
747
748      All the code (with the exception of formally generating and
749      saving the delete file entries) already exists in the Verify
750      Catalog command.  It explicitly recognizes added/deleted files since
751      the last InitCatalog.  It is more or less a "simple" matter of
752      taking that code and adapting it slightly to work for backups.
753
754   Comments from Martin Simmons (I think they are all covered):
755   Ok, that should cover the basics.  There are few issues though:
756
757   - Restore will depend on the catalog.  I think it is better to include the
758   extra data in the backup as well, so it can be seen by bscan and bextract.
759
760   - I'm not sure if it will preserve multiple hard links to the same inode.  Or
761   maybe adding or removing links will cause the data to be dumped again?
762
763   - I'm not sure if it will handle renamed directories.  Possibly it will work
764   by dumping the whole tree under a renamed directory?
765
766   - It remains to be seen how the backup performance of the DIR's will be
767   affected when comparing the catalog for a large filesystem.
768
769 ==== 
770 From David:
771 How about introducing a Type = MgmtPolicy job type? That job type would
772 be responsible for scanning the Bacula environment looking for specific
773 conditions, and submitting the appropriate jobs for implementing said
774 policy, eg: 
775
776 Job {
777    Name = "Migration-Policy"
778    Type = MgmtPolicy
779    Policy Selection Job Type = Migrate
780    Scope = "<keyword> <operator> <regexp>"
781    Threshold = "<keyword> <operator> <regexp>"
782    Job Template = <template-name>
783 }
784
785 Where <keyword> is any legal job keyword, <operator> is a comparison
786 operator (=,<,>,!=, logical operators AND/OR/NOT) and <regexp> is a
787 appropriate regexp. I could see an argument for Scope and Threshold
788 being SQL queries if we want to support full flexibility. The
789 Migration-Policy job would then get scheduled as frequently as a site
790 felt necessary (suggested default: every 15 minutes). 
791
792 Example: 
793
794 Job {
795    Name = "Migration-Policy"
796    Type = MgmtPolicy
797    Policy Selection Job Type = Migration
798    Scope = "Pool=*"
799    Threshold = "Migration Selection Type = LowestUtil"
800    Job Template = "MigrationTemplate"
801 }
802
803 would select all pools for examination and generate a job based on
804 MigrationTemplate to automatically select the volume with the lowest
805 usage and migrate it's contents to the nextpool defined for that pool. 
806
807 This policy abstraction would be really handy for adjusting the behavior
808 of Bacula according to site-selectable criteria (one thing that pops
809 into mind is Amanda's ability to automatically adjust backup levels
810 depending on various criteria).
811
812
813 =====
814
815 Regression tests:
816 - Add Pool/Storage override regression test.
817 - Add delete JobId to regression.
818 - Add a regression test for dbcheck.  
819 - New test to add bscan to four-concurrent-jobs regression,
820   i.e. after the four-concurrent jobs zap the
821   database as is done in the bscan-test, then use bscan to
822   restore the database, do a restore and compare with the
823   original.
824 - Add restore of specific JobId to regression (item 3
825   on the restore prompt)
826 - Add IPv6 to regression
827 - Add database test to regression. Test each function like delete,
828   purge, ...
829
830 - AntiVir can slow down backups on Win32 systems. 
831 - Win32 systems with FAT32 can be much slower than NTFS for
832   more than 1000 files per directory.
833
834
835 1.37 Possibilities:
836 - A HOLD command to stop all jobs from starting.
837 - A PAUSE command to pause all running jobs ==> release the
838   drive.
839 - Media Type = LTO,LTO-2,LTO-3
840   Media Type Read = LTO,LTO2,LTO3
841   Media Type Write = LTO2, LTO3
842
843 === From Carsten Menke <bootsy52@gmx.net>
844
845 Following is a list of what I think in the situations where I'm faced with, 
846 could be a usefull enhancement to bacula, which I'm certain other users will 
847 benefit from as well.
848
849 1. NextJob/NextJobs Directive within a Job Resource in the form of
850     NextJobs = job1,job2.
851
852     Why:
853     I currently solved the problem with running multiple jobs each after each
854     by setting the Max Wait Time for a job to 8 hours, and give
855     the jobs different Priorities. However, there scenarios where
856     1 Job is directly depending on another job, so if the former job fails,
857     the job after it needn't to be run
858     while maybe other jobs should run despite of that
859
860 Example:
861   A Backup Job and a Verify job, if the backup job fails there is no need to run
862   the verify job, as the backup job already failed. However, one may like
863   to backup the Catalog to disk despite of that the main backup job failed.
864
865 Notes:
866   I see that this is related to the Event Handlers which are on the ToDo
867   list, also it is maybe a good idea to check for the return value and
868   execute different actions based on the return value
869
870
871 3. offline capability to bconsole
872
873     Why:
874     Currently I use a script which I execute within the last Job via the
875     RunAfterJob Directive, to release and eject the tape.
876     So I have to call bconsole "release=Storage-Name" and afterwards
877     mt -f /dev/nst0 eject to get the tape out.
878
879     If I have multiple Storage Devices, than these may not be /dev/nst0 and
880     I have to modify the script or call it with parameters etc.
881     This would actually not be needed, as everything is already defined
882     in bacula-sd.conf and if   I can invoke bconsole with the
883     storage name via $1 in the script than I'm done and information is
884     not duplicated.
885
886 4. %s for Storage Name added to the chars being substituted in "RunAfterJob"
887
888     Why:
889
890     For the reason mentioned in 3. to have the ability to call a
891     script with /scripts/foobar %s and in the script use $1
892     to pass the Storage Name to bconsole
893
894 5. Setting Volume State within a Job Resource
895
896     Why:
897     Instead of using "Maximum Volume Jobs" in the Pool Resource,
898     I would have the possibilty to define
899     in a Job Resource that after this certain job is run, the Volume State
900     should be set to "Volume State = Used", this give more flexibility (IMHO).
901
902 6. Localization of Bacula Messages
903
904     Why:
905     Unfortunatley many,many people I work with don't speak english very well.
906     So if at least the Reporting messages would be localized then they
907     would  understand that they have to change the tape,etc. etc.
908
909     I volunteer to do the german translations, and if I can convince my wife also
910     french and Morre (western african language).
911
912 7. OK, this is evil, probably bound to security risks and maybe not possible
913     due to the design of bacula.
914
915     Implementation of Backtics ( `command` ) for shell comand execution to
916     the "Label Format" Directive.
917
918 Why:
919
920     Currently I have defined BACULA_DAY_OF_WEEK="day1|day2..." resulting in
921     Label Format = "HolyBackup-${BACULA_DAY_OF_WEEK[${WeekDay}]}". If I could
922     use backticks than I could use "Label Format = HolyBackup-`date +%A` to have
923     the localized name for the day of the week appended to the
924     format string. Then I have the tape labeled automatically with weekday
925     name in the correct language.
926 ==========
927 -  Yes, that is surely the case. I probably should turn those into Warning
928    errors. In addition, you just made me think that it might not be bad to
929    add an option to check the file size after backing up the file and
930    report if it changes. This would be done as an option because it would
931    add extra overhead.
932  
933    Kern, good idea.  If you do do that, mention in the output: file 
934    shrunk, or file expanded, just to make it obvious to the user 
935    (without having to the refer to file size), just how the file size 
936    changed.
937  
938    Would this option be for all file, or just one file?  Or a fileset?
939 - Make output from status use html table tags for nicely 
940   presenting in a browser.
941 - Can one write tapes faster with 8192 byte block sizes?
942 - Document security problems with the same password for everyone in
943   rpm and Win32 releases.
944 - Browse generations of files.
945 - I've seen an error when my catalog's File table fills up.  I
946    then have to recreate the File table with a larger maximum row
947    size.  Relevant information is at
948    http://dev.mysql.com/doc/mysql/en/Full_table.html ; I think the
949    "Installing and Configuring MySQL" chapter should talk a bit
950    about this potential problem, and recommend a solution.
951 - For Solaris must use POSIX awk.
952 - Want speed of writing to tape while despooling.
953 - Supported autochanger:
954 OS: Linux
955 Man.: HP
956 Media: LTO-2
957 Model: SSL1016
958 Slots: 16
959 Cap: 200GB
960 - Supported drive:
961   Wangtek 6525ES (SCSI-1 QIC drive, 525MB), under Linux 2.4.something, 
962   bacula 1.36.0/1 works with blocksize 16k INSIDE bacula-sd.conf.
963 - Add regex from http://www.pcre.org to Bacula for Win32.
964 - Use only shell tools no make in CDROM package.
965 - Include within include does it work?
966 - Implement a Pool of type Cleaning?
967 - Implement VolReadTime and VolWriteTime in SD
968 - Modify Backing up Your Database to include a bootstrap file.
969 - Think about making certain database errors fatal.
970 - Look at correcting the time jump in the scheduler for daylight
971   savings time changes.
972 - Add a "real" timer to network connections.
973 - Promote to Full = Time period 
974 - Check dates entered by user for correctness (month/day/... ranges)
975 - Compress restore Volume listing by date and first file.
976 - Look at patches/bacula_db.b2z postgresql that loops during restore.
977   See Gregory Wright.
978 - Perhaps add read/write programs and/or plugins to FileSets.
979 - How to handle backing up portables ...
980 - Add some sort of guaranteed Interval for upgrading jobs.
981 - Can we write the state file after every job terminates? On Win32
982   the system crashes and the state file is not updated.
983 - Limit bandwidth
984
985 Documentation to do: (any release a little bit at a time)
986 - Doc to do unmount before removing magazine.
987 - Alternative to static linking "ldd prog" save all binaries listed,
988   restore them and point LD_LIBRARY_PATH to them.
989 - Document add "</dev/null >/dev/null 2>&1" to the bacula-fd command line
990 - Document query file format.
991 - Add more documentation for bsr files.
992 - Document problems with Verify and pruning.
993 - Document how to use multiple databases.
994 - VXA drives have a "cleaning required"
995   indicator, but Exabyte recommends preventive cleaning after every 75
996   hours of operation.
997   From Phil:
998     In this context, it should be noted that Exabyte has a command-line
999     vxatool utility available for free download. (The current version is
1000     vxatool-3.72.) It can get diagnostic info, read, write and erase tapes,
1001     test the drive, unload tapes, change drive settings, flash new firmware,
1002     etc.
1003     Of particular interest in this context is that vxatool <device> -i will
1004     report, among other details, the time since last cleaning in tape motion
1005     minutes. This information can be retrieved (and settings changed, for
1006     that matter) through the generic-SCSI device even when Bacula has the
1007     regular tape device locked. (Needless to say, I don't recommend
1008     changing tape settings while a job is running.)
1009 - Lookup HP cleaning recommendations.
1010 - Lookup HP tape replacement recommendations (see trouble shooting autochanger)
1011 - Document doing table repair
1012
1013
1014 ===================================
1015 - Add macro expansions in JobDefs.
1016   Run Before Job = "SomeFile %{Level} %{Client}"
1017   Write Bootstrap="/some/dir/%{JobName}_%{Client}.bsr"
1018 - Use non-blocking network I/O but if no data is available, use
1019   select().
1020 - Use gather write() for network I/O.
1021 - Autorestart on crash.
1022 - Add bandwidth limiting.
1023 - Add acks every once and a while from the SD to keep
1024   the line from timing out.
1025 - When an error in input occurs and conio beeps, you can back
1026   up through the prompt.
1027 - Detect fixed tape block mode during positioning by looking at
1028   block numbers in btape "test".  Possibly adjust in Bacula.
1029 - Fix list volumes to output volume retention in some other
1030   units, perhaps via a directive.
1031 - Allow Simultaneous Priorities = yes  => run up to Max concurrent jobs even
1032   with multiple priorities.
1033 - If you use restore replace=never, the directory attributes for
1034   non-existent directories will not be restored properly.
1035
1036 - see lzma401.zip in others directory for new compression
1037   algorithm/library.
1038 - Allow the user to select JobType for manual pruning/purging.
1039 - bscan does not put first of two volumes back with all info in
1040   bscan-test.
1041 - Implement the FreeBSD nodump flag in chflags.
1042 - Figure out how to make named console messages go only to that
1043   console and to the non-restricted console (new console class?).
1044 - Make restricted console prompt for password if *ask* is set or
1045   perhaps if password is undefined.
1046 - Implement "from ISO-date/time every x hours/days/weeks/months" in
1047   schedules.
1048
1049 ==== from Marc Schoechlin
1050 - the help-command should be more verbose
1051   (it should explain the paramters of the different 
1052   commands in detail)
1053   -> its time-comsuming to consult the manual anytime
1054      you need a special parameter
1055   -> maybe its more easy to maintain this, if the
1056      descriptions of that commands are outsourced to
1057      a ceratin-file
1058 - the cd-command should allow complete paths
1059   i.e. cd /foo/bar/foo/bar
1060   -> if a customer mails me the path to a certain file,
1061      its faster to enter the specified directory
1062 - if the password is not configured in bconsole.conf
1063   you should be asked for it.
1064   -> sometimes you like to do restore on a customer-machine
1065      which shouldnt know the password for bacula.
1066   -> adding the password to the file favours admins
1067      to forget to remove the password after usage
1068   -> security-aspects
1069      the protection of that file is less important
1070 - long-listed-output of commands should be scrollable
1071   like the unix more/less-command does
1072   -> if someone runs 200 and more machines, the lists could
1073      be a little long and complex
1074 - command-output should be shown column by column
1075   to reduce scrolling and to increase clarity
1076   -> see last item
1077 - lsmark should list the selected files with full
1078   paths
1079 - wildcards for selecting and file and directories would be nice
1080 - any actions should be interuptable with STRG+C
1081 - command-expansion would be pretty cool
1082 ====
1083 - When the replace Never option is set, new directory permissions
1084   are not restored. See bug 213. To fix this requires creating a
1085   list of newly restored directories so that those directory 
1086   permissions *can* be restored.
1087 - Add prune all command
1088 - Document fact that purge can destroy a part of a restore by purging
1089   one volume while others remain valid -- perhaps mark Jobs.
1090 - Add multiple-media-types.txt
1091 - look at mxt-changer.html
1092 - Make ? do a help command (no return needed).
1093 - Implement restore directory.
1094 - Document streams and how to implement them.
1095 - Try not to re-backup a file if a new hard link is added.
1096 - Add feature to backup hard links only, but not the data.
1097 - Fix stream handling to be simpler.
1098 - Add Priority and Bootstrap to Run a Job.
1099 - Eliminate Restore "Run Restore Job" prompt by allowing new "run command
1100   to be issued"
1101 - Remove View FileSet button from Run a Job dialog.
1102 - Handle prompt for restore job at end of Restore command.
1103 - Add display of total selected files to Restore window.
1104 - Add tree pane to left of window.
1105 - Add progress meter.
1106 - Max wait time or max run time causes seg fault -- see runtime-bug.txt
1107 - Add message to user to check for fixed block size when the forward
1108   space test fails in btape.
1109 - When unmarking a directory check if all files below are unmarked and
1110   then remove the + flag -- in the restore tree.
1111 - Possibly implement: Action = Unmount Device="TapeDrive1" in Admin jobs.
1112 - Setup lrrd graphs: (http://www.linpro.no/projects/lrrd/) Mike Acar.
1113 - Revisit the question of multiple Volumes (disk) on a single device.
1114 - Add a block copy option to bcopy.
1115 - Finish work on Gnome restore GUI.
1116 - Fix "llist jobid=xx" where no fileset or client exists.
1117 - For each job type (Admin, Restore, ...) require only the really necessary
1118   fields.- Pass Director resource name as an option to the Console.
1119 - Add a "batch" mode to the Console (no unsolicited queries, ...).
1120 - Add a .list all files in the restore tree (probably also a list all files)
1121   Do both a long and short form.
1122 - Allow browsing the catalog to see all versions of a file (with 
1123   stat data on each file).
1124 - Restore attributes of directory if replace=never set but directory
1125   did not exist.
1126 - Use SHA1 on authentication if possible.
1127 - See comtest-xxx.zip for Windows code to talk to USB.
1128 - Add John's appended files:
1129    Appended = {     /files/server/logs/http/*log   }
1130    and such files would be treated as follows.On a FULL backup, they would
1131    be backed up like any other file.On an INCREMENTAL backup, where a
1132    previous INCREMENTAL or FULL was already in thecatalogue and the length
1133    of the file wasgreater than the length of the last backup, only thedata
1134    added since the last backup will be dumped.On an INCREMENTAL backup, if
1135    the length of the file is less than thelength of the file with the same
1136    name last backed up, the completefile is dumped.On Windows systems, with
1137    creation date of files, we can be evensmarter about this and not count
1138    entirely upon the length.On a restore, the full and all incrementals
1139    since it will beapplied in sequence to restore the file.  
1140 - Check new HAVE_WIN32 open bits.    
1141 - Check if the tape has moved before writing.  
1142 - Handling removable disks -- see below:
1143 - Keep track of tape use time, and report when cleaning is necessary.
1144 - Add FromClient and ToClient keywords on restore command (or
1145   BackupClient RestoreClient).
1146 - Implement a JobSet, which groups any number of jobs. If the
1147   JobSet is started, all the jobs are started together.
1148   Allow Pool, Level, and Schedule overrides.
1149 - Enhance cancel to timeout BSOCK packets after a specific delay.
1150 - Do scheduling by UTC using gmtime_r() in run_conf, scheduler, and   
1151   ua_status.!!! Thanks to Alan Brown for this tip.
1152 - Look at updating Volume Jobs so that Max Volume Jobs = 1 will work
1153   correctly for multiple simultaneous jobs.
1154 - Correct code so that FileSet MD5 is calculated for < and | filename   
1155   generation.
1156 - Implement the Media record flag that indicates that the Volume does disk 
1157   addressing.
1158 - Implement VolAddr, which is used when Volume is addressed like a disk,
1159   and form it from VolFile and VolBlock.
1160 - Make multiple restore jobs for multiple media types specifying 
1161   the proper storage type.
1162 - Fix fast block rejection (stored/read_record.c:118). It passes a null
1163   pointer (rec) to try_repositioning().
1164 - Look at extracting Win data from BackupRead.
1165 - Implement RestoreJobRetention? Maybe better "JobRetention" in a Job,
1166   which would take precidence over the Catalog "JobRetention".
1167 - Implement Label Format in Add and Label console commands.
1168 - Possibly up network buffers to 65K. Put on variable.
1169 - Put email tape request delays on one or more variables. User wants
1170   to cancel the job after a certain time interval.  Maximum Mount Wait?
1171 - Job, Client, Device, Pool, or Volume?
1172   Is it possible to make this a directive which is *optional* in multiple
1173   resources, like Level? If so, I think I'd make it an optional directive
1174   in Job, Client, and Pool, with precedence such that Job overrides Client
1175   which in turn overrides Pool.
1176
1177 - New Storage specifications:
1178   - Want to write to multiple storage devices simultaneously
1179   - Want to write to multiple storage devices sequentially (in one job)
1180   - Want to read/write simultaneously
1181   - Key is MediaType -- it must match
1182
1183   Passed to SD as a sort of BSR record called Storage Specification
1184     Record or SSR.
1185     SSR                    
1186       Next -> Next SSR
1187       MediaType -> Next MediaType
1188       Pool -> Next Pool
1189       Device -> Next Device
1190   Job Resource
1191      Allow multiple Storage specifications
1192      New flags
1193         One Archive = yes
1194         One Device = yes
1195         One Storage = yes
1196         One MediaType = yes
1197         One Pool = yes
1198   Storage
1199      Allow Multiple Pool specifications (note, Pool currently
1200        in Job resource).
1201      Allow Multiple MediaType specifications in Dir conf
1202      Allow Multiple Device specifications in Dir conf
1203      Perhaps keep this in a single SSR
1204   Tie a Volume to a specific device by using a MediaType that 
1205     is contained in only one device.
1206   In SD allow Device to have Multiple MediaTypes
1207
1208 - Ideas from Jerry Scharf:
1209   First let's point out some big pluses that bacula has for this
1210         it's open source
1211         more importantly it's active. Thank you so much for that
1212         even more important, it's not flaky
1213         it has an open access catalog, opening many possibilities
1214         it's pushing toward heterogeneous systems capability
1215   big things:
1216    Macintosh file client
1217         macs are an interesting niche, but I fear a server is a rathole
1218    working bare iron recovery for windows
1219    the option for  inc/diff backups not reset on fileset revision
1220         a) use both change and inode update time against base time
1221         b) do the full catalog check (expensive but accurate)
1222    sizing guide (how much system is needed to back up N systems/files)
1223    consultants on using bacula in building a disaster recovery system
1224    an integration guide
1225         or how to get at fancy things that one could do with bacula
1226    logwatch code for bacula logs (or similar)
1227    linux distro inclusion of bacula (brings good and bad, but necessary)
1228    win2k/XP server capability (icky but you asked)
1229    support for Oracle database ??
1230 ===
1231 - Look at adding SQL server and Exchange support for Windows. 
1232 - Make dev->file and dev->block_num signed integers so that -1 can
1233   be an invalid value which happens with BSR.
1234 - Create VolAddr for disk files in place of VolFile and VolBlock. This
1235   is needed to properly specify ranges.
1236 - Add progress of files/bytes to SD and FD.
1237 - Print warning message if FileId > 4 billion
1238 - do a "messages" before the first prompt in Console
1239 - Client does not show busy during Estimate command.
1240 - Implement Console mtx commands.
1241 - Implement a Mount Command and an Unmount Command where
1242   the users could specify a system command to be performed
1243   to do the mount, after which Bacula could attempt to
1244   read the device. This is for Removeable media such as a CDROM.
1245   - Most likely, this mount command would be invoked explicitly
1246   by the user using the current Console "mount" and "unmount" 
1247   commands -- the Storage Daemon would do the right thing 
1248   depending on the exact nature of the device.
1249   - As with tape drives, when Bacula wanted a new removable
1250   disk mounted, it would unmount the old one, and send a message
1251   to the user, who would then use "mount" as described above 
1252   once he had actually inserted the disk.
1253 - Implement dump/print label to UA
1254 - Spool to disk only when the tape is full, then when a tape is hung move
1255   it to tape.
1256 - bextract is sending everything to the log file ****FIXME****
1257 - Allow multiple Storage specifications (or multiple names on
1258   a single Storage specification) in the Job record. Thus a job 
1259   can be backed up to a number of storage devices.
1260 - Implement some way for the File daemon to contact the Director 
1261   to start a job or pass its DHCP obtained IP number.
1262 - Implement a query tape prompt/replace feature for a console
1263 - Copy console @ code to gnome2-console
1264 - Make tree walk routines like cd, ls, ... more user friendly
1265   by handling spaces better.
1266 - Make sure that Bacula rechecks the tape after the 20 min wait.
1267 - Set IO_NOWAIT on Bacula TCP/IP packets.
1268 - Try doing a raw partition backup and restore by mounting a
1269   Windows partition.
1270 - From Lars Kellers:
1271     Yes, it would allow to highly automatic the request for new tapes. If a 
1272     tape is empty, bacula reads the barcodes (native or simulated), and if 
1273     an unused tape is found, it runs the label command with all the 
1274     necessary parameters.
1275
1276     By the way can bacula automatically "move" an empty/purged volume say 
1277     in the "short" pool to the "long" pool if this pool runs out of volume 
1278     space?
1279 - What to do about "list files job=xxx".
1280 - Look at how fuser works and /proc/PID/fd that is how Nic found the
1281   file descriptor leak in Bacula.
1282 - Implement WrapCounters in Counters.
1283 - Add heartbeat from FD to SD if hb interval expires.
1284 - Can we dynamically change FileSets?
1285 - If pool specified to label command and Label Format is specified,
1286   automatically generate the Volume name.
1287 - Why can't SQL do the filename sort for restore?
1288 - Add ExhautiveRestoreSearch
1289 - Look at the possibility of loading only the necessary 
1290   data into the restore tree (i.e. do it one directory at a
1291   time as the user walks through the tree).
1292 - Possibly use the hash code if the user selects all for a restore command.
1293 - Fix "restore all" to bypass building the tree.
1294 - Prohibit backing up archive device (findlib/find_one.c:128)
1295 - Implement Release Device in the Job resource to unmount a drive.
1296 - Implement Acquire Device in the Job resource to mount a drive,
1297   be sure this works with admin jobs so that the user can get
1298   prompted to insert the correct tape.  Possibly some way to say to
1299   run the job but don't save the files.
1300 - Make things like list where a file is saved case independent for
1301   Windows.
1302 - Use autochanger to handle multiple devices.
1303 - Implement a Recycle command
1304 - Start working on Base jobs.
1305 - Implement UnsavedFiles DB record.
1306 - From Phil Stracchino:
1307   It would probably be a per-client option, and would be called
1308   something like, say, "Automatically purge obsoleted jobs".  What it
1309   would do is, when you successfully complete a Differential backup of a
1310   client, it would automatically purge all Incremental backups for that
1311   client that are rendered redundant by that Differential.  Likewise,
1312   when a Full backup on a client completed, it would automatically purge
1313   all Differential and Incremental jobs obsoleted by that Full backup.
1314   This would let people minimize the number of tapes they're keeping on
1315   hand without having to master the art of retention times.
1316 - When doing a Backup send all attributes back to the Director, who
1317   would then figure out what files have been deleted.
1318 - Currently in mount.c:236 the SD simply creates a Volume. It should have
1319   explicit permission to do so.  It should also mark the tape in error
1320   if there is an error.
1321 - Cancel waiting for Client connect in SD if FD goes away.
1322
1323 - Implement timeout in response() when it should come quickly.
1324 - Implement a Slot priority (loaded/not loaded).
1325 - Implement "vacation" Incremental only saves.
1326 - Implement create "FileSet"?
1327 - Add prefixlinks to where or not where absolute links to FD.
1328 - Issue message to mount a new tape before the rewind.
1329 - Simplified client job initiation for portables.
1330 - If SD cannot open a drive, make it periodically retry.
1331 - Add more of the config info to the tape label.
1332
1333 - Refine SD waiting output:
1334     Device is being positioned
1335     >     Device is being positioned for append
1336     >     Device is being positioned to file x
1337     > 
1338 - Figure out some way to estimate output size and to avoid splitting
1339   a backup across two Volumes -- this could be useful for writing CDROMs
1340   where you really prefer not to have it split -- not serious.
1341 - Have SD compute MD5 or SHA1 and compare to what FD computes.
1342 - Make VolumeToCatalog calculate an MD5 or SHA1 from the 
1343   actual data on the Volume and compare it.                  
1344 - Make bcopy read through bad tape records.
1345 - Program files (i.e. execute a program to read/write files).
1346   Pass read date of last backup, size of file last time.
1347 - Add Signature type to File DB record.
1348 - CD into subdirectory when open()ing files for backup to
1349   speed up things.  Test with testfind().
1350 - Priority job to go to top of list.
1351 - Why are save/restore of device different sizes (sparse?)   Yup! Fix it.
1352 - Implement some way for the Console to dynamically create a job.
1353 - Solaris -I on tar for include list
1354 - Need a verbose mode in restore, perhaps to bsr.
1355 - bscan without -v is too quiet -- perhaps show jobs.
1356 - Add code to reject whole blocks if not wanted on restore.
1357 - Check if we can increase Bacula FD priorty in Win2000
1358 - Make sure the MaxVolFiles is fully implemented in SD
1359 - Check if both CatalogFiles and UseCatalog are set to SD.
1360 - Possibly add email to Watchdog if drive is unmounted too
1361   long and a job is waiting on the drive.
1362 - After unmount, if restore job started, ask to mount.
1363 - Add UA rc and history files.
1364 - put termcap (used by console) in ./configure and
1365   allow -with-termcap-dir.
1366 - Fix Autoprune for Volumes to respect need for full save.
1367 - Compare tape to Client files (attributes, or attributes and data) 
1368 - Make all database Ids 64 bit.
1369 - Allow console commands to detach or run in background.
1370 - Add SD message variables to control operator wait time
1371   - Maximum Operator Wait
1372   - Minimum Message Interval
1373   - Maximum Message Interval
1374 - Send Operator message when cannot read tape label.
1375 - Verify level=Volume (scan only), level=Data (compare of data to file).
1376   Verify level=Catalog, level=InitCatalog
1377 - Events file
1378 - Add keyword search to show command in Console.
1379 - Events : tape has more than xxx bytes.
1380 - Complete code in Bacula Resources -- this will permit
1381   reading a new config file at any time.
1382 - Handle ctl-c in Console
1383 - Implement script driven addition of File daemon to config files.
1384 - Think about how to make Bacula work better with File (non-tape) archives.
1385 - Write Unix emulator for Windows.
1386 - Put memory utilization in Status output of each daemon
1387   if full status requested or if some level of debug on.
1388 - Make database type selectable by .conf files i.e. at runtime
1389 - Set flag for uname -a.  Add to Volume label.
1390 - Restore files modified after date
1391 - SET LD_RUN_PATH=$HOME/mysql/lib/mysql
1392 - Remove duplicate fields from jcr (e.g. jcr.level and jcr.jr.Level, ...).
1393 - Timout a job or terminate if link goes down, or reopen link and query.
1394 - Concept of precious tapes (cannot be reused).
1395 - Make bcopy copy with a single tape drive.
1396 - Permit changing ownership during restore.
1397
1398 - From Phil:
1399   > My suggestion:  Add a feature on the systray menu-icon menu to request
1400   > an immediate backup now.  This would be useful for laptop users who may
1401   > not be on the network when the regular scheduled backup is run.
1402   > 
1403   > My wife's suggestion: Add a setting to the win32 client to allow it to
1404   > shut down the machine after backup is complete (after, of course,
1405   > displaying a "System will shut down in one minute, click here to cancel"
1406   > warning dialog).  This would be useful for sites that want user
1407   > woorkstations to be shut down overnight to save power.
1408   > 
1409
1410 - Autolabel should be specified by DIR instead of SD.
1411 - Storage daemon    
1412   - Add media capacity
1413   - AutoScan (check checksum of tape)
1414   - Format command = "format /dev/nst0"
1415   - MaxRewindTime
1416   - MinRewindTime
1417   - MaxBufferSize
1418   - Seek resolution (usually corresponds to buffer size)
1419   - EODErrorCode=ENOSPC or code
1420   - Partial Read error code
1421   - Partial write error code
1422   - Nonformatted read error
1423   - Nonformatted write error
1424   - WriteProtected error
1425   - IOTimeout
1426   - OpenRetries
1427   - OpenTimeout
1428   - IgnoreCloseErrors=yes
1429   - Tape=yes
1430   - NoRewind=yes
1431 - Pool
1432   - Maxwrites
1433   - Recycle period
1434 - Job
1435   - MaxWarnings
1436   - MaxErrors (job?)
1437 =====
1438 - FD sends unsaved file list to Director at end of job (see
1439   RFC below).
1440 - File daemon should build list of files skipped, and then
1441   at end of save retry and report any errors.
1442 - Write a Storage daemon that uses pipes and
1443   standard Unix programs to write to the tape.
1444   See afbackup.
1445 - Need something that monitors the JCR queue and
1446   times out jobs by asking the deamons where they are.
1447 - Enhance Jmsg code to permit buffering and saving to disk.
1448 - device driver = "xxxx" for drives.
1449 - Verify from Volume
1450 - Ensure that /dev/null works
1451 - Need report class for messages. Perhaps
1452   report resource where report=group of messages
1453 - enhance scan_attrib and rename scan_jobtype, and
1454   fill in code for "since" option 
1455 - Director needs a time after which the report status is sent
1456   anyway -- or better yet, a retry time for the job.
1457 - Don't reschedule a job if previous incarnation is still running.
1458 - Some way to automatically backup everything is needed????
1459 - Need a structure for pending actions:
1460   - buffered messages
1461   - termination status (part of buffered msgs?)
1462 - Drive management
1463   Read, Write, Clean, Delete
1464 - Login to Bacula; Bacula users with different permissions:
1465    owner, group, user, quotas
1466 - Store info on each file system type (probably in the job header on tape.
1467   This could be the output of df; or perhaps some sort of /etc/mtab record.
1468
1469 ========= ideas ===============
1470 From: "Jerry K. Schieffer" <jerry@skylinetechnology.com>
1471 To: <kern@sibbald.com>
1472 Subject: RE: [Bacula-users] future large programming jobs
1473 Date: Thu, 26 Feb 2004 11:34:54 -0600
1474
1475 I noticed the subject thread and thought I would offer the following
1476 merely as sources of ideas, i.e. something to think about, not even as
1477 strong as a request.  In my former life (before retiring) I often
1478 dealt with backups and storage management issues/products as a
1479 developer and as a consultant.  I am currently migrating my personal
1480 network from amanda to bacula specifically because of the ability to
1481 cross media boundaries during storing backups.
1482 Are you familiar with the commercial product called ADSM (I think IBM
1483 now sells it under the Tivoli label)?  It has a couple of interesting
1484 ideas that may apply to the following topics.
1485
1486 1. Migration:  Consider that when you need to restore a system, there
1487 may be pressure to hurry.  If all the information for a single client
1488 can eventually end up on the same media (and in chronological order),
1489 the restore is facillitated by not having to search past information
1490 from other clients.  ADSM has the concept of "client affinity" that
1491 may be associated with it's storage pools.  It seems to me that this
1492 concept (as an optional feature) might fit in your architecture for
1493 migration.
1494
1495 ADSM also has the concept of defining one or more storage pools as
1496 "copy pools" (almost mirrors, but only in the sense of contents).
1497 These pools provide the ability to have duplicte data stored both
1498 onsite and offsite.  The copy process can be scheduled to be handled
1499 by their storage manager during periods when there is no backup
1500 activity.  Again, the migration process might be a place to consider
1501 implementing something like this.
1502
1503 >
1504 > It strikes me that it would be very nice to be able to do things
1505 like
1506 > have the Job(s) backing up the machines run, and once they have all
1507 > completed, start a migration job to copy the data from disks Volumes
1508 to
1509 > a tape library and then to offsite storage. Maybe this can already
1510 be
1511 > done with some careful scheduling and Job prioritzation; the events
1512 > mechanism described below would probably make it very easy.
1513
1514 This is the goal. In the first step (before events), you simply
1515 schedule
1516 the Migration to tape later.
1517
1518 2. Base jobs:  In ADSM, each copy of each stored file is tracked in
1519 the database.  Once a file (unique by path and metadata such as dates,
1520 size, ownership, etc.) is in a copy pool, no more copies are made.  In
1521 other words, when you start ADSM, it begins like your concept of a
1522 base job.  After that it is in the "incremental" mode.  You can
1523 configure the number of "generations" of files to be retained, plus a
1524 retention date after which even old generations are purged.  The
1525 database tracks the contents of media and projects the percentage of
1526 each volume that is valid.  When the valid content of a volume drops
1527 below a configured percentage, the valid data are migrated to another
1528 volume and the old volume is marked as empty.  Note, this requires
1529 ADSM to have an idea of the contents of a client, i.e. marking the
1530 database when an existing file was deleted, but this would solve your
1531 issue of restoring a client without restoring deleted files.
1532
1533 This is pretty far from what bacula now does, but if you are going to
1534 rip things up for Base jobs,.....
1535 Also, the benefits of this are huge for very large shops, especially
1536 with media robots, but are a pain for shops with manual media
1537 mounting.
1538
1539 >
1540 > Base jobs sound pretty useful, but I'm not dying for them.
1541
1542 Nobody is dying for them, but when you see what it does, you will die
1543 without it.
1544
1545 3. Restoring deleted files:  Since I think my comments in (2) above
1546 have low probability of implementation, I'll also suggest that you
1547 could approach the issue of deleted files by a mechanism of having the
1548 fd report to the dir, a list of all files on the client for every
1549 backup job.  The dir could note in the database entry for each file
1550 the date that the file was seen.  Then if a restore as of date X takes
1551 place, only files that exist from before X until after X would be
1552 restored.  Probably the major cost here is the extra date container in
1553 each row of the files table.
1554
1555 Thanks for "listening".  I hope some of this helps.  If you want to
1556 contact me, please send me an email - I read some but not all of the
1557 mailing list traffic and might miss a reply there.
1558
1559 Please accept my compliments for bacula.  It is doing a great job for
1560 me!!  I sympathize with you in the need to wrestle with excelence in
1561 execution vs. excelence in feature inclusion.
1562
1563 Regards,
1564 Jerry Schieffer
1565
1566 ==============================
1567
1568 Longer term to do:
1569 - Implement wait on multiple objects
1570    - Multiple max times
1571    - pthread signal
1572    - socket input ready
1573 - Design at hierarchial storage for Bacula. Migration and Clone. 
1574 - Implement FSM (File System Modules).
1575 - Audit M_ error codes to ensure they are correct and consistent.
1576 - Add variable break characters to lex analyzer.
1577   Either a bit mask or a string of chars so that
1578   the caller can change the break characters.
1579 - Make a single T_BREAK to replace T_COMMA, etc.
1580 - Ensure that File daemon and Storage daemon can
1581   continue a save if the Director goes down (this
1582   is NOT currently the case). Must detect socket error,
1583   buffer messages for later. 
1584 - Enhance time/duration input to allow multiple qualifiers e.g. 3d2h
1585 - Add ability to backup to two Storage devices (two SD sessions) at
1586   the same time -- e.g. onsite, offsite.
1587 - Compress or consolidate Volumes of old possibly deleted files. Perhaps
1588   someway to do so with every volume that has less than x% valid 
1589   files.
1590
1591
1592 Migration: Move a backup from one Volume to another
1593 Clone:     Copy a backup -- two Volumes
1594
1595
1596 ======================================================
1597         Base Jobs design
1598 It is somewhat like a Full save becomes an incremental since
1599 the Base job (or jobs) plus other non-base files.
1600 Need:
1601 - A Base backup is same as Full backup, just different type.
1602 - New BaseFiles table that contains:
1603     BaseId - index
1604     BaseJobId - Base JobId referenced for this FileId (needed ???)
1605     JobId - JobId currently running
1606     FileId - File not backed up, exists in Base Job
1607     FileIndex - FileIndex from Base Job.
1608   i.e. for each base file that exists but is not saved because
1609   it has not changed, the File daemon sends the JobId, BaseId,
1610   FileId, FileIndex back to the Director who creates the DB entry.
1611 - To initiate a Base save, the Director sends the FD 
1612   the FileId, and full filename for each file in the Base.
1613 - When the FD finds a Base file, he requests the Director to
1614   send him the full File entry (stat packet plus MD5), or
1615   conversely, the FD sends it to the Director and the Director
1616   says yes or no. This can be quite rapid if the FileId is kept
1617   by the FD for each Base Filename.          
1618 - It is probably better to have the comparison done by the FD
1619   despite the fact that the File entry must be sent across the
1620   network.
1621 - An alternative would be to send the FD the whole File entry
1622   from the start. The disadvantage is that it requires a lot of
1623   space. The advantage is that it requires less communications
1624   during the save.
1625 - The Job record must be updated to indicate that one or more
1626   Bases were used.
1627 - At end of Job, FD returns:   
1628    1. Count of base files/bytes not written to tape (i.e. matches)
1629    2. Count of base file that were saved i.e. had changed.
1630 - No tape record would be written for a Base file that matches, in the
1631   same way that no tape record is written for Incremental jobs where
1632   the file is not saved because it is unchanged.
1633 - On a restore, all the Base file records must explicitly be
1634   found from the BaseFile tape. I.e. for each Full save that is marked
1635   to have one or more Base Jobs, search the BaseFile for all occurrences
1636   of JobId.
1637 - An optimization might be to make the BaseFile have:
1638      JobId
1639      BaseId
1640      FileId
1641   plus
1642      FileIndex
1643   This would avoid the need to explicitly fetch each File record for
1644   the Base job.  The Base Job record will be fetched to get the
1645   VolSessionId and VolSessionTime.
1646 =========================================================  
1647
1648
1649 ========================================================== 
1650     Unsaved File design
1651 For each Incremental job that is run, there may be files that
1652 were found but not saved because they were locked (this applies
1653 only to Windows). Such a system could send back to the Director
1654 a list of Unsaved files.
1655 Need:
1656 - New UnSavedFiles table that contains:
1657   JobId
1658   PathId
1659   FilenameId
1660 - Then in the next Incremental job, the list of Unsaved Files will be
1661   feed to the FD, who will ensure that they are explicitly chosen even
1662   if standard date/time check would not have selected them.
1663 =============================================================
1664
1665
1666 =====
1667    Multiple drive autochanger data:  see Alan Brown
1668    mtx -f xxx unloadStorage Element 1 is Already Full(drive 0 was empty)
1669    Unloading Data Transfer Element into Storage Element 1...source Element 
1670    Address 480 is Empty
1671
1672    (drive 0 was empty and so was slot 1)
1673    >   mtx -f xxx load 15 0
1674    no response, just returns to the command prompt when complete.
1675    >   mtx -f xxx status  Storage Changer /dev/changer:2 Drives, 60 Slots ( 2 Import/Export )
1676    Data Transfer Element 0:Full (Storage Element 15 Loaded):VolumeTag = HX001
1677    Data Transfer Element 1:Empty
1678          Storage Element 1:Empty
1679          Storage Element 2:Full :VolumeTag=HX002
1680          Storage Element 3:Full :VolumeTag=HX003
1681          Storage Element 4:Full :VolumeTag=HX004
1682          Storage Element 5:Full :VolumeTag=HX005
1683          Storage Element 6:Full :VolumeTag=HX006
1684          Storage Element 7:Full :VolumeTag=HX007
1685          Storage Element 8:Full :VolumeTag=HX008
1686          Storage Element 9:Full :VolumeTag=HX009
1687          Storage Element 10:Full :VolumeTag=HX010
1688          Storage Element 11:Empty
1689          Storage Element 12:Empty
1690          Storage Element 13:Empty
1691          Storage Element 14:Empty
1692          Storage Element 15:Empty
1693          Storage Element 16:Empty....
1694          Storage Element 28:Empty
1695          Storage Element 29:Full :VolumeTag=CLNU01L1
1696          Storage Element 30:Empty....
1697          Storage Element 57:Empty
1698          Storage Element 58:Full :VolumeTag=NEX261L2
1699          Storage Element 59 IMPORT/EXPORT:Empty
1700          Storage Element 60 IMPORT/EXPORT:Empty
1701    $  mtx -f xxx unload
1702    Unloading Data Transfer Element into Storage Element 15...done
1703
1704    (just to verify it remembers where it came from, however it can be
1705     overrriden with mtx unload {slotnumber} to go to any storage slot.)
1706    Configuration wise:
1707    There needs to be a table of drive # to devices somewhere - If there are
1708    multiple changers or drives there may not be a 1:1 correspondance between
1709    changer drive number and system device name - and depending on the way the
1710    drives are hooked up to scsi busses, they may not be linearly numbered
1711    from an offset point either.something like 
1712
1713    Autochanger drives = 2
1714    Autochanger drive 0 = /dev/nst1
1715    Autochanger drive 1 = /dev/nst2
1716    IMHO, it would be _safest_ to use explicit mtx unload commands at all
1717    times, not just for multidrive changers. For a 1 drive changer, that's
1718    just:
1719
1720    mtx load xx 0
1721    mtx unload xx 0
1722
1723    MTX's manpage (1.2.15):
1724          unload [<slotnum>] [ <drivenum> ]
1725                     Unloads media from drive  <drivenum>  into  slot
1726                     <slotnum>. If <drivenum> is omitted, defaults to
1727                     drive 0 (as do all commands).  If  <slotnum>  is
1728                     omitted, defaults to the slot that the drive was
1729                     loaded from. Note that there's currently no  way
1730                     to  say  'unload  drive 1's media to the slot it
1731                     came from', other than to  explicitly  use  that
1732                     slot number as the destination.AB
1733 ====
1734
1735 ====
1736 SCSI info:
1737 FreeBSD
1738 undef# camcontrol devlist
1739 <WANGTEK 51000  SCSI M74H 12B3>    at scbus0 target 2 lun 0 (pass0,sa0)
1740 <ARCHIVE 4586XX 28887-XXX 4BGD>    at scbus0 target 4 lun 0 (pass1,sa1)
1741 <ARCHIVE 4586XX 28887-XXX 4BGD>    at scbus0 target 4 lun 1 (pass2)
1742
1743 tapeinfo -f /dev/sg0 with a bad tape in drive 1:
1744 [kern@rufus mtx-1.2.17kes]$ ./tapeinfo -f /dev/sg0
1745 Product Type: Tape Drive
1746 Vendor ID: 'HP      '
1747 Product ID: 'C5713A          '
1748 Revision: 'H107'
1749 Attached Changer: No
1750 TapeAlert[3]:   Hard Error: Uncorrectable read/write error.
1751 TapeAlert[20]:    Clean Now: The tape drive neads cleaning NOW.
1752 MinBlock:1
1753 MaxBlock:16777215
1754 SCSI ID: 5
1755 SCSI LUN: 0
1756 Ready: yes
1757 BufferedMode: yes
1758 Medium Type: Not Loaded
1759 Density Code: 0x26
1760 BlockSize: 0
1761 DataCompEnabled: yes
1762 DataCompCapable: yes
1763 DataDeCompEnabled: yes
1764 CompType: 0x20
1765 DeCompType: 0x0
1766 Block Position: 0
1767 =====
1768
1769 ====
1770    Handling removable disks
1771
1772    From: Karl Cunningham <karlc@keckec.com>
1773
1774    My backups are only to hard disk these days, in removable bays. This is my
1775    idea of how a backup to hard disk would work more smoothly. Some of these
1776    things Bacula does already, but I mention them for completeness. If others
1777    have better ways to do this, I'd like to hear about it.
1778
1779    1. Accommodate several disks, rotated similar to how tapes are.  Identified
1780    by partition volume ID or perhaps by the name of a subdirectory.
1781    2. Abort & notify the admin if the wrong disk is in the bay.
1782    3. Write backups to different subdirectories for each machine to be backed
1783    up.
1784    4. Volumes (files) get created as needed in the proper subdirectory, one
1785    for each backup.
1786    5. When a disk is recycled, remove or zero all old backup files. This is
1787    important as the disk being recycled may be close to full. This may be
1788    better done manually since the backup files for many machines may be
1789    scattered in many subdirectories.
1790 ====
1791
1792
1793 === Done
1794 - Why the heck doesn't bacula drop root priviledges before connecting to
1795   the DB?
1796 - Look at using posix_fadvise(2) for backups -- see bug #751.
1797   Possibly add the code at findlib/bfile.c:795
1798 /* TCP socket options */
1799 #define TCP_KEEPIDLE            4       /* Start keeplives after this period */
1800 - Fix bnet_connect() code to set a timer and to use time to
1801   measure the time.
1802 - Implement 4th argument to make_catalog_backup that passes hostname.
1803 - Test FIFO backup/restore -- make regression
1804 - Please mount volume "xxx" on Storage device ... should also list
1805   Pool and MediaType in case user needs to create a new volume.
1806 - On restore add Restore Client, Original Client.
1807 01-Apr 00:42 rufus-dir: Start Backup JobId 55, Job=kernsave.2007-04-01_00.42.48
1808 01-Apr 00:42 rufus-sd: Python SD JobStart: JobId=55 Client=Rufus
1809 01-Apr 00:42 rufus-dir: Created new Volume "Full0001" in catalog.
1810 01-Apr 00:42 rufus-dir: Using Device "File"
1811 01-Apr 00:42 rufus-sd: kernsave.2007-04-01_00.42.48 Warning: Device "File" (/tmp) not configured to autolabel Volumes.
1812 01-Apr 00:42 rufus-sd: kernsave.2007-04-01_00.42.48 Warning: Device "File" (/tmp) not configured to autolabel Volumes.
1813 01-Apr 00:42 rufus-sd: Please mount Volume "Full0001" on Storage Device "File" (/tmp) for Job kernsave.2007-04-01_00.42.48
1814 01-Apr 00:44 rufus-sd: Wrote label to prelabeled Volume "Full0001" on device "File" (/tmp)
1815 - Check if gnome-console works with TLS.
1816 - the director seg faulted when I omitted the pool directive from a 
1817   job resource.  I was experimenting and thought it redundant that I had 
1818   specified Pool, Full Backup Pool. and Differential Backup Pool. but 
1819   apparently not.  This  happened when I removed the pool directive and 
1820   started the director.
1821 - Add Where: client:/.... to restore job report.
1822 - Ensure that moving a purged Volume in ua_purge.c to the RecyclePool
1823   does the right thing.
1824 - FD-SD quick disconnect
1825 - Building the in memory restore tree is slow.
1826 - Erabt if min_block_size > max_block_size
1827 - Add the ability to consolidate old backup sets (basically do a restore
1828   to tape and appropriately update the catalog). Compress Volume sets.
1829   Might need to spool via file is only one drive is available.