]> git.sur5r.net Git - bacula/bacula/blob - bacula/README
Corrected cp commands in rpm spec file to preserve permissions.
[bacula/bacula] / bacula / README
1
2 As you will note, I don't follow the standard GNU release
3 numbering conventions, but rather one that I started in
4 1970.  My internal releases were 0.nn, the first release to
5 another user was 1.0, each modified source code release then
6 gets a new minor release (1.1, 1.2, ...) as well as a date.  Each
7 major change in the software -- e.g.  new tape format will
8 normally have the major release number incremented.
9
10 Your best bet for getting Bacula up and running is to read
11 the manual, which can be found in
12 <bacula-main-directory>/doc/html-manual, or in
13 <bacula-main-directory>/doc/bacula.pdf.
14
15 Barring reading the manual, you might try the
16 following:
17
18 To Configure it:
19
20   ./configure \
21     --sbindir=$HOME/bacula/bin \
22     --sysconfdir=$HOME/bacula/bin \
23     --with-pid-dir=$HOME/bacula/bin \
24     --with-subsys-dir=$HOME/bacula/bin \
25     --with-sqlite=$HOME/depkgs/sqlite \
26     --enable-gnome \
27     --with-mysql=$HOME/mysql \
28     --with-working-dir=$HOME/bacula/bin/working \
29     --with-dump-email=YOUR_EMAIL_ADDRESS \
30     --with-job-email=YOUR_EMAIL_ADDRESS \
31     --with-smtp-host=YOUR_SMTP_SERVER_ADDRESS
32
33 Note, if you do not have readline installed on your
34 system, you either need to add:
35      
36      --disable-readline 
37
38 or add:
39
40      --with-readline=$HOME/bacula/depkgs1/readline
41
42 where I assume you have loaded depkgs1 into $HOME/bacula
43 and built the readline routine.      
44
45 If you want to use SQLite, please download depkgs and
46 build sqlite, then add something like:
47
48     --with-sqlite=$HOME/depkgs/sqlite
49
50
51 Build Bacula:
52
53    make
54
55    If you are doing a port, there should be no errors.  The most
56    likely source of errors will probably come in the src/stored
57    directory in time.c or dev.c.  There may also be problems in
58    lib/signal.c as I currently pull in all Linux signals, some of
59    which may not be available on your system.
60
61 To create the database:
62
63    src/cats/make_bacula_tables
64
65 To install:
66
67    make install
68
69 To start it:
70
71    cd $HOME/bacula/bin
72    ./bacula start
73
74 To start it (as a developer). This is not appropriate if you
75 are installing Bacula.
76
77    ./startit
78    ./console (or ./gnome-console)
79
80 To stop it:
81
82   ./stopit
83
84 Well, it is all just a bit more complicated than that,
85 but you should have the idea.
86
87 Be sure you read the chapter about testing your tape drive!
88 Don't waste a lot of time setting up and running Bacula, if
89 your drive is not supported.
90
91 FreeBSD users, pay special attention to the Device configuration
92 parameters needed to deal with FreeBSD tape drivers.
93
94 License:
95 For the most part, Bacula is licensed under GPL version 2 or greater.        
96 Regardless of what is specified in the GPL license, Bacula may be linked
97 with any non-GPLed libraries, including OpenSSL, that are required for 
98 its proper functioning.
99
100 In addition to GPL, there are also parts of Bacula that are licensed
101 under LGPL so that they may be used in proprietary code to interface
102 with Bacula, and there are parts that are in the public domain.
103              
104 THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS
105 IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED
106 TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A
107 PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT OWNER
108 OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL,
109 EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO,
110 PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR
111 PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF
112 LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING
113 NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS
114 SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.