]> git.sur5r.net Git - bacula/docs/blobdiff - docs/manuals/en/main/install.tex
Merge branch 'Branch-5.2' of bsweb:docs into Branch-5.2
[bacula/docs] / docs / manuals / en / main / install.tex
index ae98e1ebf67075706963f5175f0f8978b566da82..0caf87ada3410952773bdf7ee827750d408a866a 100644 (file)
@@ -546,12 +546,12 @@ For example, on Fedora, Red Hat, or SuSE one could use the following:
 \begin{verbatim}
 CFLAGS="-g -Wall" \
   ./configure \
-    --sbindir=$HOME/bacula/bin \
-    --sysconfdir=$HOME/bacula/bin \
-    --with-pid-dir=$HOME/bacula/bin/working \
-    --with-subsys-dir=$HOME/bacula/bin/working \
+    --sbindir=/opt/bacula/bin \
+    --sysconfdir=/opt/bacula/etc \
+    --with-pid-dir=/var/run \
+    --with-subsys-dir=/var/run \
     --with-mysql \
-    --with-working-dir=$HOME/bacula/bin/working \
+    --with-working-dir=/opt/bacula/working \
     --with-dump-email=$USER
 \end{verbatim}
 \normalsize
@@ -634,25 +634,32 @@ because SQLite is compiled into Bacula an requires no administration. It
 performs well and is suitable for small to medium sized installations (maximum
 10-20 machines). However, we should note that a number of users have
 had unexplained database corruption with SQLite. For that reason, we
-recommend that you install either MySQL or PostgreSQL for production
+recommend that you install either PostgreSQL or MySQL for production
 work.
 
-If you wish to use MySQL as the Bacula catalog, please see the 
-\ilink{Installing and Configuring MySQL}{MySqlChapter} chapter of
-this manual. You will need to install MySQL prior to continuing with the
+If you wish to use MySQL as the Bacula catalog, please see the
+\ilink{Installing and Configuring MySQL}{MySqlChapter} chapter of this
+manual. You will need to install MySQL prior to continuing with the
 configuration of Bacula. MySQL is a high quality database that is very
-efficient and is suitable for any sized installation. It is slightly more
-complicated than SQLite to setup and administer because it has a number of
-sophisticated features such as userids and passwords. It runs as a separate
-process, is truly professional and can manage a database of any size. 
-
-If you wish to use PostgreSQL as the Bacula catalog, please see the 
-\ilink{Installing and Configuring PostgreSQL}{PostgreSqlChapter}
-chapter of this manual. You will need to install PostgreSQL prior to
-continuing with the configuration of Bacula. PostgreSQL is very similar to
-MySQL, though it tends to be slightly more SQL92 compliant and has many more
-advanced features such as transactions, stored procedures, and the such. It
-requires a certain knowledge to install and maintain. 
+efficient and is suitable for small and medium sized installation (up to
+2,000,000 files per job). It is slightly more complicated than SQLite to setup
+and administer because it has a number of sophisticated features such as
+userids and passwords. It runs as a separate process, is truly professional and
+can manage a database of any size.
+
+If you wish to use PostgreSQL as the Bacula catalog, please see the
+\ilink{Installing and Configuring PostgreSQL}{PostgreSqlChapter} chapter of
+this manual. You will need to install PostgreSQL prior to continuing with the
+configuration of Bacula. PostgreSQL is very similar to MySQL, though it tends
+to be slightly more SQL92 compliant and has many more advanced features such as
+transactions, stored procedures, and the such. It requires a certain knowledge
+to install and maintain. PostgreSQL is suitable for any sized installation
+(some sites have much more than 1 billion objects in the Catalog). Bacula uses
+many optimized PostgreSQL functions, and can run more than 10 time faster on
+jobs having millions of files than MySQL (Specially in during restore, accurate
+mode, bvfs queries and when the database server is not on the same host than
+the Director). It's possible to switch from MySQL/SQLite to PostgreSQL, but it
+requires some DBA knowledge.
 
 If you wish to use SQLite as the Bacula catalog, please see 
 \ilink{Installing and Configuring SQLite}{SqlLiteChapter} chapter of
