]> git.sur5r.net Git - bacula/docs/blobdiff - docs/manual/win32.tex
Fix missing end enumerate
[bacula/docs] / docs / manual / win32.tex
index 36eed1033e63e6f5c96fa30b338ea5cba3557eba..50a8e2ca3aa24fa76c2a8d8f3696771b4c154a34 100644 (file)
@@ -286,16 +286,17 @@ use the ACPI power management timer as a high-resolution counter on Windows
 \index[general]{Considerations!Windows Compatibility}
 \addcontentsline{toc}{subsection}{Windows Compatibility Considerations}
 
-If any applications are running during the backup and they have files
-opened exclusively, Bacula will not be able to backup those files, so be
-sure you close your applications (or tell your users to close their
-applications) before the backup. Fortunately,
-most Microsoft applications do not open
-files exclusively so that they can be backed up.  However, you will need to
-experiment.  In any case, if Bacula cannot open the file, it will print an
-error message, so you will always know which files were not backed up.
-For version 1.37.25 and greater, see the section below on
-Volume Shadow Copy Service.
+If you are not using the VSS (Volume Shadow Copy) option described in the
+next section of this chapter, and if any applications are running during
+the backup and they have files opened exclusively, Bacula will not be able
+to backup those files, so be sure you close your applications (or tell your
+users to close their applications) before the backup.  Fortunately, most
+Microsoft applications do not open files exclusively so that they can be
+backed up.  However, you will need to experiment.  In any case, if Bacula
+cannot open the file, it will print an error message, so you will always
+know which files were not backed up.  For version 1.37.25 and greater, see
+the section below on Volume Shadow Copy Service that permits backing up any
+file.
 
 During backup, Bacula doesn't know about the system registry, so you will
 either need to write it out to an ASCII file using {\bf regedit~~/e} or use a
@@ -308,10 +309,9 @@ gives some distinct advantages and some disadvantages.
 
 First, the advantages are that on WinNT/2K/XP systems, the security and
 ownership information is now backed up.  In addition, with the exception of
-files in exclusive use by another program (a major disaster for backup
-programs on Windows), Bacula can now access all system files.  This means
-that when you restore files, the security and ownership information will be
-restored on WinNT/2K/XP along with the data.
+files in exclusive use by another program, Bacula can now access all system
+files.  This means that when you restore files, the security and ownership
+information will be restored on WinNT/2K/XP along with the data.
 
 The disadvantage of the Windows backup API calls is that it produces
 non-portable backups.  That is files and their data that are backed up on
@@ -321,8 +321,15 @@ WinNT can be restored on WinXP, but this remains to be seen in practice
 (not yet tested).  In addition, the stand-alone tools such as {\bf bls} and
 {\bf bextract} cannot be used to retrieve the data for those files because
 those tools are not available on Windows.  All restores must use the Bacula
-{\bf restore} command.  This restriction is mentioned for completeness, but
-in practice should not create any problems.
+{\bf restore} command.  As of Bacula 1.39.x, thanks to Thorsten Engel, this
+restriction is removed, and Bacula should be able to read non-portable
+backups on any system and restore the data appropriately.  However,       
+on a system that does not have the BackupRead/BackupWrite calls (older
+Windows versions and all Unix/Linux machines), though the file data
+can be restored, the Windows security and access control data  will not be restored.
+This means that a standard set of access permissions will be set for
+such restored files.
+        
 
 As a default, Bacula backs up Windows systems using the Windows API calls.
 If you want to backup data on a WinNT/2K/XP system and restore it on a
@@ -351,8 +358,6 @@ WinNT/2K/XP specific security and ownership information will be lost.
 The following matrix will give you an idea of what you can expect. Thanks to
 Marc Brueckner for doing the tests: 
 
-+ 
-
 \addcontentsline{lot}{table}{WinNT/2K/XP Restore Portability Status}
 \begin{longtable}{|l|l|p{2.8in}|}
  \hline 
@@ -362,7 +367,7 @@ Marc Brueckner for doing the tests:
  \hline {WinMe} & {WinNT} & {Works (SYSTEM permissions) } \\
  \hline {WinMe} & {WinXP} & {Works (SYSTEM permissions) } \\
  \hline {WinMe} & {Linux} & {Works (SYSTEM permissions) } \\
