]> git.sur5r.net Git - bacula/docs/commitdiff
Tweak installation chapter
authorKern Sibbald <kern@sibbald.com>
Sun, 9 Dec 2012 15:23:42 +0000 (16:23 +0100)
committerKern Sibbald <kern@sibbald.com>
Sun, 9 Dec 2012 15:23:42 +0000 (16:23 +0100)
docs/manuals/en/main/install.tex

index 7100d3ae539280665994380e2544ff1057337fd4..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
@@ -717,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}
@@ -1267,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
 
@@ -1294,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
 
@@ -1312,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}
@@ -1336,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
 
@@ -1362,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
@@ -1392,6 +1390,7 @@ SUNWgccruntime
 SUNWlibgcrypt
 SUNWzlib
 SUNWzlibs
+SUNWreadline
 SUNWbinutilsS
 SUNWGmakeS
 SUNWlibm
@@ -1448,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}
@@ -1460,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 \
@@ -1712,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}