From: Kern Sibbald Date: Sun, 10 Sep 2006 07:30:21 +0000 (+0000) Subject: Update X-Git-Tag: Release-2.0.0~468 X-Git-Url: https://git.sur5r.net/?a=commitdiff_plain;h=247fe49adc9fc3daf9695472cd3cdf180ce7657c;p=bacula%2Fdocs Update --- diff --git a/docs/manual/install.tex b/docs/manual/install.tex index 1315cd60..f6d548fb 100644 --- a/docs/manual/install.tex +++ b/docs/manual/install.tex @@ -38,7 +38,7 @@ the Bacula CVS. The released files are: \item [bacula-docs-1.38.0.tar.gz] This file contains a copy of the docs directory with the - documents prebuild. English html directory, single html + documents prebuild. English HTML directory, single HTML file, and pdf file. The French and German translations are in progress, but are not built. @@ -72,12 +72,13 @@ the Bacula CVS. The released files are: \addcontentsline{toc}{subsection}{Upgrading Bacula} If you are upgrading from one Bacula version to another, you should first -carefully read the ReleaseNotes of all versions between your current version -and the version to which you are upgrading. If the Bacula catalog database has -been upgraded (as it is almost every major release), -you will either need to reinitialize your database starting -from scratch, or save an ASCII copy of your database, then proceed to upgrade -it. This is normally done after Bacula is build and installed by: +carefully read the ReleaseNotes of all versions between your current +version and the version to which you are upgrading. If the Bacula catalog +database has been upgraded (as it is almost every major release), you will +either need to reinitialize your database starting from scratch (not +normally a good idea), or save an ASCII copy of your database, then proceed +to upgrade it. This is normally done after Bacula is build and installed +by: \begin{verbatim} cd (default /etc/bacula) @@ -120,6 +121,35 @@ and you must do both the {\bf make} and {\bf make install} commands, a For additional information on upgrading, please see the \ilink{Upgrading Bacula Versions}{upgrading} in the Tips chapter of this manual. +\subsection*{Beta Releases} +\index[general]{Beta Releases} +\addcontentsline{toc}{subsection}{Beta Releases} +Towards the end of the development cycle, which typically runs +one year from a major release to another, there will be several beta +releases of the development code prior to a production release. The +purpose of the beta releases is to allow users to test the new code. +Beta releases are made with the following considerations: +\begin{itemize} +\item The code passes the regression testing on Linux, + FreeBSD, and Solaris machines. Including tape drive testing + on Linux and FreeBSD (not currently on Solaris). +\item There are no known major bugs. +\item Some of the new code/features will not yet be tested. +\item Bugs are expected to be found, especially in the new + code before the final production release. +\item The code will be in production in at least one small + site (mine). +\item The Win32 client will have been run in production at least + one night at that small site. +\item The documentation is unlikely to be complete especially + for the new features, and the Release Notes may not be fully + organized. +\item Beta code is not generally recommended for everyone, but + rather for early adopters. +\end{itemize} + + + \subsection*{Dependency Packages} \label{Dependency} @@ -1150,25 +1180,6 @@ probably not work. To install the binary Win32 version of the File daemon please see the \ilink{Win32 Installation Chapter}{_ChapterStart7} in this document. -\subsection*{Windows Systems with CYGWIN Installed} -\label{Win32} -\index[general]{Windows Systems with CYGWIN Installed } -\index[general]{Installed!Windows Systems with CYGWIN } -\addcontentsline{toc}{subsection}{Windows Systems with CYGWIN Installed} - -As of version 1.34, Bacula no longer uses CYGWIN for the Win32 File daemon. -However, it is still built under a CYGWIN build environment -- though you -can probably do it with VC Studio only. If you wish to build the Win32 -File daemon from the source, you will need Microsoft C++ version 7.1. -Details for building the Win32 FD are in the README.win32 file of the -src/win32 directory. - -Note, although most parts of Bacula build on Windows systems, the only part -that we have tested and used is the File daemon. - -Finally, you should follow the installation instructions in the -\ilink{Win32 Installation}{_ChapterStart7} section of this document. - \subsection*{Kern's Configure Script} \index[general]{Script!Kern's Configure } \index[general]{Kern's Configure Script } @@ -1184,27 +1195,22 @@ CFLAGS="-g -Wall" \ ./configure \ --sbindir=$HOME/bacula/bin \ --sysconfdir=$HOME/bacula/bin \ + --mandir=$HOME/bacula/bin \ --enable-smartalloc \ --enable-gnome \ + --enable-wx-console \ + --enable-tray-monitor \ --with-pid-dir=$HOME/bacula/bin/working \ --with-subsys-dir=$HOME/bacula/bin/working \ - --with-mysql=$HOME/mysql \ + --with-mysql \ --with-working-dir=$HOME/bacula/bin/working \ - --with-dump-email=$USER \ - --with-smtp-host=mail.your-site.com \ - --with-baseport=9101 + --with-dump-email=$USER@your-site.com \ + --with-job-email=$USER@your-site.com \ + --with-smtp-host=mail.your-site.com exit 0 \end{verbatim} \normalsize -Note that I define the base port as 9101, which means that Bacula will use -port 9101 for the Director console, port 9102 for the File daemons, and port -9103 for the Storage daemons. These ports should be available on all systems -because they have been officially assigned to Bacula by IANA (Internet -Assigned Numbers Authority). We strongly recommend that you use only these -ports to prevent any conflicts with other programs. This is in fact the -default if you do not specify a {\bf \verb:--:with-baseport} option. - You may also want to put the following entries in your {\bf /etc/services} file as it will make viewing the connections made by Bacula easier to recognize (i.e. netstat -a): @@ -1250,7 +1256,7 @@ configuration file {\bf bacula-fd.conf} then modify the name and password in the conf file to be unique. Be sure to make corresponding additions to the Director's configuration file ({\bf bacula-dir.conf}). -If the architecture or the O/S level are different, you will need to build a +If the architecture or the OS level are different, you will need to build a File daemon on the Client machine. To do so, you can use the same {\bf ./configure} command as you did for your main program, starting either from a fresh copy of the source tree, or using {\bf make\ distclean} before the {\bf @@ -1410,6 +1416,7 @@ startmysql stopmysql wx-console wx-console.conf +9 man pages \end{verbatim} \normalsize diff --git a/docs/manual/state.tex b/docs/manual/state.tex index 9130464d..392ad19d 100644 --- a/docs/manual/state.tex +++ b/docs/manual/state.tex @@ -44,7 +44,7 @@ In other words, what is and what is not currently implemented and functional. \item Restore Features \begin{itemize} - \item Restore of one or more files selected interactively either for the + \item Restore of one or more files selected interactively either for the current backup or a backup prior to a specified time and date. \item Restore of a complete system starting from bare metal. This is mostly automated for Linux systems and partially automated for Solaris. See @@ -55,6 +55,8 @@ In other words, what is and what is not currently implemented and functional. when Bacula and/or the catalog are not available. Note, the recommended way to restore files is using the restore command in the Console. These programs are designed for use as a last resort. + \item Ability to restore the catalog database rapidly by using bootstrap + files (previously saved). \item Ability to recreate the catalog database by scanning backup Volumes using the {\bf bscan} program. \end{itemize} @@ -63,8 +65,8 @@ In other words, what is and what is not currently implemented and functional. \begin{itemize} \item Catalog database facility for remembering Volumes, Pools, Jobs, and Files backed up. - \item Support for SQLite, PostgreSQL, and MySQL Catalog databases. - \item User extensible queries to the SQLite, PostgreSQL and MySQL databases. + \item Support for MySQL, PostgreSQL, and SQLite Catalog databases. + \item User extensible queries to the MySQL, PostgreSQL and SQLite databases. \end{itemize} \item Advanced Volume and Pool Management @@ -82,6 +84,8 @@ In other words, what is and what is not currently implemented and functional. sets segregated by Client, ...). \item Machine independent Volume data format. Linux, Solaris, and Windows clients can all be backed up to the same Volume if desired. + \item The Volume data format is upwards compatible so that old Volumes + can always be read. \item A flexible \ilink{ message}{MessageResource} handler including routing of messages from any daemon back to the Director and automatic email @@ -115,8 +119,7 @@ In other words, what is and what is not currently implemented and functional. \item Access control lists for Consoles that permit restricting user access to only their data. \item Support for save/restore of files larger than 2GB. - \item Support for 64 bit machines, e.g. amd64. - \item Ability to encrypt communications between daemons using stunnel. + \item Support for 64 bit machines, e.g. amd64, Sparc. \item Support ANSI and IBM tape labels. \item Support for Unicode filenames (e.g. Chinese) on Win32 machines on version 1.37.28 and greater. diff --git a/docs/manual/version.tex b/docs/manual/version.tex index 1b85adc4..09bb6b4b 100644 --- a/docs/manual/version.tex +++ b/docs/manual/version.tex @@ -1 +1 @@ -1.39.22 (07 Septermber 2006) +1.39.22 (08 September 2006) diff --git a/docs/manual/win32.tex b/docs/manual/win32.tex index 5f0ee44e..8226222d 100644 --- a/docs/manual/win32.tex +++ b/docs/manual/win32.tex @@ -44,19 +44,25 @@ This install is standard Windows .exe that runs an install wizard using the NSIS Free Software installer, so if you have already installed Windows software, it should be very familiar to you. -If you have a previous version Cygwin of Bacula (1.32 or lower) +If you have a previous version Bacula (1.39.20 or lower) installed, you should stop the service, uninstall it, and remove the Bacula installation directory possibly saving your -bacula-fd.conf file for use with the new version you will -install. Current versions of Bacula do not use Cygwin and has -far fewer files than the old Cygwin version, so it is better to -start with a clean directory. - -If you have Bacula version 1.38 or lower, we recommend the same procedure -as mentioned in the paragraph above. This is because Bacula 1.39 and -greater installs a bit differently from previous versions. There are -different registry keys, ... that are better cleaned up before installing -the new version. +bacula-fd.conf, bconsole.conf, and wx-console.conf files +for use with the new version you will install. The Uninstall +program is normally found in {\bf c:\textbackslash{}bacula\textbackslash{}Uninstall.exe}. +We also recommend that you completely remove the directory +{\bf c:\textbackslash{}bacula}, because the current installer +uses a different directory structure (see below). + +Providing you do not already have Bacula installed, +the new installer (1.39.22 and later) installs the binaries and dlls in +c:\textbackslash{}Program Files\textbackslash{}Bacula\textbackslash{}bin +and the configuration files +in c:\textbackslash{}Documents and Settings\textbackslash{}All Users\textbackslash{}Application Data\textbackslash{}Bacula +In addition, the {\bf Start\-\gt{}All Programs\-\gt{}Bacula} menu item +will be created during the installation, and on that menu, you +will find items for editing the configuration files, displaying +the document, and starting wx-console or bconsole. Finally, proceed with the installation. @@ -70,13 +76,19 @@ Finally, proceed with the installation. another. \includegraphics{./win32-nsis.eps} winbacula-1.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} \includegraphics{./win32-welcome.eps} -\ + +\item Next you will be asked to select the installation type. + +\addcontentsline{lof}{figure}{Win32 Installation Type} +\includegraphics{./win32-installation-type.eps} + + \item If you proceed, you will be asked to select the components to be installed. You may install the Bacula program (Bacula File Service) and or the documentation. Both will be installed in sub-directories of the install @@ -86,42 +98,20 @@ Finally, proceed with the installation. \addcontentsline{lof}{figure}{Win32 Component Selection Dialog} \includegraphics{./win32-pkg.eps} -\item Next you will be asked to select an installation directory. - -\addcontentsline{lof}{figure}{Win32 Directory Selection Dialog} -\includegraphics{./win32-location.eps} +\item If you are installing for the first time, you will be asked to + enter some very basic information about your configuration. If + you are not sure what to enter, or have previously saved configuration + files, you can put anything you want into the fields, then either + replace the configuration files later with the ones saved, or edit + the file. -\item If you are installing for the first time, you will be asked if you want - to edit the bacula-fd.conf file, and if you respond with yes, it will be - opened in notepad. Note, if you have installed Bacula to a drive other - than C: you probably should prefix the installation drive name to each - of the directory references in the bacula-fd.conf file, in particular - the {\bf WorkingDirectory} and the {\bf Pid Directory} directives. + If you are upgrading an existing installation, the following will + not be displayed. - Also, if you do not wish to see the full listing of all files restored - in the job output after running a restore job, you can add {\bf , - !restored} to the {\bf director} directive in the {\bf Messages} - resource. \addcontentsline{lof}{figure}{Win32 Configure} \includegraphics{./win32-config.eps} -\item Then the installer will display a dialog that allows you to - to install Bacula as a service. You should always choose to do so. - It also permits you to start the service. Normally you should check - the box, and any running Bacula will be shutdown and the new one started. You - may see a DOS box momentarily appear on the screen as the service is started. - It should disappear in a second or two: - -\addcontentsline{lof}{figure}{Win32 Client Service Selection} -\includegraphics{./win32-service.eps} - - -\item If everything goes well, you will receive the following confirmation: - - \addcontentsline{lof}{figure}{Win32 Client Service Confirmation} - \includegraphics{./win32-service-ok.eps} - \item While the various files are being loaded, you will see the following dialog: @@ -160,9 +150,9 @@ when you log into the console, but the remote desktop may not display it. \addcontentsline{toc}{subsection}{Post Win32 Installation} After installing Bacula and before running it, you should check the contents -of {\bf -c:\textbackslash{}bacula\textbackslash{}bin\textbackslash{}bacula-fd.conf} to -ensure that it corresponds to your configuration. +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 @@ -187,8 +177,7 @@ Windows Add/Remove Programs dialog found on the Control panel. The most likely source of problems is authentication when the Director attempts to connect to the File daemon that you installed. This can occur if the names and the passwords defined in the File daemon's configuration file -{\bf -c:\textbackslash{}bacula\textbackslash{}bin\textbackslash{}bacula-fd.conf} on +{\bf bacula-fd.conf} file on the Windows machine do not match with the names and the passwords in the Director's configuration file {\bf bacula-dir.conf} located on your Unix/Linux server.