@@ -695,7 +702,10 @@ customize your installation.
    This option is meant to allow you to direct where the architecture
    independent files should be placed.  However, we find this a somewhat
    vague concept, and so we have not implemented this option other than
-   what ./configure does by default.  As a consequence, we suggest that
+   to use any explicit prefix that you may define.  If you do not
+   explicitly specify a prefix, Bacula's configure routine will not use
+   the default value that ./configure --help prints.
+   As a consequence, we suggest that
    you avoid it. We have provided options that allow you to explicitly
    specify the directories for each of the major categories of installation
    files.
@@ -707,7 +717,9 @@ customize your installation.
 \item [ {-}{\-}sysconfdir=\lt{}config-path\gt{}]
    \index[general]{{-}{\-}sysconfdir}
    Defines where the Bacula configuration files should be placed during a
-   {\bf make install} command.
+   {\bf make install} command.  Note, for security reasons,
+   this directory should be unique to Bacula and not read/writable by
+   any other user/group than Bacula is running under.
 
 \item [ {-}{\-}mandir=\lt{}path\gt{}]
    \index[general]{{-}{\-}mandir}
@@ -1111,8 +1123,8 @@ $ nm /usr/local/lib/libpq.a | grep mutex
    The working directory  is not automatically created by the install process, so
    you  must ensure that it exists before using Bacula for the  first time. 
 
-\item [ {-}{\-}with-base-port=\lt{}port=number\gt{}]
-   \index[general]{{-}{\-}with-base-port}
+\item [ {-}{\-}with-baseport=\lt{}port=number\gt{}]
+   \index[general]{{-}{\-}with-baseport}
    In order to run,  Bacula needs three TCP/IP ports (one for the Bacula 
    Console, one for the Storage daemon, and one for the File daemon).  The {\bf
    \verb:--:with-baseport} option will automatically assign three  ports beginning at
@@ -1257,12 +1269,11 @@ For most systems, we recommend starting with the following options:
 \begin{verbatim}
 ./configure \
   --enable-smartalloc \
-  --sbindir=$HOME/bacula/bin \
-  --sysconfdir=$HOME/bacula/bin \
-  --with-pid-dir=$HOME/bacula/bin/working \
-  --with-subsys-dir=$HOME/bacula/bin/working \
-  --with-mysql=$HOME/mysql \
-  --with-working-dir=$HOME/bacula/working
+  --sbindir=/opt/bacula/bin \
+  --sysconfdir=/opt/bacula/etc \
+  --with-pid-dir=/opt/bacula/working \
+  --with-subsys-dir=/opt/bacula/working \
+  --with-working-dir=/opt/bacula/working
 \end{verbatim}
 \normalsize
 
@@ -1284,15 +1295,15 @@ Using SQLite:
 \begin{verbatim}
  
 CFLAGS="-g -Wall" ./configure \
-  --sbindir=$HOME/bacula/bin \
-  --sysconfdir=$HOME/bacula/bin \
+  --sbindir=/opt/bacula/bin \
+  --sysconfdir=/opt/bacula/etc \
   --enable-smartalloc \
   --with-sqlite=$HOME/bacula/depkgs/sqlite \
-  --with-working-dir=$HOME/bacula/working \
-  --with-pid-dir=$HOME/bacula/bin/working \
-  --with-subsys-dir=$HOME/bacula/bin/working \
+  --with-working-dir=/opt/bacula/working \
+  --with-pid-dir=/opt/bacula/working \
+  --with-subsys-dir=/opt/bacula/working \
   --enable-bat \
-  --enable-conio
+  --enable-readline
 \end{verbatim}
 \normalsize
 
