s4:kdc: Gate claims, auth policies and NTLM restrctions behind 2012/2016 FLs
[Samba.git] / WHATSNEW.txt
blob29e825df8bab06a82ae6e860ebb8d0dfb94c4aa5
1 Release Announcements
2 =====================
4 This is the first pre release of Samba 4.19.  This is *not*
5 intended for production environments and is designed for testing
6 purposes only.  Please report any defects via the Samba bug reporting
7 system at https://bugzilla.samba.org/.
9 Samba 4.19 will be the next version of the Samba suite.
12 UPGRADING
13 =========
16 NEW FEATURES/CHANGES
17 ====================
19 Migrated smbget to use common command line parser
20 -------------------------------------------------
22 The smbget utility implemented its own command line parsing logic. After
23 discovering an issue we decided to migrate it to use the common command line
24 parser. This has some advantages as you get all the feature it provides like
25 Kerberos authentication. The downside is that breaks the options interface.
26 The support for smbgetrc has been removed. You can use an authentication file
27 if needed, this is documented in the manpage.
29 Please check the smbget manpage or --help output.
31 gpupdate changes
32 ----------------
34 The libgpo.get_gpo_list function has been deprecated in favor of
35 an implementation written in python. The new function can be imported via
36 `import samba.gp`. The python implementation connects to Active Directory
37 using the SamDB module, instead of ADS (which is what libgpo uses).
39 Improved winbind logging and a new tool for parsing the winbind logs
40 --------------------------------------------------------------------
42 Winbind logs (if smb.conf 'winbind debug traceid = yes' is set) contain new
43 trace header fields 'traceid' and 'depth'.  Field 'traceid' allows to track the
44 trace records belonging to the same request.  Field 'depth' allows to track the
45 request nesting level. A new tool samba-log-parser is added for better log
46 parsing.
48 Kerberos Claims, Authentication Silos and NTLM authentication policies
49 ----------------------------------------------------------------------
51 An initial, partial implementation of Active Directory Functional
52 Level 2012, 2012R2 and 2016 is available in this release.
54 While we continue to develop these features, existing domains can
55 test the feature by selecting the functional level in provision or
56 raising the DC functional level by setting
58  ad dc functional level = 2016
60 in the smb.conf
62 The smb.conf file on each DC must have 'ad dc functional level = 2016'
63 set to have the partially complete feature available.  This will also,
64 at first startup, update the server's own AD entry with the configured
65 functional level.
67 For new domains, add these parameters to 'samba-tool provision'
69 --option="ad dc functional level = 2016" --function-level=2016
71 The second option, setting the overall domain functional level
72 indicates that all DCs should be at this functional level.
74 To raise the domain functional level of an existing domain, after
75 updating the smb.conf and restarting Samba run
76 samba-tool domain schemaupgrade --schema=2019
77 samba-tool domain functionalprep --function-level=2016
78 samba-tool domain level raise --domain-level=2016 --forest-level=2016
81 REMOVED FEATURES
82 ================
85 smb.conf changes
86 ================
88   Parameter Name                          Description     Default
89   --------------                          -----------     -------
90   winbind debug traceid                   Add traceid     No
91   directory name cache size               Removed
94 KNOWN ISSUES
95 ============
97 https://wiki.samba.org/index.php/Release_Planning_for_Samba_4.19#Release_blocking_bugs
100 #######################################
101 Reporting bugs & Development Discussion
102 #######################################
104 Please discuss this release on the samba-technical mailing list or by
105 joining the #samba-technical:matrix.org matrix room, or
106 #samba-technical IRC channel on irc.libera.chat
108 If you do report problems then please try to send high quality
109 feedback. If you don't provide vital information to help us track down
110 the problem then you will probably be ignored.  All bug reports should
111 be filed under the Samba 4.1 and newer product in the project's Bugzilla
112 database (https://bugzilla.samba.org/).
115 ======================================================================
116 == Our Code, Our Bugs, Our Responsibility.
117 == The Samba Team
118 ======================================================================