Implement Device Spool directory and sizes

[bacula/bacula] / bacula / README

diff --git a/bacula/README b/bacula/README
index ba488c6bd779a3ade5fd0828c21ad676648701b5..a360ddd2d7e5f837b4c21de90ea6d4410919346d 100644 (file)
--- a/bacula/README
+++ b/bacula/README
@@ -3,9 +3,9 @@ As you will note, I don't follow the standard GNU release
 numbering conventions, but rather one that I started in
 1970.  My internal releases were 0.nn, the first release to
 another user was 1.0, each modified source code release then
-gets a new minor release (1.1, ...) as well as a date.  Each
+gets a new minor release (1.1, 1.2, ...) as well as a date.  Each
 major change in the software -- e.g.  new tape format will
-have the major release number incremented.
+normally have the major release number incremented.
 
 Your best bet for getting Bacula up and running is to read
 the manual, which can be found in
@@ -15,27 +15,102 @@ the manual, which can be found in
 Barring reading the manual, you might try the
 following:
 
-CFLAGS="-g -Wall" \
+To Configure it:
+
   ./configure \
     --sbindir=$HOME/bacula/bin \
     --sysconfdir=$HOME/bacula/bin \
     --with-pid-dir=$HOME/bacula/bin \
     --with-subsys-dir=$HOME/bacula/bin \
+    --with-sqlite=$HOME/depkgs/sqlite \
     --enable-gnome \
     --with-mysql=$HOME/mysql \
     --with-working-dir=$HOME/bacula/bin/working \
     --with-dump-email=YOUR_EMAIL_ADDRESS \
     --with-job-email=YOUR_EMAIL_ADDRESS \
-    --with-smtp-host=YOUR_SMTP_SERVER_ADDRESS \
-    --with-baseport=9101
+    --with-smtp-host=YOUR_SMTP_SERVER_ADDRESS
+
+Note, if you do not have readline installed on your
+system, you either need to add:
+     
+     --disable-readline 
+
+or add:
+
+     --with-readline=$HOME/bacula/depkgs1/readline
+
+where I assume you have loaded depkgs1 into $HOME/bacula
+and built the readline routine.      
+
+If you want to use SQLite, please download depkgs and
+build sqlite, then add something like:
 
+    --with-sqlite=$HOME/depkgs/sqlite
 
-Build Bacula
+
+Build Bacula:
 
    make
 
-   There should be no errors.  The most likely source of
-   errors will probably come in the src/stored directory
-   in time.c or dev.c.  There may also be problems in
-   lib/signal.c as I currently pull in all Linux signals,
-   some of which may not be available on your system.
+   If you are doing a port, there should be no errors.  The most
+   likely source of errors will probably come in the src/stored
+   directory in time.c or dev.c.  There may also be problems in
+   lib/signal.c as I currently pull in all Linux signals, some of
+   which may not be available on your system.
+
+To create the database:
+
+   src/cats/make_bacula_tables
+
+To install:
+
+   make install
+
+To start it:
+
+   cd $HOME/bacula/bin
+   ./bacula start
+
+To start it (as a developer). This is not appropriate if you
+are installing Bacula.
+
+   ./startit
+   ./console (or ./gnome-console)
+
+To stop it:
+
+  ./stopit
+
+Well, it is all just a bit more complicated than that,
+but you should have the idea.
+
+Be sure you read the chapter about testing your tape drive!
+Don't waste a lot of time setting up and running Bacula, if
+your drive is not supported.
+
+FreeBSD users, pay special attention to the Device configuration
+parameters needed to deal with FreeBSD tape drivers.
+
+License:
+For the most part, Bacula is licensed under GPL version 2 or greater.        
+Bacula may be linked with any libraries permitted under the GPL, or 
+with any non-GPLed libraries, including OpenSSL, that are required for 
+its proper functioning, providing the source code of those non-GPLed
+libraries is freely available.
+    
+
+In addition to GPL, there are also parts of Bacula that are licensed
+under LGPL so that they may be used in proprietary code to interface
+with Bacula, and there are parts that are in the public domain.
+             
+THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS
+IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED
+TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A
+PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT OWNER
+OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL,
+EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO,
+PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR
+PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF
+LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING
+NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS
+SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.