xml-docbook-documentation-first-pass-20060915

[openafs.git] / doc / xml / AdminReference / sect5 / prdb.DB0.xml

diff --git a/doc/xml/AdminReference/sect5/prdb.DB0.xml b/doc/xml/AdminReference/sect5/prdb.DB0.xml
new file mode 100644 (file)
index 0000000..c6e2042
--- /dev/null
+++ b/doc/xml/AdminReference/sect5/prdb.DB0.xml
@@ -0,0 +1,53 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<refentry id="prdb_DB05">
+  <refmeta>
+    <refentrytitle>prdb.DB0, prdb.DBSYS1</refentrytitle>
+    <manvolnum>5</manvolnum>
+  </refmeta>
+  <refnamediv>
+    <refname>prdb.DB0, prdb.DBSYS1</refname>
+    <refpurpose>Contain the Protection Database and associated log</refpurpose>
+  </refnamediv>
+  <refsect1>
+    <title>Description</title>
+    <para>The <replaceable>prdb.DB0</replaceable> file contains the Protection Database, which maps AFS
+    user, machine, and group names to their respective IDs (AFS UIDs and GIDs)
+    and tracks group memberships. The Protection Server (<emphasis role="bold">ptserver</emphasis> process)
+    uses the information in the database to help the File Server grant data
+    access to authorized users.</para>
+
+    <para>The <replaceable>prdb.DBSYS1</replaceable> file is a log file in which the Protection Server logs
+    each database operation before performing it.  When an operation is
+    interrupted, the Protection Server replays the log to complete the
+    operation.</para>
+
+    <para>Both files are in binary format and reside in the <replaceable>/usr/afs/db</replaceable> directory
+    on each of the cell's database server machines. When the Protection Server
+    starts or restarts on a given machine, it establishes a connection with
+    its peers and verifies that its copy of the database matches the copy on
+    the other database server machines. If not, the Protection Servers call on
+    AFS's distributed database technology, Ubik, to distribute to all of the
+    machines the copy of the database with the highest version number.</para>
+
+    <para>Always use the commands in the <emphasis role="bold">pts</emphasis> suite to administer the Protection
+    Database. It is advisable to create an archive copy of the database on a
+    regular basis, using a tool such as the UNIX <emphasis role="bold">tar</emphasis> command.</para>
+
+  </refsect1>
+  <refsect1>
+    <title>See Also</title>
+    <para><link linkend="prdb_check8">prdb_check(8)</link>,
+    <link linkend="pts1">pts(1)</link>,
+    <link linkend="ptserver8">ptserver(8)</link></para>
+
+  </refsect1>
+  <refsect1>
+    <title>Copyright</title>
+    <para>IBM Corporation 2000. &lt;http://www.ibm.com/&gt; All Rights Reserved.</para>
+
+    <para>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.</para>
+
+  </refsect1>
+</refentry>