[bacula/f17] Update documentation
Simone Caronni
slaanesh at fedoraproject.org
Tue Feb 26 09:01:08 UTC 2013
commit e0efc06f2b1e945e407bdec69738668b9c2c4c54
Author: Simone Caronni <negativo17 at gmail.com>
Date: Tue Feb 26 10:00:36 2013 +0100
Update documentation
README.Redhat | 55 +++++++++++++++++++++++++++-----------------
bacula.spec | 5 +++-
quickstart_mysql.txt | 28 +++++++++-------------
quickstart_postgresql.txt | 28 +++++++++-------------
quickstart_sqlite3.txt | 28 +++++++++-------------
5 files changed, 74 insertions(+), 70 deletions(-)
---
diff --git a/README.Redhat b/README.Redhat
index 37a811a..cdb6109 100644
--- a/README.Redhat
+++ b/README.Redhat
@@ -2,41 +2,54 @@
- Standard components: director, storage, client, docs, bconsole.
- Graphical components: bat, bacula-tray-monitor (where supported).
+- Tab completion for bconsole.
- Nagios plugin.
- HTML/PDF docs.
+- Quick start guides.
- File Daemon bpipe-fd plugin.
- POSIX.1e capabilities for File Daemon.
-- Systemd for Fedora 15+.
-- GZIP/LZO compression (where supported).
+- Systemd for Fedora and RHEL 7+.
+- SysV init scripts for RHEL 5/6.
+- GZIP/LZO compression.
- Static uid/gid of 133 (see "setup" package).
- No usermode / fedora-usermgmt stuff in the console packages.
- Docs no longer an arch specific subpackage.
- SQL libraries needed only by Director and Storage daemons.
-- Tab completion for bconsole.
+- SQL backend management through the alternatives system.
+
+======== Quick start
+
+Please look at the following files for a quick start with the various database
+backends:
+
+- quickstart_mysql.txt
+- quickstart_postgresql.txt
+- quickstart_sqlite3.txt
-======== PostgreSQL, MySQL and SQLite databases
+To deal with the switching process for the database backend, see the following
+file which explains how to make the necessary changes:
-Bacula director supports different databases backends, if you want to switch
-away from the default PostgreSQL one you need to change the "libbaccats" (the
-catalogue library) symlink to the real library.
+- database_backends.txt
-To change to a different backend, issue the following command:
+======== Upgrading from old Redhat releases
-# alternatives --config libbaccats.so
+When upgrading from old Redhat releases, the "bacula-libs-sql" package takes
+care of making the appropriate selection for the database backend based on what
+was previously configured on the old system.
-There are 3 programs which provide 'libbaccats.so'.
+The default permissions in the "/etc/bacula" folder have changed; please perform
+the following commands for restoring the permissions for the correct operation
+of the daemons.
- Selection Command
------------------------------------------------
- 1 /usr/lib64/libbaccats-mysql.so
- 2 /usr/lib64/libbaccats-sqlite3.so
-*+ 3 /usr/lib64/libbaccats-postgresql.so
+# chown -R root:root /etc/bacula
+# chmod 755 /etc/bacula
+# chmod 640 /etc/bacula/*
+# chgrp bacula /etc/bacula/bacula-dir.conf /etc/bacula/query.sql
-Enter to keep the current selection[+], or type selection number: 1
+All the files that are part of the Director configuration (included with @) must
+of course have the same permissions as the main configuration file.
-There is NO need to edit any part in the Bacula Director configuration; for the
-purposes of the database creation steps, the bacula-dir.conf configuration file
-can be left at their default values.
+======== Documentation
-Please look at the quickstart_<backend>.txt files for a quick start with the
-various backends.
+To see all the available documentation in both HTML and PDF formats, please
+install the "bacula-docs" package.
diff --git a/bacula.spec b/bacula.spec
index 8d518a0..cc5c31c 100644
--- a/bacula.spec
+++ b/bacula.spec
@@ -3,7 +3,7 @@
Name: bacula
Version: 5.2.13
-Release: 4%{?dist}
+Release: 5%{?dist}
Summary: Cross platform network backup for Linux, Unix, Mac and Windows
# See LICENSE for details
License: AGPLv3 with exceptions
@@ -906,6 +906,9 @@ fi
%changelog
+* Tue Feb 26 2013 Simone Caronni <negativo17 at gmail.com> - 5.2.13-5
+- Improve documentation.
+
* Mon Feb 25 2013 Simone Caronni <negativo17 at gmail.com> - 5.2.13-4
- Fix director reload command.
- Adjust to 5.2.13 permission changes.
diff --git a/quickstart_mysql.txt b/quickstart_mysql.txt
index 4c370de..b7efa59 100644
--- a/quickstart_mysql.txt
+++ b/quickstart_mysql.txt
@@ -23,15 +23,15 @@ and all daemons and consoles in one server.
# ./make_bacula_tables mysql
# ./grant_bacula_privileges mysql
-4) Change passwords in /etc/bacula/*conf with something you like.
+4) Change passwords in /etc/bacula/*.conf with something you like.
-# sed -i -e 's/@@DIR_PASSWORD@@/dir-Fedora/g' \
- -e 's/@@FD_PASSWORD@@/fd-Fedora/g' \
- -e 's/@@SD_PASSWORD@@/sd-Fedora/g' \
- -e 's/@@MON_DIR_PASSWORD@@/mon-dir-Fedora/g' \
- -e 's/@@MON_FD_PASSWORD@@/mon-fd-Fedora/g' \
- -e 's/@@MON_SD_PASSWORD@@/mon-sd-Fedora/g' \
- /etc/bacula/*conf
+# sed -i -e 's/@@DIR_PASSWORD@@/dir-password/g' \
+ -e 's/@@FD_PASSWORD@@/fd-password/g' \
+ -e 's/@@SD_PASSWORD@@/sd-password/g' \
+ -e 's/@@MON_DIR_PASSWORD@@/mon-dir-password/g' \
+ -e 's/@@MON_FD_PASSWORD@@/mon-fd-password/g' \
+ -e 's/@@MON_SD_PASSWORD@@/mon-sd-password/g' \
+ /etc/bacula/*.conf
5) Enable daemons and check they are working
@@ -48,17 +48,13 @@ and all daemons and consoles in one server.
# systemctl start bacula-fd.service
# echo status bacula-fd | bconsole
-6) Install the docs and read them
-
-# yum -y install bacula-docs
-
-7) If you don't backup to disk and have a tape library or autochanger, please
+6) If you don't backup to disk and have a tape library or autochanger, please
also install the magnetic tapes commands:
# yum -y install mt-st mtx
-8) To grant console access to regular users add the read permission
-to the console configuration files. Remember that there is no authentication
-check; so a user that can launch the console can perform any command.
+7) To grant console access to regular users add the read permission to the
+console configuration files. Remember that there is no authentication check; so
+a user that can launch the console can perform any command.
# chmod +r /etc/bacula/bconsole.conf /etc/bacula/bat.conf
diff --git a/quickstart_postgresql.txt b/quickstart_postgresql.txt
index 21c03f7..088f196 100644
--- a/quickstart_postgresql.txt
+++ b/quickstart_postgresql.txt
@@ -25,15 +25,15 @@ $ ./create_bacula_database
$ ./make_bacula_tables
$ ./grant_bacula_privileges
-4) Change passwords in /etc/bacula/*conf with something you like.
+4) Change passwords in /etc/bacula/*.conf with something you like.
-# sed -i -e 's/@@DIR_PASSWORD@@/dir-Fedora/g' \
- -e 's/@@FD_PASSWORD@@/fd-Fedora/g' \
- -e 's/@@SD_PASSWORD@@/sd-Fedora/g' \
- -e 's/@@MON_DIR_PASSWORD@@/mon-dir-Fedora/g' \
- -e 's/@@MON_FD_PASSWORD@@/mon-fd-Fedora/g' \
- -e 's/@@MON_SD_PASSWORD@@/mon-sd-Fedora/g' \
- /etc/bacula/*conf
+# sed -i -e 's/@@DIR_PASSWORD@@/dir-password/g' \
+ -e 's/@@FD_PASSWORD@@/fd-password/g' \
+ -e 's/@@SD_PASSWORD@@/sd-password/g' \
+ -e 's/@@MON_DIR_PASSWORD@@/mon-dir-password/g' \
+ -e 's/@@MON_FD_PASSWORD@@/mon-fd-password/g' \
+ -e 's/@@MON_SD_PASSWORD@@/mon-sd-password/g' \
+ /etc/bacula/*.conf
5) Enable daemons and check they are working
@@ -50,17 +50,13 @@ $ ./grant_bacula_privileges
# systemctl start bacula-fd.service
# echo status bacula-fd | bconsole
-6) Install the docs and read them
-
-# yum -y install bacula-docs
-
-7) If you don't backup to disk and have a tape library or autochanger, please
+6) If you don't backup to disk and have a tape library or autochanger, please
also install the magnetic tapes commands:
# yum -y install mt-st mtx
-8) To grant console access to regular users add the read permission
-to the console configuration files. Remember that there is no authentication
-check; so a user that can launch the console can perform any command.
+7) To grant console access to regular users add the read permission to the
+console configuration files. Remember that there is no authentication check; so
+a user that can launch the console can perform any command.
# chmod +r /etc/bacula/bconsole.conf /etc/bacula/bat.conf
diff --git a/quickstart_sqlite3.txt b/quickstart_sqlite3.txt
index 58c8e0e..75022ea 100644
--- a/quickstart_sqlite3.txt
+++ b/quickstart_sqlite3.txt
@@ -20,15 +20,15 @@ and all daemons and consoles in one server.
# ./make_bacula_tables sqlite3
# ./grant_bacula_privileges sqlite3
-4) Change passwords in /etc/bacula/*conf with something you like.
+4) Change passwords in /etc/bacula/*.conf with something you like.
-# sed -i -e 's/@@DIR_PASSWORD@@/dir-Fedora/g' \
- -e 's/@@FD_PASSWORD@@/fd-Fedora/g' \
- -e 's/@@SD_PASSWORD@@/sd-Fedora/g' \
- -e 's/@@MON_DIR_PASSWORD@@/mon-dir-Fedora/g' \
- -e 's/@@MON_FD_PASSWORD@@/mon-fd-Fedora/g' \
- -e 's/@@MON_SD_PASSWORD@@/mon-sd-Fedora/g' \
- /etc/bacula/*conf
+# sed -i -e 's/@@DIR_PASSWORD@@/dir-password/g' \
+ -e 's/@@FD_PASSWORD@@/fd-password/g' \
+ -e 's/@@SD_PASSWORD@@/sd-password/g' \
+ -e 's/@@MON_DIR_PASSWORD@@/mon-dir-password/g' \
+ -e 's/@@MON_FD_PASSWORD@@/mon-fd-password/g' \
+ -e 's/@@MON_SD_PASSWORD@@/mon-sd-password/g' \
+ /etc/bacula/*.conf
5) Enable daemons and check they are working
@@ -45,17 +45,13 @@ and all daemons and consoles in one server.
# systemctl start bacula-fd.service
# echo status bacula-fd | bconsole
-6) Install the docs and read them
-
-# yum -y install bacula-docs
-
-7) If you don't backup to disk and have a tape library or autochanger, please
+6) If you don't backup to disk and have a tape library or autochanger, please
also install the magnetic tapes commands:
# yum -y install mt-st mtx
-8) To grant console access to regular users add the read permission
-to the console configuration files. Remember that there is no authentication
-check; so a user that can launch the console can perform any command.
+7) To grant console access to regular users add the read permission to the
+console configuration files. Remember that there is no authentication check; so
+a user that can launch the console can perform any command.
# chmod +r /etc/bacula/bconsole.conf /etc/bacula/bat.conf
More information about the scm-commits
mailing list