From 8fd6d74cbadb3f605442c2895ae110fd671124ee Mon Sep 17 00:00:00 2001 From: Joerg Steffens Date: Thu, 6 Feb 2014 12:38:23 +0100 Subject: [PATCH] fixes refcheck and add some small improvements refcheck now only logs to the log file and do not create visible marks in the document. Describes the different Bareos packages and what to use for the different purposes. --- .../en/main/bareos-manual-main-reference.tex | 6 +- manuals/en/main/coverpage.tex | 2 +- manuals/en/main/general.tex | 5 +- manuals/en/main/install.tex | 70 ++++++++++++++++--- 4 files changed, 70 insertions(+), 13 deletions(-) diff --git a/manuals/en/main/bareos-manual-main-reference.tex b/manuals/en/main/bareos-manual-main-reference.tex index 3f792d9..fde5bf5 100644 --- a/manuals/en/main/bareos-manual-main-reference.tex +++ b/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} diff --git a/manuals/en/main/coverpage.tex b/manuals/en/main/coverpage.tex index 453eefd..df9a1d3 100644 --- a/manuals/en/main/coverpage.tex +++ b/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} diff --git a/manuals/en/main/general.tex b/manuals/en/main/general.tex index dd376e3..2a4cfae 100644 --- a/manuals/en/main/general.tex +++ b/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 diff --git a/manuals/en/main/install.tex b/manuals/en/main/install.tex index 4d1e60e..7fe5f2b 100644 --- a/manuals/en/main/install.tex +++ b/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,18 +108,18 @@ \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} @@ -127,10 +127,10 @@ \subsubsection{openSUSE 12.3} \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}