From a8199782a098c0d8d6010c1528c54f9af2b1248a Mon Sep 17 00:00:00 2001 From: Kern Sibbald Date: Sun, 5 Apr 2009 10:06:56 +0000 Subject: [PATCH] Manual updates --- docs/manuals/en/concepts/concepts.kilepr | 10 +-- docs/manuals/en/concepts/newfeatures.tex | 78 ++++++++++++++++++------ docs/manuals/en/console/bconsole.tex | 12 ++-- docs/manuals/en/console/console.kilepr | 18 +++--- 4 files changed, 83 insertions(+), 35 deletions(-) diff --git a/docs/manuals/en/concepts/concepts.kilepr b/docs/manuals/en/concepts/concepts.kilepr index 3ee46e1a..79f532b9 100644 --- a/docs/manuals/en/concepts/concepts.kilepr +++ b/docs/manuals/en/concepts/concepts.kilepr @@ -161,10 +161,10 @@ order=-1 [item:newfeatures.tex] archive=true -column=72 +column=49 encoding=UTF-8 highlight=LaTeX -line=837 +line=516 open=true order=0 @@ -352,10 +352,10 @@ order=-1 archive=true column=0 encoding= -highlight= +highlight=LaTeX line=0 -open=false -order=-1 +open=true +order=1 [item:win32.tex] archive=true diff --git a/docs/manuals/en/concepts/newfeatures.tex b/docs/manuals/en/concepts/newfeatures.tex index 4e2374fe..30a14623 100644 --- a/docs/manuals/en/concepts/newfeatures.tex +++ b/docs/manuals/en/concepts/newfeatures.tex @@ -255,14 +255,15 @@ Something that was on the project list for some time is now implemented for platforms that support a similar kind of interface. Its the support for backup and restore of so called extended attributes. As extended attributes are so platform specific these attributes are saved in seperate streams for each -platform. Restores can only be performed on the same platform the backup was -done. There is support for all types of extended attributes, but restoring from -one type of filesystem onto an other type of filesystem on the same platform -may lead to supprises. As extended attributes can contain any type of data they -are stored as a series of so called value-pairs. This data must be seen as -mostly binary and is stored as such. As security labels from selinux are also -extended attributes this option also stores those labels and no specific code -is enabled for handling selinux security labels. +platform. Restores of the extended attributes can only be performed on the +same platform the backup was done. There is support for all types of extended +attributes, but restoring from one type of filesystem onto an other type of +filesystem on the same platform may lead to supprises. As extended attributes +can contain any type of data they are stored as a series of so called +value-pairs. This data must be seen as mostly binary and is stored as such. +As security labels from selinux are also extended attributes this option also +stores those labels and no specific code is enabled for handling selinux +security labels. Currently the following platforms support extended attributes: \begin{itemize} @@ -466,14 +467,58 @@ Full was actually run. \section{Catalog Format} \index[general]{Catalog Format} -Bacula 3.0 comes with some changes on the catalog format. The upgrade -operation will convert an essential field of the File table that permits to -handle more than 4 billion objects over the time, and this operation will take -TIME and will likely DOUBLE THE SIZE of your catalog during the conversion. -You won't be able to run jobs during this period. For example, a 3 million -files catalog will take 2 minutes to upgrade on a normal machine. Please don't -forget to make a valid backup of your database before executing the upgrade -script. +Bacula 3.0 comes with some changes to the catalog format. The upgrade +operation will convert the FileId field of the File table from 32 bits (max 4 +billion table entries) to 64 bits (very large number of items). The +conversion process can take a bit of time and will likely DOUBLE THE SIZE of +your catalog during the conversion. Also you won't be able to run jobs during +this conversion period. For example, a 3 million file catalog will take 2 +minutes to upgrade on a normal machine. Please don't forget to make a valid +backup of your database before executing the upgrade script. See the +ReleaseNotes for additional details. + +\section{64 bit Windows Client} +\index[general]{Win64 Client} +Unfortunately, Microsoft's implementation of Volume Shadown Copy (VSS) on +their 64 bit OS versions is not compatible with a 32 bit Bacula Client. +As a consequence, we are also releasing a 64 bit version of the Bacula +Windows Client (win64bacula-3.0.0.exe) that does work with VSS. +These binaries should only be installed on 64 bit Windows operating systems. +What is important is not your hardware but whether or not you have +a 64 bit version of the Windows OS. + +Compared to the Win32 Bacula Client, the 64 bit release contains a few differences: +\begin{enumerate} +\item Before installing the Win64 Bacula Client, you must totally + deinstall any prior 2.4.x Client installation using the + Bacula deinstallation (see the menu item). You may want + to save your .conf files first. +\item Only the Client (File daemon) is ported to Win64, the Director + and the Storage daemon are not in the 64 bit Windows installer. +\item bwx-console is not yet ported. +\item bconsole is ported but it has not been tested. +\item The documentation is not included in the installer. +\item Due to Vista security restrictions imposed on a default installation + of Vista, before upgrading the Client, you must manually stop + any prior version of Bacula from running, otherwise the install + will fail. +\item Due to Vista security restrictions imposed on a default installation + of Vista, attempting to edit the conf files via the menu items + will fail. You must directly edit the files with appropriate + permissions. Generally double clicking on the appropriate .conf + file will work providing you have sufficient permissions. +\item All Bacula files are now installed in + {\bf C:/Program Files/Bacula} except the main menu items, + which are installed as before. This vastly simplifies the installation. +\item If you are running on a foreign language version of Windows, most + likely {\bf C:/Program Files} does not exist, so you should use the + Custom installation and enter an appropriate location to install + the files. +\item The 3.0.0 Win32 Client continues to install files in the locations used + by prior versions. For the next version we will convert it to use + the same installation conventions as the Win64 version. +\end{enumerate} + \section{Duplicate Job Control} \index[general]{Duplicate Jobs} @@ -1383,4 +1428,3 @@ LICENSE, ReleaseNotes, ChangeLog, ... The default is You can use {-}{-}htmldir= on the ./configure command to specify the directory where you want Bacula bat html help files placed. The default is {\bf /usr/share/doc/bacula/html} - diff --git a/docs/manuals/en/console/bconsole.tex b/docs/manuals/en/console/bconsole.tex index 8524e4db..1143adbd 100644 --- a/docs/manuals/en/console/bconsole.tex +++ b/docs/manuals/en/console/bconsole.tex @@ -1481,19 +1481,23 @@ regression test might be: \item [@\# anything] \index[general]{anything} Comment -\end{description} - \item [@separator \lt{}char\gt{}] \index[general]{@separator} When using bconsole with readline, you can set the command separator to one - of those characters to write commands who require multiple input in one line. + of those characters to write commands who require multiple input on one line, + or to put multiple commands on a single line. \begin{verbatim} !$%&'()*+,-/:;<>?[]^`{|}~ \end{verbatim} -\label{scripting} + Note, if you use a semicolon (;) as a separator character, which is + common, you will not be able to use the {\bf sql} command, which + requires each command to be terminated by a semicolon. +\end{description} + +\label{scripting} \section{Running the Console from a Shell Script} \index[general]{Script!Running the Console Program from a Shell} \index[general]{Running the Console Program from a Shell Script} diff --git a/docs/manuals/en/console/console.kilepr b/docs/manuals/en/console/console.kilepr index 0ce8fe86..37505b3b 100644 --- a/docs/manuals/en/console/console.kilepr +++ b/docs/manuals/en/console/console.kilepr @@ -3,7 +3,7 @@ img_extIsRegExp=false img_extensions=.eps .jpg .jpeg .png .pdf .ps .fig .gif kileprversion=2 kileversion=2.0 -lastDocument=console.tex +lastDocument=bconsole.tex masterDocument= name=Console pkg_extIsRegExp=false @@ -17,12 +17,12 @@ QuickBuild= [item:bconsole.tex] archive=true -column=0 -encoding= -highlight= -line=0 -open=false -order=-1 +column=56 +encoding=UTF-8 +highlight=LaTeX +line=1495 +open=true +order=1 [item:console.kilepr] archive=true @@ -35,10 +35,10 @@ order=-1 [item:console.tex] archive=true -column=18 +column=0 encoding=UTF-8 highlight=LaTeX -line=10 +line=9 open=true order=0 -- 2.39.5