@@ -1302,18 +1313,20 @@ or
 \begin{verbatim}
  
 CFLAGS="-g -Wall" ./configure \
-  --sbindir=$HOME/bacula/bin \
-  --sysconfdir=$HOME/bacula/bin \
+  --sbindir=/opt/bacula/bin \
+  --sysconfdir=/opt/bacula/etc \
   --enable-smartalloc \
-  --with-mysql=$HOME/mysql \
-  --with-working-dir=$HOME/bacula/working
-  --with-pid-dir=$HOME/bacula/bin/working \
-  --with-subsys-dir=$HOME/bacula/bin/working
-  --enable-conio
+  --with-mysql \
+  --with-working-dir=/opt/bacula/working
+  --with-pid-dir=/opt/bacula/working \
+  --with-subsys-dir=/opt/bacula/working
+  --enable-readline
 \end{verbatim}
 \normalsize
 
-or finally, a completely traditional Red Hat Linux install: 
+or finally, a completely traditional Red Hat Linux install,
+which we do not recommend, because it make it harder to
+backup Bacula for disaster recovery purposes:
 
 \footnotesize
 \begin{verbatim}
@@ -1326,7 +1339,7 @@ CFLAGS="-g -Wall" ./configure \
   --with-mysql \
   --with-working-dir=/var/bacula \
   --with-pid-dir=/var/run \
-  --enable-conio
+  --enable-readline
 \end{verbatim}
 \normalsize
 
@@ -1352,21 +1365,16 @@ A typical configuration command might look like:
 \begin{verbatim}
 #!/bin/sh
 CFLAGS="-g" ./configure \
-  --sbindir=$HOME/bacula/bin \
-  --sysconfdir=$HOME/bacula/bin \
-  --with-mysql=$HOME/mysql \
+  --sbindir=/opt/bacula/bin \
+  --sysconfdir=/opt/bacula/etc \
+  --with-mysql \
   --enable-smartalloc \
-  --with-pid-dir=$HOME/bacula/bin/working \
-  --with-subsys-dir=$HOME/bacula/bin/working \
-  --with-working-dir=$HOME/bacula/working
+  --with-pid-dir=/opt/bacula/working \
+  --with-subsys-dir=/opt/bacula/working \
+  --with-working-dir=/opt/bacula/working
 \end{verbatim}
 \normalsize
 
-As mentioned above, the install process will create the sbindir and sysconfdir
-if they do not exist, but it will not automatically create the pid-dir,
-subsys-dir, or working-dir, so you must ensure that they exist before running
-Bacula for the first time.
-
 Note, you may need to install the following packages to build Bacula
 from source:
 \footnotesize
@@ -1382,6 +1390,7 @@ SUNWgccruntime
 SUNWlibgcrypt
 SUNWzlib
 SUNWzlibs
+SUNWreadline
 SUNWbinutilsS
 SUNWGmakeS
 SUNWlibm
@@ -1438,7 +1447,7 @@ To install the binary Win32 version of the File daemon please see the
 \index[general]{One Files Configure Script}
 
 The following script could be used if you want to put everything
-in a single file:
+in a single directory (except for the working directory):
 
 \footnotesize
 \begin{verbatim}
@@ -1450,8 +1459,6 @@ CFLAGS="-g -Wall" \
     --mandir=$HOME/bacula/bin \
     --enable-smartalloc \
     --enable-bat \
-    --enable-bwx-console \
-    --enable-tray-monitor \
     --with-pid-dir=$HOME/bacula/bin/working \
     --with-subsys-dir=$HOME/bacula/bin/working \
     --with-mysql \
@@ -1702,7 +1709,7 @@ System tray has been supported in KDE since version 3.1. To activate it,
 right-click on one of your panels, open the menu {\bf Add}, then {\bf Applet}
 and finally click on {\bf System Tray}. 
 
-\subsection{Other window managers}
+\subsection{Other Window Managers}
 \index[general]{Managers!Other window}
 \index[general]{Other window managers}