]> git.sur5r.net Git - bacula/docs/blob - docs/manual/win32.tex
Corrected minor LaTeX errors in manual
[bacula/docs] / docs / manual / win32.tex
1 %%
2 %%
3
4 \section*{The Windows Version of Bacula}
5 \label{_ChapterStart7}
6 \index[general]{Windows Version of Bacula }
7 \addcontentsline{toc}{section}{Windows Version of Bacula}
8
9 \subsection*{General}
10 \index[general]{General }
11 \addcontentsline{toc}{subsection}{General}
12
13 At the current time only the File daemon or Client program has been tested on
14 Windows. As a consequence, when we speak of the Windows version of Bacula
15 below, we are referring to the File daemon only. 
16
17 The Windows version of the Bacula File daemon has been tested on Win98, WinMe,
18 WinNT, and Win2000 systems. We have coded to support Win95, but no longer have
19 a system for testing. The Windows version of Bacula is a native Win32 port,
20 but there are very few source code changes to the Unix code, which means that the Windows
21 version is for the most part running code that has long proved stable on Unix
22 systems. When running, it is perfectly integrated with Windows and displays
23 its icon in the system icon tray, and provides a system tray menu to obtain
24 additional information on how Bacula is running (status and events dialog
25 boxes). If so desired, it can also be stopped by using the system tray menu,
26 though this should normally never be necessary. 
27
28 Once installed Bacula normally runs as a system service. This means that it is
29 immediately started by the operating system when the system is booted, and
30 runs in the background even if there is no user logged into the system. 
31
32 \subsection*{Win32 Installation}
33 \label{installation}
34 \index[general]{Installation }
35 \index[general]{Win32!Installation }
36 \addcontentsline{toc}{subsection}{Win32 Installation}
37
38 Normally, you will install the Windows version of Bacula from the binaries.
39 This install is standard Windows .exe that runs an install wizard using the
40 NSIS Free Software installer, so if you have already installed Windows
41 software, it should be very familiar to you. 
42
43 If you have a previous version Cygwin of Bacula (1.32 or lower) installed, you
44 should stop the service, uninstall it, and remove the Bacula installation directory possibly
45 saving your bacula-fd.conf file for use with the new version you will install.
46 The new native version of Bacula has far fewer files than the old Cygwin
47 version, so it is better to start with a clean directory.
48
49 Finally, proceed with the installation. 
50
51 \begin{itemize}
52 \item You must be logged in as Administrator to do a correct installation,
53    if not, please do so before continuing.
54   
55 \item Simply double click on the {\bf winbacula-1.xx.0.exe}  NSIS install
56    icon. The  actual name of the icon will vary from one release version to 
57    another. 
58
59 \includegraphics{./win32-nsis.eps}  winbacula-1.xx.0.exe  
60
61 \item Once launched, the installer wizard will ask you if you want  to install
62    Bacula.  
63
64 \addcontentsline{lof}{figure}{Win32 Client Setup Wizard}
65 \includegraphics{./win32-welcome.eps}  
66
67 \item If you proceed, you will be asked to select the components to be 
68    installed. You may install the Bacula program (Bacula File Service)  and or
69    the documentation. Both will be installed in sub-directories  of the install
70    location that you choose later. The components  dialog looks like the
71    following:  
72
73 \addcontentsline{lof}{figure}{Win32 Component Selection Dialog}
74 \includegraphics{./win32-pkg.eps}  
75
76 \item Next you will be asked to select an installation directory.  
77
78    \addcontentsline{lof}{figure}{Win32 Directory Selection Dialog}
79 \includegraphics{./win32-location.eps}  
80
81 \item If you are installing for the first time, you will  be asked if you want
82    to edit the bacula-fd.conf file, and  if you respond with yes, it will be
83    opened in notepad.  
84  
85 \item Then the installer will ask if you wish to install Bacula as a  service. You
86    should always choose to do so:  
87
88 \addcontentsline{lof}{figure}{Win32 Client Service Selection}
89 \includegraphics{./win32-service.eps}  
90
91  
92 \item If everything goes well, you will receive the following  confirmation:  
93
94    \addcontentsline{lof}{figure}{Win32 Client Service Confirmation}
95    \includegraphics{./win32-service-ok.eps}  
96
97  
98 \item Then you will be asked if you wish to start the service.  If you respond
99    with yes, any running Bacula will be shutdown  and the new one started. You
100    may see a DOS box momentarily  appear on the screen as the service is started.
101    It should  disappear in a second or two:  
102
103 \addcontentsline{lof}{figure}{Win32 Client Start}
104 \includegraphics{./win32-start.eps}  
105
106
107 \item Finally, the finish dialog will appear:  
108    \addcontentsline{lof}{figure}{Win32 Client Setup Completed}
109    \includegraphics{./win32-finish.eps}  
110
111
112 \end{itemize}
113
114 That should complete the installation process. When the Bacula File Server is
115 ready to serve files, an icon \includegraphics{./idle.eps} representing a
116 cassette (or tape) will appear in the system tray
117 \includegraphics{./tray-icon.eps}; right click on it and a menu will appear.\\
118 \includegraphics{./menu.eps}\\
119 The {\bf Events} item is currently unimplemented, by selecting the {\bf
120 Status} item, you can verify whether any jobs are running or not. 
121
122 When the Bacula File Server begins saving files, the color of the holes in the
123 cassette icon will change from white to green \includegraphics{./running.eps},
124 and if there is an error, the holes in the cassette icon will change to red
125 \includegraphics{./error.eps}. 
126
127 If you are using remote desktop connections between your windows boxes, be
128 warned that that tray icon does not always appear. It will always be visible
129 when you log into the console, but the remote desktop may not display it. 
130
131 \subsection*{Post Win32 Installation}
132 \index[general]{Post Win32 Installation }
133 \index[general]{Win32!Post Installation }
134 \addcontentsline{toc}{subsection}{Post Win32 Installation}
135
136 After installing Bacula and before running it, you should check the contents
137 of {\bf
138 c:\textbackslash{}bacula\textbackslash{}bin\textbackslash{}bacula-fd.conf} to
139 ensure that it corresponds to your configuration. 
140
141 Finally, but pulling up the Task Manager (ctl-alt-del), verify that Bacula
142 is running as a process (not an Application) with User Name SYSTEM. If this is 
143 not the case, you probably have not installed Bacula while running as
144 Administrator, and hence it will be unlikely that Bacula can access
145 all the system files.
146
147 \subsection*{Uninstalling Bacula on Win32}
148 \index[general]{Win32!Uninstalling Bacula }
149 \index[general]{Uninstalling Bacula on Win32 }
150 \addcontentsline{toc}{subsection}{Uninstalling Bacula on Win32}
151
152 Once Bacula has been installed, it can be uninstalled using the standard
153 Windows Add/Remove Programs dialog found on the Control panel. 
154
155 \subsection*{Dealing with Win32 Problems}
156 \label{problems}
157 \index[general]{Win32!Dealing with Problems }
158 \index[general]{Dealing with Win32 Problems }
159 \addcontentsline{toc}{subsection}{Dealing with Win32 Problems}
160
161 The most likely source of problems is authentication when the Director
162 attempts to connect to the File daemon that you installed. This can occur if
163 the names and the passwords defined in the File daemon's configuration file
164 {\bf 
165 c:\textbackslash{}bacula\textbackslash{}bin\textbackslash{}bacula-fd.conf} on
166 the Windows machine do not match with the names and the passwords in the
167 Director's configuration file {\bf bacula-dir.conf} located on your Unix/Linux
168 server. 
169
170 More specifically, the password found in the {\bf Client} resource in the
171 Director's configuration file must be the same as the password in the {\bf
172 Director} resource of the File daemon's configuration file. In addition, the
173 name of the {\bf Director} resource in the File daemon's configuration file
174 must be the same as the name in the {\bf Director} resource of the Director's
175 configuration file. 
176
177 It is a bit hard to explain in words, but if you understand that a Director
178 normally has multiple Clients and a Client (or File daemon) may permit access
179 by multiple Directors, you can see that the names and the passwords on both
180 sides must match for proper authentication. 
181
182 One user had serious problems with the configuration file until he realized
183 that the Unix end of line conventions were used and Bacula wanted them in
184 Windows format. This has not been confirmed though. 
185
186 Running Unix like programs on Windows machines is a bit frustrating because
187 the Windows command line shell (DOS Window) is rather primitive. As a
188 consequence, it is not generally possible to see the debug information and
189 certain error messages that Bacula prints. With a bit of work, however, it is
190 possible. When everything else fails and you want to {\bf see} what is going
191 on, try the following: 
192
193 \footnotesize
194 \begin{verbatim}
195    Start a DOS shell Window.
196    cd c:\bacula\bin
197    bacula-fd -t >out
198    type out
199 \end{verbatim}
200 \normalsize
201
202 The {\bf -t} option will cause Bacula to read the configuration file, print
203 any error messages and then exit. the {\bf \gt{}} redirects the output to the
204 file named {\bf out}, which you can list with the {\bf type} command. 
205
206 If something is going wrong later, or you want to run {\bf Bacula} with a
207 debug option, you might try starting it as: 
208
209 \footnotesize
210 \begin{verbatim}
211    bacula-fd -d 100 >out
212 \end{verbatim}
213 \normalsize
214
215 In this case, Bacula will run until you explicitly stop it, which will give
216 you a chance to connect to it from your Unix/Linux server. In later versions
217 of Bacula (1.34 on, I think), when you start the File daemon in debug mode it
218 can write the output to a trace file {\bf bacula.trace} in the current
219 directory. To enable this, before running a job, use the console, and enter: 
220
221 \footnotesize
222 \begin{verbatim}
223    trace on
224 \end{verbatim}
225 \normalsize
226
227 then run the job, and once you have terminated the File daemon, you will find
228 the debug output in the {\bf bacula.trace} file. 
229
230 In addition, you should look in the System Applications log on the Control
231 Panel to find any Windows errors that Bacula got during the startup process. 
232
233 Finally, due to the above problems, when you turn on debugging, and specify
234 trace=1 on a setdebug command in the Console, Bacula will write the debug
235 information to the file {\bf bacula.trace} in the directory from which Bacula
236 is executing. 
237
238 \label{Compatibility}
239 \subsection*{Windows Compatibility Considerations}
240 \index[general]{Windows Compatibility Considerations }
241 \index[general]{Considerations!Windows Compatibility }
242 \addcontentsline{toc}{subsection}{Windows Compatibility Considerations}
243
244 If any applications are running during the backup and they have files
245 opened exclusively, Bacula will not be able to backup those files, so be
246 sure you close your applications (or tell your users to close their
247 applications) before the backup. Fortunately,
248 most Microsoft applications do not open
249 files exclusively so that they can be backed up.  However, you will need to
250 experiment.  In any case, if Bacula cannot open the file, it will print an
251 error message, so you will always know which files were not backed up.
252 For version 1.37.25 and greater, see the section below on
253 Volume Shadow Copy Service.
254
255 During backup, Bacula doesn't know about the system registry, so you will
256 either need to write it out to an ASCII file using {\bf regedit~~/e} or use a
257 program specifically designed to make a copy or backup the registry. 
258
259 In Bacula version 1.31 and later, we use Windows backup API calls by
260 default.  Typical of Windows, programming these special BackupRead and
261 BackupWrite calls is a real nightmare of complications.  The end result
262 gives some distinct advantages and some disadvantages.
263
264 First, the advantages are that on WinNT/2K/XP systems, the security and
265 ownership information is now backed up.  In addition, with the exception of
266 files in exclusive use by another program (a major disaster for backup
267 programs on Windows), Bacula can now access all system files.  This means
268 that when you restore files, the security and ownership information will be
269 restored on WinNT/2K/XP along with the data.
270
271 The disadvantage of the Windows backup API calls is that it produces
272 non-portable backups.  That is files and their data that are backed up on
273 WinNT using the native API calls (BackupRead/BackupWrite) cannot be
274 restored on Win95/98/Me or Unix systems.  In principle, a file backed up on
275 WinNT can be restored on WinXP, but this remains to be seen in practice
276 (not yet tested).  In addition, the stand-alone tools such as {\bf bls} and
277 {\bf bextract} cannot be used to retrieve the data for those files because
278 those tools are not available on Windows.  All restores must use the Bacula
279 {\bf restore} command.  This restriction is mentioned for completeness, but
280 in practice should not create any problems.
281
282 As a default, Bacula backs up Windows systems using the Windows API calls.
283 If you want to backup data on a WinNT/2K/XP system and restore it on a
284 Unix/Win95/98/Me system, we have provided a special {\bf portable} option
285 that backs up the data in a portable fashion by using portable API calls.
286 See the \ilink{portable option}{portable} on the Include statement in a
287 FileSet resource in the Director's configuration chapter for the details on
288 setting this option.  However, using the portable option means you may have
289 permissions problems accessing files, and none of the security and
290 ownership information will be backed up or restored.  The file data can,
291 however, be restored on any system.
292
293 You should always be able to restore any file backed up on Unix or Win95/98/Me
294 to any other system. On some systems, such as WinNT/2K/XP, you may have to
295 reset the ownership of such restored files. Any file backed up on WinNT/2K/XP
296 should in principle be able to be restored to a similar system (i.e.
297 WinNT/2K/XP), however, I am unsure of the consequences if the owner
298 information and accounts are not identical on both systems. Bacula will not
299 let you restore files backed up on WinNT/2K/XP to any other system (i.e. Unix
300 Win95/98/Me) if you have used the defaults. 
301
302 Finally, if you specify the {\bf portable=yes} option on the files you back
303 up. Bacula will be able to restore them on any other system. However, any
304 WinNT/2K/XP specific security and ownership information will be lost. 
305
306 The following matrix will give you an idea of what you can expect. Thanks to
307 Marc Brueckner for doing the tests: 
308
309
310
311 \addcontentsline{lot}{table}{WinNT/2K/XP Restore Portability Status}
312 \begin{longtable}{|l|l|p{2.8in}|}
313  \hline 
314 \multicolumn{1}{|c| }{\bf Backup OS } & \multicolumn{1}{c| }{\bf Restore OS }
315 & \multicolumn{1}{c| }{\bf Results  } \\
316  \hline {WinMe } & {WinMe } & {Works  } \\
317  \hline {WinMe } & {WinNT } & {Works (SYSTEM permissions)  } \\
318  \hline {WinMe } & {WinXP } & {Works (SYSTEM permissions)  } \\
319  \hline {WinMe } & {Linux } & {Works (SYSTEM permissions)  } \\
320  \hline {\ } & {\ } & {\  } \\
321  \hline {WinXP } & {WinXP } & {Works  } \\
322  \hline {WinXP } & {WinNT } & {Works (all files OK, but got ``The data is invalid''
323 message)  } \\
324  \hline {WinXP } & {WinMe } & {Error: Win32 data stream not supported.  } \\
325  \hline {WinXP } & {WinMe } & {Works if {\bf Portable=yes} specified during backup.} \\
326  \hline {WinXP } & {Linux } & {Error: Win32 data stream not supported.  } \\
327  \hline {WinXP } & {Linux } & {Works if {\bf Portable=yes} specified during backup.}\\
328  \hline {\ } & {\ } & {\  } \\
329  \hline {WinNT } & {WinNT } & {Works  } \\
330  \hline {WinNT } & {WinXP } & {Works  } \\
331  \hline {WinNT } & {WinMe } & {Error: Win32 data stream not supported.  } \\
332  \hline {WinNT } & {WinMe } & {Works if {\bf Portable=yes} specified during backup.}\\
333  \hline {WinNT } & {Linux } & {Error: Win32 data stream not supported.  } \\
334  \hline {WinNT } & {Linux } & {Works if {\bf Portable=yes} specified during backup.  }\\
335  \hline {\ } & {\ } & {\  } \\
336  \hline {Linux } & {Linux } & {Works  } \\
337  \hline {Linux } & {WinNT } & {Works (SYSTEM permissions)  } \\
338  \hline {Linux } & {WinMe } & {Works  } \\
339  \hline {Linux } & {WinXP } & {Works (SYSTEM permissions) }
340 \\ \hline 
341
342 \end{longtable}
343
344 \label{VSS}
345 \subsection*{Volume Shadow Copy Service}
346 \index[general]{Volume Shadow Copy Service }
347 \addcontentsline{toc}{subsection}{Volume Shadow Copy Service}
348 In version 1.37.25 and greater, you can turn on Microsoft's Volume
349 Shadow Copy Service (VSS).      
350
351 Microsoft added VSS to Windows XP and Windows 2003. From the perspective of
352 a backup-solution for Windows, this is an extremely important step. VSS
353 allows Bacula to backup open files and even to interact with applications like
354 RDBMS to produce consistent file copies.
355
356 Bacula supports VSS on both Windows 2003 and Windows XP.
357 Technically Bacula creates a shadow copy as soon as the backup process
358 starts. It does then backup all files from the shadow copy and destroys the
359 shadow copy after the backup process. Please have in mind, that VSS
360 creates a snapshot and thus backs up the system at the state it had
361 when starting the backup. It will disregard file changes which occur during
362 the backup process.
363
364 VSS can be turned on by placing an
365
366 \begin{verbatim}
367 Enable VSS = yes
368 \end{verbatim}
369
370 in your FileSet resource. 
371
372
373 \subsection*{Windows Firewalls}
374 \index[general]{Firewalls!Windows }
375 \index[general]{Windows Firewalls }
376 \addcontentsline{toc}{subsection}{Windows Firewalls}
377
378 If you turn on the firewalling feature on Windows (default in WinXP SP2), you
379 are likely to find that the Bacula ports are blocked and you cannot
380 communicate to the other daemons. This can be deactivated through the {\bf
381 Security Notification} dialog, which is apparently somewhere in the {\bf
382 Security Center}. I don't have this on my computer, so I cannot give the exact
383 details. 
384
385 The command: 
386
387 \footnotesize
388 \begin{verbatim}
389 netsh firewall set opmode disable
390 \end{verbatim}
391 \normalsize
392
393 is purported to disable the firewall, but this command is not accepted on my
394 WinXP Home machine. 
395
396 \subsection*{Windows Port Usage}
397 \index[general]{Windows Port Usage }
398 \index[general]{Usage!Windows Port }
399 \addcontentsline{toc}{subsection}{Windows Port Usage}
400
401 If you want to see if the File daemon has properly opened the port and is
402 listening, you can enter the following command in a shell window: 
403
404 \footnotesize
405 \begin{verbatim}
406    netstat -an | findstr 910[123]
407 \end{verbatim}
408 \normalsize
409
410 \subsection*{Windows Disaster Recovery}
411 \index[general]{Recovery!Windows Disaster }
412 \index[general]{Windows Disaster Recovery }
413 \addcontentsline{toc}{subsection}{Windows Disaster Recovery}
414
415 We don't currently have a good solution for disaster recovery on Windows as we
416 do on Linux. The main piece lacking is a Windows boot floppy or a Windows boot
417 CD. Microsoft releases a Windows Pre-installation Environment ({\bf WinPE})
418 that could possibly work, but we have not investigated it. This means that
419 until someone figures out the correct procedure, you must restore the OS from
420 the installation disks, then you can load a Bacula client and restore files.
421 Please don't count on using {\bf bextract} to extract files from your backup
422 tapes during a disaster recovery unless you have backed up those files using
423 the {\bf portable} option. {\bf bextract} does not run on Windows, and the
424 normal way Bacula saves files using the Windows API prevents the files from
425 being restored on a Unix machine. Once you have an operational Windows OS
426 loaded, you can run the File daemon and restore your user files. 
427
428 Please see 
429 \ilink{ Disaster Recovery of Win32 Systems}{Win3233} for the latest
430 suggestion, which looks very promising. 
431
432 It looks like Bart PE Builder, which creates a Windows PE (Pre-installation
433 Environment) Boot-CD, may be just what is needed to build a complete disaster
434 recovery system for Win32. This distribution can be found at 
435 \elink{http://www.nu2.nu/pebuilder/ }{http://www.nu2.nu/pebuilder/}. 
436
437 \subsection*{Windows Restore Problems}
438 \index[general]{Problems!Windows Restore}
439 \index[general]{Windows Restore Problems}
440 \addcontentsline{toc}{subsection}{Windows Restore Problems}
441 Please see the  
442 \ilink{Restore Chapter}{Windows} of this manual for problems
443 that you might encounter doing a restore.
444
445
446 \subsection*{Windows Ownership and Permissions Problems}
447 \index[general]{Problems!Windows Ownership and Permissions }
448 \index[general]{Windows Ownership and Permissions Problems }
449 \addcontentsline{toc}{subsection}{Windows Ownership and Permissions
450 Problems}
451
452 If you restore files backed up from WinNT/XP/2K to an alternate directory,
453 Bacula may need to create some higher level directories that were not saved
454 (or restored). In this case, the File daemon will create them under the SYSTEM
455 account because that is the account that Bacula runs under as a service. As of
456 version 1.32f-3, Bacula creates these files with full access permission.
457 However, there may be cases where you have problems accessing those files even
458 if you run as administrator. In principle, Microsoft supplies you with the way
459 to cease the ownership of those files and thus change the permissions.
460 However, a much better solution to working with and changing Win32 permissions
461 is the program {\bf SetACL}, which can be found at 
462 \elink{http://setacl.sourceforge.net/ }{http://setacl.sourceforge.net/}. 
463
464 If you have not installed Bacula while running as Administrator
465 and if Bacula is not running as a Process with the userid (User Name) SYSTEM, 
466 then it is very unlikely that it will have sufficient permission to
467 access all your files. 
468
469 Some users have experienced problems restoring files that participate in
470 the Active Directory. They also report that changing the userid under which
471 Bacula (bacula-fd.exe) runs, from SYSTEM to a Domain Admin userid, resolves
472 the problem.
473
474
475 \subsection*{Manually resetting the Permissions}
476 \index[general]{Manually resetting the Permissions }
477 \index[general]{Permissions!Manually resetting the }
478 \addcontentsline{toc}{subsection}{Manually resetting the Permissions}
479
480 The following solution was provided by Dan Langille \lt{}dan at langille in
481 the dot org domain\gt{}. The steps are performed using Windows 2000 Server but
482 they should apply to most Win32 platforms. The procedure outlines how to deal
483 with a problem which arises when a restore creates a top-level new directory.
484 In this example, ``top-level'' means something like {\bf
485 c:\textbackslash{}src}, not {\bf c:\textbackslash{}tmp\textbackslash{}src}
486 where {\bf c:\textbackslash{}tmp} already exists. If a restore job specifies /
487 as the {\bf Where:} value, this problem will arise. 
488
489 The problem appears as a directory which cannot be browsed with Windows
490 Explorer. The symptoms include the following message when you try to click on
491 that directory: 
492
493 \includegraphics{./access-is-denied.eps} 
494
495 If you encounter this message, the following steps will change the permissions
496 to allow full access. 
497
498 \begin{enumerate}
499 \item right click on the top level directory (in this example, {\bf c:/src})
500    and  select {\bf Properties}. 
501 \item click on the Security tab. 
502 \item If the following message appears, you can ignore it, and click on {\bf
503    OK}. 
504
505 \includegraphics{./view-only.eps} 
506
507 You should see something like this: 
508
509 \includegraphics{./properties-security.eps} 
510 \item click on Advanced 
511 \item click on the Owner tab 
512 \item Change the owner to something other than the current owner (which is
513    {\bf SYSTEM} in this example as shown below). 
514
515 \includegraphics{./properties-security-advanced-owner.eps} 
516 \item ensure the ``Replace owner on subcontainers and objects'' box is 
517    checked 
518 \item click on OK 
519 \item When the message ``You do not have permission to read the contents of
520    directory ''c:\textbackslash{}src\textbackslash{}basis. Do you wish to replace
521    the directory permissions with permissions granting you Full Control?``, click
522 on Yes. 
523
524 \includegraphics{./confirm.eps} 
525 \item Click on OK to close the Properties tab 
526    \end{enumerate}
527
528 With the above procedure, you should now have full control over your restored
529 directory. 
530
531 \subsection*{Backing Up the WinNT/XP/2K System State}
532 \index[general]{State!Backing Up the WinNT/XP/2K System }
533 \index[general]{Backing Up the WinNT/XP/2K System State }
534 \addcontentsline{toc}{subsection}{Backing Up the WinNT/XP/2K System State}
535
536 A suggestion by Damian Coutts using Microsoft's NTBackup utility in
537 conjunction with Bacula should permit a full restore of any damaged system
538 files on Win2K/XP. His suggestion is to do an NTBackup of the critical system
539 state prior to running a Bacula backup with the following command: 
540
541 \footnotesize
542 \begin{verbatim}
543 ntbackup backup systemstate /F c:\systemstate.bkf
544 \end{verbatim}
545 \normalsize
546
547 The {\bf backup} is the command, the {\bf systemstate} says to backup only the
548 system state and not all the user files, and the {\bf /F
549 c:\textbackslash{}systemstate.bkf} specifies where to write the state file.
550 this file must then be saved and restored by Bacula. 
551
552 To restore the system state, you first reload a base operating system if the
553 OS is damaged, otherwise, this is not necessary, then you would use Bacula to
554 restore all the damaged or lost user's files and to recover the {\bf
555 c:\textbackslash{}systemstate.bkf} file. Finally if there are any damaged or
556 missing system files or registry problems, you run {\bf NTBackup} and {\bf
557 catalogue} the system statefile, and then select it for restore. The
558 documentation says you can't run a command line restore of the systemstate. 
559
560 To the best of my knowledge, this has not yet been tested. If you test it,
561 please report your results to the Bacula email list. 
562
563 \subsection*{Windows Considerations for Filename Specifications}
564 \index[general]{Specifications!Windows Considerations for Filename }
565 \index[general]{Windows Considerations for Filename Specifications }
566 \addcontentsline{toc}{subsection}{Windows Considerations for Filename
567 Specifications}
568
569 Please see the 
570 \ilink{Director's Configuration chapter}{win32} of this manual
571 for important considerations on how to specify Windows paths in Bacula FileSet
572 Include and Exclude directives. 
573
574 Bacula versions prior to 1.37.28 do not support Windows Unicode filenames.
575 As of that version, both {\bf bconsole} and {\bf wx-console} support Windows
576 Unicode filenames. There may still be some problems with multiple byte
577 characters (e.g. Chinese, ...) where it is a two byte character but the
578 displayed character is not two characters wide.
579
580 Path/filenames longer than 260 characters are not supported. This may be
581 possible in a future version.
582
583 \subsection*{Command Line Options Specific to the Bacula Windows File
584 Daemon (Client)}
585 \index[general]{Client!Command Line Options Specific to the Bacula Windows
586 File Daemon }
587 \index[general]{Command Line Options Specific to the Bacula Windows File
588 Daemon (Client) }
589 \addcontentsline{toc}{subsection}{Command Line Options Specific to the
590 Bacula Windows File Daemon (Client)}
591
592 These options are not normally seen or used by the user, and are documented
593 here only for information purposes. At the current time, to change the default
594 options, you must either manually run {\bf Bacula} or you must manually edit
595 the system registry and modify the appropriate entries. 
596
597 In order to avoid option clashes between the options necessary for {\bf
598 Bacula} to run on Windows and the standard Bacula options, all Windows
599 specific options are signaled with a forward slash character (/), while as
600 usual, the standard Bacula options are signaled with a minus (-), or a minus
601 minus (\verb:--:). All the standard Bacula options can be used on the Windows
602 version. In addition, the following Windows only options are implemented: 
603
604 \begin{description}
605
606 \item [/servicehelper ]
607    \index[fd]{/servicehelper }
608    Run the service helper application  (don't use this it is deprecated.).  
609
610 \item [/service ]
611    \index[fd]{/service }
612    Start Bacula as a service 
613
614 \item [/run ]
615    \index[fd]{/run }
616    Run the Bacula application  
617
618 \item [/install ]
619    \index[fd]{/install }
620    Install Bacula as a service in the system registry  
621
622 \item [/remove ]
623    \index[fd]{/remove }
624    Uninstall Bacula from the system registry  
625
626 \item [/about ]
627    \index[fd]{/about }
628    Show the Bacula about dialogue box  
629
630 \item [/status ]
631    \index[fd]{/status }
632    Show the Bacula status dialogue box  
633
634 \item [/events ]
635    \index[fd]{/events }
636    Show the Bacula events dialogue box (not  yet implemented)  
637
638 \item [/kill ]
639    \index[fd]{/kill }
640    Stop any running {\bf Bacula}  
641
642 \item [/help ]
643    \index[fd]{/help }
644    Show the Bacula help dialogue box 
645 \end{description}
646
647 It is important to note that under normal circumstances the user should never
648 need to use these options as they are normally handled by the system
649 automatically once Bacula is installed. However, you may note these options in
650 some of the .bat files that have been created for your use. 
651
652 \subsection*{Shutting down Windows Systems}
653 \index[general]{Shutting down Windows Systems }
654 \index[general]{Systems!Shutting down Windows }
655 \addcontentsline{toc}{subsection}{Shutting down Windows Systems}
656
657 Some users like to shutdown their windows machines after a backup using a
658 Client Run After Job directive. If you want to do something similar, you might
659 take the shutdown program from the 
660 \elink{apcupsd project}{http://www.apcupsd.com} or one from the 
661 \elink{ Sysinternals
662 project}{http://www.sysinternals.com/ntw2k/freeware/psshutdown.shtml}.