Imported Upstream version 2.4.4p3
[debian/amanda] / example / config.site
1 ######################################################################
2 #
3 # Site dependend configuration.  Please edit this file for your
4 # local site and place it in $prefix/share or $prefix/etc.
5 #
6 # For those options that need to replace the default configuration,
7 # remove the beginning # at beginning of the line and set the
8 # options to how you like it.
9 #
10 # These options can also be set on the command line for the configure
11 # script.  The appropriate option for the option is listed along with
12 # the option.
13 #
14 ######################################################################
15
16 # These are the directories for the Amanda programs and files.
17 #
18 # Let $prefix be the location of the root Amanda directory, commonly
19 # /usr/local or /opt/amanda.  $prefix is set by using configure --prefix=.
20 # Other directories are setable:
21 #    $prefix            --prefix=               Default:/usr/local
22 #    $exec_prefix       --exec-prefix=          Default:$prefix
23 #    $sbindir           --sbindir=              Default:$exec_prefix/sbin
24 #    $libexecdir        --libexecdir=           Default:$exec_prefix/libexec
25 #    $libdir            --libdir=               Default:$exec_prefix/lib
26 #    $sysconfdir        --sysconfdir=           Default:$prefix/etc
27 #    $localstatedir     --localstatedir=        Default:$prefix/var
28 #    $mandir            --mandir=               Default:$prefix/man
29
30 # sbindir               --sbindir=DIR
31 #                       Default: $exec_prefix/sbin = /usr/local/sbin
32 #                       Directory containing the server side binaries.
33 # sbindir=/usr/local/sbin
34
35
36 # libexecdir            --libexecdir=DIR
37 #                       Default: $exec_prefix/libexec = /usr/local/libexec
38 #                       Directory containing the client side binaries.
39 # libexecdir=/usr/local/lib/amanda
40
41
42 # lib                   --libdir=DIR
43 #                       Default: $exec_prefix/lib = /usr/local/lib
44 #                       Directory containing the amanda (shared) libraries.
45 # libdir=/usr/local/lib/amanda
46
47
48 # mandir                --mandir=DIR
49 #                       Default: $prefix/man = /usr/local/man
50 #                       Directory containing the manual pages.
51 # mandir=/local/man
52
53
54 # INCLUDE_DIRS          --with-includes="DIR DIR ..."
55 #                       Default: empty
56 #                       Non-standard directories where include files should
57 #                       be looked for.
58 # INCLUDE_DIRS="/opt/gnu/readline/include /opt/gnu/gdbm/include"
59
60
61 # LIBRARY_DIRS          --with-libraries="DIR DIR ..."
62 #                       Default: empty
63 #                       Non-standard directories where libraries should
64 #                       be looked for.
65 # LIBRARY_DIRS="/opt/gnu/readline/lib /opt/gnu/gdbm/lib"
66
67
68 # CONFIG_DIR            --with-configdir=DIR
69 #                       Default: $sysconfdir/amanda = /usr/local/etc/amanda
70 #                       Directory where the runtime files are to be
71 #                       found.  Amanda supports multiple
72 #                       configurations per site; these are contained
73 #                       in subdirectories of CONFIG_DIR.
74 # CONFIG_DIR=/usr/local/etc/amanda
75
76
77 # USE_VERSION_SUFFIXES  --with-suffixes
78 #                       Default: no
79 #                       All the Amanda binaries will be installed with a
80 #                       version string appended to the command name, for
81 #                       example "amdump-2.3.0.4".  You must then set up
82 #                       symlinks from "amdump" to the correct version of
83 #                       the binary, or use them with the version suffixes
84 #                       directly.
85 #                       This is mostly useful when you want multiple
86 #                       versions online for testing purposes.  I recommend
87 #                       it if you are doing a major version upgrade and
88 #                       wish to try out the new version in parallel with
89 #                       the old.
90 # USE_VERSION_SUFFIXES=yes
91
92
93 # NO_SERVER_MODE        --without-server
94 #                       Default: false
95 #                       if true, disables building server stuff.
96 # NO_SERVER_MODE=true
97
98
99 # NO_CLIENT_MODE        --without-client
100 #                       Default: false
101 #                       if true, disables building client stuff.
102 # NO_CLIENT_MODE=true
103
104
105 # NO_RESTORE_MODE       --without-restore
106 #                       Default: false
107 #                       if true, disables building amrestore and amidxtaped
108 # NO_RESTORE_MODE=true
109
110
111 # NO_RECOVER_MODE       --without-amrecover
112 #                       Default: false
113 #                       if true, disables building amrecover.
114 # NO_RECOVER_MODE=true
115
116
117 # DEFAULT_SERVER        --with-index-server=HOST
118 #                       Default: name of the machine configure is run on
119 #                       The default server for the index of files dumped
120 #                       database.
121 # DEFAULT_SERVER=kipuka
122
123
124 # FORCE_USERID          --with-dont-force-uid
125 #                       Default: yes
126 #                       FORCE_USERID controls whether or not the Amanda
127 #                       client-side should suid to a non-priveledged user
128 #                       when inetd runs it as root.  Most older inetds do
129 #                       not allow you to specify which user to run a daemon
130 #                       as in inetd.conf; all daemons are just run as root.
131 #                       We prefer to not do anything as root that can be
132 #                       done as a normal user, so unless FORCE_USERID is set
133 #                       to no, Amanda will switch to the user specified by
134 #                       CLIENT_LOGIN for all further operations on the slave
135 #                       host.  This type of operation normally requires that
136 #                       the CLIENT_LOGIN be in some group that has read
137 #                       permissions on the raw disk devices, and read/write
138 #                       permissions on /etc/dumpdates.
139 # FORCE_USERID=no
140
141
142 # CLIENT_LOGIN          --with-user=USERNAME
143 #                       This flag *must* be specified
144 #                       The user to install as the owner of all Amanda
145 #                       programs and the user to switch to on client
146 #                       machines.
147 # CLIENT_LOGIN=amanda
148
149
150 # SETUID_GROUP          --with-group=GROUPNAME
151 #                       This flag *must* be specified
152 #                       The name of the group to install all files under.
153 # SETUID_GROUP=bin
154
155
156 # USE_RUNDUMP           --with-rundump
157 #                       Default: no (unless xfsdump or vdump are found)
158 #                       Enables the usage of the rundump setuid-root
159 #                       program, that invokes dump as root.
160 # USE_RUNDUMP=yes
161
162
163 # DEFAULT_CONFIG        --with-config=CONFIG
164 #                       Default: DailySet1
165 #                       The default configuration name of the default
166 #                       dump set up.  This gets used throughout the
167 #                       configuration of Amanda.
168 # DEFAULT_CONFIG=DailySet1
169
170
171 # DEFAULT_TAPE_SERVER   --with-tape-server=TAPE_SERVER
172 #                       Default: DEFAULT_SERVER or [--with-index-server]
173 #                       This is the name of the machine which serves as the
174 #                       default machine to recover files from tape using
175 #                       amrecover.  The default machine is the one used
176 #                       for DEFAULT_SERVER.
177 # DEFAULT_TAPE_SERVER=kipuka
178
179
180 # DEFAULT_TAPE_DEVICE   --with-tape-device=TAPE_DEVICE
181 #                       Default: /dev/rmt/[0-9]bn or /dev/nrst[0-9]
182 #                       This sets the default no rewinding tape device.  The
183 #                       configure script will search for the lowest numbered
184 #                       /dev/rmt/[0-9]bn device and if none exist, it will
185 #                       use the lowest numbered /dev/nrst[0-9] device.  If
186 #                       no tape device is found, /dev/null is used.
187 #
188 #                       This is also the name of the no rewinding tape device
189 #                       on the the DEFAULT_TAPE_SERVER machine for
190 #                       restoring backups.
191 # DEFAULT_TAPE_DEVICE=/dev/rmt/0bn
192 # DEFAULT_TAPE_DEVICE=/dev/nrst0
193
194
195 # DEFAULT_RAW_TAPE_DEVICE  --with-ftape-rawdevice=RAW_TAPE_DEVICE
196 #           Default: /dev/rawft[0-3]
197 #           This sets the default raw tape device for use with the Linux 
198 #           floppy tape driver ftape (version 3.04d).
199 #           The configure script will search for the lowest numbered
200 #           /dev/rawft[0-3] device. If no device is found, /dev/null is used.
201 #
202 #           This device is needed for QIC volume table operations with 
203 #           floppy tapes.
204 # DEFAULT_RAW_TAPE_DEVICE=/dev/rawft0
205
206
207 # DEFAULT_CHANGER_DEVICE --with-changer-device=CHANGER_DEVICE
208 #                       Default: /dev/ch0 or /dev/null
209 #                       This sets the default tape changer device.
210 #                       If /dev/ch0 exists, it is used, otherwise, no
211 #                       changer device is defined.
212 # DEFAULT_CHANGER_DEVICE=/dev/ch0
213
214
215 # USE_FQDN              --with-fqdn
216 #                       Default: no
217 #                       Allow Amanda to backup systems in different
218 #                       domains.  This requires that the disklist file
219 #                       have the fully qualified domain names (FQDNs)
220 #                       listed.
221 # USE_FQDN=yes
222
223
224 # SAMBA_CLIENT          --with-smbclient=PROG
225 #                       Default: no
226 #                       Tell Amanda where to find the smbclient program,
227 #                       which does the backing up of Samba PC clients.
228 #                       Look in the patches/ directory for patches to
229 #                       apply to Samba for this to work properly.
230 # SAMBA_CLIENT=/usr/local/bin/smbclient
231
232
233 # GNUTAR                --with-gnutar=PROG
234 #                       Default: look for program named gtar, gnutar or tar
235 #                       that prints GNU tar when run with --version.
236 # GNUTAR=/usr/local/bin/gnutar
237
238 # GNUTAR_LISTDIR        --with-gnutar-listdir[=DIR]
239 #                       Default: $localstatedir/amanda/gnutar-lists =
240 #                               /usr/local/var/amanda/gnutar-lists
241 #                       This specifies the directory where gnutar should
242 #                       place the listed incrementals directory lists it 
243 #                       uses to do incremental backups.
244 # GNUTAR_LISTDIR=/usr/local/var/amanda/gnutar-lists
245
246
247 # DEV_PREFIX
248 #                       Default: system specific
249 #                       Define DEV_PREFIX is the configure script can not
250 #                       figure out the correct device prefix for the disk
251 #                       devices.
252 # DEV_PREFIX="/dev/"
253
254
255 # RDEV_PREFIX
256 #                       Default: system specific
257 #                       Define DEV_PREFIX is the configure script can not
258 #                       figure out the correct device prefix for the raw
259 #                       disk devices.
260 # RDEV_PREFIX="/dev/r"
261
262
263 # BSD_SECURITY          --without-bsd-security
264 #                       Default: yes
265 #                       BSD_SECURITY selects BSD rsh/rlogin style security,
266 #                       which is not great, but is in common use, and its
267 #                       strengths and weaknesses are well known.  Under
268 #                       BSD_SECURITY, the Amanda backup client hosts will
269 #                       check .rhosts (or .amandahosts, see below)
270 #                       files before sending any dump data.
271 # BSD_SECURITY=no
272
273
274 # USE_AMANDAHOSTS       --without-amandahosts
275 #                       Default: yes
276 #                       When BSD_SECURITY is used, by default it will use
277 #                       the .amandahosts file to make sure that the remote
278 #                       user can tell the Amanda client what to do.  If you
279 #                       wish to use the more standard .rhosts and
280 #                       /etc/hosts.equiv files instead, then define this to
281 #                       no.  Unlike .rhosts, .amandahosts cannot contain
282 #                       lines with hostnames only; the username must always
283 #                       be specified.
284 # USE_AMANDAHOSTS=no
285
286
287 # PORTRANGE             --with-portrange=min,max
288 #                       Default: unlimited
289 #                       Limits the range of ports that TCP server
290 #                       sockets will be bound to.  It does not affect
291 #                       reserved (<1024) ports, though.  This is useful 
292 #                       for backing up hosts behind firewalls: they can
293 #                       be configured to use this limited range of
294 #                       ports for data, message and index connections.
295 # PORTRANGE=50000,50100
296
297
298 # UDPPORTRANGE          --with-udpportrange=min,max
299 #                       Default: unlimited
300 #                       Limits the range of ports that UDP sockets
301 #                       will be bound to.  This one *does* affect
302 #                       reserved (<1024) ports, except those handed to
303 #                       amandad by inetd, of course.  This is useful 
304 #                       for backing up hosts behind firewalls: they can
305 #                       be configured to use this limited range of
306 #                       ports for requests.
307 # UDPPORTRANGE=512,520
308
309
310 # KRB4_SECURITY         --with-krb4-security
311 #                       Default: no
312 #                       KRB4_SECURITY selects MIT Kerberos version 4 style
313 #                       security, which is significantly better than
314 #                       BSD_SECURITY, providing for mutual authentication
315 #                       and (optionally) encryption of backup data over the
316 #                       network.  Both BSD_SECURITY and KRB4_SECURITY may be
317 #                       defined at the same time: the type of security to be
318 #                       used can be selected on a per-client-host basis (in
319 #                       the disklist file).
320 #                       NOTE: Due to stupid USA export restrictions, use of
321 #                       KRB4_SECURITY requires source files from the separate
322 #                       "amanda-krb4" package.  See the KERBEROS.HOW-TO-GET
323 #                       instructions on the Amanda home ftp site,
324 #                       ftp.amanda.org.
325 # KRB4_SECURITY=yes
326
327 # If you turn on KRB4_SECURITY, you must set all these options below.
328 #
329 # You can set the principle, instance, and keyfile to use seperately for
330 # both the client and server.
331 #
332 # The instance can either be a string constant, or `HOSTNAME_INSTANCE' if
333 # you want the local hostname used as the instance (ala krb_get_phost).
334 #
335 # The keyfile name can be either a string constant, or `KEYFILE' to use the
336 # default keyfile defined in <krb.h>.
337 # SERVER_HOST_PRINCIPLE="amanda"
338 # SERVER_HOST_INSTANCE="amanda"
339 # SERVER_HOST_KEY_FILE="/.amanda"
340 # CLIENT_HOST_PRINCIPAL="rcmd"
341 # CLIENT_HOST_INSTANCE=HOSTNAME_INSTANCE
342 # CLIENT_HOST_KEY_FILE=KEYFILE
343 # TICKET_LIFETIME=128
344
345
346 # DB_STYLE              --with-db={text,db,dbm,gdbm,ndbm}
347 #                       Default: text
348 #                       This allows the user to force Amanda to use a
349 #                       particular database library.
350 # DB_STYLE=text
351
352 # FORCE_MMAP            --with-mmap
353 #                       Default: no
354 #                       Force the use of mmap() instead of shared memory
355 #                       support.
356 # FORCE_MMAP=yes
357
358
359 # DUMPER_SOCKET_BUFFERIING --with-buffered-dump
360 #                       Default: no
361 #                       Dumping sockets are buffered in the server.  This
362 #                       may improve dumping speed.
363 # DUMPER_SOCKET_BUFFERING=yes
364
365
366 # ASSERTIONS            --with-assertions
367 #                       Default: no
368 #                       Turns on assertion checking, which makes Amanda a
369 #                       bit bigger and slower, but will help catch errors
370 #                       earlier.
371 # ASSERTIONS=yes
372
373
374 # DEBUGGING             --with-debugging
375 #                       Default: /tmp/amanda
376 #                       Turning off debugging prevents that each
377 #                       program saves a transcript of what it did to a
378 #                       file in /tmp/amanda for debugging purposes.  An
379 #                       alternate directory can be specified too.
380 # DEBUGGING=no
381 # DEBUGGING=/var/amanda/debug
382
383 # DEBUG_FILE_WITH_PID   --with-pid-debug-files
384 #                       Default: no
385 #                       Have the Amanda debugging files that are placed
386 #                       in /tmp/amanda have the process ID appended to their
387 #                       filename.
388 # DEBUG_FILE_WITH_PID=yes
389
390
391 # TESTING               --with-testing[=suffix]
392 #                       Default: no
393 #                       Ues alternate service names so that a new
394 #                       version of amanda can be tested without preventing
395 #                       a production one from being run successfully.
396 #                       The used service names will have `-test' appended
397 #                       to the original names, i.e., service `amanda'
398 #                       will become `amanda-test'.
399 #                       If anything different from `n', `no', `y', `ye' or
400 #                       `yes' is specified as suffix, after the equal sign,
401 #                       this suffix will be appended to the service names
402 #                       after a hyphen, i.e., --with-testing=test2 will
403 #                       cause service `amanda-test2' to be used.
404 # TESTING=yes
405
406
407 # USE_LIBTOOL           --disable-libtool
408 #                       Default: yes
409 #                       By default, libtool to create static/shared
410 #                       libraries.  If USE_LIBTOOL is set to no, or
411 #                       --disable-libtool is specified, only static
412 #                       libraries will be created, and the libtool
413 #                       script will only be used to link and install
414 #                       programs.
415 #                       A drawback of using libtool is that it will
416 #                       always install libraries, even static ones,
417 #                       which are not necessary for the execution of
418 #                       programs.  The advantage of using libtool is
419 #                       that shared libraries may be created, which
420 #                       saves disk space.
421 # USE_LIBTOOL=yes
422
423 # with_gnu_ld           --with-gnu-ld
424 #                       Default: no
425 #                       Use GNU ld in order to build shared libraries
426 # with_gnu_ld=yes
427
428
429 # libtool_shared        --enable-shared
430 #                       Default: (enabled)
431 #                       Enable the creation of shared libraries
432 # libtool_shared=--disable-shared
433
434
435 # libtool_static        --enable-static
436 #                       Default: (enabled)
437 #                       Enable the creation of static libraries
438 # libtool_static=--disable-static
439
440
441 #
442 ######################################################################