WHATSNEW: Prepare release notes for Samba 4.7.0rc1.
[samba.git] / WHATSNEW.txt
1 Release Announcements
2 =====================
3
4 This is the first release candidate of Samba 4.7.  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.7 will be the next version of the Samba suite.
10
11
12 UPGRADING
13 =========
14
15 smbclient changes
16 -----------------
17
18 smbclient no longer prints a 'Domain=[...] OS=[Windows 6.1] Server=[...]'
19 banner when connecting to the first server. With SMB2 and Kerberos
20 there's no way to print this information reliable. Now we avoid it at all
21 consistently. In interactive session the following banner is now presented
22 to the user: 'Try "help" do get a list of possible commands.'.
23
24 The default for "client max protocol" has changed to "SMB3_11",
25 which means that smbclient (and related commands) will work against
26 servers without SMB1 support.
27
28 It's possible to use the '-m/--max-protocol' option to overwrite
29 the "client max protocol" option temporary.
30
31 Note that the '-e/--encrypt' option also works with most SMB3 servers
32 (e.g. Windows >= 2012 and Samba >= 4.0.0), so the SMB1 unix extensions
33 are not required for encryption.
34
35 The change to SMB3_11 as default also  means smbclient no longer
36 negotiates SMB1 unix extensions by default, when talking to a Samba server with
37 "unix extensions = yes".  As a result some commands are not available, e.g.
38 posix_encrypt, posix_open, posix_mkdir, posix_rmdir, posix_unlink, posix_whoami,
39 getfacl and symlink. Using "-mNT1" reenabled them, if the server supports SMB1.
40
41 Note the default ("CORE") for "client min protocol" hasn't changed,
42 so it's still possible to connect to SMB1-only servers by default.
43
44
45 NEW FEATURES/CHANGES
46 ====================
47
48 Whole DB read locks: Improved LDAP and replication consistency
49 --------------------------------------------------------------
50
51 Prior to Samba 4.7 and ldb 1.2.0, the LDB database layer used by Samba
52 erronously did not take whole-DB read locks to protect search
53 and DRS replication operations.
54
55 While each object returned remained subject to a record-level lock (so
56 would remain consistent to itself), under a race condition with a
57 rename or delete, it and any links (like the member attribute) to it
58 would not be returned.
59
60 The symptoms of this issue include:
61
62 Replication failures with this error showing in the client side logs:
63  error during DRS repl ADD: No objectClass found in replPropertyMetaData for
64  Failed to commit objects:
65  WERR_GEN_FAILURE/NT_STATUS_INVALID_NETWORK_RESPONSE
66
67 A crash of the server, in particular the rpc_server process with
68  INTERNAL ERROR: Signal 11
69
70 LDAP read inconsistency
71  A DN subject to a search at the same time as it is being renamed
72  may not appear under either the old or new name, but will re-appear
73  for a subsequent search.
74
75 See https://bugzilla.samba.org/show_bug.cgi?id=12858 for more details
76 and updated advise on database recovery for affected installations.
77
78
79 Samba AD with MIT Kerberos
80 --------------------------
81
82 After four years of development, Samba finally supports compiling and
83 running Samba AD with MIT Kerberos. You can enable it with:
84
85     ./configure --with-system-mitkrb5
86
87 Samba requires version 1.15.1 of MIT Kerberos to build with AD DC support.
88 The krb5-devel and krb5-server packages are required.
89 The feature set is not on par with with the Heimdal build but the most important
90 things, like forest and external trusts, are working. Samba uses the KDC binary
91 provided by MIT Kerberos.
92
93 Missing features, compared to Heimdal, are:
94   * PKINIT support
95   * S4U2SELF/S4U2PROXY support
96   * RODC support (not fully working with Heimdal either)
97
98 The Samba AD process will take care of starting the MIT KDC and it will load a
99 KDB (Kerberos Database) driver to access the Samba AD database.  When
100 provisioning an AD DC using 'samba-tool' it will take care of creating a correct
101 kdc.conf file for the MIT KDC. Note that 'samba-tool' will overwrite the system
102 kdc.conf by default. It is possible to use a different location during
103 provision. You should consult the 'samba-tool' help and smb.conf manpage for
104 details.
105
106 Dynamic RPC port range
107 ----------------------
108
109 The dynamic port range for RPC services has been changed from the old default
110 value 1024-1300 to 49152-65535. This port range is not only used by a
111 Samba AD DC but also applies to all other server roles including NT4-style
112 domain controllers. The new value has been defined by Microsoft in Windows
113 Server 2008 and newer versions. To make it easier for Administrators to control
114 those port ranges we use the same default and make it configurable with the
115 option: 'rpc server dynamic port range'.
116
117 The 'rpc server port' option sets the first available port from the new
118 'rpc server dynamic port range' option. The option 'rpc server port' only
119 applies to Samba provisioned as an AD DC.
120
121 Authentication and Authorization audit support
122 ----------------------------------------------
123
124 Detailed authentication and authorization audit information is now
125 logged to Samba's debug logs under the "auth_audit" debug class,
126 including in particular the client IP address triggering the audit
127 line.  Additionally, if Samba is compiled against the jansson JSON
128 library, a JSON representation is logged under the "auth_json_audit"
129 debug class.
130
131 Audit support is comprehensive for all authentication and
132 authorisation of user accounts in the Samba Active Directory Domain
133 Controller, as well as the implicit authentication in password
134 changes.  In the file server and classic/NT4 domain controller, NTLM
135 authentication, SMB and RPC authorization is covered, however password
136 changes are not at this stage, and this support is not currently
137 backed by a testsuite.
138
139 Multi-process LDAP Server
140 -------------------------
141
142 The LDAP server in the AD DC now honours the process model used for
143 the rest of the samba process, rather than being forced into a single
144 process.  This aids in Samba's ability to scale to larger numbers of AD
145 clients and the AD DC's overall resiliency, but will mean that there is a
146 fork()ed child for every LDAP client, which may be more resource
147 intensive in some situations.
148
149 Improved Read-Only Domain Controller (RODC) Support
150 ---------------------------------------------------
151
152 Support for RODCs in Samba AD until now has been experimental. With this latest
153 version, many of the critical bugs have been fixed and the RODC can be used in
154 DC environments requiring no writable behaviour. RODCs now correctly support
155 bad password lockouts and password disclosure auditing through the
156 msDS-RevealedUsers attribute.
157
158 The fixes made to the RWDC will also allow Windows RODC to function more
159 correctly and to avoid strange data omissions such as failures to replicate
160 groups or updated passwords. Password changes are currently rejected at the
161 RODC, although referrals should be given over LDAP. While any bad passwords can
162 trigger domain-wide lockout, good passwords which have not been replicated yet
163 for a password change can only be used via NTLM on the RODC (and not Kerberos).
164
165 The reliability of RODCs locating a writable partner still requires some
166 improvements and so the 'password server' configuration option is generally
167 recommended on the RODC.
168
169 Additional password hashes stored in supplementalCredentials
170 ------------------------------------------------------------
171
172 A new config option 'password hash userPassword schemes' has been added to
173 enable generation of SHA-256 and SHA-512 hashes (without storing the plaintext
174 password with reversible encryption). This builds upon previous work to improve
175 password sync for the AD DC (originally using GPG).
176
177 The user command of 'samba-tool' has been updated in order to be able to
178 extract these additional hashes, as well as extracting the (HTTP) WDigest
179 hashes that we had also been storing in supplementalCredentials.
180
181 Improvements to DNS during Active Directory domain join
182 -------------------------------------------------------
183
184 The 'samba-tool' domain join command will now add the A and GUID DNS records
185 (on both the local and remote servers) during a join if possible via RPC. This
186 should allow replication to proceed more smoothly post-join.
187
188 The mname element of the SOA record will now also be dynamically generated to
189 point to the local read-write server. 'samba_dnsupdate' should now be more
190 reliable as it will now find the appropriate name server even when resolv.conf
191 points to a forwarder.
192
193 Significant AD performance and replication improvements
194 -------------------------------------------------------
195
196 Previously, replication of group memberships was been an incredibly expensive
197 process for the AD DC. This was mostly due to unnecessary CPU time being spent
198 parsing member linked attributes. The database now stores these linked
199 attributes in sorted form to perform efficient searches for existing members.
200 In domains with a large number of group memberships, a join can now be
201 completed in half the time compared with Samba 4.6.
202
203 LDAP search performance has also improved, particularly in the unindexed search
204 case. Parsing and processing of security descriptors should now be more
205 efficient, improving replication but also overall performance.
206
207 Query record for open file or directory
208 ---------------------------------------
209
210 The record attached to an open file or directory in Samba can be
211 queried through the 'net tdb locking' command. In clustered Samba this
212 can be useful to determine the file or directory triggering
213 corresponding "hot" record warnings in ctdb.
214
215 Removal of lpcfg_register_defaults_hook()
216 -----------------------------------------
217
218 The undocumented and unsupported function lpcfg_register_defaults_hook()
219 that was used by external projects to call into Samba and modify
220 smb.conf default parameter settings has been removed. If your project
221 was using this call please raise the issue on
222 samba-technical@lists.samba.org in order to design a supported
223 way of obtaining the same functionality.
224
225 Change of loadable module interface
226 -----------------------------------
227
228 The _init function of all loadable modules in Samba has changed
229 from:
230
231 NTSTATUS _init(void);
232
233 to:
234
235 NTSTATUS _init(TALLOC_CTX *);
236
237 This allows a program loading a module to pass in a long-lived
238 talloc context (which must be guaranteed to be alive for the
239 lifetime of the module). This allows modules to avoid use of
240 the talloc_autofree_context() (which is inherently thread-unsafe)
241 and still be valgrind-clean on exit. Modules that don't need to
242 free long-lived data on exit should use the NULL talloc context.
243
244 Parameter changes
245 -----------------
246
247 The "strict sync" global parameter has been changed from
248 a default of "no" to "yes". This means smbd will by default
249 obey client requests to synchronize unwritten data in operating
250 system buffers safely onto disk. This is a safer default setting
251 for modern SMB1/2/3 clients.
252
253 The 'ntlm auth' option default is renamed to 'ntlmv2-only', reflecting
254 the previous behaviour.  Two new values have been provided,
255 'mschapv2-and-ntlmv2-only' (allowing MSCHAPv2 while denying NTLMv1)
256 and 'disabled', totally disabling NTLM authentication and password
257 changes.
258
259 smb.conf changes
260 ================
261
262   Parameter Name                     Description             Default
263   --------------                     -----------             -------
264   allow unsafe cluster upgrade       New parameter           no
265   auth event notification            New parameter           no
266   auth methods                       Deprecated
267   client max protocol                Effective               SMB3_11
268                                      default changed
269   map untrusted to domain            New value/              auto
270                                      Default changed/
271                                      Deprecated
272   mit kdc command                    New parameter
273   profile acls                       Deprecated
274   rpc server dynamic port range      New parameter           49152-65535
275   strict sync                        Default changed         yes
276   password hash userPassword schemes New parameter
277   ntlm auth                          New values              ntlmv2-only
278
279
280 KNOWN ISSUES
281 ============
282
283 https://wiki.samba.org/index.php/Release_Planning_for_Samba_4.7#Release_blocking_bugs
284
285
286 #######################################
287 Reporting bugs & Development Discussion
288 #######################################
289
290 Please discuss this release on the samba-technical mailing list or by
291 joining the #samba-technical IRC channel on irc.freenode.net.
292
293 If you do report problems then please try to send high quality
294 feedback. If you don't provide vital information to help us track down
295 the problem then you will probably be ignored.  All bug reports should
296 be filed under the Samba 4.1 and newer product in the project's Bugzilla
297 database (https://bugzilla.samba.org/).
298
299
300 ======================================================================
301 == Our Code, Our Bugs, Our Responsibility.
302 == The Samba Team
303 ======================================================================
304