Add instructions for providing ~/.my.cnf and ~/.pgpass files to provide database...

[bacula/docs] / docs / manuals / en / developers / regression.tex

diff --git a/docs/manuals/en/developers/regression.tex b/docs/manuals/en/developers/regression.tex
index 2d4c90ba20037211e6781593957684d5b475b226..0f3606dec30d5f36ea1c980d4c0ef5eb058d854e 100644 (file)
--- a/docs/manuals/en/developers/regression.tex
+++ b/docs/manuals/en/developers/regression.tex
@@ -7,9 +7,9 @@
 \index{Bacula Regression Testing}
 \addcontentsline{toc}{section}{Bacula Regression Testing}
 
-\section{General}
-\index{General}
-\addcontentsline{toc}{section}{General}
+\section{Setting up Regession Testing}
+\index{Setting up Regession Testing}
+\addcontentsline{toc}{section}{Setting up Regression Testing}
 
 This document is intended mostly for developers who wish to ensure that their
 changes to Bacula don't introduce bugs in the base code.  However, you
@@ -39,8 +39,7 @@ are working in your home directory in a non-root account):
 
 \footnotesize
 \begin{verbatim}
-cd
-git clone git://bacula.git.sourceforge.net/gitroot/bacula bacula
+git clone git://bacula.git.sourceforge.net/gitroot/bacula/bacula bacula
 \end{verbatim}
 \normalsize
 
@@ -226,18 +225,17 @@ HOST="localhost"
 \index{Bacula!Building the Test}
 \addcontentsline{toc}{subsection}{Building the Test Bacula}
 
-Once the above variables are set, you can build the Makefile by entering: 
+Once the above variables are set, you can build the setup by entering:
 
 \footnotesize
 \begin{verbatim}
-./config xxx.conf
+make setup
 \end{verbatim}
 \normalsize
 
-Where xxx.conf is the name of the conf file containing your system parameters.
-This will build a Makefile from Makefile.in, and you should not need to
+This will setup the regression testing and you should not need to
 do this again unless you want to change the database or other regression
-configuration parameter.
+configuration parameters.
 
 
 \subsection{Setting up your SQL engine}
@@ -263,6 +261,25 @@ Generally, to do the above, you will need to run under root to
 be able to create databases and modify permissions within MySQL and
 PostgreSQL.
 
+It is possible to configure MySQL access for database accounts that
+require a password to be supplied. This can be done by creating a ~/.my.cnf
+file which supplies the credentials by default to the MySQL commandline
+utilities.
+
+\begin{verbatim}
+[client]
+host     = localhost
+user     = regress
+password = asecret
+\end{verbatim}
+
+A similar technique can be used PostgreSQL regression testing where the
+database is configured to require a password. The ~/.pgpass file should
+contain a line with the database connection properties.
+
+\begin{verbatim}
+hostname:port:database:username:password
+\end{verbatim}
 
 \subsection{Running the Disk Only Regression}
 \index{Regression!Running the Disk Only}