updated for bareos-17.2 including release notes

bareos · Dec 14, 2017 · 0c71d81 · 0c71d81
1 parent 487b3f4
commit 0c71d81
Show file tree

Hide file tree

Showing 11 changed files with 188 additions and 94 deletions.
diff --git a/manuals/en/main/bareos.sty b/manuals/en/main/bareos.sty
@@ -211,6 +211,7 @@
 \newcommand{\configresource}[1]{\path|#1|}
 \newcommand{\configline}[1]{\path|#1|}
 \newcommand{\directory}[1]{\path|#1|}
+\newcommand{\dbcolumn}[1]{\path|#1|}
 \newcommand{\dbtable}[1]{\path|#1|}
 \newcommand{\email}[1]{\url{#1}}
 \newcommand{\file}[1]{\path|#1|}

diff --git a/manuals/en/main/catmaintenance.tex b/manuals/en/main/catmaintenance.tex
@@ -9,16 +9,16 @@ \chapter{Catalog Maintenance}
 \section{Catalog Database}
 
 Bareos stores its catalog in a database.
-Different database backends are supported:
+Different database backends are offered:
 \begin{itemize}
-    \item PostgreSQL
+    \item PostgreSQL (recommended)
     \item MariaDB/MySQL (see \nameref{sec:MysqlSupport})
     \item Sqlite (only for testing)
 \end{itemize}
 
 What database will be used, can be configured in the \bareosDir configuration, see the \nameref{DirectorResourceCatalog}.
 
-The database often runs on the same server as the Bareos Director.
+The database often runs on the same server as the \bareosDir.
 However, it is also possible to run it on a different system.
 This might require some more manual configuration.
 
@@ -261,7 +261,9 @@ \subsubsection{PostgreSQL}
 By default, using PostgreSQL ident, a Unix user can access a database of the same name.
 Therefore the user \user{bareos} can access the database \path|bareos|.
 
-\begin{commands}{Verify Bareos database on PostgreSQL as Unix user bareos}
+
+
+\begin{commands}{Verify Bareos database on PostgreSQL as Unix user bareos (bareos-13.2.3)}
 root@linux:~# <input>su - bareos -s /bin/sh</input>
 bareos@linux:~# <input>psql</input>
 Welcome to psql 8.3.23, the PostgreSQL interactive terminal.
@@ -379,7 +381,7 @@ \subsubsection{MySQL}
 
 After this, run the Bareos database preparation scripts.
 For Bareos $<=$ 13.2.2, the database password must be specified as environment variable \variable{db_password}.
-From \sinceVersion{dir}{MySQL password from configuration file}{13.2.3} 
+From \sinceVersion{dir}{MySQL password from configuration file}{13.2.3}
 the database password is read from the configuration, if no environment variable is given.
 
 \begin{commands}{Setup Bareos catalog database}
@@ -444,6 +446,40 @@ \subsubsection{MySQL}
 +--------------------+
 30 rows in set (0.00 sec)
 
+mysql> <input>describe Job;</input>
++-----------------+---------------------+------+-----+---------+----------------+
+| Field           | Type                | Null | Key | Default | Extra          |
++-----------------+---------------------+------+-----+---------+----------------+
+| JobId           | int(10) unsigned    | NO   | PRI | NULL    | auto_increment |
+| Job             | tinyblob            | NO   |     | NULL    |                |
+| Name            | tinyblob            | NO   | MUL | NULL    |                |
+| Type            | binary(1)           | NO   |     | NULL    |                |
+| Level           | binary(1)           | NO   |     | NULL    |                |
+| ClientId        | int(11)             | YES  |     | 0       |                |
+| JobStatus       | binary(1)           | NO   |     | NULL    |                |
+| SchedTime       | datetime            | YES  |     | NULL    |                |
+| StartTime       | datetime            | YES  |     | NULL    |                |
+| EndTime         | datetime            | YES  |     | NULL    |                |
+| RealEndTime     | datetime            | YES  |     | NULL    |                |
+| JobTDate        | bigint(20) unsigned | YES  |     | 0       |                |
+| VolSessionId    | int(10) unsigned    | YES  |     | 0       |                |
+| VolSessionTime  | int(10) unsigned    | YES  |     | 0       |                |
+| JobFiles        | int(10) unsigned    | YES  |     | 0       |                |
+| JobBytes        | bigint(20) unsigned | YES  |     | 0       |                |
+| ReadBytes       | bigint(20) unsigned | YES  |     | 0       |                |
+| JobErrors       | int(10) unsigned    | YES  |     | 0       |                |
+| JobMissingFiles | int(10) unsigned    | YES  |     | 0       |                |
+| PoolId          | int(10) unsigned    | YES  |     | 0       |                |
+| FileSetId       | int(10) unsigned    | YES  |     | 0       |                |
+| PriorJobId      | int(10) unsigned    | YES  |     | 0       |                |
+| PurgedFiles     | tinyint(4)          | YES  |     | 0       |                |
+| HasBase         | tinyint(4)          | YES  |     | 0       |                |
+| HasCache        | tinyint(4)          | YES  |     | 0       |                |
+| Reviewed        | tinyint(4)          | YES  |     | 0       |                |
+| Comment         | blob                | YES  |     | NULL    |                |
++-----------------+---------------------+------+-----+---------+----------------+
+27 rows in set (0,00 sec)
+
 mysql> <input>select * from Version;</input>
 +-----------+
 | VersionId |
@@ -487,6 +523,11 @@ \subsubsection{MySQL}
 /usr/lib/bareos/scripts/grant_bareos_privileges
 \end{commands}
 
+
+\hide{
+% table and commands have changed in MySQL 5.7.6.
+% As things now get more complicated (different command for different version)
+% we skip this topic here.
 ... or modify the database users directly:
 
 \begin{commands}{Show Bareos database users}
@@ -520,7 +561,7 @@ \subsubsection{MySQL}
 
 mysql>
 \end{commands}
-
+}
 
 
 \subsubsection{Sqlite}
@@ -537,7 +578,7 @@ \subsubsection{Sqlite}
 Sqlite does not offer access permissions. The only permissions that do apply are the Unix file permissions.
 
 The database is accessable by following command:
-\begin{commands}{Verify Bareos database on Sqlite3}
+\begin{commands}{Verify Bareos database on Sqlite3 (bareos-13.2.3)}
 <command>sqlite3</command><input> /var/lib/bareos/bareos.db</input>
 SQLite version 3.7.6.3
 Enter ".help" for instructions
@@ -971,8 +1012,8 @@ \subsection{Repairing Your PostgreSQL Database}
 The same considerations apply as for \nameref{RepairingMySQL}.
 Consult the PostgreSQL documents for how to repair the database.
 
-For Bareos specific problems, 
-consider using \nameref{bareos-dbcheck} program .
+For Bareos specific problems,
+consider using \nameref{bareos-dbcheck} program.
 
 
 
@@ -989,11 +1030,14 @@ \subsection{MySQL/MariaDB Support}
 As MariaDB is a fork of MySQL, we use MySQL as synonym for MariaDB and fully support it.
 We test our packages against the preferred MySQL fork that a distribution provides.
 
+\hide{
+supporting MySQL >= 5.7 since bareos-17.2.4
 \limitation{MySQL}{MySQL $\geq$ 5.7 not supported}{%
 MySQL 5.7 did change it behavior in some respects. The result is, that the Bareos database creation scripts do not work any more.
 For the time being, we advise to use MariaDB instead, which is also the default on most Linux distributions.
 See \ticket{705}.
 }
+}
 
 \subsection{Compacting Your MySQL Database}
 \index[general]{Database!MySQL!Compacting}
@@ -1022,6 +1066,7 @@ \subsection{Compacting Your MySQL Database}
 \elink{http://dev.mysql.com/doc/refman/5.5/en/innodb-multiple-tablespaces.html}
 {http://dev.mysql.com/doc/refman/5.5/en/innodb-multiple-tablespaces.html} for details.
 
+\hide{
 \footnotesize
 \begin{verbatim}
 mysqldump -f --opt bareos > bareos.sql
@@ -1032,6 +1077,7 @@ \subsection{Compacting Your MySQL Database}
 
 Depending on the size of your database, this will take more or less time and a
 fair amount of disk space.
+}
 
 \subsection{Repairing Your MySQL Database}
 \index[general]{Database!Repairing Your MySQL}
@@ -1042,7 +1088,7 @@ \subsection{Repairing Your MySQL Database}
 Bareos hangs each time it tries to access the database, you should consider
 running MySQL's database check and repair routines.
 
-This can be done by running the {\bf mysqlcheck } command:
+This can be done by running the \command{mysqlcheck} command:
 \footnotesize
 \begin{verbatim}
 mysqlcheck --all-databases
@@ -1203,7 +1249,7 @@ \section{Database Performance Issues}
 sure your checkpoint\_segments is set to at least 8.
 }
 
-
+\hide{
 \section{Performance Issues Indexes}
 \index[general]{Database Performance Issues Indexes}
 \index[general]{Performance!Database}
@@ -1315,7 +1361,7 @@ \subsection{SQLite Indexes}
 CREATE INDEX file_jobid_idx on File (JobId);
 \end{verbatim}
 \normalsize
-
+}
 
 
 \section{Backing Up Your Bareos Database}

diff --git a/manuals/en/main/general.tex b/manuals/en/main/general.tex
@@ -160,20 +160,21 @@ \section{Bareos Version Numbers and Releases}
 \section{Bareos Packages}
     \label{sec:BareosPackages}
 
-Following Bareos Linux packages are available (release 14.2):
+Following Bareos Linux packages are available (release 17.2.4):
 
 % generated by
 % cd bareos:/bareos-13.2/SLE_11_SP3
 % rpm -qp --qf '%{NAME} | %{SUMMARY} \\\\\n' */*bareos*.rpm | sed -e 's/&/and/g' -e 's/|/\&/' | sort | uniq
 % cd /srv/obs/repos/bareos:/bareos-15.2/RHEL_7
 % rpm -qp --qf '%{NAME} | %{SUMMARY} \\\\\n' */*bareos*.rpm | sed -e 's/&/and/g' -e 's/|/\&/' | grep -v debuginfo | sort | uniq
+% cd /srv/obs/repos/bareos:/bareos-17.2/RHEL_7
+% rpm -qp --qf '%{NAME} | %{SUMMARY} \\\\\n' */*bareos*.rpm | sed -e 's/&/and/g' -e 's/|/\&/' | grep -v debuginfo | sort | uniq
 \begin{center}
 \begin{tabular}{ | l | l | }
 \hline
 \textbf{Package Name} & \textbf{Description} \\
 \hline
 bareos & Backup Archiving REcovery Open Sourced - metapackage \\
-bareos-bat & Bareos Admin Tool (GUI) \\
 bareos-bconsole & Bareos administration console (CLI) \\
 bareos-client & Bareos client Meta-All-In-One package \\
 bareos-common & Common files, required by multiple Bareos packages \\
@@ -190,8 +191,10 @@ \section{Bareos Packages}
 bareos-filedaemon-glusterfs-plugin & GlusterFS plugin for Bareos File daemon \\
 bareos-filedaemon-ldap-python-plugin & LDAP Python plugin for Bareos File daemon \\
 bareos-filedaemon-python-plugin & Python plugin for Bareos File daemon \\
+bareos-regress-config & Required files for bareos-regress \\
 bareos-storage & Bareos Storage daemon \\
 bareos-storage-ceph & CEPH support for the Bareos Storage daemon \\
+bareos-storage-droplet & Object Storage support (through libdroplet) for the Bareos Storage daemon \\
 bareos-storage-fifo & FIFO support for the Bareos Storage backend \\
 bareos-storage-glusterfs & GlusterFS support for the Bareos Storage daemon \\
 bareos-storage-python-plugin & Python plugin for Bareos Storage daemon \\
@@ -200,8 +203,10 @@ \section{Bareos Packages}
 bareos-traymonitor & Bareos Tray Monitor (QT) \\
 bareos-vadp-dumper & VADP Dumper - vStorage APIs for Data Protection Dumper program \\
 bareos-vmware-plugin & Bareos VMware plugin \\
+bareos-vmware-plugin-compat & Bareos VMware plugin compatibility \\
 bareos-vmware-vix-disklib & VMware vix disklib distributable libraries \\
 bareos-webui & Bareos Web User Interface \\
+python-bareos & Backup Archiving REcovery Open Sourced - Python module \\
 \hline
 \end{tabular}
 \end{center}
@@ -217,7 +222,7 @@ \section{Bareos Packages}
 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-postgresql}, \package{bareos-database-mysql} or \package{bareos-database-sqlite3} are required (use \package{bareos-database-sqlite3} only for testing).
+    \item For the Bareos Director, the package \package{bareos-director} and one of \package{bareos-database-postgresql}, \package{bareos-database-mysql} or \package{bareos-database-sqlite3} are required. It is recommended to use \package{bareos-database-postgresql}.
 
     \item For the \bareosSd, 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 kept separately, because it has additional dependencies  for tape tools.
 

diff --git a/manuals/en/main/howto.tex b/manuals/en/main/howto.tex
@@ -759,12 +759,11 @@ \subsubsection{Backup of MySQL Databases using the Bareos MySQL Percona xtraback
 \paragraph{Configuration}
 % \newline
 
-Activate your plugin directory in the fd resource conf on the client. See \nameref{fdPlugins} for more about plugins in general.
+Activate your plugin directory in the \bareosFd configuration. See \nameref{fdPlugins} for more about plugins in general.
 
-\begin{bareosConfigResource}{bareos-fd}{client}{mysql-fd}
+\begin{bareosConfigResource}{bareos-fd}{client}{myself}
 Client {
-  Name = mysql-fd
-  #...
+  ...
   Plugin Directory = /usr/lib64/bareos/plugins
   Plugin Names = "python"
 }
@@ -849,9 +848,8 @@ \subsubsection{Backup of MySQL Databases using the Python MySQL plugin}
   \item disable bacula compatibility (default for Bareos $>=$ 15.2)
 \end{itemize}
 
-\begin{bareosConfigResource}{bareos-fd}{client}{mysql-fd}
+\begin{bareosConfigResource}{bareos-fd}{client}{myself}
 Client {
-  Name = mysql-fd
   ...
   Plugin Directory = /usr/lib64/bareos/plugins
   Plugin Names = "python"