4 \chapter{The Windows Version of Bacula}
6 \index[general]{Windows Version of Bacula}
8 At the current time only the File daemon or Client program has
9 been thouroughly tested on Windows and is suitable for a
10 production environment. As a consequence, when we
11 speak of the Windows version of Bacula below, we are referring to
12 the File daemon (client) only.
14 As of Bacula version 1.39.20 or greater, the installer is capable
15 of installing not just the Client program, but also the Director
16 and the Storage daemon and all the other programs that were
17 previously available only on Unix systems. These additional
18 programs, notably the Director and Storage daemon, have been partially
19 tested, are reported to have some bugs, and still need to be documented.
20 They are not yet supported, and we cannot currently accept or fix
21 bug reports on them. Consequently, please test them carefully before putting
22 them into a critical production environment.
24 The Windows version of the Bacula File daemon has been tested on Win98, WinMe,
25 WinNT, WinXP, Win2000, and Windows 2003 systems. We have coded to support
26 Win95, but no longer have a system for testing. The Windows version of
27 Bacula is a native Win32 port, but there are very few source code changes
28 to the Unix code, which means that the Windows version is for the most part
29 running code that has long proved stable on Unix systems. When running, it
30 is perfectly integrated with Windows and displays its icon in the system
31 icon tray, and provides a system tray menu to obtain additional information
32 on how Bacula is running (status and events dialog boxes). If so desired,
33 it can also be stopped by using the system tray menu, though this should
34 normally never be necessary.
36 Once installed Bacula normally runs as a system service. This means that it is
37 immediately started by the operating system when the system is booted, and
38 runs in the background even if there is no user logged into the system.
40 \section{Win32 Installation}
42 \index[general]{Installation}
43 \index[general]{Win32!Installation}
45 Normally, you will install the Windows version of Bacula from the binaries.
46 This install is standard Windows .exe that runs an install wizard using the
47 NSIS Free Software installer, so if you have already installed Windows
48 software, it should be very familiar to you.
50 If you have a previous version Bacula (1.39.20 or lower)
51 installed, you should stop the service, uninstall it, and remove
52 the Bacula installation directory possibly saving your
53 bacula-fd.conf, bconsole.conf, and bwx-console.conf files
54 for use with the new version you will install. The Uninstall
55 program is normally found in {\bf c:\textbackslash{}bacula\textbackslash{}Uninstall.exe}.
56 We also recommend that you completely remove the directory
57 {\bf c:\textbackslash{}bacula}, because the current installer
58 uses a different directory structure (see below).
60 Providing you do not already have Bacula installed,
61 the new installer (1.39.22 and later) installs the binaries and dlls in
62 c:\textbackslash{}Program Files\textbackslash{}Bacula\textbackslash{}bin
63 and the configuration files
64 in c:\textbackslash{}Documents and Settings\textbackslash{}All Users\textbackslash{}Application Data\textbackslash{}Bacula
65 In addition, the {\bf Start\-\gt{}All Programs\-\gt{}Bacula} menu item
66 will be created during the installation, and on that menu, you
67 will find items for editing the configuration files, displaying
68 the document, and starting bwx-console or bconsole.
71 Finally, proceed with the installation.
74 \item You must be logged in as Administrator to the local machine
75 to do a correct installation, if not, please do so before continuing.
76 Some users have attempted to install logged in as a domain administrator
77 account and experienced permissions problems attempting to run
78 Bacula, so we don't recommend that option.
80 \item Simply double click on the {\bf winbacula-1.xx.0.exe} NSIS install
81 icon. The actual name of the icon will vary from one release version to
84 \includegraphics{./win32-nsis.eps} winbacula-1.xx.0.exe
86 \item Once launched, the installer wizard will ask you if you want to install
89 \addcontentsline{lof}{figure}{Win32 Client Setup Wizard}
90 \includegraphics{./win32-welcome.eps}
92 \item Next you will be asked to select the installation type.
94 \addcontentsline{lof}{figure}{Win32 Installation Type}
95 \includegraphics{./win32-installation-type.eps}
98 \item If you proceed, you will be asked to select the components to be
99 installed. You may install the Bacula program (Bacula File Service) and or
100 the documentation. Both will be installed in sub-directories of the install
101 location that you choose later. The components dialog looks like the
104 \addcontentsline{lof}{figure}{Win32 Component Selection Dialog}
105 \includegraphics{./win32-pkg.eps}
106 \index[general]{Upgrading}
108 \item If you are installing for the first time, you will be asked to
109 enter some very basic information about your configuration. If
110 you are not sure what to enter, or have previously saved configuration
111 files, you can put anything you want into the fields, then either
112 replace the configuration files later with the ones saved, or edit
115 If you are upgrading an existing installation, the following will
119 \addcontentsline{lof}{figure}{Win32 Configure}
120 \includegraphics{./win32-config.eps}
122 \item While the various files are being loaded, you will see the following
125 \addcontentsline{lof}{figure}{Win32 Install Progress}
126 \includegraphics{./win32-installing.eps}
129 \item Finally, the finish dialog will appear:
131 \addcontentsline{lof}{figure}{Win32 Client Setup Completed}
132 \includegraphics{./win32-finish.eps}
137 That should complete the installation process. When the Bacula File Server is
138 ready to serve files, an icon \includegraphics{./idle.eps} representing a
139 cassette (or tape) will appear in the system tray
140 \includegraphics{./tray-icon.eps}; right click on it and a menu will appear.\\
141 \includegraphics{./menu.eps}\\
142 The {\bf Events} item is currently unimplemented, by selecting the {\bf
143 Status} item, you can verify whether any jobs are running or not.
145 When the Bacula File Server begins saving files, the color of the holes in the
146 cassette icon will change from white to green \includegraphics{./running.eps},
147 and if there is an error, the holes in the cassette icon will change to red
148 \includegraphics{./error.eps}.
150 If you are using remote desktop connections between your Windows boxes, be
151 warned that that tray icon does not always appear. It will always be visible
152 when you log into the console, but the remote desktop may not display it.
154 \section{Post Win32 Installation}
155 \index[general]{Post Win32 Installation}
156 \index[general]{Win32!Post Installation}
158 After installing Bacula and before running it, you should check the contents
159 of the configuration files to ensure that they correspond to your
160 installation. You can get to them by using:
161 the {\bf Start\-\gt{}All Programs\-\gt{}Bacula} menu item.
163 Finally, but pulling up the Task Manager (ctl-alt-del), verify that Bacula
164 is running as a process (not an Application) with User Name SYSTEM. If this is
165 not the case, you probably have not installed Bacula while running as
166 Administrator, and hence it will be unlikely that Bacula can access
167 all the system files.
169 \section{Uninstalling Bacula on Win32}
170 \index[general]{Win32!Uninstalling Bacula}
171 \index[general]{Uninstalling Bacula on Win32}
173 Once Bacula has been installed, it can be uninstalled using the standard
174 Windows Add/Remove Programs dialog found on the Control panel.
176 \section{Dealing with Win32 Problems}
178 \index[general]{Win32!Dealing with Problems}
179 \index[general]{Dealing with Win32 Problems}
181 Sometimes Win32 machines the File daemon may have very slow
182 backup transfer rates compared to other machines. To you might
183 try setting the Maximum Network Buffer Size to 32,768 in both the
184 File daemon and in the Storage daemon. The default size is larger,
185 and apparently some Windows ethernet controllers do not deal with
186 a larger network buffer size.
188 Many Windows ethernet drivers have a tendency to either run slowly
189 due to old broken firmware, or because they are running in half-duplex
190 mode. Please check with the ethernet card manufacturer for the latest
191 firmware and use whatever techniques are necessary to ensure that the
192 card is running in duplex.
194 If you are not using the portable option, and you have VSS
195 (Volume Shadow Copy) enabled in the Director, and you experience
196 problems with Bacula not being able to open files, it is most
197 likely that you are running an antivirus program that blocks
198 Bacula from doing certain operations. In this case, disable the
199 antivirus program and try another backup. If it succeeds, either
200 get a different (better) antivirus program or use something like
201 RunClientJobBefore/After to turn off the antivirus program while
202 the backup is running.
204 If turning off anti-virus software does not resolve your VSS
205 problems, you might have to turn on VSS debugging. The following
206 link describes how to do this:
207 \elink{http://support.microsoft.com/kb/887013/en-us}{\url{http://support.microsoft.com/kb/887013/en-us}}.
209 In Microsoft Windows Small Business Server 2003 the VSS Writer for Exchange
210 is turned off by default. To turn it on, please see the following link:
211 \elink{http://support.microsoft.com/default.aspx?scid=kb;EN-US;Q838183}{\url{
212 http://support.microsoft.com/default.aspx?scid=kb;EN-US;Q838183}}
215 The most likely source of problems is authentication when the Director
216 attempts to connect to the File daemon that you installed. This can occur if
217 the names and the passwords defined in the File daemon's configuration file
218 {\bf bacula-fd.conf} file on
219 the Windows machine do not match with the names and the passwords in the
220 Director's configuration file {\bf bacula-dir.conf} located on your Unix/Linux
223 More specifically, the password found in the {\bf Client} resource in the
224 Director's configuration file must be the same as the password in the {\bf
225 Director} resource of the File daemon's configuration file. In addition, the
226 name of the {\bf Director} resource in the File daemon's configuration file
227 must be the same as the name in the {\bf Director} resource of the Director's
230 It is a bit hard to explain in words, but if you understand that a Director
231 normally has multiple Clients and a Client (or File daemon) may permit access
232 by multiple Directors, you can see that the names and the passwords on both
233 sides must match for proper authentication.
235 One user had serious problems with the configuration file until he realized
236 that the Unix end of line conventions were used and Bacula wanted them in
237 Windows format. This has not been confirmed though, and Bacula version 2.0.0
238 and above should now accept all end of line conventions (Win32,
241 Running Unix like programs on Windows machines is a bit frustrating because
242 the Windows command line shell (DOS Window) is rather primitive. As a
243 consequence, it is not generally possible to see the debug information and
244 certain error messages that Bacula prints. With a bit of work, however, it is
245 possible. When everything else fails and you want to {\bf see} what is going
246 on, try the following:
250 Start a DOS shell Window.
251 c:\Program Files\bacula\bin\bacula-fd -t >out
256 The precise path to bacula-fd depends on where it is installed. The
257 example above is the default used in 1.39.22 and later.
258 The {\bf -t} option will cause Bacula to read the configuration file, print
259 any error messages and then exit. the {\bf \gt{}} redirects the output to the
260 file named {\bf out}, which you can list with the {\bf type} command.
262 If something is going wrong later, or you want to run {\bf Bacula} with a
263 debug option, you might try starting it as:
267 c:\Program Files\bacula\bin\bacula-fd -d 100 >out
271 In this case, Bacula will run until you explicitly stop it, which will give
272 you a chance to connect to it from your Unix/Linux server. In later versions
273 of Bacula (1.34 on, I think), when you start the File daemon in debug mode it
274 can write the output to a trace file {\bf bacula.trace} in the current
275 directory. To enable this, before running a job, use the console, and enter:
283 then run the job, and once you have terminated the File daemon, you will find
284 the debug output in the {\bf bacula.trace} file, which will probably be
285 located in the same directory as bacula-fd.exe.
287 In addition, you should look in the System Applications log on the Control
288 Panel to find any Windows errors that Bacula got during the startup process.
290 Finally, due to the above problems, when you turn on debugging, and specify
291 trace=1 on a setdebug command in the Console, Bacula will write the debug
292 information to the file {\bf bacula.trace} in the directory from which Bacula
295 If you are having problems with ClientRunBeforeJob scripts randomly dying,
296 it is possible that you have run into an Oracle bug. See bug number 622 in
297 the bugs.bacula.org database. The following information has been
298 provided by a user on this issue:
302 The information in this document applies to:
303 Oracle HTTP Server - Version: 9.0.4
304 Microsoft Windows Server 2003
306 When starting an OC4J instance, the System Clock runs faster, about 7
311 + This is caused by the Sun JVM bug 4500388, which states that "Calling
312 Thread.sleep() with a small argument affects the system clock". Although
313 this is reported as fixed in JDK 1.4.0_02, several reports contradict this
315 http://bugs.sun.com/bugdatabase/view_bug.do?bug_id=4500388).
317 + Also reported by Microsoft as "The system clock may run fast when you
318 use the ACPI power management timer as a high-resolution counter on Windows
319 2000-based computers" (See http://support.microsoft.com/?id=821893)
323 \label{Compatibility}
324 \section{Windows Compatibility Considerations}
325 \index[general]{Windows Compatibility Considerations}
326 \index[general]{Considerations!Windows Compatibility}
328 If you are not using the VSS (Volume Shadow Copy) option described in the
329 next section of this chapter, and if any applications are running during
330 the backup and they have files opened exclusively, Bacula will not be able
331 to backup those files, so be sure you close your applications (or tell your
332 users to close their applications) before the backup. Fortunately, most
333 Microsoft applications do not open files exclusively so that they can be
334 backed up. However, you will need to experiment. In any case, if Bacula
335 cannot open the file, it will print an error message, so you will always
336 know which files were not backed up. For version 1.37.25 and greater, see
337 the section below on Volume Shadow Copy Service that permits backing up any
340 During backup, Bacula doesn't know about the system registry, so you will
341 either need to write it out to an ASCII file using {\bf regedit~~/e} or use a
342 program specifically designed to make a copy or backup the registry.
344 In Bacula version 1.31 and later, we use Windows backup API calls by
345 default. Typical of Windows, programming these special BackupRead and
346 BackupWrite calls is a real nightmare of complications. The end result
347 gives some distinct advantages and some disadvantages.
349 First, the advantages are that on WinNT/2K/XP systems, the security and
350 ownership information is now backed up. In addition, with the exception of
351 files in exclusive use by another program, Bacula can now access all system
352 files. This means that when you restore files, the security and ownership
353 information will be restored on WinNT/2K/XP along with the data.
355 The disadvantage of the Windows backup API calls is that it produces
356 non-portable backups. That is files and their data that are backed up on
357 WinNT using the native API calls (BackupRead/BackupWrite) cannot be
358 restored on Win95/98/Me or Unix systems. In principle, a file backed up on
359 WinNT can be restored on WinXP, but this remains to be seen in practice
360 (not yet tested). In addition, the stand-alone tools such as {\bf bls} and
361 {\bf bextract} cannot be used to retrieve the data for those files because
362 those tools are not available on Windows. All restores must use the Bacula
363 {\bf restore} command. As of Bacula 1.39.x, thanks to Thorsten Engel, this
364 restriction is removed, and Bacula should be able to read non-portable
365 backups on any system and restore the data appropriately. However,
366 on a system that does not have the BackupRead/BackupWrite calls (older
367 Windows versions and all Unix/Linux machines), though the file data
368 can be restored, the Windows security and access control data will not be restored.
369 This means that a standard set of access permissions will be set for
373 As a default, Bacula backs up Windows systems using the Windows API calls.
374 If you want to backup data on a WinNT/2K/XP system and restore it on a
375 Unix/Win95/98/Me system, we have provided a special {\bf portable} option
376 that backs up the data in a portable fashion by using portable API calls.
377 See the \ilink{portable option}{portable} on the Include statement in a
378 FileSet resource in the Director's configuration chapter for the details on
379 setting this option. However, using the portable option means you may have
380 permissions problems accessing files, and none of the security and
381 ownership information will be backed up or restored. The file data can,
382 however, be restored on any system.
384 You should always be able to restore any file backed up on Unix or Win95/98/Me
385 to any other system. On some systems, such as WinNT/2K/XP, you may have to
386 reset the ownership of such restored files. Any file backed up on WinNT/2K/XP
387 should in principle be able to be restored to a similar system (i.e.
388 WinNT/2K/XP), however, I am unsure of the consequences if the owner
389 information and accounts are not identical on both systems. Bacula will not
390 let you restore files backed up on WinNT/2K/XP to any other system (i.e. Unix
391 Win95/98/Me) if you have used the defaults.
393 Finally, if you specify the {\bf portable=yes} option on the files you back
394 up. Bacula will be able to restore them on any other system. However, any
395 WinNT/2K/XP specific security and ownership information will be lost.
397 The following matrix will give you an idea of what you can expect. Thanks to
398 Marc Brueckner for doing the tests:
400 \addcontentsline{lot}{table}{WinNT/2K/XP Restore Portability Status}
401 \begin{longtable}{|l|l|p{2.8in}|}
403 \multicolumn{1}{|c|}{\bf Backup OS} & \multicolumn{1}{c|}{\bf Restore OS}
404 & \multicolumn{1}{c|}{\bf Results } \\
405 \hline {WinMe} & {WinMe} & {Works } \\
406 \hline {WinMe} & {WinNT} & {Works (SYSTEM permissions) } \\
407 \hline {WinMe} & {WinXP} & {Works (SYSTEM permissions) } \\
408 \hline {WinMe} & {Linux} & {Works (SYSTEM permissions) } \\
409 \hline {\ } & {\ } & {\ } \\
410 \hline {WinXP} & {WinXP} & {Works } \\
411 \hline {WinXP} & {WinNT} & {Works (all files OK, but got "The data is invalid"
413 \hline {WinXP} & {WinMe} & {Error: Win32 data stream not supported. } \\
414 \hline {WinXP} & {WinMe} & {Works if {\bf Portable=yes} specified during backup.} \\
415 \hline {WinXP} & {Linux} & {Error: Win32 data stream not supported. } \\
416 \hline {WinXP} & {Linux} & {Works if {\bf Portable=yes} specified during backup.}\\
417 \hline {\ } & {\ } & {\ } \\
418 \hline {WinNT} & {WinNT} & {Works } \\
419 \hline {WinNT} & {WinXP} & {Works } \\
420 \hline {WinNT} & {WinMe} & {Error: Win32 data stream not supported. } \\
421 \hline {WinNT} & {WinMe} & {Works if {\bf Portable=yes} specified during backup.}\\
422 \hline {WinNT} & {Linux} & {Error: Win32 data stream not supported. } \\
423 \hline {WinNT} & {Linux} & {Works if {\bf Portable=yes} specified during backup. }\\
424 \hline {\ } & {\ } & {\ } \\
425 \hline {Linux} & {Linux} & {Works } \\
426 \hline {Linux} & {WinNT} & {Works (SYSTEM permissions) } \\
427 \hline {Linux} & {WinMe} & {Works } \\
428 \hline {Linux} & {WinXP} & {Works (SYSTEM permissions)}
432 Note: with Bacula versions 1.39.x and later, non-portable Windows data can
433 be restore to any machine.
437 \section{Volume Shadow Copy Service}
438 \index[general]{Volume Shadow Copy Service}
440 In version 1.37.30 and greater, you can turn on Microsoft's Volume
441 Shadow Copy Service (VSS).
443 Microsoft added VSS to Windows XP and Windows 2003. From the perspective of
444 a backup-solution for Windows, this is an extremely important step. VSS
445 allows Bacula to backup open files and even to interact with applications like
446 RDBMS to produce consistent file copies. VSS aware applications are called
447 VSS Writers, they register with the OS so that when Bacula wants to do a
448 Snapshot, the OS will notify the register Writer programs, which may then
449 create a consistent state in their application, which will be backed up.
450 Examples for these writers are "MSDE" (Microsoft database
451 engine), "Event Log Writer", "Registry Writer" plus 3rd
452 party-writers. If you have a non-vss aware application (e.g.
453 SQL Anywhere or probably MySQL), a shadow copy is still generated
454 and the open files can be backed up, but there is no guarantee
455 that the file is consistent.
457 Bacula produces a message from each of the registered writer programs
458 when it is doing a VSS backup so you know which ones are correctly backed
461 Bacula supports VSS on both Windows 2003 and Windows XP.
462 Technically Bacula creates a shadow copy as soon as the backup process
463 starts. It does then backup all files from the shadow copy and destroys the
464 shadow copy after the backup process. Please have in mind, that VSS
465 creates a snapshot and thus backs up the system at the state it had
466 when starting the backup. It will disregard file changes which occur during
469 VSS can be turned on by placing an
471 \index[dir]{Enable VSS}
472 \index[general]{Enable VSS}
477 in your FileSet resource.
479 The VSS aware File daemon has the letters VSS on the signon line that
480 it produces when contacted by the console. For example:
482 Tibs-fd Version: 1.37.32 (22 July 2005) VSS Windows XP MVS NT 5.1.2600
484 the VSS is shown in the line above. This only means that the File daemon
485 is capable of doing VSS not that VSS is turned on for a particular backup.
486 There are two ways of telling if VSS is actually turned on during a backup.
487 The first is to look at the status output for a job, e.g.:
491 JobId 1 Job NightlySave.2005-07-23_13.25.45 is running.
492 VSS Backup Job started: 23-Jul-05 13:25
493 Files=70,113 Bytes=3,987,180,650 Bytes/sec=3,244,247
494 Files Examined=75,021
495 Processing file: c:/Documents and Settings/kern/My Documents/My Pictures/Misc1/Sans titre - 39.pdd
499 Here, you see under Running Jobs that JobId 1 is "VSS Backup Job started ..."
500 This means that VSS is enabled for that job. If VSS is not enabled, it will
501 simply show "Backup Job started ..." without the letters VSS.
503 The second way to know that the job was backed up with VSS is to look at the
504 Job Report, which will look something like the following:
507 23-Jul 13:25 rufus-dir: Start Backup JobId 1, Job=NightlySave.2005-07-23_13.25.45
508 23-Jul 13:26 rufus-sd: Wrote label to prelabeled Volume "TestVolume001" on device "DDS-4" (/dev/nst0)
509 23-Jul 13:26 rufus-sd: Spooling data ...
510 23-Jul 13:26 Tibs: Generate VSS snapshots. Driver="VSS WinXP", Drive(s)="C"
511 23-Jul 13:26 Tibs: VSS Writer: "MSDEWriter", State: 1 (VSS_WS_STABLE)
512 23-Jul 13:26 Tibs: VSS Writer: "Microsoft Writer (Bootable State)", State: 1 (VSS_WS_STABLE)
513 23-Jul 13:26 Tibs: VSS Writer: "WMI Writer", State: 1 (VSS_WS_STABLE)
514 23-Jul 13:26 Tibs: VSS Writer: "Microsoft Writer (Service State)", State: 1 (VSS_WS_STABLE)
517 In the above Job Report listing, you see that the VSS snapshot was generated for drive C (if
518 other drives are backed up, they will be listed on the {\bf Drive(s)="C"} You also see the
519 reports from each of the writer program. Here they all report VSS\_WS\_STABLE, which means
520 that you will get a consistent snapshot of the data handled by that writer.
522 \section{VSS Problems}
523 \index[general]{Problems!VSS}
524 \index[fd] {Problems!VSS}
525 \index[general]{VSS Problems}
526 \index[fd]{VSS Problems}
528 If you are experiencing problems such as VSS hanging on MSDE, first try
529 running {\bf vssadmin} to check for problems, then try running {\bf
530 ntbackup} which also uses VSS to see if it has similar problems. If so, you
531 know that the problem is in your Windows machine and not with Bacula.
533 The FD hang problems were reported with {\bf MSDEwriter} when:
535 \item a local firewall locked local access to the MSDE TCP port (MSDEwriter
536 seems to use TCP/IP and not Named Pipes).
537 \item msdtcs was installed to run under "localsystem": try running msdtcs
538 under networking account (instead of local system) (com+ seems to work
539 better with this configuration).
543 \section{Windows Firewalls}
544 \index[general]{Firewalls!Windows}
545 \index[general]{Windows Firewalls}
547 If you turn on the firewalling feature on Windows (default in WinXP SP2), you
548 are likely to find that the Bacula ports are blocked and you cannot
549 communicate to the other daemons. This can be deactivated through the {\bf
550 Security Notification} dialog, which is apparently somewhere in the {\bf
551 Security Center}. I don't have this on my computer, so I cannot give the exact
558 netsh firewall set opmode disable
562 is purported to disable the firewall, but this command is not accepted on my
565 \section{Windows Port Usage}
566 \index[general]{Windows Port Usage}
567 \index[general]{Usage!Windows Port}
569 If you want to see if the File daemon has properly opened the port and is
570 listening, you can enter the following command in a shell window:
574 netstat -an | findstr 910[123]
578 TopView is another program that has been recommend, but it is not a
579 standard Win32 program, so you must find and download it from the Internet.
581 \section{Windows Disaster Recovery}
582 \index[general]{Recovery!Windows Disaster}
583 \index[general]{Windows Disaster Recovery}
585 We don't currently have a good solution for disaster recovery on Windows as we
586 do on Linux. The main piece lacking is a Windows boot floppy or a Windows boot
587 CD. Microsoft releases a Windows Pre-installation Environment ({\bf WinPE})
588 that could possibly work, but we have not investigated it. This means that
589 until someone figures out the correct procedure, you must restore the OS from
590 the installation disks, then you can load a Bacula client and restore files.
591 Please don't count on using {\bf bextract} to extract files from your backup
592 tapes during a disaster recovery unless you have backed up those files using
593 the {\bf portable} option. {\bf bextract} does not run on Windows, and the
594 normal way Bacula saves files using the Windows API prevents the files from
595 being restored on a Unix machine. Once you have an operational Windows OS
596 loaded, you can run the File daemon and restore your user files.
599 \ilink{ Disaster Recovery of Win32 Systems}{Win3233} for the latest
600 suggestion, which looks very promising.
602 It looks like Bart PE Builder, which creates a Windows PE (Pre-installation
603 Environment) Boot-CD, may be just what is needed to build a complete disaster
604 recovery system for Win32. This distribution can be found at
605 \elink{http://www.nu2.nu/pebuilder/}{\url{http://www.nu2.nu/pebuilder/}}.
607 \section{Windows Restore Problems}
608 \index[general]{Problems!Windows Restore}
609 \index[general]{Windows Restore Problems}
611 \ilink{Restore Chapter}{Windows} of this manual for problems
612 that you might encounter doing a restore.
614 section{Windows Backup Problems}
615 \index[general]{Problems!Windows Backup}
616 \index[general]{Windows Backup Problems}
617 If during a Backup, you get the message:
618 {\bf ERR=Access is denied} and you are using the portable option,
619 you should try both adding both the non-portable (backup API) and
620 the Volume Shadow Copy options to your Director's conf file.
622 In the Options resource:
629 In the FileSet resource:
636 In general, specifying these two options should allow you to backup
637 any file on a Windows system. However, in some cases, if users
638 have allowed to have full control of their folders, even system programs
639 such a Bacula can be locked out. In this case, you must identify
640 which folders or files are creating the problem and do the following:
643 \item Grant ownership of the file/folder to the Administrators group,
644 with the option to replace the owner on all child objects.
645 \item Grant full control permissions to the Administrators group,
646 and change the user's group to only have Modify permission to
647 the file/folder and all child objects.
650 Thanks to Georger Araujo for the above information.
652 \section{Windows Ownership and Permissions Problems}
653 \index[general]{Problems!Windows Ownership and Permissions}
654 \index[general]{Windows Ownership and Permissions Problems}
656 If you restore files backed up from WinNT/XP/2K to an alternate directory,
657 Bacula may need to create some higher level directories that were not saved
658 (or restored). In this case, the File daemon will create them under the SYSTEM
659 account because that is the account that Bacula runs under as a service. As of
660 version 1.32f-3, Bacula creates these files with full access permission.
661 However, there may be cases where you have problems accessing those files even
662 if you run as administrator. In principle, Microsoft supplies you with the way
663 to cease the ownership of those files and thus change the permissions.
664 However, a much better solution to working with and changing Win32 permissions
665 is the program {\bf SetACL}, which can be found at
666 \elink{http://setacl.sourceforge.net/}{\url{http://setacl.sourceforge.net/}}.
668 If you have not installed Bacula while running as Administrator
669 and if Bacula is not running as a Process with the userid (User Name) SYSTEM,
670 then it is very unlikely that it will have sufficient permission to
671 access all your files.
673 Some users have experienced problems restoring files that participate in
674 the Active Directory. They also report that changing the userid under which
675 Bacula (bacula-fd.exe) runs, from SYSTEM to a Domain Admin userid, resolves
679 \section{Manually resetting the Permissions}
680 \index[general]{Manually resetting the Permissions}
681 \index[general]{Permissions!Manually resetting the}
683 The following solution was provided by Dan Langille \lt{}dan at langille in
684 the dot org domain\gt{}. The steps are performed using Windows 2000 Server but
685 they should apply to most Win32 platforms. The procedure outlines how to deal
686 with a problem which arises when a restore creates a top-level new directory.
687 In this example, "top-level" means something like {\bf
688 c:\textbackslash{}src}, not {\bf c:\textbackslash{}tmp\textbackslash{}src}
689 where {\bf c:\textbackslash{}tmp} already exists. If a restore job specifies /
690 as the {\bf Where:} value, this problem will arise.
692 The problem appears as a directory which cannot be browsed with Windows
693 Explorer. The symptoms include the following message when you try to click on
696 \includegraphics{./access-is-denied.eps}
698 If you encounter this message, the following steps will change the permissions
699 to allow full access.
702 \item right click on the top level directory (in this example, {\bf c:/src})
703 and select {\bf Properties}.
704 \item click on the Security tab.
705 \item If the following message appears, you can ignore it, and click on {\bf
708 \includegraphics{./view-only.eps}
710 You should see something like this:
712 \includegraphics{./properties-security.eps}
713 \item click on Advanced
714 \item click on the Owner tab
715 \item Change the owner to something other than the current owner (which is
716 {\bf SYSTEM} in this example as shown below).
718 \includegraphics{./properties-security-advanced-owner.eps}
719 \item ensure the "Replace owner on subcontainers and objects" box is
722 \item When the message "You do not have permission to read the contents of
723 directory c:\textbackslash{}src\textbackslash{}basis. Do you wish to replace
724 the directory permissions with permissions granting you Full Control?", click
727 \includegraphics{./confirm.eps}
728 \item Click on OK to close the Properties tab
731 With the above procedure, you should now have full control over your restored
734 In addition to the above methods of changing permissions, there is a Microsoft
735 program named {\bf cacls} that can perform similar functions.
737 \section{Backing Up the WinNT/XP/2K System State}
738 \index[general]{State!Backing Up the WinNT/XP/2K System}
739 \index[general]{Backing Up the WinNT/XP/2K System State}
741 A suggestion by Damian Coutts using Microsoft's NTBackup utility in
742 conjunction with Bacula should permit a full restore of any damaged system
743 files on Win2K/XP. His suggestion is to do an NTBackup of the critical system
744 state prior to running a Bacula backup with the following command:
748 ntbackup backup systemstate /F c:\systemstate.bkf
752 The {\bf backup} is the command, the {\bf systemstate} says to backup only the
753 system state and not all the user files, and the {\bf /F
754 c:\textbackslash{}systemstate.bkf} specifies where to write the state file.
755 this file must then be saved and restored by Bacula.
757 To restore the system state, you first reload a base operating system if the
758 OS is damaged, otherwise, this is not necessary, then you would use Bacula to
759 restore all the damaged or lost user's files and to recover the {\bf
760 c:\textbackslash{}systemstate.bkf} file. Finally if there are any damaged or
761 missing system files or registry problems, you run {\bf NTBackup} and {\bf
762 catalogue} the system statefile, and then select it for restore. The
763 documentation says you can't run a command line restore of the systemstate.
765 To the best of my knowledge, this has not yet been tested. If you test it,
766 please report your results to the Bacula email list.
768 \section{Considerations for Filename Specifications}
769 \index[general]{Windows!Considerations for Filename Specifications}
772 \ilink{Director's Configuration chapter}{win32} of this manual
773 for important considerations on how to specify Windows paths in Bacula FileSet
774 Include and Exclude directives.
776 \index[general]{Unicode}
777 Bacula versions prior to 1.37.28 do not support Windows Unicode filenames.
778 As of that version, both {\bf bconsole} and {\bf bwx-console} support Windows
779 Unicode filenames. There may still be some problems with multiple byte
780 characters (e.g. Chinese, ...) where it is a two byte character but the
781 displayed character is not two characters wide.
783 \index[general]{Win32 Path Length Restriction}
784 Path/filenames longer than 260 characters (up to 32,000) are supported
785 beginning with Bacula version 1.39.20. Older Bacula versions support
786 only 260 character path/filenames.
788 \section{Win32 Specific File daemon Command Line}
789 \index[general]{Client!Win32 Specific File daemon Command Line Options}
790 \index[general]{Win32 Specific File daemon Command Line Options}
792 These options are not normally seen or used by the user, and are documented
793 here only for information purposes. At the current time, to change the default
794 options, you must either manually run {\bf Bacula} or you must manually edit
795 the system registry and modify the appropriate entries.
797 In order to avoid option clashes between the options necessary for {\bf
798 Bacula} to run on Windows and the standard Bacula options, all Windows
799 specific options are signaled with a forward slash character (/), while as
800 usual, the standard Bacula options are signaled with a minus (-), or a minus
801 minus (\verb:--:). All the standard Bacula options can be used on the Windows
802 version. In addition, the following Windows only options are implemented:
808 Start Bacula as a service
812 Run the Bacula application
816 Install Bacula as a service in the system registry
820 Uninstall Bacula from the system registry
824 Show the Bacula about dialogue box
828 Show the Bacula status dialogue box
832 Show the Bacula events dialogue box (not yet implemented)
836 Stop any running {\bf Bacula}
840 Show the Bacula help dialogue box
843 It is important to note that under normal circumstances the user should never
844 need to use these options as they are normally handled by the system
845 automatically once Bacula is installed. However, you may note these options in
846 some of the .bat files that have been created for your use.
848 \section{Shutting down Windows Systems}
849 \index[general]{Shutting down Windows Systems}
850 \index[general]{Systems!Shutting down Windows}
852 Some users like to shutdown their Windows machines after a backup using a
853 Client Run After Job directive. If you want to do something similar, you might
854 take the shutdown program from the
855 \elink{apcupsd project}{\url{http://www.apcupsd.com}} or one from the
856 \elink{Sysinternals project}
857 {\url{http://www.sysinternals.com/ntw2k/freeware/psshutdown.shtml}}.