WHATSNEW: Mention performance improvements for SMB3 encryption
[samba.git] / WHATSNEW.txt
1 Release Announcements
2 =====================
3
4 This is the first preview release of Samba 4.12.  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/.
8
9 Samba 4.12 will be the next version of the Samba suite.
10
11
12 UPGRADING
13 =========
14
15
16 NEW FEATURES/CHANGES
17 ====================
18
19 Python 3.5 Required
20 -------------------
21
22 Samba's minimum runtime requirement for python was raised to Python
23 3.4 with samba 4.11.  Samba 4.12 raises this minimum version to Python
24 3.5 both to access new features and because this is the oldest version
25 we test with in our CI infrastructure.
26
27 (Build time support for the file server with Python 2.6 has not
28 changed)
29
30 GnuTLS 3.4.7 required
31 ---------------------
32
33 Samba is making efforts to remove in-tree cryptographic functionality,
34 and to instead rely on externally maintained libraries.  To this end,
35 Samba has chosen GnuTLS as our standard cryptographic provider.
36
37 Samba now requires GnuTLS 3.4.7 to be installed (including development
38 headers at build time) for all configurations, not just the Samba AD
39 DC.
40
41 Using GnuTLS for SMB3 encryption you will notice huge performance and copy
42 speed improvements. Tests with the CIFS Kernel client from Linux Kernel 5.3
43 show a 3x speed improvement for writing and a 2.5x speed improvement for reads!
44
45 NOTE WELL: The use of GnuTLS means that Samba will honour the
46 system-wide 'FIPS mode' (a reference to the US FIPS-140 cryptographic
47 standard) and so will not operate in many still common situations if
48 this system-wide parameter is in effect, as many of our protocols rely
49 on outdated cryptography.
50
51 A future Samba version will mitigate this to some extent where good
52 cryptography effectively wraps bad cryptography, but for now that above
53 applies.
54
55
56 REMOVED FEATURES
57 ================
58
59 BIND9_FLATFILE deprecated
60 -------------------------
61
62 The BIND9_FLATFILE DNS backend is deprecated in this release and will
63 be removed in the future.  This was only practically useful on a single
64 domain controller or under expert care and supervision.
65
66 This release removes the "rndc command" smb.conf parameter, which
67 supported this configuration by writing out a list of DCs permitted to
68 make changes to the DNS Zone and nudging the 'named' server if a new
69 DC was added to the domain.  Administrators using BIND9_FLATFILE will
70 need to maintain this manually from now on.
71
72 smb.conf changes
73 ================
74
75   Parameter Name                     Description                Default
76   --------------                     -----------                -------
77
78   nfs4:acedup                        Changed default            merge
79   rndc command                       Removed
80
81 KNOWN ISSUES
82 ============
83
84 https://wiki.samba.org/index.php/Release_Planning_for_Samba_4.12#Release_blocking_bugs
85
86
87 #######################################
88 Reporting bugs & Development Discussion
89 #######################################
90
91 Please discuss this release on the samba-technical mailing list or by
92 joining the #samba-technical IRC channel on irc.freenode.net.
93
94 If you do report problems then please try to send high quality
95 feedback. If you don't provide vital information to help us track down
96 the problem then you will probably be ignored.  All bug reports should
97 be filed under the Samba 4.1 and newer product in the project's Bugzilla
98 database (https://bugzilla.samba.org/).
99
100
101 ======================================================================
102 == Our Code, Our Bugs, Our Responsibility.
103 == The Samba Team
104 ======================================================================
105