From 66cb994177fc2cf8a974e8ef169e412eb4d9087c Mon Sep 17 00:00:00 2001 From: Thomas Glatthor Date: Wed, 9 Apr 2008 14:54:12 +0000 Subject: [PATCH] update --- docs/manuals/de/catalog/mysql.tex | 199 ++++++++++++++++-------------- 1 file changed, 109 insertions(+), 90 deletions(-) diff --git a/docs/manuals/de/catalog/mysql.tex b/docs/manuals/de/catalog/mysql.tex index 51b80e11..8f87ac69 100644 --- a/docs/manuals/de/catalog/mysql.tex +++ b/docs/manuals/de/catalog/mysql.tex @@ -68,6 +68,9 @@ ausf\"{u}hren, das Ergebnis ist das selbe. in das Sie gerade den Quelltext entpackt haben. + +\item ./configure \verb:--:enable-thread-safe-client \verb:--:prefix=MySQL-Verzeichnis + Seit der Bacula-Version 1.31 wird die thread-safe-Version der MySQL-Client-Bibliotheken verwendet. Daher muss die Option {\bf \verb:--:enable-thread-safe-client} beim Konfigurieren des @@ -77,12 +80,14 @@ ausf\"{u}hren, das Ergebnis ist das selbe. diese in {\bf libz-devel} und bei Debian hei{\ss}t dieses Paket {\bf zlib1g-dev} (auf anderen Distributionen wird der Name \"{a}hnlich sein). -\item ./configure \verb:--:enable-thread-safe-client \verb:--:prefix=MySQL-Verzeichnis - - ersetzen Sie "`MySQL-Verzeichnis"' mit dem Pfad, in den MySQL installiert werden soll. + Ersetzen Sie "`MySQL-Verzeichnis"' mit dem Pfad, in den MySQL installiert werden soll. Normalerweise /usr/local/mysql f\"{u}r systemweite Installation oder zum Beispiel /home/bacula/mysql damit der Benutzer bacula eine eigene Datenbank zur Verf\"{u}gung hat. + Bitte beachten Sie, dass Sie das "`MySQL-Verzeichnis"' auch beim konfigurieren + des Bacula-Quelltextes mit der Option {\bf \verb:--:with-mysql=MySQL-Verzeichnis} + angeben m\"{u}ssen. + \item make startet das Kompilieren des Quelltextes und wird einige Zeit ben\"{o}tigen @@ -109,90 +114,98 @@ Konfiguration ben\"{o}tigen, werden erst bei der Installation von Bacula erstell \index[general]{MySQL Installation und Konfiguration -- Phase II } \index[general]{Phase II!MySQL Installation und Konfiguration -- } -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 -Bacula}. If not, please complete these items before proceeding. - -Please note that the {\bf ./configure} used to build {\bf Bacula} will need to -include {\bf \verb:--:with-mysql=mysql-directory}, where {\bf mysql-directory} is the -directory name that you specified on the ./configure command for configuring -MySQL. This is needed so that Bacula can find the necessary include headers -and library files for interfacing to MySQL. - -{\bf Bacula} will install scripts for manipulating the database (create, -delete, make tables etc) into the main installation directory. These files -will be of the form *\_bacula\_* (e.g. create\_bacula\_database). These files -are also available in the \lt{}bacula-src\gt{}/src/cats directory after -running ./configure. If you inspect create\_bacula\_database, you will see -that it calls create\_mysql\_database. The *\_bacula\_* files are provided for -convenience. It doesn't matter what database you have chosen; -create\_bacula\_database will always create your database. - -Now you will create the Bacula MySQL database and the tables that Bacula uses. - +An diesem Punkt sollten Sie bereits MySQL und Bacula kompiliert +und installiert haben. Falls nicht, schliessen Sie bitte diese +beiden Schritte erst ab, bevor Sie hier weitermachen. + +Bei der Installation von Bacula werden mehrere Scripte in das +Installations-Verzeichnis kopiert, mit denen Sie verschiedene +\"{A}nderungen an der Datenbank durchf\"{u}hren k\"{o}nnen. +Diese Scripte haben Namen im Format *\_bacula\_* +(z.B. create\_bacula\_database)und dienen dazu die Datenbank +zu initialisieren, zu aktualisieren oder zu l\"{o}schen. +Diese Scripte sind auch im Bacula-Quelltext-Verzeichnis, nach +der Ausf\"{u}hrung des "`./configure"'-Scripts, unter +\lt{}bacula-src\gt{}/src/cats zu finden. Wenn Sie sich, zum +Beispiel, das Script create\_mysql\_database n\"{a}her ansehen +werden Sie merken, dass dieses Script einfach nur +create\_mysql\_database ausf\"{u}hrt. Alle Scripte die *\_bacula\_* +heissen, dienen nur der Bequemlichkeit. Es spielt keine Rolle +mit welcher Datenbank Sie den Bacula-Quelltext \"{u}bersetzt haben, +das Script create\_bacula\_database wird immer die f\"{u}r Sie +richtige Datenbank erstellen. + +Die folgenden Schritte sind n\"{o}tig um die MySQL-Datenbank und Tabellen +zu erstellen, die Bacula benutzt: \begin{enumerate} -\item Start {\bf mysql}. You might want to use the {\bf startmysql} script - provided in the Bacula release. - -\item cd \lt{}install-directory\gt{} - This directory contains the Bacula catalog interface routines. - -\item ./grant\_mysql\_privileges - This script creates unrestricted access rights for the user {\bf bacula}. - You may want to modify it to suit your situation. Please - note that none of the userids, including root, are password protected. - If you need more security, please assign a password to the root user - and to bacula. The program {\bf mysqladmin} can be used for this. - -\item ./create\_mysql\_database - This script creates the MySQL {\bf bacula} database. The databases you - create as well as the access databases will be located in - \lt{}install-dir\gt{}/var/ in a subdirectory with the name of the - database, where \lt{}install-dir\gt{} is the directory name that you - specified on the {\bf \verb:--:prefix} option. This can be important to - know if you want to make a special backup of the Bacula database or to - check its size. - -\item ./make\_mysql\_tables - This script creates the MySQL tables used by {\bf Bacula}. +\item Starten Sie {\bf mysql}. Dazu k\"{o}nnen Sie auch das Script {\bf startmysql} + benutzen, dass Bacula mitinstalliert. + +\item cd \lt{}Bacula-Installations-Verzeichnis\gt{} + In diesem Verzeichnis finden Sie die Bacula-Datenbank-Scripte. + +\item ./grant\_bacula\_privileges + Dieses Script erm\"{o}glicht dem Benutzer "`bacula"' uneingeschr\"{a}nkten + Zugriff auf die Datenbank. Eventuell m\"{u}ssen Sie es anpassen, um es auf + Ihre Umgebung anzupassen. Bitte beachten Sie auch, dass nach der Installation + kein Datenbank-Benutzer, auch root, ein Passwort gesetzt hat. Falls das + f\"{u}r Sie zu unsicher ist, k\"{o}nnen Sie mit dem Kommando "`mysqladmin"' + den Benutzern Passw\"{o}rter zuweisen. + +\item ./create\_bacula\_database + Dieses Script erzeugt die Bacula-Katalog-Datenbank. Diese Datenbank, + und auch die bei der Installation angelegte MySQL-interne Benutzer-Datenbank, + liegt danach im Verzeichnis var/ unterhalb des "`MySQL-Verzeichnis"' + das Sie bei der Konfiguration des MySQL-Quelltextes mit der Option + {\bf \verb:--:prefix} angegeben haben. Dieser Pfad zu den + Datenbank-Dateien kann wichtig sein, wenn Sie diese Dateien auf speziellem + Weg sichern wollen oder falls Sie wissen m\"{o}chten, welche Gr\"{o}{\ss}e + die Datenbank hat. + +\item ./make\_bacula\_tables + Dieses Script legt die Tabellen an die Bacula ben\"{o}tigt. \end{enumerate} -Each of the three scripts (grant\_mysql\_privileges, create\_mysql\_database -and make\_mysql\_tables) allows the addition of a command line argument. This -can be useful for specifying the user and or password. For example, you might -need to add {\bf -u root} to the command line to have sufficient privilege to -create the Bacula tables. +Jedes dieser Scripte erlaubt es Ihnen Optionen mit auf der Kommandozeile +zu \"{u}bergeben. Das kann n\"{u}tzlich sein, wenn Sie zum Beispiel einen +Benutzer oder Passwort zum Zugriff auf die Datenbank angeben m\"{u}ssen. +So ist es m\"{o}glich auf der Kommandozeile beispielsweise {\bf -u root} anzugeben, +um gen\"{u}gend Rechte zur Erstellung der Bacula-Datenbank zu haben. -To take a closer look at the access privileges that you have setup with the -above, you can do: +Um einen genaueren Blick auf die oben gesetzten Zugriffsrechte f\"{u}r +den Benutzer bacula innerhalb der Datenbank zu werfen, k\"{o}nnen Sie +folgende Kommandos ausf\"{u}hren: \footnotesize \begin{verbatim} -mysql-directory/bin/mysql -u root mysql +/bin/mysql -u root mysql select * from user; \end{verbatim} \normalsize -\section{Re-initializing the Catalog Database} -\index[general]{Database!Re-initializing the Catalog } -\index[general]{Re-initializing the Catalog Database } +\section{Re-Initialisierung der Katalog-Datenbank} +\index[general]{Datenbank!Re-Initialisierung der Katalog- } +\index[general]{Re-Initialisierung der Katalog-Datenbank } -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 -that you ran. To do so, you can do the following: +Nachdem Sie einige anf\"{a}ngliche Tests mit Bacula gemacht haben, wollen +Sie eventuell Ihre Katalog-Datenbank komplett leeren, um alle gelaufenen +Test-Backups aus der Datenbank zu entfernen. Um das zu erreichen, +tun Sie folgendes: \footnotesize \begin{verbatim} cd - ./drop_mysql_tables - ./make_mysql_tables + ./drop_bacula_tables + ./make_bacula_tables \end{verbatim} \normalsize -Please note that all information in the database will be lost and you will be -starting from scratch. If you have written on any Volumes, you must write an -end of file mark on the volume so that Bacula can reuse it. Do so with: +Bitte bedenken Sie, dass dabei alle Informationen unwiderruflich +aus der Datenbank gel\"{o}scht werden. Falls Sie auch beschriebene +Volumes wiederverwenden wollen, m\"{u}ssen Sie das Volume-Label +\"{u}berschreiben damit Bacula sie erneut benutzen kann. +Das erreichen Sie durch: \footnotesize \begin{verbatim} @@ -202,34 +215,40 @@ end of file mark on the volume so that Bacula can reuse it. Do so with: \end{verbatim} \normalsize -Where you should replace {\bf /dev/nst0} with the appropriate tape drive -device name for your machine. +hierbei m\"{u}ssen Sie {\bf /dev/nst0} durch das Device ersetzen, +dem Ihr Tapelaufwerk entspricht. + +\section{Bacula mit MySQL linken} +\index[general]{Bacula mit MySQL linken } +\index[general]{MySQL!linken Bacula mit } -\section{Linking Bacula with MySQL} -\index[general]{Linking Bacula with MySQL } -\index[general]{MySQL!Linking Bacula with } -\index[general]{Upgrading} -After configuring Bacula with +Nach der MySQL-Quelltext-Konfiguration mit: -./configure \verb:--:enable-thread-safe-client \verb:--:prefix=\lt{}mysql-directory\gt{} -where \lt{}mysql-directory\gt{} is in my case {\bf /home/kern/mysql}, you may -have to configure the loader so that it can find the MySQL shared libraries. -If you have previously followed this procedure and later add the {\bf -\verb:--:enable-thread-safe-client} options, you will need to rerun the {\bf -ldconfig} program shown below. If you put MySQL in a standard place such as -{\bf /usr/lib} or {\bf /usr/local/lib} this will not be necessary, but in my -case it is. The description that follows is Linux specific. For other -operating systems, please consult your manuals on how to do the same thing: +./configure \verb:--:enable-thread-safe-client \verb:--:prefix=\lt{}MySQL-Verzeichnis\gt{} +wobei "`MySQL-Verzeichnis"' in diesem Beispiel {\bf /home/bacula/mysql} ist, +m\"{u}ssen Sie Ihrem Betriebssystem mitteilen wo die MySQL-Bibliotheken zu +finden sind. Falls Sie MySQL in einem Standard-Pfad installiert haben, wie +zum Beispiel {\bf /usr/lib} oder {\bf /usr/local/lib}, ist dies nicht n\"{o}tig. +In diesem Beispiel ist es aber notwendig den Pfad {\bf /home/bacula/mysql} +dem Loader-Proze{\ss} f\"{u}r dynamische Bibliotheken bekannt zu machen. +Die folgende Beschreibung ist Linux-spezifisch, bei anderen Betriebssystemen +lesen Sie bitte deren Dokumentation um dieses Ziel zu erreichen. -First edit: {\bf /etc/ld.so.conf} and add a new line to the end of the file -with the name of the mysql-directory. In my case, it is: +Als erstes m\"{u}ssen Sie die Datei {\bf /etc/ld.so.conf} editieren +und am Ende eine neue Zeile mit dem entsprechenden Pfad hinzuf\"{u}gen. -/home/kern/mysql/lib/mysql then rebuild the loader's cache with: +In diesem Beispiel: "`/home/bacula/mysql/lib/mysql"' +danach muss der Cache des Loader-Proze{\ss}es mit {\bf /sbin/ldconfig} +neu gebaut werden. -/sbin/ldconfig If you upgrade to a new version of {\bf MySQL}, the shared -library names will probably change, and you must re-run the {\bf -/sbin/ldconfig} command so that the runtime loader can find them. +Wenn Sie MySQL auf eine neuere Version updaten \"{a}ndern eventuell +einige der Bibliotheken ihre Namen, dann m\"{u}ssen Sie den Loader-Cache +wiederum mit {\bf /sbin/ldconfig} aktualisieren. Das Gleiche gilt +wenn Sie MySQL mit anderen Optionen neu kompilieren und sich dadurch +die MySQL-Bibliotheken \"{a}ndern, zum Beispiel, weil Sie beim ersten +kompilieren die ben\"{o}tigte Option \verb:--:enable-thread-safe-client +vergessen haben. Alternatively, your system my have a loader environment variable that can be set. For example, on a Solaris system where I do not have root permission, I @@ -269,7 +288,7 @@ This will be the same with most other package managers too. \section{Upgrading MySQL} \index[general]{Upgrading MySQL } -\index[general]{Upgrading!MySQL } +\index[general]{MySQL!Upgrading } \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 -- 2.39.5