]> git.sur5r.net Git - bacula/docs/blobdiff - docs/manuals/en/main/win32.tex
Tweak upload and Windows chapter
[bacula/docs] / docs / manuals / en / main / win32.tex
index f1754349a4b0ca8c35800a30991fc6fecd935970..c1d74cc3a48dba6a9061614cd3c9abce4a0a249d 100644 (file)
@@ -12,24 +12,25 @@ speak of the Windows version of Bacula below, we are referring to
 the File daemon (client) only. 
 
 The Windows version of the Bacula File daemon has been tested on WinXP,
-Win2000, Windows Server 2003, Windows Server 2008, Vista, and Windows 7
-systems.  The Windows version of Bacula is a native Win32 port, but there
-are very few source code changes to the Unix code, which means that the
-Windows version is for the most part running code that has long proved
-stable on Unix systems.  When running, it is perfectly integrated with
-Windows and displays its icon in the system icon tray, and provides a
-system tray menu to obtain additional information on how Bacula is running
-(status and events dialog boxes).  If so desired, it can also be stopped by
-using the system tray menu, though this should normally never be necessary.
+Win2000, Windows Server 2003, Windows Server 2008, Vista, Windows 7, and
+Windows 2012 systems.  The Windows version of Bacula is a native Windows
+port, but there are very few source code changes to the Unix code, which
+means that the Windows version is for the most part running code that has
+long proved stable on Unix systems.  When running, it is perfectly
+integrated with Windows and displays its icon in the system icon tray, and
+provides a system tray menu to obtain additional information on how Bacula
+is running (status and events dialog boxes).  If so desired, it can also be
+stopped by using the system tray menu, though this should normally never be
+necessary.
 
 Once installed Bacula normally runs as a system service. This means that it is
 immediately started by the operating system when the system is booted, and
 runs in the background even if there is no user logged into the system. 
 
-\section{Win32 Installation}
+\section{Windows Installation}
 \label{installation}
 \index[general]{Installation}
-\index[general]{Win32!Installation}
+\index[general]{Windows!Installation}
 
 Normally, you will install the Windows version of Bacula from the binaries.
 This install is standard Windows .exe that runs an install wizard using the
@@ -66,21 +67,21 @@ Some users have attempted to install logged in as a domain administrator
 account and experienced permissions problems attempting to run
 Bacula, so we don't recommend that option.
   
-\item Simply double click on the {\bf bacula-win32-5.xx.0.exe}  NSIS install
-   icon. The  actual name of the icon will vary from one release version to 
-   another. 
+\item Simply double click on the {\bf bacula-win32-5.xx.0.exe} NSIS install
+   icon.  The actual name of the icon will vary from one release version to
+   another.
 
 \includegraphics{\idir win32-nsis.eps}  bacula-win32-5.xx.0.exe  
   
 \item Once launched, the installer wizard will ask you if you want  to install
    Bacula.  
 
-\addcontentsline{lof}{figure}{Win32 Client Setup Wizard}
+\addcontentsline{lof}{figure}{Windows Client Setup Wizard}
 \includegraphics{\idir win32-welcome.eps}  
 
 \item Next you will be asked to select the installation type. 
 
-\addcontentsline{lof}{figure}{Win32 Installation Type}
+\addcontentsline{lof}{figure}{Windows Installation Type}
 \includegraphics{\idir win32-installation-type.eps}
 
 
@@ -90,7 +91,7 @@ Bacula, so we don't recommend that option.
    location that you choose later. The components  dialog looks like the
    following:  
 
-\addcontentsline{lof}{figure}{Win32 Component Selection Dialog}
+\addcontentsline{lof}{figure}{Windows Component Selection Dialog}
 \includegraphics{\idir win32-pkg.eps}  
 \index[general]{Upgrading}
 
@@ -105,49 +106,60 @@ Bacula, so we don't recommend that option.
    not be displayed.
 
 
-\addcontentsline{lof}{figure}{Win32 Configure}
+\addcontentsline{lof}{figure}{Windows Configure}
 \includegraphics{\idir win32-config.eps}  
  
 \item While the various files are being loaded, you will see the following
    dialog:
 
-   \addcontentsline{lof}{figure}{Win32 Install Progress}
+   \addcontentsline{lof}{figure}{Windows Install Progress}
    \includegraphics{\idir win32-installing.eps}  
 
 
 \item Finally, the finish dialog will appear:  
 
-   \addcontentsline{lof}{figure}{Win32 Client Setup Completed}
+   \addcontentsline{lof}{figure}{Windows Client Setup Completed}
    \includegraphics{\idir win32-finish.eps}  
 
 \ 
 \end{itemize}
 
