Update

[bacula/docs] / docs / manual / mysql.tex

diff --git a/docs/manual/mysql.tex b/docs/manual/mysql.tex
index af32170da4e9cba92f969994817dc31b2e58c901..240b147dc330a6764c7a4957fdd8c918a1b90954 100644 (file)
--- a/docs/manual/mysql.tex
+++ b/docs/manual/mysql.tex
@@ -1,16 +1,14 @@
 %%
 %%
 
 %%
 %%
 

-\section*{Installing and Configuring MySQL}
-\label{_ChapterStart}
+\chapter{Installing and Configuring MySQL}
+\label{MySqlChapter}

 \index[general]{MySQL!Installing and Configuring }
 \index[general]{Installing and Configuring MySQL }
 \index[general]{MySQL!Installing and Configuring }
 \index[general]{Installing and Configuring MySQL }

-\addcontentsline{toc}{section}{Installing and Configuring MySQL}

 
 

-\subsection*{Installing and Configuring MySQL -- Phase I}
+\section{Installing and Configuring MySQL -- Phase I}

 \index[general]{Installing and Configuring MySQL -- Phase I }
 \index[general]{Phase I!Installing and Configuring MySQL -- }
 \index[general]{Installing and Configuring MySQL -- Phase I }
 \index[general]{Phase I!Installing and Configuring MySQL -- }

-\addcontentsline{toc}{subsection}{Installing and Configuring MySQL -- Phase I}

 
 If you use the ./configure \verb:--:with-mysql=mysql-directory statement for
 configuring {\bf Bacula}, you will need MySQL version 3.23.53 or later
 
 If you use the ./configure \verb:--:with-mysql=mysql-directory statement for
 configuring {\bf Bacula}, you will need MySQL version 3.23.53 or later


@@ -41,8 +39,15 @@ the following:
 \begin{verbatim}
 mysql-<version>.rpm
 mysql-server-<version>.rpm
 \begin{verbatim}
 mysql-<version>.rpm
 mysql-server-<version>.rpm

+mysql-devel-<version>.rpm

 \end{verbatim}
 \normalsize
 \end{verbatim}
 \normalsize

