Merge pull request #7 from joergsteffens/joergs/travis

fixes refcheck and add some small improvements

manuals/en/main/bareos-manual-main-reference.tex

@@ -34,7 +34,11 @@
 \usepackage{caption} % captionof
 % mdframed does not work on openSUSE 12.2
 %\usepackage{mdframed}
-\usepackage{refcheck}
+
+% check for undefined references (refcheck), 
+% but don't write them as marginal notes, 
+% instead only write remarks to the log file
+\usepackage[norefs,nocites]{refcheck}
 
 \usepackage{bareos}
 

manuals/en/main/coverpage.tex

@@ -12,7 +12,7 @@
       \vspace{0.2in}
       Copyright {\copyright} 1999-2012, Free Software Foundation Europe e.V. \\
       Copyright {\copyright} 2010-2012, Planets Communications B.V. \\
-      Copyright {\copyright} 2013-2013, Bareos GmbH \& Co. KG \\
+      Copyright {\copyright} 2013-2014, Bareos GmbH \& Co. KG \\
       Bareos {\textregistered} is a registered trademark of Bareos GmbH \& Co KG.\\
       Bacula {\textregistered} is a registered trademark of Kern Sibbald.\\
       \vspace{0.2in}

manuals/en/main/general.tex

@@ -166,11 +166,14 @@ \section{Conventions Used in this Document}
 If you are reading this manual as supplied in a released version of the
 software, the above paragraph holds true. If you are reading the online
 version of the manual,
