man5-editing-pass-20051213
[openafs.git] / doc / man-pages / pod5 / prdb.DB0.pod
1 =head1 NAME
2
3 prdb.DB0, prdb.DBSYS1 - Contain the Protection Database and associated log
4
5 =head1 DESCRIPTION
6
7 The F<prdb.DB0> file contains the Protection Database, which maps AFS
8 user, machine, and group names to their respective IDs (AFS UIDs and GIDs)
9 and tracks group memberships. The Protection Server (B<ptserver> process)
10 uses the information in the database to help the File Server grant data
11 access to authorized users.
12
13 The F<prdb.DBSYS1> file is a log file in which the Protection Server logs
14 each database operation before performing it.  When an operation is
15 interrupted, the Protection Server replays the log to complete the
16 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 Protection Server
20 starts or restarts on a given machine, it establishes a connection with
21 its peers and verifies that its copy of the database matches the copy on
22 the other database server machines. If not, the Protection Servers call on
23 AFS's distributed database technology, Ubik, to distribute to all of the
24 machines the copy of the database with the highest version number.
25
26 Always use the commands in the B<pts> suite to administer the Protection
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<prdb_check(8)>,
33 L<pts(8)>,
34 L<ptserver(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.