]> git.sur5r.net Git - bacula/bacula/blob - bacula/README
misc minor updates
[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 Bacula may be linked with any libraries permitted under the GPL, or 
97 with any non-GPLed libraries, including OpenSSL, that are required for 
98 its proper functioning, providing the source code of those non-GPLed
99 libraries is freely available.
100     
101
102 In addition to GPL, there are also parts of Bacula that are licensed
103 under LGPL so that they may be used in proprietary code to interface
104 with Bacula, and there are parts that are in the public domain.
105              
106 THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS
107 IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED
108 TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A
109 PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT OWNER
110 OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL,
111 EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO,
112 PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR
113 PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF
114 LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING
115 NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS
116 SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.