diff --git a/core/src/cats/create_bareos_database.in b/core/src/cats/create_bareos_database.in
index 85d41e8458e..98612c00ff7 100644
--- a/core/src/cats/create_bareos_database.in
+++ b/core/src/cats/create_bareos_database.in
@@ -127,7 +127,7 @@ ALTER DATABASE ${db_name} SET datestyle TO 'ISO, YMD';
END-OF-DATA
retval=$?
- if psql -l ${dbname} | grep " ${db_name}.*SQL_ASCII" >/dev/null; then
+ if psql -l ${dbname} $* | grep " ${db_name}.*SQL_ASCII" >/dev/null; then
echo "Database encoding OK"
else
echo " "
diff --git a/docs/manuals/en/main/catmaintenance.tex b/docs/manuals/en/main/catmaintenance.tex
index 27f4c2f35ee..52a2da55080 100644
--- a/docs/manuals/en/main/catmaintenance.tex
+++ b/docs/manuals/en/main/catmaintenance.tex
@@ -20,7 +20,7 @@ \section{Catalog Database}
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.
+This might require some more manual configuration, a PostgreSQL example can be found in \nameref{catalog-maintenance-remote-psql}.
@@ -51,7 +51,8 @@ \subsection{dbconfig-common (Debian)}
The \package{dbconfig-common} configuration (and credentials) is done by the \package{bareos-database-common} package.
Settings are stored in the file \file{/etc/dbconfig-common/bareos-database-common.conf}.
-The Bareos database backend will get automatically configured in \file{/etc/bareos/bareos-dir.conf}.
+The Bareos database backend will get automatically configured in \file{/etc/bareos/bareos-dir.d/catalog/MyCatalog.conf}.
+If the Server is not running locally you need to specify \linkResourceDirective{Dir}{Catalog}{DB Address} in the catalog ressource.
A later reconfiguration might require manual adapt changes.
\warning{When using the PostgreSQL backend and updating to Bareos $<$ 14.2.3, it is necessary to manually grant database permissions (\command{grant_bareos_privileges}), normally by}
@@ -184,7 +185,7 @@ \subsubsection{PostgreSQL}
psql
\end{commands}
-If your database is configured to to require a password, this must be definied in the file
+If your database is configured to require a password, this must be definied in the file
\elink{\file{~/.pgpass}}{http://www.postgresql.org/docs/8.2/static/libpq-pgpass.html}
in the following syntax: \parameter{HOST:PORT:DATABASE:USER:PASSWORD}, e.g.
\begin{config}{PostgreSQL access credentials}
@@ -335,6 +336,49 @@ \subsubsection{PostgreSQL}
bareos=>
\end{commands}
+\subsubsection{Remote PostgreSQL Database}
+\label{catalog-maintenance-remote-psql}
+
+When configuring bareos with a remote database, your first step is to check the connection from the \bareosDir host into the database.
+A functional connection can be verified by
+\begin{commands}{Access the remote PostgreSQL database}
+su - postgres
+psql --host bareos-database.example.com
+\end{commands}
+With a correct configuration you can access the database, if it fails you need to correct the PostgreSQL servers configuration files.
+
+One way to manually create the database would be calling the bareos database preparation scripts with the \parameter{--host} option, explained later.
+How ever, it is advised to use the \package{dbconfig-common}.
+Both methods require you to add the database hostname/address as \linkResourceDirective{Dir}{Catalog}{DB Address}.
+
+If you're using \package{dbconfig-common} you should choose \parameter{New Host}, enter the hostname or the local address followed by the password.
+As \package{dbconfig-common} uses the \parameter{ident} authentication by default the first try to connect will fail. Don't be bothered by that. Choose \parameter{Retry} when prompted. From there, read carefully and configure the database to your needs.
+The authentication should be set to password, as the ident method will not work with a remote server.
+Set the user and administrator according to your PostgreSQL servers settings.
+
+Set the PostgreSQL server IP as \linkResourceDirective{Dir}{Catalog}{DB Address} in \nameref{DirectorResourceCatalog}.
+You can also customize other parameters or use the defaults. A quick check should display your recent changes:
+\begin{commands}{Show current database configuration}
+ /usr/sbin/bareos-dbcheck -B
+catalog=MyCatalog
+db_name=bareos
+db_driver=postgresql
+db_user=bareos
+db_password=secret
+db_address=bareos-database.example.com
+db_port=0
+db_socket=
+db_type=PostgreSQL
+working_dir=/var/lib/bareos
+\end{commands}
+
+If \package{dbconfig-common} did not succeed or you choosed not to use it, run the Bareos database preparation scripts with:
+\begin{commands}{Setup Bareos catalog database}
+su - postgres
+/usr/lib/bareos/scripts/create_bareos_database --host=bareos-database.example.com
+/usr/lib/bareos/scripts/make_bareos_tables --host=bareos-database.example.com
+/usr/lib/bareos/scripts/grant_bareos_privileges --host=bareos-database.example.com
+\end{commands}
\subsubsection{MySQL}
\label{catalog-maintenance-mysql}