+The names of the packages may vary from distribution to
+distribution. It is important to have the devel package loaded as
+it contains the libraries and header files necessary to build
+Bacula.  There may be additional packages that are required to 
+install the above, for example, zlib and openssl.   
+

 Once these packages are installed, you will be able to build Bacula (using
 the files installed with the mysql package, then run MySQL using the
 files installed with mysql-server. If you have installed MySQL by rpms,
 Once these packages are installed, you will be able to build Bacula (using
 the files installed with the mysql package, then run MySQL using the
 files installed with mysql-server. If you have installed MySQL by rpms,


@@ -51,8 +56,9 @@ Bacula, then come back to Phase II of the MySQL installation when indicated
 to do so.
 
 Beginning with Bacula version 1.31, the thread safe version of the
 to do so.
 
 Beginning with Bacula version 1.31, the thread safe version of the

-MySQL client library is used, and hence you must add the {\bf
-\verb:--:enable-thread-safe-client} option to the {\bf ./configure} as shown below: 
+MySQL client library is used, and hence you should add the {\bf
+\verb:--:enable-thread-safe-client} option to the {\bf
+./configure} as shown below:

 
 \begin{enumerate}
 \item Download MySQL source code from 
 
 \begin{enumerate}
 \item Download MySQL source code from 


@@ -65,9 +71,9 @@ MySQL client library is used, and hence you must add the {\bf
 Note, the above command requires GNU tar. If you do not  have GNU tar, a
 command such as:
 
 Note, the above command requires GNU tar. If you do not  have GNU tar, a
 command such as:
 

-{\bf zcat mysql-filename | tar xvf - 
+{\bf zcat mysql-filename | tar xvf - }  

 
 

-}  will probably accomplish the same thing. 
+will probably accomplish the same thing. 

 
 \item cd {\bf mysql-source-directory}
 
 
 \item cd {\bf mysql-source-directory}
 


@@ -110,11 +116,9 @@ second phase of the MySQL installation are created during the Bacula
 Installation. 
 
 \label{mysql_phase2}
 Installation. 
 
 \label{mysql_phase2}

-\subsection*{Installing and Configuring MySQL -- Phase II}
+\section{Installing and Configuring MySQL -- Phase II}

 \index[general]{Installing and Configuring MySQL -- Phase II }
 \index[general]{Phase II!Installing and Configuring MySQL -- }
 \index[general]{Installing and Configuring MySQL -- Phase II }
 \index[general]{Phase II!Installing and Configuring MySQL -- }

-\addcontentsline{toc}{subsection}{Installing and Configuring MySQL -- Phase
-II}

 
 At this point, you should have built and installed MySQL, or already have a
 running MySQL, and you should have configured, built and installed {\bf
 
 At this point, you should have built and installed MySQL, or already have a
 running MySQL, and you should have configured, built and installed {\bf


@@ -181,10 +185,9 @@ select * from user;
 \end{verbatim}
 \normalsize
 
 \end{verbatim}
 \normalsize
 

-\subsection*{Re-initializing the Catalog Database}
+\section{Re-initializing the Catalog Database}

 \index[general]{Database!Re-initializing the Catalog }
 \index[general]{Re-initializing the Catalog Database }
 \index[general]{Database!Re-initializing the Catalog }
 \index[general]{Re-initializing the Catalog Database }

-\addcontentsline{toc}{subsection}{Re-initializing the Catalog Database}

 
 After you have done some initial testing with {\bf Bacula}, you will probably
 want to re-initialize the catalog database and throw away all the test Jobs
 
 After you have done some initial testing with {\bf Bacula}, you will probably
 want to re-initialize the catalog database and throw away all the test Jobs


@@ -213,10 +216,10 @@ end of file mark on the volume so that Bacula can reuse it. Do so with:
 Where you should replace {\bf /dev/nst0} with the appropriate tape drive
 device name for your machine. 
 
 Where you should replace {\bf /dev/nst0} with the appropriate tape drive
 device name for your machine. 
 

-\subsection*{Linking Bacula with MySQL}
+\section{Linking Bacula with MySQL}

 \index[general]{Linking Bacula with MySQL }
 \index[general]{MySQL!Linking Bacula with }
 \index[general]{Linking Bacula with MySQL }
 \index[general]{MySQL!Linking Bacula with }

-\addcontentsline{toc}{subsection}{Linking Bacula with MySQL}
+\index[general]{Upgrading}

 
 After configuring Bacula with 
 
 
 After configuring Bacula with 
 


@@ -258,13 +261,12 @@ LDFLAGS="-lssl -lcyrpto" \
 \end{verbatim}
 \normalsize
 
 \end{verbatim}
 \normalsize
 

-\subsection*{Installing MySQL from RPMs}
+\section{Installing MySQL from RPMs}

 \index[general]{MySQL!Installing from RPMs}
 \index[general]{Installing MySQL from RPMs}
 \index[general]{MySQL!Installing from RPMs}
 \index[general]{Installing MySQL from RPMs}

-\addcontentsline{toc}{subsection}{Installing MySQL from RPMs}

 If you are installing MySQL from RPMs, you will need to install
 both the MySQL binaries and the client libraries.  The client
 If you are installing MySQL from RPMs, you will need to install
 both the MySQL binaries and the client libraries.  The client

-libraries are ususally found in a devel package, so you must
+libraries are usually found in a devel package, so you must

 install:
 
 \footnotesize
 install:
 
 \footnotesize


@@ -276,10 +278,10 @@ install:
 
 This will be the same with most other package managers too.
 
 
 This will be the same with most other package managers too.
 

-\subsection*{Upgrading MySQL}
+\section{Upgrading MySQL}

 \index[general]{Upgrading MySQL }
 \index[general]{Upgrading!MySQL }
 \index[general]{Upgrading MySQL }
 \index[general]{Upgrading!MySQL }

-\addcontentsline{toc}{subsection}{Upgrading MySQL}
+\index[general]{Upgrading}

 If you upgrade MySQL, you must reconfigure, rebuild, and re-install 
 Bacula otherwise you are likely to get bizarre failures.  If you
 install from rpms and you upgrade MySQL, you must also rebuild Bacula.
 If you upgrade MySQL, you must reconfigure, rebuild, and re-install 
 Bacula otherwise you are likely to get bizarre failures.  If you
 install from rpms and you upgrade MySQL, you must also rebuild Bacula.