-\elink{www.bareos.org}{http://www.bareos.org}, please bear in
+\elink{http://www.bareos.org}{http://www.bareos.org}, please bear in
 mind that this version describes the current version in development
 that may contain features not in the released version. Just the same, it
 generally lags behind the code a bit.
 
+The source of this document is available at \elink{https://github.com/bareos/bareos-docs}{https://github.com/bareos/bareos-docs}. 
+As with the rest of the Bareos project, you are welcome to participate and improve it.
+
 \section{Quick Start}
 
 To get Bareos up and running quickly, the author recommends

manuals/en/main/install.tex

@@ -47,7 +47,7 @@ \subsubsection{RHEL 6}
 
 For adding the repository:
 \begin{verbatim}
-wget -O /etc/yum.repos.d/bareos.repo http://download.bareos.org/bareos/release/12.4/RHEL_6/bareos.repo
+wget -O /etc/yum.repos.d/bareos.repo http://download.bareos.org/bareos/release/latest/RHEL_6/bareos.repo
 \end{verbatim}
 
 For using PostgreSQL backend:
@@ -70,7 +70,7 @@ \subsubsection{RHEL 5}
 
 First add the repository using:
 \begin{verbatim}
-wget -O /etc/yum.repos.d/bareos.repo http://download.bareos.org/bareos/release/12.4/RHEL_5/bareos.repo
+wget -O /etc/yum.repos.d/bareos.repo http://download.bareos.org/bareos/release/latest/RHEL_5/bareos.repo
 \end{verbatim}
 
 After that you can install with PostgreSQL backend:
@@ -93,7 +93,7 @@ \subsubsection{Fedora 18}
 
 For adding the repository:
 \begin{verbatim}
-wget -O /etc/yum.repos.d/bareos.repo http://download.bareos.org/bareos/release/12.4/Fedora_18/bareos.repo
+wget -O /etc/yum.repos.d/bareos.repo http://download.bareos.org/bareos/release/latest/Fedora_18/bareos.repo
 \end{verbatim}
 
 After that you can install with PostgreSQL backend:
@@ -108,29 +108,29 @@ \subsubsection{Fedora 18}
 
 \subsection{Install on SUSE based Linux Distributions}
 
-\subsubsection{SLES11 SP2}
+\subsubsection{SLES11 SP3}
 
 \begin{verbatim}
-zypper addrepo --refresh http://download.bareos.org/bareos/release/12.4/SLE_11_SP2/bareos.repo
+zypper addrepo --refresh http://download.bareos.org/bareos/release/latest/SLE_11_SP3/bareos.repo
 zypper install bareos bareos-database-mysql
 \end{verbatim}
 In this example using mysql as database backend.
 
-\subsubsection{openSUSE 12.3}
+\subsubsection{openSUSE 13.1}
 
 \begin{verbatim}
-zypper addrepo --refresh http://download.bareos.org/bareos/release/12.4/openSUSE_12.3/bareos.repo
+zypper addrepo --refresh http://download.bareos.org/bareos/release/latest/openSUSE_13.1/bareos.repo
 zypper install bareos bareos-database-mysql
 \end{verbatim}
 
 
 \subsection{Install on Debian based Linux Distributions}
 
 
-\subsubsection{Debian 6}
+\subsubsection{Debian 7}
 
 \begin{verbatim}
-URL=http://download.bareos.org/bareos/release/12.4/Debian_6.0/
+URL=http://download.bareos.org/bareos/release/latest/Debian_7.0/
 printf "deb $URL /\n" > /etc/apt/sources.list.d/bareos.list
 
 # add package key
@@ -143,7 +143,7 @@ \subsubsection{Debian 6}
 \subsubsection{Ubuntu 12.04}
 
 \begin{verbatim}
-URL=http://download.bareos.org/bareos/release/12.4/xUbuntu_12.04/
+URL=http://download.bareos.org/bareos/release/latest/xUbuntu_12.04/
 printf "deb $URL /\n" > /etc/apt/sources.list.d/bareos.list
 
 # add package key
@@ -205,3 +205,53 @@ \section{Start the daemons}
 You will eventually have to allow access to the ports 9101-9103, used by Bareos.
 
 Now you should be able to access the director using the bconsole.
+
+\section{Overview about Bareos Packages}
+
+Following Bareos Linux packages are available (release 13.2):
+
+% generated by
+% cd bareos:/bareos-13.2/SLE_11_SP3/x86_64
+% rpm -qp --qf '%{NAME} & %{SUMMARY} \\\\\n' *bareos*.rpm
+\begin{center}
+\begin{tabular}{ | l | l | }
+\hline
+\textbf{Package Name} & \textbf{Description} \\ \hline
+bareos & Bares All-In-One package (dir,sd,fd) \\
+bareos-bat & Provide Bareos Admin Tool gui \\
+bareos-bconsole & Provide ncurses administration console \\
+bareos-client & Meta-All-In-One package client package \\
+bareos-common & Generic libs needed by every package \\
+bareos-database-common & Generic abstration lib for the sql catalog \\
+bareos-database-mysql & Libs and tools for mysql catalog \\
+bareos-database-postgresql & Libs and tools for postgresql catalog \\
+bareos-database-sqlite3 & Libs and tools for sqlite3 catalog \\
+bareos-database-tools & Provides bareos-dbcheck, bscan \\
+bareos-devel & Devel headers \\
+bareos-director & Provide bareos director daemon \\
+bareos-filedaemon & Provide bareos file daemon service \\
+bareos-storage & Provide bareos storage daemon \\
+bareos-storage-tape & Provide bareos storage daemon tape support \\
+bareos-tools & Provides bcopy, bextract, bls, bregex, bwild \\
+bareos-traymonitor & Qt based tray monitor \\
+\hline
+\end{tabular}
+\end{center}
+
+Additionally, packages containing debug information are available.
+These are named differently depending on the distribution (\package{bareos-debuginfo} or \package{bareos-dbg} or  $\ldots$).
+%bareos-debuginfo & Debug information for package bareos \\
+%bareos-debugsource & Debug sources for package bareos \\
+
+Not all packages are required to run Bareos.
+
+\begin{itemize}
+    \item For the Bareos Director, the package \package{bareos-director} and one of \package{bareos-database-mysql}, \package{bareos-database-postgresql} or \package{bareos-database-sqlite3} are required (use \package{bareos-database-sqlite3} only for testing).
+
+    \item For the Bareos Storage Daemon, the package \package{bareos-storage} is required. If you plan to connect tape drives to the storage director, also install the package \package{bareos-storage-tape}. This is keeped separtly, because it has additional dependencies  for tape tools.
+
+    \item On a client, only the package \package{bareos-filedaemon} is required. If you run it on a workstation, the packages \package{bareos-traymonitor} gives the user information about running backups.
+
+    \item On a Backup Administration system you need to install at least \package{bareos-bconsole} to have an interactive console to the Bareos Director.
+
+\end{itemize}