]> git.sur5r.net Git - bacula/docs/blobdiff - docs/manuals/en/main/install.tex
Clarify use of prefix
[bacula/docs] / docs / manuals / en / main / install.tex
index 8184e0d29deb16f45e35116df9c11acec671bae6..f317f579cd362d72391b1bf5dd79efac0d63719d 100644 (file)
@@ -634,25 +634,32 @@ because SQLite is compiled into Bacula an requires no administration. It
 performs well and is suitable for small to medium sized installations (maximum
 10-20 machines). However, we should note that a number of users have
 had unexplained database corruption with SQLite. For that reason, we
-recommend that you install either MySQL or PostgreSQL for production
+recommend that you install either PostgreSQL or MySQL for production
 work.
 
-If you wish to use MySQL as the Bacula catalog, please see the 
-\ilink{Installing and Configuring MySQL}{MySqlChapter} chapter of
-this manual. You will need to install MySQL prior to continuing with the
+If you wish to use MySQL as the Bacula catalog, please see the
+\ilink{Installing and Configuring MySQL}{MySqlChapter} chapter of this
+manual. You will need to install MySQL prior to continuing with the
 configuration of Bacula. MySQL is a high quality database that is very
-efficient and is suitable for any sized installation. It is slightly more
-complicated than SQLite to setup and administer because it has a number of
-sophisticated features such as userids and passwords. It runs as a separate
-process, is truly professional and can manage a database of any size. 
-
-If you wish to use PostgreSQL as the Bacula catalog, please see the 
-\ilink{Installing and Configuring PostgreSQL}{PostgreSqlChapter}
-chapter of this manual. You will need to install PostgreSQL prior to
-continuing with the configuration of Bacula. PostgreSQL is very similar to
-MySQL, though it tends to be slightly more SQL92 compliant and has many more
-advanced features such as transactions, stored procedures, and the such. It
-requires a certain knowledge to install and maintain. 
+efficient and is suitable for small and medium sized installation (up to
+2,000,000 files per job). It is slightly more complicated than SQLite to setup
+and administer because it has a number of sophisticated features such as
+userids and passwords. It runs as a separate process, is truly professional and
+can manage a database of any size.
+
+If you wish to use PostgreSQL as the Bacula catalog, please see the
+\ilink{Installing and Configuring PostgreSQL}{PostgreSqlChapter} chapter of
+this manual. You will need to install PostgreSQL prior to continuing with the
+configuration of Bacula. PostgreSQL is very similar to MySQL, though it tends
+to be slightly more SQL92 compliant and has many more advanced features such as
+transactions, stored procedures, and the such. It requires a certain knowledge
+to install and maintain. PostgreSQL is suitable for any sized installation
+(some sites have much more than 1 billion objects in the Catalog). Bacula uses
+many optimized PostgreSQL functions, and can run more than 10 time faster on
+jobs having millions of files than MySQL (Specially in during restore, accurate
+mode, bvfs queries and when the database server is not on the same host than
+the Director). It's possible to switch from MySQL/SQLite to PostgreSQL, but it
+requires some DBA knowledge.
 
 If you wish to use SQLite as the Bacula catalog, please see 
 \ilink{Installing and Configuring SQLite}{SqlLiteChapter} chapter of
@@ -695,7 +702,10 @@ customize your installation.
    This option is meant to allow you to direct where the architecture
    independent files should be placed.  However, we find this a somewhat
    vague concept, and so we have not implemented this option other than
-   what ./configure does by default.  As a consequence, we suggest that
+   to use any explicit prefix that you may define.  If you do not
+   explicitly specify a prefix, Bacula's configure routine will not use
+   the default value that ./configure --help prints.
+   As a consequence, we suggest that
    you avoid it. We have provided options that allow you to explicitly
    specify the directories for each of the major categories of installation
    files.
@@ -1015,7 +1025,9 @@ $ nm /usr/local/lib/libpq.a | grep mutex
    Bacula or if you want to use File Daemon PKI data encryption.
    Normally, the {\bf path} specification is not necessary since
    the configuration searches for the OpenSSL libraries in standard system
-   locations. Enabling OpenSSL in Bacula permits secure communications
+   locations. However, you must ensure that all the libraries are
+   loaded including {\bf libssl-dev} or the equivalent on your
+   system. Enabling OpenSSL in Bacula permits secure communications
    between the daemons and/or data encryption in the File daemon.
    For more information on using TLS, please see the
    \ilink{Bacula TLS -- Communications Encryption}{CommEncryption} chapter
@@ -1023,6 +1035,10 @@ $ nm /usr/local/lib/libpq.a | grep mutex
    For more information on using PKI data encryption, please see the
    \ilink{Bacula PKI -- Data Encryption}{DataEncryption}
    chapter of this manual.
+              
+   If you get errors linking, you need to load the development libraries,
+   or you need to disable SSL by setting without-openssl.
+
 
 \item [ {-}{\-}with-python=\lt{}path\gt{}]
    \index[general]{{-}{\-}with-python}