]> git.sur5r.net Git - bacula/docs/commitdiff
Update
authorKern Sibbald <kern@sibbald.com>
Sun, 10 Sep 2006 07:30:21 +0000 (07:30 +0000)
committerKern Sibbald <kern@sibbald.com>
Sun, 10 Sep 2006 07:30:21 +0000 (07:30 +0000)
docs/manual/install.tex
docs/manual/state.tex
docs/manual/version.tex
docs/manual/win32.tex

index 1315cd60ea83169fd89f2c149c6a60b66c59bd25..f6d548fbf04fee01ceba6efaea91c19f2442cadb 100644 (file)
@@ -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 <installed-scripts-dir> (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
 
index 9130464d6920c747f8bf8e1d74efc38c5180b24c..392ad19d12b7fd276d8e956a5e5834ac53d6877e 100644 (file)
@@ -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.
index 1b85adc42fdc799e03eaf226e481a7d1daa7f4e6..09bb6b4bbf8e385971650460182ff9d46c477b95 100644 (file)
@@ -1 +1 @@
-1.39.22 (07 Septermber 2006)
+1.39.22 (08 September 2006)
index 5f0ee44e2098e96a27363f7df2d95574c5ecd66c..8226222d243398d84b1e71ad91415f77004d429b 100644 (file)
@@ -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.