docs-xml/manpages/samba_downgrade_db.8.xml

   1 <?xml version="1.0" encoding="iso-8859-1"?>
   2 <!DOCTYPE refentry PUBLIC "-//Samba-Team//DTD DocBook V4.2-Based Variant V1.0//EN" "http://www.samba.org/samba/DTD/samba-doc">
   3 <refentry id="samba_downgrade_db.8">
   4
   5 <refmeta>
   6         <refentrytitle>samba_downgrade_db</refentrytitle>
   7         <manvolnum>8</manvolnum>
   8         <refmiscinfo class="source">Samba</refmiscinfo>
   9         <refmiscinfo class="manual">User Commands</refmiscinfo>
  10         <refmiscinfo class="version">&doc.version;</refmiscinfo>
  11 </refmeta>
  12
  13
  14 <refnamediv>
  15         <refname>samba_downgrade_db</refname>
  16         <refpurpose>Samba tool for downgrading AD databases
  17         </refpurpose>
  18 </refnamediv>
  19
  20 <refsynopsisdiv>
  21         <cmdsynopsis>
  22                 <command>samba_downgrade_db</command>
  23                 <arg choice="opt">-H</arg>
  24                 <arg choice="opt">-s</arg>
  25         </cmdsynopsis>
  26 </refsynopsisdiv>
  27
  28 <refsect1>
  29         <title>DESCRIPTION</title>
  30         <para>This tool is part of the <citerefentry><refentrytitle>samba</refentrytitle>
  31         <manvolnum>8</manvolnum></citerefentry> suite.</para>
  32
  33         <para>The format of the Samba Active Directory (AD) database changed in
  34         version 4.8 and 4.11. When downgrading a Samba AD Domain Controller (DC)
  35         to a release that is older than either of these versions (e.g. 4.11 to
  36         4.10), the AD database must be manually downgraded
  37         <emphasis>before</emphasis> the Samba packages can be safely downgraded.
  38         </para>
  39
  40         <para>This tool downgrades a Samba sam.ldb database from the format
  41         used in version &doc.version; to that of version 4.7. The v4.7 database
  42         format can safely be read by any version of Samba. If necessary, later
  43         versions of Samba will repack and reconfigure a v4.7-format database when
  44         the samba executable is first started.</para>
  45
  46         <para>Note that all Samba services must be stopped on the DC before running
  47         this tool. Once the tool has run, do not restart samba or modify the
  48         database before the Samba software package has been downgraded.
  49         </para>
  50 </refsect1>
  51
  52 <refsect1>
  53         <title>OPTIONS</title>
  54
  55         <variablelist>
  56
  57         <varlistentry>
  58         <term>-H [sam.ldb file]</term>
  59         <listitem><para>
  60         Link directly to a sam.ldb file instead of using path in system
  61         smb.conf
  62         </para></listitem>
  63         </varlistentry>
  64
  65         <varlistentry>
  66         <term>-s [smb.conf file]</term>
  67         <listitem><para>
  68         Link directly to smb.conf file instead of system default (usually
  69         in /usr/local/samba/etc/smb.conf)
  70         </para></listitem>
  71         </varlistentry>
  72
  73         </variablelist>
  74 </refsect1>
  75
  76 <refsect1>
  77         <title>VERSION</title>
  78
  79         <para>This man page is complete for version &doc.version; of the Samba
  80         suite.</para>
  81 </refsect1>
  82
  83 <refsect1>
  84         <title>AUTHOR</title>
  85
  86         <para>The original Samba software and related utilities
  87         were created by Andrew Tridgell. Samba is now developed
  88         by the Samba Team as an Open Source project similar
  89         to the way the Linux kernel is developed.</para>
  90
  91         <para>The samba_downgrade_db tool was developed by the Samba team
  92         at Catalyst IT Ltd.</para>
  93 </refsect1>
  94
  95 </refentry>