ubik: Don't leak UBIK_VERSION_LOCK if setlabel fails
[openafs.git] / doc / man-pages / pod5 / kaserver.DB0.pod
1 =head1 NAME
2
3 kaserver.DB0, kaserver.DBSYS1 - The Authentication Database and associated log
4
5 =head1 DESCRIPTION
6
7 The F<kaserver.DB0> file contains the Authentication Database, which
8 records server encryption keys and an encrypted form of all user
9 passwords. The Authentication Server (B<kaserver> process) uses the
10 information in the database to enable secured communications between AFS
11 server and client processes.
12
13 The F<kaserver.DBSYS1> file is a log file in which the Authentication
14 Server logs each database operation before performing it. When an
15 operation is interrupted, the Authentication Server replays the log to
16 complete the operation.
17
18 Both files are in binary format and reside in the F</usr/afs/db> directory
19 on each of the cell's database server machines. When the Authentication
20 Server starts or restarts on a given machine, it establishes a connection
21 with its peers and verifies that its copy of the database matches the copy
22 on the other database server machines. If not, the Authentication Servers
23 call on AFS's distributed database technology, Ubik, to distribute to all
24 of the machines the copy of the database with the highest version number.
25
26 Always use the commands in the kas suite to administer the Authentication
27 Database. It is advisable to create an archive copy of the database on a
28 regular basis, using a tool such as the UNIX B<tar> command.
29
30 =head1 CAUTIONS
31
32 The Authentication Server is obsolete and is provided only for sites that
33 need to use it while preparing for a migration to Kerberos KDC. It will be
34 removed in a future version of OpenAFS.
35
36 =head1 SEE ALSO
37
38 L<kadb_check(8)>,
39 L<kas(8)>,
40 L<kaserver(8)>
41
42 =head1 COPYRIGHT
43
44 IBM Corporation 2000. <http://www.ibm.com/> All Rights Reserved.
45
46 This documentation is covered by the IBM Public License Version 1.0.  It was
47 converted from HTML to POD by software written by Chas Williams and Russ
48 Allbery, based on work by Alf Wachsmann and Elizabeth Cassell.