[hcoop/debian/openafs.git] / doc / man-pages / pod5 / bdb.DB0.pod

=head1 NAME

bdb.DB0, bdb.DBSYS1 - Contain the Backup Database and associated log

=head1 DESCRIPTION

The F<bdb.DB0> file contains the Backup Database, which records
configuration information used by the AFS Backup System along with
cross-indexed records of the tapes created and volumes dumped using the
Backup System commands.

The F<bdb.DBSYS1> file is a log file in which the Backup Server
(B<buserver> process) logs each database operation before performing
it. When an operation is interrupted, the Backup Server replays the log to
complete the operation.

Both files are in binary format and reside in the F</usr/afs/db> directory
on each database server machine that runs the Backup Server.  When the
Backup Server starts or restarts on a given machine, it establishes a
connection with its peers and verifies that its copy of the F<bdb.DB0>
file matches the copy on the other database server machines. If not, the
Backup Servers use AFS's distributed database technology, Ubik, to
distribute to all of the machines the copy of the database with the
highest version number.

Use the commands in the backup suite to administer the Backup Database. It
is advisable to create a backup copy of the F<bdb.DB0> file on tape on a
regular basis, using the UNIX B<tar> command or another local disk backup
utility.

=head1 SEE ALSO

L<backup(8)>,
L<backup_savedb(8)>,
L<buserver(8)>

=head1 COPYRIGHT

IBM Corporation 2000. <http://www.ibm.com/> All Rights Reserved.

This documentation is covered by the IBM Public License Version 1.0.  It was
converted from HTML to POD by software written by Chas Williams and Russ
Allbery, based on work by Alf Wachsmann and Elizabeth Cassell.
Commit	Line	Data
805e021f CE	1	=head1 NAME
	2
	3	bdb.DB0, bdb.DBSYS1 - Contain the Backup Database and associated log
	4
	5	=head1 DESCRIPTION
	6
	7	The F<bdb.DB0> file contains the Backup Database, which records
	8	configuration information used by the AFS Backup System along with
	9	cross-indexed records of the tapes created and volumes dumped using the
	10	Backup System commands.
	11
	12	The F<bdb.DBSYS1> file is a log file in which the Backup Server
	13	(B<buserver> process) logs each database operation before performing
	14	it. When an operation is interrupted, the Backup Server replays the log to
	15	complete the operation.
	16
	17	Both files are in binary format and reside in the F</usr/afs/db> directory
	18	on each database server machine that runs the Backup Server. When the
	19	Backup Server starts or restarts on a given machine, it establishes a
	20	connection with its peers and verifies that its copy of the F<bdb.DB0>
	21	file matches the copy on the other database server machines. If not, the
	22	Backup Servers use AFS's distributed database technology, Ubik, to
	23	distribute to all of the machines the copy of the database with the
	24	highest version number.
	25
	26	Use the commands in the backup suite to administer the Backup Database. It
	27	is advisable to create a backup copy of the F<bdb.DB0> file on tape on a
	28	regular basis, using the UNIX B<tar> command or another local disk backup
	29	utility.
	30
	31	=head1 SEE ALSO
	32
	33	L<backup(8)>,
	34	L<backup_savedb(8)>,
	35	L<buserver(8)>
	36
	37	=head1 COPYRIGHT
	38
	39	IBM Corporation 2000. <http://www.ibm.com/> All Rights Reserved.
	40
	41	This documentation is covered by the IBM Public License Version 1.0. It was
	42	converted from HTML to POD by software written by Chas Williams and Russ
	43	Allbery, based on work by Alf Wachsmann and Elizabeth Cassell.