]> git.sur5r.net Git - bacula/bacula/blob - bacula/kernstodo
- Implemented Preben 'Peppe' Guldberg <peppe@wielders.org>
[bacula/bacula] / bacula / kernstodo
1                     Kern's ToDo List
2                      18 November 2004
3
4 Major development:      
5 Project                     Developer
6 =======                     =========                         
7 IPv6_2                      Meno Abels
8 Data encryption             Meno Abels (see projects)
9 Communication encryption    Meno Abels  
10 Version 1.37                Kern (see below)
11 ========================================================
12
13 1.37 Major Projects:
14 #3   Migration (Move, Copy, Archive Jobs)
15 #4   Embedded Python Scripting (implemented in Dir)
16 #5   Events that call a Python program (Implemented in Dir)
17 #6   Select one from among Multiple Storage Devices for Job
18 #7   Single Job Writing to Multiple Storage Devices
19
20 ##   Integrate web-bacula into a new Bacula project with
21      bimagemgr.
22 ##   Consider moving docs to their own project.
23
24 For 1.37:
25 - Tell the "restore" user when browsing is no longer possible.
26 - Add disk seeking on restore.  
27 - Cancel command should include JobId in list of Jobs.
28 - Require restore via the restore command or make a restore Job
29   get the bootstrap file.
30 - Add dump of VolSessionId/Time and FileIndex with bls.
31 - Make bootstrap file handle multiple MediaTypes (SD)
32 - Add offline command to Bacula console.
33 - Implement WildFile and WildDir to solve problem of 
34   saving only *.doc files.
35 - Add performance testing hooks
36 - Add Python writable variable for changing the Priority.
37 - Document that Bootstrap files can be written with cataloging
38   turned off.
39 - Look at adding full Volume and Pool information to a Volume 
40   label so that bscan can get *all* the info. 
41 - Scratch Pool where the volumes can be re-assigned to any Pool.
42 - Fix orphanned buffers:
43    Orphaned buffer:      24 bytes allocated at line 808 of rufus-dir job.c
44    Orphaned buffer:      40 bytes allocated at line 45 of rufus-dir alist.c
45
46 Regression tests (Jo):
47 - Add Pool/Storage override regression test.
48 - Add delete JobId to regression.
49 - Add a regression test for dbcheck.  
50 - New test to add bscan to four-concurrent-jobs regression,
51   i.e. after the four-concurrent jobs zap the
52   database as is done in the bscan-test, then use bscan to
53   restore the database, do a restore and compare with the
54   original.
55 - Add restore of specific JobId to regression (item 3
56   on the restore prompt)
57 - Add IPv6 to regression
58 - Add database test to regression. Test each function like delete,
59   purge, ...
60
61
62 1.37 Possibilities:
63 - Document security problems with the same password for everyone in
64   rpm and Win32 releases.
65 - Browse generations of files.
66 - I've seen an error when my catalog's File table fills up.  I
67    then have to recreate the File table with a larger maximum row
68    size.  Relevant information is at
69    http://dev.mysql.com/doc/mysql/en/Full_table.html ; I think the
70    "Installing and Configuring MySQL" chapter should talk a bit
71    about this potential problem, and recommend a solution.
72 - For Solaris must use POSIX awk.
73 - Want speed of writing to tape while despooling.
74 - Supported autochanger:
75 OS: Linux
76 Man.: HP
77 Media: LTO-2
78 Model: SSL1016
79 Slots: 16
80 Cap: 200GB
81 - Supported drive:
82   Wangtek 6525ES (SCSI-1 QIC drive, 525MB), under Linux 2.4.something, 
83   bacula 1.36.0/1 works with blocksize 16k INSIDE bacula-sd.conf.
84 - Add regex from http://www.pcre.org to Bacula for Win32.
85 - Use only shell tools no make in CDROM package.
86 - Document PostgreSQL performance problems bug 131.
87 - Document testing
88 - Document that ChangerDevice is used for Alert command.
89 - Include within include does it work?
90 - Implement a Pool of type Cleaning?
91 - Implement VolReadTime and VolWriteTime in SD
92 - Modify Backing up Your Database to include a bootstrap file.
93 - Think about making certain database errors fatal.
94 - Look at correcting the time jump in the scheduler for daylight
95   savings time changes.
96 - Add a "real" timer to network connections.
97 - Write non-optimized bsrs from the JobMedia and Media records,
98   even after Files are pruned.
99 - Promote to Full = Time period 
100 - Despool attributes simultaneously with data in a separate
101   thread, rejoined at end of data spooling.
102 - Implement Files/Bytes,... stats for restore job.
103 - Implement Total Bytes Written, ... for restore job.
104 - Check dates entered by user for correctness (month/day/... ranges)
105 - Compress restore Volume listing by date and first file.
106 - Look at patches/bacula_db.b2z postgresql that loops during restore.
107   See Gregory Wright.
108 - Perhaps add read/write programs and/or plugins to FileSets.
109 - How to handle backing up portables ...
110 - Add some sort of guaranteed Interval for upgrading jobs.
111 - Can we write the state file after every job terminates? On Win32
112   the system crashes and the state file is not updated.
113 - Limit bandwidth
114
115 Documentation to do: (any release a little bit at a time)
116 - Doc to do unmount before removing magazine.
117 - Alternative to static linking "ldd prog" save all binaries listed,
118   restore them and point LD_LIBRARY_PATH to them.
119 - Document add "</dev/null >/dev/null 2>&1" to the bacula-fd command line
120 - Document query file format.
121 - Add more documentation for bsr files.
122 - Document problems with Verify and pruning.
123 - Document how to use multiple databases.
124 - VXA drives have a "cleaning required"
125   indicator, but Exabyte recommends preventive cleaning after every 75
126   hours of operation.
127   From Phil:
128     In this context, it should be noted that Exabyte has a command-line
129     vxatool utility available for free download.  (The current version is
130     vxatool-3.72.) It can get diagnostic info, read, write and erase tapes,
131     test the drive, unload tapes, change drive settings, flash new firmware,
132     etc.
133     Of particular interest in this context is that vxatool <device> -i will
134     report, among other details, the time since last cleaning in tape motion
135     minutes.  This information can be retrieved (and settings changed, for
136     that matter) through the generic-SCSI device even when Bacula has the
137     regular tape device locked.  (Needless to say, I don't recommend
138     changing tape settings while a job is running.)
139 - Lookup HP cleaning recommendations.
140 - Lookup HP tape replacement recommendations (see trouble shooting autochanger)
141 - Document doing table repair
142   
143           
144 Testing to do: (painful)
145
146
147 For 1.37 Testing/Documentation:
148 - Add bandwidth limiting.
149 - Add acks every once and a while from the SD to keep
150   the line from timing out.
151 - When an error in input occurs and conio beeps, you can back
152   up through the prompt.
153 - Detect fixed tape block mode during positioning by looking at
154   block numbers in btape "test".  Possibly adjust in Bacula.
155 - Fix list volumes to output volume retention in some other
156   units, perhaps via a directive.
157 - If opening a tape in read/write mode fails attempt to open
158   it in read-only mode, and mark the tape for read only.
159 - Add a read-only mode to the mount option.
160 - Allow Simultaneous Priorities = yes  => run up to Max concurrent jobs even
161   with multiple priorities.
162 - If you use restore replace=never, the directory attributes for
163   non-existent directories will not be restored properly.
164
165 - see lzma401.zip in others directory for new compression
166   algorithm/library.
167 - Minimal autochanger handling in Bacula and in btape.
168 - Look into how tar does not save sockets and the possiblity of
169   not saving them in Bacula (Martin Simmons reported this).
170 - Add All Local Partitions = yes to new style saves.
171 - localmounts=`awk '/ext/ { print $2 }' /proc/mounts`   # or whatever
172   find $localmounts -xdev -type s -ls
173 - Fix restore jobs so that multiple jobs can run if they
174   are not using the same tape(s).
175 - Allow the user to select JobType for manual pruning/purging.
176 - Look at adding Client run command that will use the
177   port opened by the client.
178 - bscan does not put first of two volumes back with all info in
179   bscan-test.
180 - Implement the FreeBSD nodump flag in chflags.
181 - Figure out how to make named console messages go only to that
182   console and to the non-restricted console (new console class?).
183 - Make restricted console prompt for password if *ask* is set or
184   perhaps if password is undefined.
185 - Implement "from ISO-date/time every x hours/days/weeks/months" in
186   schedules.
187 ==== from Marc Schoechlin
188 - the help-command should be more verbose
189   (it should explain the paramters of the different 
190   commands in detail)
191   -> it´s time-comsuming to consult the manual anytime
192      you need a special parameter
193   -> maybe it´s more easy to maintain this, if the
194      descriptions of that commands are outsourced to
195      a ceratin-file
196 - the cd-command should allow complete paths
197   i.e. cd /foo/bar/foo/bar
198   -> if a customer mails me the path to a certain file,
199      it´s faster to enter the specified directory
200 - if the password is not configured in bconsole.conf
201   you should be asked for it.
202   -> sometimes you like to do restore on a customer-machine
203      which shouldn´t know the password for bacula.
204   -> adding the password to the file favours admins
205      to forget to remove the password after usage
206   -> security-aspects
207      the protection of that file is less important
208 - long-listed-output of commands should be scrollable
209   like the unix more/less-command does
210   -> if someone runs 200 and more machines, the lists could
211      be a little long and complex
212 - command-output should be shown column by column
213   to reduce scrolling and to increase clarity
214   -> see last item
215 - lsmark should list the selected files with full
216   paths
217 - wildcards for selecting and file and directories would be nice
218 - any actions should be interuptable with STRG+C
219 - command-expansion would be pretty cool
220 ====
221 - Compaction of Disk space by "migrating" Volumes that have pruned
222   Jobs (what criteria? size, #jobs, time).
223 - Add prune all command
224 - Document fact that purge can destroy a part of a restore by purging
225   one volume while others remain valid -- perhaps mark Jobs.
226 - Add multiple-media-types.txt
227 - look at mxt-changer.html
228 - Make ? do a help command (no return needed).
229 - Implement restore directory.
230 - Document streams and how to implement them.
231 - Try not to re-backup a file if a new hard link is added.
232 - Add feature to backup hard links only, but not the data.
233 - Fix stream handling to be simpler.
234 - Add Priority and Bootstrap to Run a Job.
235 - Eliminate Restore "Run Restore Job" prompt by allowing new "run command
236   to be issued"
237 - Remove View FileSet button from Run a Job dialog.
238 - Handle prompt for restore job at end of Restore command.
239 - Add display of total selected files to Restore window.
240 - Add tree pane to left of window.
241 - Add progress meter.
242 - Max wait time or max run time causes seg fault -- see runtime-bug.txt
243 - Document writing to a CD/DVD with Bacula.
244 - Add a "base" package to the window installer for pthreadsVCE.dll
245   which is needed by all packages.
246 - Add message to user to check for fixed block size when the forward
247   space test fails in btape.
248 - When unmarking a directory check if all files below are unmarked and
249   then remove the + flag -- in the restore tree.
250 - Possibly implement: Action = Unmount Device="TapeDrive1" in Admin jobs.
251 - Setup lrrd graphs: (http://www.linpro.no/projects/lrrd/) Mike Acar.
252 - Revisit the question of multiple Volumes (disk) on a single device.
253 - Add a block copy option to bcopy.
254 - Investigate adding Mac Resource Forks.
255 - Finish work on Gnome restore GUI.
256 - Fix "llist jobid=xx" where no fileset or client exists.
257 - From Chris Hull:
258    it seems to be complaining about 12:00pm which should be a valid 12
259    hour time.  I changed the time to 11:59am and everything works fine.
260    Also 12:00am works fine.  0:00pm also works (which I don't think
261    should).  None of the values 12:00pm - 12:59pm work for that matter.
262 - Add level to estimate command.
263 - For each job type (Admin, Restore, ...) require only the really necessary
264   fields.
265 - Fix option 2 of restore -- list where file is backed up -- require Client,
266   then list last 20 backups.
267 - Pass Director resource name as an option to the Console.
268 - Add a "batch" mode to the Console (no unsolicited queries, ...).
269 - Add a .list all files in the restore tree (probably also a list all files)
270   Do both a long and short form.
271 - Allow browsing the catalog to see all versions of a file (with 
272   stat data on each file).
273 - Restore attributes of directory if replace=never set but directory
274   did not exist.
275 - Use SHA1 on authentication if possible.
276 - See comtest-xxx.zip for Windows code to talk to USB.
277 - Add Events and Perl scripting.
278 - Add John's appended files:
279    Appended = {     /files/server/logs/http/*log   }
280    and such files would be treated as follows.On a FULL backup, they would
281    be backed up like any other file.On an INCREMENTAL backup, where a
282    previous INCREMENTAL or FULL was already in thecatalogue and the length
283    of the file wasgreater than the length of the last backup, only thedata
284    added since the last backup will be dumped.On an INCREMENTAL backup, if
285    the length of the file is less than thelength of the file with the same
286    name last backed up, the completefile is dumped.On Windows systems, with
287    creation date of files, we can be evensmarter about this and not count
288    entirely upon the length.On a restore, the full and all incrementals
289    since it will beapplied in sequence to restore the file.  
290 - Allow for optional cancelling of SD and FD in case DIR
291   gets a fatal error. Requested by Jesse Guardiani <jesse@wingnet.net>
292 - Add "limit=n" for "list jobs"
293 - Check new HAVE_WIN32 open bits.    
294 - Check if the tape has moved before writing.  
295 - Handling removable disks -- see below:
296 - Keep track of tape use time, and report when cleaning is necessary.
297 - Add FromClient and ToClient keywords on restore command (or
298   BackupClient RestoreClient).
299 - Implement a JobSet, which groups any number of jobs. If the
300   JobSet is started, all the jobs are started together.
301   Allow Pool, Level, and Schedule overrides.
302 - Enhance cancel to timeout BSOCK packets after a specific delay.
303 - Do scheduling by UTC using gmtime_r() in run_conf, scheduler, and   
304   ua_status.!!! Thanks to Alan Brown for this tip.
305 - Look at updating Volume Jobs so that Max Volume Jobs = 1 will work
306   correctly for multiple simultaneous jobs.
307 - Correct code so that FileSet MD5 is calculated for < and | filename   
308   generation.
309 - Implement the Media record flag that indicates that the Volume does disk 
310   addressing.
311 - Implement VolAddr, which is used when Volume is addressed like a disk,
312   and form it from VolFile and VolBlock.
313 - Make multiple restore jobs for multiple media types specifying 
314   the proper storage type.
315 - Implement MediaType keyword in bsr?   
316 - Fix fast block rejection (stored/read_record.c:118). It passes a null
317   pointer (rec) to try_repositioning().
318 - Look at extracting Win data from BackupRead.
319 - Implement RestoreJobRetention? Maybe better "JobRetention" in a Job,
320   which would take precidence over the Catalog "JobRetention".
321 - Implement Label Format in Add and Label console commands.
322 - Possibly up network buffers to 65K. Put on variable.
323 - Put email tape request delays on one or more variables. User wants
324   to cancel the job after a certain time interval.  Maximum Mount Wait?
325 - Job, Client, Device, Pool, or Volume?
326   Is it possible to make this a directive which is *optional* in multiple
327   resources, like Level? If so, I think I'd make it an optional directive
328   in Job, Client, and Pool, with precedence such that Job overrides Client
329   which in turn overrides Pool.
330
331 - New Storage specifications:
332   - Want to write to multiple storage devices simultaneously
333   - Want to write to multiple storage devices sequentially (in one job)
334   - Want to read/write simultaneously
335   - Key is MediaType -- it must match
336
337   Passed to SD as a sort of BSR record called Storage Specification
338     Record or SSR.
339     SSR                    
340       Next -> Next SSR
341       MediaType -> Next MediaType
342       Pool -> Next Pool
343       Device -> Next Device
344   Job Resource
345      Allow multiple Storage specifications
346      New flags
347         One Archive = yes
348         One Device = yes
349         One Storage = yes
350         One MediaType = yes
351         One Pool = yes
352   Storage
353      Allow Multiple Pool specifications (note, Pool currently
354        in Job resource).
355      Allow Multiple MediaType specifications in Dir conf
356      Allow Multiple Device specifications in Dir conf
357      Perhaps keep this in a single SSR
358   Tie a Volume to a specific device by using a MediaType that 
359     is contained in only one device.
360   In SD allow Device to have Multiple MediaTypes
361
362 - Ideas from Jerry Scharf:
363   First let's point out some big pluses that bacula has for this
364         it's open source
365         more importantly it's active. Thank you so much for that
366         even more important, it's not flaky
367         it has an open access catalog, opening many possibilities
368         it's pushing toward heterogeneous systems capability
369   big things:
370    Macintosh file client
371         macs are an interesting niche, but I fear a server is a rathole
372    working bare iron recovery for windows
373    the option for  inc/diff backups not reset on fileset revision
374         a) use both change and inode update time against base time
375         b) do the full catalog check (expensive but accurate)
376    sizing guide (how much system is needed to back up N systems/files)
377    consultants on using bacula in building a disaster recovery system
378    an integration guide
379         or how to get at fancy things that one could do with bacula
380    logwatch code for bacula logs (or similar)
381    linux distro inclusion of bacula (brings good and bad, but necessary)
382    win2k/XP server capability (icky but you asked)
383    support for Oracle database ??
384 ===
385 - Look at adding SQL server and Exchange support for Windows. 
386 - Each DVD-RAM disk would be a volume, just like each tape is 
387   a volume. It's a 4.7GB media with random access, but there's nothing about 
388   it that I can see that makes it so different than a tape from  bacula's 
389   perspective. Why couldn't I back up to a bare floppy as a volume (ignoring 
390   the media capacity?)
391 - Make dev->file and dev->block_num signed integers so that -1 can
392   be an invalid value which happens with BSR.
393 - Create VolAddr for disk files in place of VolFile and VolBlock. This
394   is needed to properly specify ranges.
395 - Add progress of files/bytes to SD and FD.
396 - Print warning message if FileId > 4 billion
397 - do a "messages" before the first prompt in Console
398 - Add a date and time stamp at the beginning of every line in the 
399   Job report (Volker Sauer).
400 - Client does not show busy during Estimate command.
401 - Implement Console mtx commands.
402 - Implement a Mount Command and an Unmount Command where
403   the users could specify a system command to be performed
404   to do the mount, after which Bacula could attempt to
405   read the device. This is for Removeable media such as a CDROM.
406   - Most likely, this mount command would be invoked explicitly
407   by the user using the current Console "mount" and "unmount" 
408   commands -- the Storage Daemon would do the right thing 
409   depending on the exact nature of the device.
410   - As with tape drives, when Bacula wanted a new removable
411   disk mounted, it would unmount the old one, and send a message
412   to the user, who would then use "mount" as described above 
413   once he had actually inserted the disk.
414 - Implement dump/print label to UA
415 - Spool to disk only when the tape is full, then when a tape is hung move
416   it to tape.
417 - bextract is sending everything to the log file ****FIXME****
418 - Allow multiple Storage specifications (or multiple names on
419   a single Storage specification) in the Job record. Thus a job 
420   can be backed up to a number of storage devices.
421 - Implement some way for the File daemon to contact the Director 
422   to start a job or pass its DHCP obtained IP number.
423 - Implement a query tape prompt/replace feature for a console
424 - Copy console @ code to gnome2-console
425 - Make AES the only encryption algorithm see 
426   http://csrc.nist.gov/CryptoToolkit/aes/).  It's
427   an officially adopted standard, has survived peer
428   review, and provides keys up to 256 bits.
429 - Take a careful look at SetACL http://setacl.sourceforge.net     
430 - Take a careful look at Level for the estimate command, maybe make
431   it a command line option.
432 - Add Volume name to "I cannot write on this volume because"
433 - Make tree walk routines like cd, ls, ... more user friendly
434   by handling spaces better.
435 - Make sure that Bacula rechecks the tape after the 20 min wait.
436 - Set IO_NOWAIT on Bacula TCP/IP packets.
437 - Try doing a raw partition backup and restore by mounting a
438   Windows partition.
439 - From Lars Kellers:
440     Yes, it would allow to highly automatic the request for new tapes. If a 
441     tape is empty, bacula reads the barcodes (native or simulated), and if 
442     an unused tape is found, it runs the label command with all the 
443     necessary parameters.
444
445     By the way can bacula automatically "move" an empty/purged volume say 
446     in the "short" pool to the "long" pool if this pool runs out of volume 
447     space?
448 - What to do about "list files job=xxx".
449 - Make Dmsg look at global before calling subroutine.
450 - Get and test MySQL 4.0
451 - Look at how fuser works and /proc/PID/fd that is how Nic found the
452   file descriptor leak in Bacula.
453 - Implement WrapCounters in Counters.
454 - Add heartbeat from FD to SD if hb interval expires.
455 - Can we dynamically change FileSets?
456 - If pool specified to label command and Label Format is specified,
457   automatically generate the Volume name.
458 - Why can't SQL do the filename sort for restore?
459 - Look into Microsoft Volume Shadowcopy Service VSS for backing
460   up system state components (Active Directory, System Volume, ...)
461 - Add ExhautiveRestoreSearch
462 - Look at the possibility of loading only the necessary 
463   data into the restore tree (i.e. do it one directory at a
464   time as the user walks through the tree).
465 - Possibly use the hash code if the user selects all for a restore command.
466 - Fix "restore all" to bypass building the tree.
467 - Prohibit backing up archive device (findlib/find_one.c:128)
468 - Implement Release Device in the Job resource to unmount a drive.
469 - Implement Acquire Device in the Job resource to mount a drive,
470   be sure this works with admin jobs so that the user can get
471   prompted to insert the correct tape.  Possibly some way to say to
472   run the job but don't save the files.
473 - Make things like list where a file is saved case independent for
474   Windows.
475 - Implement migrate
476 - Use autochanger to handle multiple devices.
477 - Add SuSE install doc to list.
478 - Check and rechedk "Invalid block number"
479 - User wants to NOT backup up certain big files (email files).
480 - Maybe remove multiple simultaneous devices code in SD.
481 - On Windows with very long path names, it may be impossible to create 
482   a file (and thus restore it) because the total length is too long.
483   We must cd into the directory then create the file without the
484   full path name.
485 - Implement a Recycle command
486 - Add client name to cram-md5 challenge so Director can immediately
487   verify if it is the correct client.
488 - Audit all UA commands to ensure that we always prompt where possible.
489 - Make bootstrap filename unique.
490 - Test a second language e.g. french.
491 - Start working on Base jobs.
492 - Implement UnsavedFiles DB record.
493 - Implement argc/argv for daemon command line scanning using table driven
494   stuff below.
495 - From Phil Stracchino:
496   It would probably be a per-client option, and would be called
497   something like, say, "Automatically purge obsoleted jobs".  What it
498   would do is, when you successfully complete a Differential backup of a
499   client, it would automatically purge all Incremental backups for that
500   client that are rendered redundant by that Differential.  Likewise,
501   when a Full backup on a client completed, it would automatically purge
502   all Differential and Incremental jobs obsoleted by that Full backup.
503   This would let people minimize the number of tapes they're keeping on
504   hand without having to master the art of retention times.
505 - Implement a M_SECURITY message class.
506 - When doing a Backup send all attributes back to the Director, who
507   would then figure out what files have been deleted.
508 - Currently in mount.c:236 the SD simply creates a Volume. It should have
509   explicit permission to do so.  It should also mark the tape in error
510   if there is an error.
511 - SD Bytes Read is wrong.
512 - Investigate doing RAW backup of Win32 partition.
513 - Cancel waiting for Client connect in SD if FD goes away.
514
515 - Implement timeout in response() when it should come quickly.
516 - Implement console @echo command.
517 - Implement a Slot priority (loaded/not loaded).
518 - Implement "vacation" Incremental only saves.
519 - Implement single pane restore (much like the Gftp panes).
520 - Implement Automatic Mount even in operator wait.
521 - Implement create "FileSet"?
522 - Implement restore "current system", but take all files without
523   doing selection tree -- so that jobs without File records can
524   be restored.
525 - Add prefixlinks to where or not where absolute links to FD.
526 - Issue message to mount a new tape before the rewind.
527 - Simplified client job initiation for portables.
528 - If SD cannot open a drive, make it periodically retry.
529 - Add more of the config info to the tape label.
530
531 - If tape is marked read-only, then try opening it read-only rather than
532   failing, and remember that it cannot be written.
533 - Refine SD waiting output:
534     Device is being positioned
535     >     Device is being positioned for append
536     >     Device is being positioned to file x
537     > 
538 - Figure out some way to estimate output size and to avoid splitting
539   a backup across two Volumes -- this could be useful for writing CDROMs
540   where you really prefer not to have it split -- not serious.
541 - Have SD compute MD5 or SHA1 and compare to what FD computes.
542 - Make VolumeToCatalog calculate an MD5 or SHA1 from the 
543   actual data on the Volume and compare it.                  
544 - Implement Bacula plugins -- design API
545 - Make bcopy read through bad tape records.
546 - Program files (i.e. execute a program to read/write files).
547   Pass read date of last backup, size of file last time.
548 - Add Signature type to File DB record.
549 - CD into subdirectory when open()ing files for backup to
550   speed up things.  Test with testfind().
551 - Priority job to go to top of list.
552 - Why are save/restore of device different sizes (sparse?)   Yup! Fix it.
553 - Implement some way for the Console to dynamically create a job.
554 - Restore to a particular time -- e.g. before date, after date. 
555 - Solaris -I on tar for include list
556 - Need a verbose mode in restore, perhaps to bsr.
557 - bscan without -v is too quiet -- perhaps show jobs.
558 - Add code to reject whole blocks if not wanted on restore.
559 - Check if we can increase Bacula FD priorty in Win2000
560 - Make sure the MaxVolFiles is fully implemented in SD
561 - Check if both CatalogFiles and UseCatalog are set to SD.
562 - Figure out how to do a bare metal Windows restore
563 - Possibly add email to Watchdog if drive is unmounted too
564   long and a job is waiting on the drive.
565 - After unmount, if restore job started, ask to mount.
566 - Convert all %x substitution variables, which are hard to remember
567   and read to %(variable-name).  Idea from TMDA.
568 - Remove NextId for SQLite. Optimize.
569 - Move all SQL statements into a single location.
570 - Add UA rc and history files.
571 - put termcap (used by console) in ./configure and
572   allow -with-termcap-dir.
573 - Fix Autoprune for Volumes to respect need for full save.
574 - Fix Win32 config file definition name on /install
575 - Compare tape to Client files (attributes, or attributes and data) 
576 - Make all database Ids 64 bit.
577 - Write an applet for Linux.
578 - Allow console commands to detach or run in background.
579 - Fix status delay on storage daemon during rewind.
580 - Add SD message variables to control operator wait time
581   - Maximum Operator Wait
582   - Minimum Message Interval
583   - Maximum Message Interval
584 - Send Operator message when cannot read tape label.
585 - Verify level=Volume (scan only), level=Data (compare of data to file).
586   Verify level=Catalog, level=InitCatalog
587 - Events file
588 - Add keyword search to show command in Console.
589 - Events : tape has more than xxx bytes.
590 - Complete code in Bacula Resources -- this will permit
591   reading a new config file at any time.
592 - Handle ctl-c in Console
593 - Implement script driven addition of File daemon to config files.
594 - Think about how to make Bacula work better with File (non-tape) archives.
595 - Write Unix emulator for Windows.
596 - Put memory utilization in Status output of each daemon
597   if full status requested or if some level of debug on.
598 - Make database type selectable by .conf files i.e. at runtime
599 - Set flag for uname -a.  Add to Volume label.
600 - Restore files modified after date
601 - SET LD_RUN_PATH=$HOME/mysql/lib/mysql
602 - Remove duplicate fields from jcr (e.g. jcr.level and jcr.jr.Level, ...).
603 - Timout a job or terminate if link goes down, or reopen link and query.
604 - Concept of precious tapes (cannot be reused).
605 - Make bcopy copy with a single tape drive.
606 - Permit changing ownership during restore.
607
608 - From Phil:
609   > My suggestion:  Add a feature on the systray menu-icon menu to request
610   > an immediate backup now.  This would be useful for laptop users who may
611   > not be on the network when the regular scheduled backup is run.
612   > 
613   > My wife's suggestion: Add a setting to the win32 client to allow it to
614   > shut down the machine after backup is complete (after, of course,
615   > displaying a "System will shut down in one minute, click here to cancel"
616   > warning dialog).  This would be useful for sites that want user
617   > woorkstations to be shut down overnight to save power.
618   > 
619
620 - Autolabel should be specified by DIR instead of SD.
621 - Storage daemon    
622   - Add media capacity
623   - AutoScan (check checksum of tape)
624   - Format command = "format /dev/nst0"
625   - MaxRewindTime
626   - MinRewindTime
627   - MaxBufferSize
628   - Seek resolution (usually corresponds to buffer size)
629   - EODErrorCode=ENOSPC or code
630   - Partial Read error code
631   - Partial write error code
632   - Nonformatted read error
633   - Nonformatted write error
634   - WriteProtected error
635   - IOTimeout
636   - OpenRetries
637   - OpenTimeout
638   - IgnoreCloseErrors=yes
639   - Tape=yes
640   - NoRewind=yes
641 - Pool
642   - Maxwrites
643   - Recycle period
644 - Job
645   - MaxWarnings
646   - MaxErrors (job?)
647 =====
648 - FD sends unsaved file list to Director at end of job (see
649   RFC below).
650 - File daemon should build list of files skipped, and then
651   at end of save retry and report any errors.
652 - Write a Storage daemon that uses pipes and
653   standard Unix programs to write to the tape.
654   See afbackup.
655 - Need something that monitors the JCR queue and
656   times out jobs by asking the deamons where they are.
657 - Enhance Jmsg code to permit buffering and saving to disk.
658 - device driver = "xxxx" for drives.
659 - Verify from Volume
660 - Ensure that /dev/null works
661 - Need report class for messages. Perhaps
662   report resource where report=group of messages
663 - enhance scan_attrib and rename scan_jobtype, and
664   fill in code for "since" option 
665 - Director needs a time after which the report status is sent
666   anyway -- or better yet, a retry time for the job.
667 - Don't reschedule a job if previous incarnation is still running.
668 - Some way to automatically backup everything is needed????
669 - Need a structure for pending actions:
670   - buffered messages
671   - termination status (part of buffered msgs?)
672 - Drive management
673   Read, Write, Clean, Delete
674 - Login to Bacula; Bacula users with different permissions:
675    owner, group, user, quotas
676 - Store info on each file system type (probably in the job header on tape.
677   This could be the output of df; or perhaps some sort of /etc/mtab record.
678
679 ========= ideas ===============
680 From: "Jerry K. Schieffer" <jerry@skylinetechnology.com>
681 To: <kern@sibbald.com>
682 Subject: RE: [Bacula-users] future large programming jobs
683 Date: Thu, 26 Feb 2004 11:34:54 -0600
684
685 I noticed the subject thread and thought I would offer the following
686 merely as sources of ideas, i.e. something to think about, not even as
687 strong as a request.  In my former life (before retiring) I often
688 dealt with backups and storage management issues/products as a
689 developer and as a consultant.  I am currently migrating my personal
690 network from amanda to bacula specifically because of the ability to
691 cross media boundaries during storing backups.
692 Are you familiar with the commercial product called ADSM (I think IBM
693 now sells it under the Tivoli label)?  It has a couple of interesting
694 ideas that may apply to the following topics.
695
696 1. Migration:  Consider that when you need to restore a system, there
697 may be pressure to hurry.  If all the information for a single client
698 can eventually end up on the same media (and in chronological order),
699 the restore is facillitated by not having to search past information
700 from other clients.  ADSM has the concept of "client affinity" that
701 may be associated with it's storage pools.  It seems to me that this
702 concept (as an optional feature) might fit in your architecture for
703 migration.
704
705 ADSM also has the concept of defining one or more storage pools as
706 "copy pools" (almost mirrors, but only in the sense of contents).
707 These pools provide the ability to have duplicte data stored both
708 onsite and offsite.  The copy process can be scheduled to be handled
709 by their storage manager during periods when there is no backup
710 activity.  Again, the migration process might be a place to consider
711 implementing something like this.
712
713 >
714 > It strikes me that it would be very nice to be able to do things
715 like
716 > have the Job(s) backing up the machines run, and once they have all
717 > completed, start a migration job to copy the data from disks Volumes
718 to
719 > a tape library and then to offsite storage. Maybe this can already
720 be
721 > done with some careful scheduling and Job prioritzation; the events
722 > mechanism described below would probably make it very easy.
723
724 This is the goal. In the first step (before events), you simply
725 schedule
726 the Migration to tape later.
727
728 2. Base jobs:  In ADSM, each copy of each stored file is tracked in
729 the database.  Once a file (unique by path and metadata such as dates,
730 size, ownership, etc.) is in a copy pool, no more copies are made.  In
731 other words, when you start ADSM, it begins like your concept of a
732 base job.  After that it is in the "incremental" mode.  You can
733 configure the number of "generations" of files to be retained, plus a
734 retention date after which even old generations are purged.  The
735 database tracks the contents of media and projects the percentage of
736 each volume that is valid.  When the valid content of a volume drops
737 below a configured percentage, the valid data are migrated to another
738 volume and the old volume is marked as empty.  Note, this requires
739 ADSM to have an idea of the contents of a client, i.e. marking the
740 database when an existing file was deleted, but this would solve your
741 issue of restoring a client without restoring deleted files.
742
743 This is pretty far from what bacula now does, but if you are going to
744 rip things up for Base jobs,.....
745 Also, the benefits of this are huge for very large shops, especially
746 with media robots, but are a pain for shops with manual media
747 mounting.
748
749 >
750 > Base jobs sound pretty useful, but I'm not dying for them.
751
752 Nobody is dying for them, but when you see what it does, you will die
753 without it.
754
755 3. Restoring deleted files:  Since I think my comments in (2) above
756 have low probability of implementation, I'll also suggest that you
757 could approach the issue of deleted files by a mechanism of having the
758 fd report to the dir, a list of all files on the client for every
759 backup job.  The dir could note in the database entry for each file
760 the date that the file was seen.  Then if a restore as of date X takes
761 place, only files that exist from before X until after X would be
762 restored.  Probably the major cost here is the extra date container in
763 each row of the files table.
764
765 Thanks for "listening".  I hope some of this helps.  If you want to
766 contact me, please send me an email - I read some but not all of the
767 mailing list traffic and might miss a reply there.
768
769 Please accept my compliments for bacula.  It is doing a great job for
770 me!!  I sympathize with you in the need to wrestle with excelence in
771 execution vs. excelence in feature inclusion.
772
773 Regards,
774 Jerry Schieffer
775
776 ==============================
777
778 Longer term to do:
779 - Design at hierarchial storage for Bacula. Migration and Clone. 
780 - Implement FSM (File System Modules).
781 - Audit M_ error codes to ensure they are correct and consistent.
782 - Add variable break characters to lex analyzer.
783   Either a bit mask or a string of chars so that
784   the caller can change the break characters.
785 - Make a single T_BREAK to replace T_COMMA, etc.
786 - Ensure that File daemon and Storage daemon can
787   continue a save if the Director goes down (this
788   is NOT currently the case). Must detect socket error,
789   buffer messages for later. 
790 - Enhance time/duration input to allow multiple qualifiers e.g. 3d2h
791 - Add ability to backup to two Storage devices (two SD sessions) at
792   the same time -- e.g. onsite, offsite.
793 - Add the ability to consolidate old backup sets (basically do a restore
794   to tape and appropriately update the catalog). Compress Volume sets.
795   Might need to spool via file is only one drive is available.
796 - Compress or consolidate Volumes of old possibly deleted files. Perhaps
797   someway to do so with every volume that has less than x% valid 
798   files.
799
800
801 Migration: Move a backup from one Volume to another
802 Clone:     Copy a backup -- two Volumes
803
804 Bacula Migration is based on Jobs (apparently Networker is file by file).
805
806 Migration triggered by:
807   Number of Jobs
808   Number of Volumes
809   Age of Jobs
810   Highwater mark (keep total size)
811   Lowwater mark
812   
813
814
815 ======================================================
816         Base Jobs design
817 It is somewhat like a Full save becomes an incremental since
818 the Base job (or jobs) plus other non-base files.
819 Need:
820 - A Base backup is same as Full backup, just different type.
821 - New BaseFiles table that contains:
822     BaseId - index
823     BaseJobId - Base JobId referenced for this FileId (needed ???)
824     JobId - JobId currently running
825     FileId - File not backed up, exists in Base Job
826     FileIndex - FileIndex from Base Job.
827   i.e. for each base file that exists but is not saved because
828   it has not changed, the File daemon sends the JobId, BaseId,
829   FileId, FileIndex back to the Director who creates the DB entry.
830 - To initiate a Base save, the Director sends the FD 
831   the FileId, and full filename for each file in the Base.
832 - When the FD finds a Base file, he requests the Director to
833   send him the full File entry (stat packet plus MD5), or
834   conversely, the FD sends it to the Director and the Director
835   says yes or no. This can be quite rapid if the FileId is kept
836   by the FD for each Base Filename.          
837 - It is probably better to have the comparison done by the FD
838   despite the fact that the File entry must be sent across the
839   network.
840 - An alternative would be to send the FD the whole File entry
841   from the start. The disadvantage is that it requires a lot of
842   space. The advantage is that it requires less communications
843   during the save.
844 - The Job record must be updated to indicate that one or more
845   Bases were used.
846 - At end of Job, FD returns:   
847    1. Count of base files/bytes not written to tape (i.e. matches)
848    2. Count of base file that were saved i.e. had changed.
849 - No tape record would be written for a Base file that matches, in the
850   same way that no tape record is written for Incremental jobs where
851   the file is not saved because it is unchanged.
852 - On a restore, all the Base file records must explicitly be
853   found from the BaseFile tape. I.e. for each Full save that is marked
854   to have one or more Base Jobs, search the BaseFile for all occurrences
855   of JobId.
856 - An optimization might be to make the BaseFile have:
857      JobId
858      BaseId
859      FileId
860   plus
861      FileIndex
862   This would avoid the need to explicitly fetch each File record for
863   the Base job.  The Base Job record will be fetched to get the
864   VolSessionId and VolSessionTime.
865 =========================================================  
866
867
868 ========================================================== 
869     Unsaved File design
870 For each Incremental job that is run, there may be files that
871 were found but not saved because they were locked (this applies
872 only to Windows). Such a system could send back to the Director
873 a list of Unsaved files.
874 Need:
875 - New UnSavedFiles table that contains:
876   JobId
877   PathId
878   FilenameId
879 - Then in the next Incremental job, the list of Unsaved Files will be
880   feed to the FD, who will ensure that they are explicitly chosen even
881   if standard date/time check would not have selected them.
882 =============================================================
883
884
885 Done: (see kernsdone for more)
886
887 === after 1.32c
888 - John's Full save failed with 1.32c FD and 1.31 Dir no FD status,
889   and no error message.
890 - Add fd and st as Console keywords.
891 - Recycling volume with a Slot requires an operator intervention:
892     rufus-dir: Start Backup JobId 18, Job=kernsave.2003-11-01_21.23.52
893     rufus-dir: Pruned 1 Job on Volume Vol01 from catalog.
894     rufus-dir: There are no Jobs associated with Volume Vol01. Marking it purged.
895     rufus-dir: Recycled volume "Vol01"
896     rufus-sd: Please mount Volume "Vol01" on Storage Device "DDS-4" for Job kernsave.2003-11-01_21.23.52
897     Use "mount" command to release Job.
898 - Implement Dan's bacula script (email of 26 Oct).
899 - Add JobName= to VerifyToCatalog so that all verifies can be done at the end.
900 - Edit the Client/Storage name into authentication failure messages.
901 - Fix packet too big problem. This is most likely a Windows TCP stack 
902   problem.
903 - Implement ClientRunBeforeJob and ClientRunAfterJob.
904 - Implement forward spacing block/file: position_device(bsr) --
905   just before read_block_from_device();
906
907 =====
908    Multiple drive autochanger data:  see Alan Brown
909    mtx -f xxx unloadStorage Element 1 is Already Full(drive 0 was empty)
910    Unloading Data Transfer Element into Storage Element 1...source Element 
911    Address 480 is Empty
912
913    (drive 0 was empty and so was slot 1)
914    >   mtx -f xxx load 15 0
915    no response, just returns to the command prompt when complete.
916    >   mtx -f xxx status  Storage Changer /dev/changer:2 Drives, 60 Slots ( 2 Import/Export )
917    Data Transfer Element 0:Full (Storage Element 15 Loaded):VolumeTag = HX001
918    Data Transfer Element 1:Empty
919          Storage Element 1:Empty
920          Storage Element 2:Full :VolumeTag=HX002
921          Storage Element 3:Full :VolumeTag=HX003
922          Storage Element 4:Full :VolumeTag=HX004
923          Storage Element 5:Full :VolumeTag=HX005
924          Storage Element 6:Full :VolumeTag=HX006
925          Storage Element 7:Full :VolumeTag=HX007
926          Storage Element 8:Full :VolumeTag=HX008
927          Storage Element 9:Full :VolumeTag=HX009
928          Storage Element 10:Full :VolumeTag=HX010
929          Storage Element 11:Empty
930          Storage Element 12:Empty
931          Storage Element 13:Empty
932          Storage Element 14:Empty
933          Storage Element 15:Empty
934          Storage Element 16:Empty....
935          Storage Element 28:Empty
936          Storage Element 29:Full :VolumeTag=CLNU01L1
937          Storage Element 30:Empty....
938          Storage Element 57:Empty
939          Storage Element 58:Full :VolumeTag=NEX261L2
940          Storage Element 59 IMPORT/EXPORT:Empty
941          Storage Element 60 IMPORT/EXPORT:Empty
942    $  mtx -f xxx unload
943    Unloading Data Transfer Element into Storage Element 15...done
944
945    (just to verify it remembers where it came from, however it can be
946     overrriden with mtx unload {slotnumber} to go to any storage slot.)
947    Configuration wise:
948    There needs to be a table of drive # to devices somewhere - If there are
949    multiple changers or drives there may not be a 1:1 correspondance between
950    changer drive number and system device name - and depending on the way the
951    drives are hooked up to scsi busses, they may not be linearly numbered
952    from an offset point either.something like 
953
954    Autochanger drives = 2
955    Autochanger drive 0 = /dev/nst1
956    Autochanger drive 1 = /dev/nst2
957    IMHO, it would be _safest_ to use explicit mtx unload commands at all
958    times, not just for multidrive changers. For a 1 drive changer, that's
959    just:
960
961    mtx load xx 0
962    mtx unload xx 0
963
964    MTX's manpage (1.2.15):
965          unload [<slotnum>] [ <drivenum> ]
966                     Unloads media from drive  <drivenum>  into  slot
967                     <slotnum>. If <drivenum> is omitted, defaults to
968                     drive 0 (as do all commands).  If  <slotnum>  is
969                     omitted, defaults to the slot that the drive was
970                     loaded from. Note that there's currently no  way
971                     to  say  'unload  drive 1's media to the slot it
972                     came from', other than to  explicitly  use  that
973                     slot number as the destination.AB
974 ====
975
976 ====
977 SCSI info:
978 FreeBSD
979 undef# camcontrol devlist
980 <WANGTEK 51000  SCSI M74H 12B3>    at scbus0 target 2 lun 0 (pass0,sa0)
981 <ARCHIVE 4586XX 28887-XXX 4BGD>    at scbus0 target 4 lun 0 (pass1,sa1)
982 <ARCHIVE 4586XX 28887-XXX 4BGD>    at scbus0 target 4 lun 1 (pass2)
983
984 tapeinfo -f /dev/sg0 with a bad tape in drive 1:
985 [kern@rufus mtx-1.2.17kes]$ ./tapeinfo -f /dev/sg0
986 Product Type: Tape Drive
987 Vendor ID: 'HP      '
988 Product ID: 'C5713A          '
989 Revision: 'H107'
990 Attached Changer: No
991 TapeAlert[3]:   Hard Error: Uncorrectable read/write error.
992 TapeAlert[20]:    Clean Now: The tape drive neads cleaning NOW.
993 MinBlock:1
994 MaxBlock:16777215
995 SCSI ID: 5
996 SCSI LUN: 0
997 Ready: yes
998 BufferedMode: yes
999 Medium Type: Not Loaded
1000 Density Code: 0x26
1001 BlockSize: 0
1002 DataCompEnabled: yes
1003 DataCompCapable: yes
1004 DataDeCompEnabled: yes
1005 CompType: 0x20
1006 DeCompType: 0x0
1007 Block Position: 0
1008 =====
1009
1010 ====
1011    Handling removable disks
1012
1013    From: Karl Cunningham <karlc@keckec.com>
1014
1015    My backups are only to hard disk these days, in removable bays. This is my
1016    idea of how a backup to hard disk would work more smoothly. Some of these
1017    things Bacula does already, but I mention them for completeness. If others
1018    have better ways to do this, I'd like to hear about it.
1019
1020    1. Accommodate several disks, rotated similar to how tapes are.  Identified
1021    by partition volume ID or perhaps by the name of a subdirectory.
1022    2. Abort & notify the admin if the wrong disk is in the bay.
1023    3. Write backups to different subdirectories for each machine to be backed
1024    up.
1025    4. Volumes (files) get created as needed in the proper subdirectory, one
1026    for each backup.
1027    5. When a disk is recycled, remove or zero all old backup files. This is
1028    important as the disk being recycled may be close to full. This may be
1029    better done manually since the backup files for many machines may be
1030    scattered in many subdirectories.
1031 ====
1032
1033
1034 === Done
1035 - Save mount point for directories not traversed with onefs=yes.
1036 - Add seconds to start and end times in the Job report output.
1037 - if 2 concurrent backups are attempted on the same tape
1038   drive (autoloader) into different tape pools, one of them will exit
1039   fatally instead of halting until the drive is idle
1040 - Update StartTime if job held in Job Queue.
1041 - Look at www.nu2.nu/pebuilder as a helper for full windows
1042   bare metal restore. (done by Scott)