netinfo-fake-address-text-20090427
[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 SEE ALSO
31
32 L<kadb_check(8)>,
33 L<kas(8)>,
34 L<kaserver(8)>
35
36 =head1 COPYRIGHT
37
38 IBM Corporation 2000. <http://www.ibm.com/> All Rights Reserved.
39
40 This documentation is covered by the IBM Public License Version 1.0.  It was
41 converted from HTML to POD by software written by Chas Williams and Russ
42 Allbery, based on work by Alf Wachsmann and Elizabeth Cassell.