-That should complete the installation process. When the Bacula File Server is
-ready to serve files, an icon \includegraphics{\idir idle.eps} representing a
-cassette (or tape) will appear in the system tray
-\includegraphics{\idir tray-icon.eps}; right click on it and a menu will appear.\\
-\includegraphics{\idir menu.eps}\\
-The {\bf Events} item is currently unimplemented, by selecting the {\bf
-Status} item, you can verify whether any jobs are running or not. 
+That should complete the installation process.  
 
-When the Bacula File Server begins saving files, the color of the holes in the
-cassette icon will change from white to green \includegraphics{\idir running.eps},
-and if there is an error, the holes in the cassette icon will change to red
-\includegraphics{\idir error.eps}. 
+\section{Tray Icon}
+\index[general]{Tray Icon}
+
+Note: this section does not apply to all Windows versions 
+later than Windows XP, since in those later versions Microsoft
+explicitly prohibits a system service such as Bacula from interacting
+with the user.
+
+On Windows XP, when the Bacula File Server
+is ready to serve files, an icon \includegraphics{\idir idle.eps}
+representing a cassette (or tape) will appear in the system tray
+\includegraphics{\idir tray-icon.eps}; right click on it and a menu will
+appear.\\ \includegraphics{\idir menu.eps}\\ The {\bf Events} item is
+currently unimplemented, by selecting the {\bf Status} item, you can verify
+whether any jobs are running or not.
+
+When the Bacula File Server begins saving files, the color of the holes in
+the cassette icon will change from white to green \includegraphics{\idir
+running.eps}, and if there is an error, the holes in the cassette icon will
+change to red \includegraphics{\idir error.eps}.
 
 If you are using remote desktop connections between your Windows boxes, be
-warned that that tray icon does not always appear. It will always be visible
-when you log into the console, but the remote desktop may not display it. 
+warned that that tray icon does not always appear.  It will always be
+visible when you log into the console, but the remote desktop may not
+display it.
 
-\section{Post Win32 Installation}
-\index[general]{Post Win32 Installation}
-\index[general]{Win32!Post Installation}
+\section{Post Windows Installation}
+\index[general]{Post Windows Installation}
+\index[general]{Windows!Post Installation}
 
-After installing Bacula and before running it, you should check the contents
-of the configuration files to ensure that they correspond to your
-installation.  You can get to them by using:
-the {\bf Start\-\gt{}All Programs\-\gt{}Bacula} menu item.
+After installing Bacula and before running it, you should check the
+contents of the configuration files to ensure that they correspond to your
+installation.  You can get to them by using: the {\bf Start\-\gt{}All
+Programs\-\gt{}Bacula} menu item.
 
 Finally, but pulling up the Task Manager (ctl-alt-del), verify that Bacula
 is running as a process (not an Application) with User Name SYSTEM. If this is 
@@ -155,19 +167,26 @@ not the case, you probably have not installed Bacula while running as
 Administrator, and hence it will be unlikely that Bacula can access
 all the system files.
 
-\section{Uninstalling Bacula on Win32}
-\index[general]{Win32!Uninstalling Bacula}
-\index[general]{Uninstalling Bacula on Win32}
+\section{Windows FD Restrictions}
+\index[general]{Windows FD Restrictions}
+In recent versions of Windows, Microsoft has implemented
+Volume Mount Points, Encrypted Volumes, and Deduplicated Volumes.
+Current versions of the Windows File daemon do not support
+any of these special Volume formats.
+
+\section{Uninstalling Bacula on Windows}
+\index[general]{Windows!Uninstalling Bacula}
+\index[general]{Uninstalling Bacula on Windows}
 
 Once Bacula has been installed, it can be uninstalled using the standard
 Windows Add/Remove Programs dialog found on the Control panel. 
 
-\section{Dealing with Win32 Problems}
+\section{Dealing with Windows Problems}
 \label{problems}
-\index[general]{Win32!Dealing with Problems}
-\index[general]{Dealing with Win32 Problems}
+\index[general]{Windows!Dealing with Problems}
+\index[general]{Dealing with Windows Problems}
 
-Sometimes Win32 machines the File daemon may have very slow
+Sometimes Windows machines the File daemon may have very slow
 backup transfer rates compared to other machines.  To you might
 try setting the Maximum Network Buffer Size to 32,768 in both the
 File daemon and in the Storage daemon. The default size is larger,
@@ -224,7 +243,7 @@ sides must match for proper authentication.
 One user had serious problems with the configuration file until he realized
 that the Unix end of line conventions were used and Bacula wanted them in
 Windows format. This has not been confirmed though, and Bacula version 2.0.0 
