summaryrefslogtreecommitdiff
path: root/docs
diff options
context:
space:
mode:
authorJohn Terpstra <jht@samba.org>2005-12-02 21:04:10 +0000
committerGerald W. Carter <jerry@samba.org>2008-04-23 08:47:12 -0500
commitdf0bf64c958d9f165214c55196f96eaf0aa9a7e9 (patch)
treeb2d34b873b3267b6b39d983b34073b4c5bd33756 /docs
parent5dcee1338a9b7c07f4f7ea3bd8929ac49218c7f1 (diff)
downloadsamba-df0bf64c958d9f165214c55196f96eaf0aa9a7e9.tar.gz
samba-df0bf64c958d9f165214c55196f96eaf0aa9a7e9.tar.bz2
samba-df0bf64c958d9f165214c55196f96eaf0aa9a7e9.zip
Added IDMAP dump/restore command info.
(This used to be commit 4204fcb6349a913f4d49ba725a638dfc6a7695af)
Diffstat (limited to 'docs')
-rw-r--r--docs/Samba3-HOWTO/TOSHARG-TheNetCommand.xml56
1 files changed, 56 insertions, 0 deletions
diff --git a/docs/Samba3-HOWTO/TOSHARG-TheNetCommand.xml b/docs/Samba3-HOWTO/TOSHARG-TheNetCommand.xml
index 63dbf7bfce..ebcfd4abb6 100644
--- a/docs/Samba3-HOWTO/TOSHARG-TheNetCommand.xml
+++ b/docs/Samba3-HOWTO/TOSHARG-TheNetCommand.xml
@@ -1802,6 +1802,62 @@ net ads printer search &lt;printer_name&gt; -Uadministrator%secret
</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>