From: Kern Sibbald <kern@sibbald.com>
Date: Sun, 9 Dec 2012 15:23:42 +0000 (+0100)
Subject: Tweak installation chapter
X-Git-Url: https://git.sur5r.net/?a=commitdiff_plain;h=1b3707e0bb2d92b2985434d22761edfc9a476198;p=bacula%2Fdocs

Tweak installation chapter
---

diff --git a/docs/manuals/en/main/install.tex b/docs/manuals/en/main/install.tex
index 2eda4af1..89a4c499 100644
--- a/docs/manuals/en/main/install.tex
+++ b/docs/manuals/en/main/install.tex
@@ -536,12 +536,12 @@ For example, on Fedora, Red Hat, or SuSE one could use the following:
 \begin{lstlisting}
 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{lstlisting}
 \normalsize
@@ -707,7 +707,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}
@@ -1258,12 +1260,11 @@ For most systems, we recommend starting with the following options:
 \begin{lstlisting}
 ./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{lstlisting}
 \normalsize
 
@@ -1285,15 +1286,15 @@ Using SQLite:
 \begin{lstlisting}
 
 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{lstlisting}
 \normalsize
 
@@ -1303,18 +1304,20 @@ or
 \begin{lstlisting}
 
 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{lstlisting}
 \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{lstlisting}
@@ -1327,7 +1330,7 @@ CFLAGS="-g -Wall" ./configure \
   --with-mysql \
   --with-working-dir=/var/bacula \
   --with-pid-dir=/var/run \
-  --enable-conio
+  --enable-readline
 \end{lstlisting}
 \normalsize
 
@@ -1353,21 +1356,16 @@ A typical configuration command might look like:
 \begin{lstlisting}
 #!/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{lstlisting}
 \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
@@ -1383,6 +1381,7 @@ SUNWgccruntime
 SUNWlibgcrypt
 SUNWzlib
 SUNWzlibs
+SUNWreadline
 SUNWbinutilsS
 SUNWGmakeS
 SUNWlibm
@@ -1439,7 +1438,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{lstlisting}
@@ -1451,8 +1450,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 \
@@ -1703,7 +1700,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}