svn commit: samba-docs r878 - in trunk/Samba3-HOWTO: .

[jht]

Author: jht
Date: 2005-12-02 21:04:10 +0000 (Fri, 02 Dec 2005)
New Revision: 878

WebSVN: 
http://websvn.samba.org/cgi-bin/viewcvs.cgi?view=rev&root=samba-docs&rev=878

Log:
Added IDMAP dump/restore command info.
Modified:
   trunk/Samba3-HOWTO/TOSHARG-TheNetCommand.xml


Changeset:
Modified: trunk/Samba3-HOWTO/TOSHARG-TheNetCommand.xml
===================================================================
--- trunk/Samba3-HOWTO/TOSHARG-TheNetCommand.xml        2005-12-02 20:02:27 UTC 
(rev 877)
+++ trunk/Samba3-HOWTO/TOSHARG-TheNetCommand.xml        2005-12-02 21:04:10 UTC 
(rev 878)
@@ -1802,6 +1802,62 @@
 
        </sect1>
 
+       <sect1>
+       <title>Managing IDMAP UID/SID Mappings</title>
+
+       <para>
+       The IDMAP UID to SID, and SID to UID, mappings that are created by 
<command>winbindd</command> can be
+       backed up to a text file. The text file can be manually edited, 
although it is highly recommended that
+       you attempt this only if you know precisely what you are doing.
+       </para>
+
+       <para>
+       An IDMAP text dump file can be restored (or reloaded). There are two 
situations that may necessitate
+       this action: a) The existing IDMAP file is corrupt, b) It is necessary 
to install an editted version
+       of the mapping information.
+       </para>
+
+       <para>
+       Winbind must be shut down to dump the IDMAP file. Before restoring a 
dump file, shut down
+       <command>winbindd</command> and delete the old 
<filename>winbindd_idmap.tdb</filename> file.
+       </para>
+
+       <sect2>
+       <title>Creating an IDMAP Database Dump File</title>
+
+       <para>
+       The IDMAP database can be dumped to a text file as shown here:
+<screen>
+net idmap dump &lt;full_path_and_tdb_filename&gt; &gt; dumpfile.txt
+</screen>
+       Where the Samba run-time tdb files are stored in the 
<filename>/var/lib/samba</filename> directory
+       the the following commands to create the dump file will suffice:
+<screen>
+net idmap dump /var/lib/samba/winbindd_idmap.tdb &gt; idmap_dump.txt
+</scrreen>
+       </para>
+
+       </sect2>
+
+       <sect2>
+       <title>Restoring the IDMAP Database Dump File</title>
+
+       <para>
+       The IDMAP dump file can be restored using the following command:
+<screen>
+net idmap restore &lt;full_path_and_tdb_filename&gt; &lt; dumpfile.txt
+</screen>
+       Where the Samba run-time tdb files are stored in the 
<filename>/var/lib/samba</filename> directory
+    the the following commands can be used to restore the data to the tdb file.
+<screen>
+net idmap restore /var/lib/samba/winbindd_idmap.tdb &lt; idmap_dump.txt
+</screen>
+       </para>
+
+       </sect2>
+
+       </sect1>
+
        <sect1 id="netmisc1">
        <title>Other Miscellaneous Operations</title>