docs-xml/smbdotconf/protocol/addcfunctionallevel.xml

   1 <samba:parameter name="ad dc functional level"
   2                  context="G"
   3                  type="enum"
   4                  function="ad_dc_functional_level"
   5                  enumlist="enum_ad_functional_level"
   6                  xmlns:samba="http://www.samba.org/samba/DTD/samba-doc">
   7 <description>
   8     <para>The value of the parameter (a string) is the Active
   9     Directory functional level that this Domain Controller will claim
  10     to support.  </para>
  11
  12     <para>Possible values are :</para>
  13     <itemizedlist>
  14         <listitem>
  15             <para><constant>2008_R2</constant>: Similar to Windows
  16             2008 R2 Functional Level</para>
  17         </listitem>
  18         <listitem>
  19             <para><constant>2012</constant>: Similar to Windows
  20             2012 Functional Level</para>
  21         </listitem>
  22         <listitem>
  23             <para><constant>2012_R2</constant>: Similar to Windows
  24             2012 R2 Functional Level</para>
  25         </listitem>
  26         <listitem>
  27             <para><constant>2016</constant>: Similar to Windows
  28             2016 Functional Level</para>
  29         </listitem>
  30     </itemizedlist>
  31
  32     <para>Normally this option should not be set as Samba will operate
  33     per the released functionality of the Samba Active Directory
  34     Domain Controller. </para>
  35
  36     <para>However to access incomplete features in domain functional
  37     level 2016 it may be useful to
  38     set this value, prior to upgrading the domain functional level. </para>
  39
  40     <para>If this is set manually, the protection against mismatching
  41     features between domain controllers is reduced, so all domain
  42     controllers should be running the same version of Samba, to ensure
  43     that behaviour as seen by the client is the same no matter which
  44     DC is contacted.</para>
  45
  46     <para>Setting this to <constant>2016</constant> will allow
  47     raising the domain functional level with <command>samba-tool
  48     domain level raise --domain-level=2016</command> and provide
  49     access to Samba's Kerberos Claims and Dynamic Access
  50     Control feature.</para>
  51
  52     <warning><para> The Samba's Kerberos Claims and Dynamic Access
  53     Control features enabled with <constant>2016</constant> are
  54     incomplete in Samba 4.19.  </para></warning>
  55
  56
  57 </description>
  58
  59 <!-- DO NOT MODIFY without discussion: take care to only update this
  60      default once Samba implements the core aspects of Active
  61      Directory Domain and Forest Functional Level 2016 -->
  62 <value type="default">2008_R2</value>
  63 <value type="example">2016</value>
  64 </samba:parameter>