- \hline {\} & {\} & {\ } \\
+ \hline {\ } & {\ } & {\ } \\
  \hline {WinXP} & {WinXP} & {Works } \\
  \hline {WinXP} & {WinNT} & {Works (all files OK, but got "The data is invalid"
 message) } \\
@@ -370,22 +375,25 @@ message) } \\
  \hline {WinXP} & {WinMe} & {Works if {\bf Portable=yes} specified during backup.} \\
  \hline {WinXP} & {Linux} & {Error: Win32 data stream not supported. } \\
  \hline {WinXP} & {Linux} & {Works if {\bf Portable=yes} specified during backup.}\\
- \hline {\} & {\} & {\ } \\
+ \hline {\ } & {\ } & {\ } \\
  \hline {WinNT} & {WinNT} & {Works } \\
  \hline {WinNT} & {WinXP} & {Works } \\
  \hline {WinNT} & {WinMe} & {Error: Win32 data stream not supported. } \\
  \hline {WinNT} & {WinMe} & {Works if {\bf Portable=yes} specified during backup.}\\
  \hline {WinNT} & {Linux} & {Error: Win32 data stream not supported. } \\
  \hline {WinNT} & {Linux} & {Works if {\bf Portable=yes} specified during backup. }\\
- \hline {\} & {\} & {\ } \\
+ \hline {\ } & {\ } & {\ } \\
  \hline {Linux} & {Linux} & {Works } \\
  \hline {Linux} & {WinNT} & {Works (SYSTEM permissions) } \\
  \hline {Linux} & {WinMe} & {Works } \\
  \hline {Linux} & {WinXP} & {Works (SYSTEM permissions)}
 \\ \hline 
-
 \end{longtable}
 
+Note: with Bacula versions 1.39.x and later, non-portable Windows data can
+be restore to any machine.
+
+
 \label{VSS}
 \subsection*{Volume Shadow Copy Service}
 \index[general]{Volume Shadow Copy Service}
@@ -532,6 +540,9 @@ listening, you can enter the following command in a shell window:
 \end{verbatim}
 \normalsize
 
+TopView is another program that has been recommend, but it is not a
+standard Win32 program, so you must find and download it from the Internet.
+
 \subsection*{Windows Disaster Recovery}
 \index[general]{Recovery!Windows Disaster}
 \index[general]{Windows Disaster Recovery}
@@ -567,6 +578,44 @@ Please see the
 \ilink{Restore Chapter}{Windows} of this manual for problems
 that you might encounter doing a restore.
 
+subsection*{Windows Backup Problems}
+\index[general]{Problems!Windows Backup}
+\index[general]{Windows Backup Problems}
+\addcontentsline{toc}{subsection}{Windows Backup Problems}
+If during a Backup, you get the message: 
+{\bf ERR=Access is denied} and you are using the portable option,
+you should try both adding both the non-portable (backup API) and
+the Volume Shadow Copy options to your Director's conf file.
+
+In the Options resource:
+\footnotesize
+\begin{verbatim}
+portable = no
+\end{verbatim}
+\normalsize
+
+In the FileSet resource:
+\footnotesize
+\begin{verbatim}
+enablevss = yes
+\end{verbatim}
+\normalsize
+
+In general, specifying these two options should allow you to backup
+any file on a Windows system.  However, in some cases, if users
+have allowed to have full control of their folders, even system programs
+such a Bacula can be locked out.  In this case, you must identify
+which folders or files are creating the problem and do the following:
+
+\begin{enumerate}
+\item Grant ownership of the file/folder to the Administrators group,
+with the option to replace the owner on all child objects.
+\item Grant full control permissions to the Administrators group,
+and change the user's group to only have Modify permission to
+the file/folder and all child objects.
+\end{enumerate}
+
+Thanks to Georger Araujo for the above information.
 
 \subsection*{Windows Ownership and Permissions Problems}
 \index[general]{Problems!Windows Ownership and Permissions}