-and above should now accept all end of line conventions (Win32,
+and above should now accept all end of line conventions (Windows,
 Unix, Mac).
 
 Running Unix like programs on Windows machines is a bit frustrating because
@@ -341,7 +360,7 @@ 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
 program specifically designed to make a copy or backup the registry. 
 
-In Bacula version 1.31 and later, we use Windows backup API calls by
+Bacula uses Windows backup API calls by
 default.  Typical of Windows, programming these special BackupRead and
 BackupWrite calls is a real nightmare of complications.  The end result
 gives some distinct advantages and some disadvantages.
@@ -399,16 +418,16 @@ Marc Brueckner for doing the tests:
  \hline {WinXP} & {WinXP} & {Works } \\
  \hline {WinXP} & {WinNT} & {Works (all files OK, but got "The data is invalid"
 message) } \\
- \hline {WinXP} & {WinMe} & {Error: Win32 data stream not supported. } \\
+ \hline {WinXP} & {WinMe} & {Error: Windows data stream not supported. } \\
  \hline {WinXP} & {WinMe} & {Works if {\bf Portable=yes} specified during backup.} \\
- \hline {WinXP} & {Linux} & {Error: Win32 data stream not supported. } \\
+ \hline {WinXP} & {Linux} & {Error: Windows data stream not supported. } \\
  \hline {WinXP} & {Linux} & {Works if {\bf Portable=yes} specified during backup.}\\
  \hline {\ } & {\ } & {\ } \\
  \hline {WinNT} & {WinNT} & {Works } \\
  \hline {WinNT} & {WinXP} & {Works } \\
- \hline {WinNT} & {WinMe} & {Error: Win32 data stream not supported. } \\
+ \hline {WinNT} & {WinMe} & {Error: Windows 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} & {Error: Windows data stream not supported. } \\
  \hline {WinNT} & {Linux} & {Works if {\bf Portable=yes} specified during backup. }\\
  \hline {\ } & {\ } & {\ } \\
  \hline {Linux} & {Linux} & {Works } \\
@@ -418,36 +437,32 @@ message) } \\
 \\ \hline 
 \end{longtable}
 
-Note: with Bacula versions 1.39.x and later, non-portable Windows data can
-be restore to any machine.
-
+Note: Non-portable Windows data can be restore to any machine.  In
+addition, with recent Bacula versions, Bacula is able to extract data
+part from Windows backup streams when restoring on a non-Windows
+machine.
 
 \label{VSS}
 \section{Volume Shadow Copy Service}
 \index[general]{Volume Shadow Copy Service}
 \index[general]{VSS}
-In version 1.37.30 and greater, you can turn on Microsoft's Volume
-Shadow Copy Service (VSS).      
-
-Microsoft added VSS to Windows XP and Windows 2003. From the perspective of
-a backup-solution for Windows, this is an extremely important step. VSS
-allows Bacula to backup open files and even to interact with applications like
-RDBMS to produce consistent file copies. VSS aware applications are called
-VSS Writers, they register with the OS so that when Bacula wants to do a
-Snapshot, the OS will notify the register Writer programs, which may then
-create a consistent state in their application, which will be backed up.
-Examples for these writers are "MSDE" (Microsoft database
-engine), "Event Log Writer", "Registry Writer" plus 3rd
-party-writers.  If you have a non-vss aware application (e.g.
-SQL Anywhere or probably MySQL), a shadow copy is still generated
-and the open files can be backed up, but there is no guarantee
-that the file is consistent.
+Microsoft added VSS to Windows XP and later systems.  From the perspective
+of a backup-solution for Windows, this is an extremely important step.  VSS
+allows Bacula to backup open files and even to interact with applications
+like RDBMS to produce consistent file copies.  VSS aware applications are
+called VSS Writers, they register with the OS so that when Bacula wants to
+do a Snapshot, the OS will notify the register Writer programs, which may
+then create a consistent state in their application, which will be backed
+up.  Examples for these writers are "MSDE" (Microsoft database engine),
+"Event Log Writer", "Registry Writer" plus 3rd party-writers.  If you have
+a non-vss aware application (e.g.  SQL Anywhere or probably MySQL), a
+shadow copy is still generated and the open files can be backed up, but
+there is no guarantee that the file is consistent.
 
 Bacula produces a message from each of the registered writer programs
 when it is doing a VSS backup so you know which ones are correctly backed
 up.
 
-Bacula supports VSS on both Windows 2003 and Windows XP.
 Technically Bacula creates a shadow copy as soon as the backup process
 starts. It does then backup all files from the shadow copy and destroys the
 shadow copy after the backup process. Please have in mind, that VSS
@@ -565,7 +580,7 @@ listening, you can enter the following command in a shell window:
 \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.
+standard Windows program, so you must find and download it from the Internet.
 
 \section{Windows Disaster Recovery}
 \index[general]{Recovery!Windows Disaster}
@@ -585,12 +600,12 @@ being restored on a Unix machine. Once you have an operational Windows OS
 loaded, you can run the File daemon and restore your user files. 
 
 Please see 
