From 1b3707e0bb2d92b2985434d22761edfc9a476198 Mon Sep 17 00:00:00 2001 From: Kern Sibbald Date: Sun, 9 Dec 2012 16:23:42 +0100 Subject: [PATCH] Tweak installation chapter --- docs/manuals/en/main/install.tex | 81 +++++++++++++++----------------- 1 file changed, 39 insertions(+), 42 deletions(-) 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} -- 2.39.5