-\ilink{ Disaster Recovery of Win32 Systems}{Win3233} for the latest
+\ilink{ Disaster Recovery of Windows Systems}{Windows33} for the latest
 suggestion, which looks very promising. 
 
 It looks like Bart PE Builder, which creates a Windows PE (Pre-installation
 Environment) Boot-CD, may be just what is needed to build a complete disaster
-recovery system for Win32. This distribution can be found at 
+recovery system for Windows. This distribution can be found at 
 \elink{http://www.nu2.nu/pebuilder/}{http://www.nu2.nu/pebuilder/}.
 
 \section{Windows Restore Problems}
@@ -644,20 +659,21 @@ Thanks to Georger Araujo for the above information.
 
 If you restore files backed up from Windows to an alternate directory,
 Bacula may need to create some higher level directories that were not saved
-(or restored). In this case, the File daemon will create them under the SYSTEM
-account because that is the account that Bacula runs under as a service. As of
-version 1.32f-3, Bacula creates these files with full access permission.
-However, there may be cases where you have problems accessing those files even
-if you run as administrator. In principle, Microsoft supplies you with the way
-to cease the ownership of those files and thus change the permissions.
-However, a much better solution to working with and changing Win32 permissions
-is the program {\bf SetACL}, which can be found at 
-\elink{http://setacl.sourceforge.net/}{http://setacl.sourceforge.net/}. 
-
-If you have not installed Bacula while running as Administrator
-and if Bacula is not running as a Process with the userid (User Name) SYSTEM, 
-then it is very unlikely that it will have sufficient permission to
-access all your files. 
+(or restored).  In this case, the File daemon will create them under the
+SYSTEM account because that is the account that Bacula runs under as a
+service.  As of version 1.32f-3, Bacula creates these files with full
+access permission.  However, there may be cases where you have problems
+accessing those files even if you run as administrator.  In principle,
+Microsoft supplies you with the way to cease the ownership of those files
+and thus change the permissions.  However, a much better solution to
+working with and changing Windows permissions is the program {\bf SetACL},
+which can be found at
+\elink{http://setacl.sourceforge.net/}{http://setacl.sourceforge.net/}.
+
+If you have not installed Bacula while running as Administrator and if
+Bacula is not running as a Process with the userid (User Name) SYSTEM, then
+it is very unlikely that it will have sufficient permission to access all
+your files.
 
 Some users have experienced problems restoring files that participate in
 the Active Directory. They also report that changing the userid under which
@@ -671,7 +687,7 @@ the problem.
 
 The following solution was provided by Dan Langille \lt{}dan at langille in
 the dot org domain\gt{}. The steps are performed using Windows 2000 Server but
-they should apply to most Win32 platforms. The procedure outlines how to deal
+they should apply to most Windows platforms. The procedure outlines how to deal
 with a problem which arises when a restore creates a top-level new directory.
 In this example, "top-level" means something like {\bf
 c:\textbackslash{}src}, not {\bf c:\textbackslash{}tmp\textbackslash{}src}
@@ -767,6 +783,29 @@ above.  On new Windows machines, Bacula will backup and restore
 all files including the system state providing you have
 VSS enabled in your Bacula FileSet (default).
 
+\section{Fixing the Windows Boot Record}
+\index[general]{Fixing the Windows Boot Record}
+\index[general]{Windows!Fixing the Boot Record}
+A tip from a user:
+An effective way to restore a Windows backup for
+those who do not purchase the bare metal restore
+capability is to install Windows on a different
+hard drive and restore the backup.  Then run the
+recovery CD and run
+
+\begin{verbatim}
+diskpart
+   select disk 0
+   select part 1
+   active
+   exit
+
+bootrec /rebuldbcd
+bootrec /fixboot
+bootrec /fixmbr
+\end{verbatim}
+
+
 \section{Considerations for Filename Specifications}
 \index[general]{Windows!Considerations for Filename Specifications}
 
@@ -782,14 +821,14 @@ Unicode filenames. There may still be some problems with multiple byte
 characters (e.g. Chinese, ...) where it is a two byte character but the
 displayed character is not two characters wide.
 
-\index[general]{Win32 Path Length Restriction}
+\index[general]{Windows Path Length Restriction}
 Path/filenames longer than 260 characters (up to 32,000) are supported
 beginning with Bacula version 1.39.20. Older Bacula versions support
 only 260 character path/filenames.
 
-\section{Win32 Specific File daemon Command Line}
-\index[general]{Client!Win32 Specific File daemon Command Line Options}
-\index[general]{Win32 Specific File daemon Command Line Options}
+\section{Windows Specific File daemon Command Line}
+\index[general]{Client!Windows Specific File daemon Command Line Options}
+\index[general]{Windows Specific File daemon Command Line Options}
 
 These options are not normally seen or used by the user, and are documented
 here only for information purposes. At the current time, to change the default