WHATSNEW.txt

   1                    ==============================
   2                    Release Notes for Samba 4.10.0
   3                            March 19, 2019
   4                    ==============================
   5
   6
   7 This is the first stable release of the Samba 4.10 release series.
   8 Please read the release notes carefully before upgrading.
   9
  10
  11 NEW FEATURES/CHANGES
  12 ====================
  13
  14 GPO Improvements
  15 ----------------
  16
  17 A new 'samba-tool gpo backup' command has been added that can export a
  18 set of Group Policy Objects from a domain in a generalised XML format.
  19
  20 A corresponding 'samba-tool gpo restore' command has been added to
  21 rebuild the Group Policy Objects from the XML after generalization.
  22 (The administrator needs to correct the values of XML entities between
  23 the backup and restore to account for the change in domain).
  24
  25 KDC prefork
  26 -----------
  27
  28 The KDC now supports the pre-fork process model and worker processes will be
  29 forked for the KDC when the pre-fork process model is selected for samba.
  30
  31 Prefork 'prefork children'
  32 --------------------------
  33
  34 The default value for this smdb.conf parameter has been increased from 1 to
  35 4.
  36
  37 Netlogon prefork
  38 ----------------
  39
  40 DCERPC now supports pre-forked NETLOGON processes. The netlogon processes are
  41 pre-forked when the prefork process model is selected for samba.
  42
  43 Offline domain backups
  44 ----------------------
  45
  46 The 'samba-tool domain backup' command has been extended with a new 'offline'
  47 option. This safely creates a backup of the local DC's database directly from
  48 disk. The main benefits of an offline backup are it's quicker, it stores more
  49 database details (for forensic purposes), and the samba process does not have
  50 to be running when the backup is made. Refer to the samba-tool help for more
  51 details on using this command.
  52
  53 Group membership statistics
  54 ---------------------------
  55
  56 A new 'samba-tool group stats' command has been added. This provides summary
  57 information about how the users are spread across groups in your domain.
  58 The 'samba-tool group list --verbose' command has also been updated to include
  59 the number of users in each group.
  60
  61 Paged results LDAP control
  62 --------------------------
  63
  64 The behaviour of the paged results control (1.2.840.113556.1.4.319, RFC2696)
  65 has been changed to more closely match Windows servers, to improve memory
  66 usage. Paged results may be used internally (or is requested by the user) by
  67 LDAP libraries or tools that deal with large result sizes, for example, when
  68 listing all the objects in the database.
  69
  70 Previously, results were returned as a snapshot of the database but now,
  71 some changes made to the set of results while paging may be reflected in the
  72 responses. If strict inter-record consistency is required in answers (which is
  73 not possible on Windows with large result sets), consider avoiding the paged
  74 results control or alternatively, it might be possible to enforce restrictions
  75 using the LDAP filter expression.
  76
  77 For further details see https://wiki.samba.org/index.php/Paged_Results
  78
  79 Prefork process restart
  80 -----------------------
  81
  82 The pre-fork process model now restarts failed processes. The delay between
  83 restart attempts is controlled by the "prefork backoff increment" (default = 10)
  84 and "prefork maximum backoff" (default = 120) smbd.conf parameters.  A linear
  85 back off strategy is used with "prefork backoff increment" added to the
  86 delay between restart attempts up until it reaches "prefork maximum backoff".
  87
  88 Using the default sequence the restart delays (in seconds) are:
  89   0, 10, 20, ..., 120, 120, ...
  90
  91 Standard process model
  92 ----------------------
  93
  94 When using the standard process model samba forks a new process to handle ldap
  95 and netlogon connections.  Samba now honours the 'max smbd processes' smb.conf
  96 parameter.  The default value of 0, indicates there is no limit.  The limit
  97 is applied individually to netlogon and ldap.  When the process limit is
  98 exceeded Samba drops new connections immediately.
  99
 100 python3 support
 101 ---------------
 102
 103 This is the first release of Samba which has full support for Python 3.
 104 Samba 4.10 still has support for Python 2, however, Python 3 will be used by
 105 default, i.e. 'configure' & 'make' will execute using python3.
 106
 107 To build Samba with python2 you *must* set the 'PYTHON' environment variable
 108 for both the 'configure' and 'make' steps, i.e.
 109    'PYTHON=python2 ./configure'
 110    'PYTHON=python2 make'
 111 This will override the python3 default.
 112
 113 Alternatively, it is possible to produce Samba Python bindings for both
 114 Python 2 and Python 3. To do so, specify '--extra-python=/usr/bin/python2'
 115 as part of the 'configure' command. Note that python3 will still be used as
 116 the default in this case.
 117
 118 Note that Samba 4.10 supports Python 3.4 onwards.
 119
 120 Future Python support
 121 ---------------------
 122
 123 Samba 4.10 will be the last release that comes with full support for
 124 Python 2. Unfortunately, the Samba Team doesn't have the resources to support
 125 both Python 2 and Python 3 long-term.
 126
 127 Samba 4.11 will not have any runtime support for Python 2. This means if
 128 you use Python 2 bindings it is time to migrate to Python 3 now.
 129
 130 If you are building Samba using the '--disable-python' option (i.e. you're
 131 excluding all the run-time Python support), then this will continue to work
 132 on a system that supports either python2 or python3.
 133
 134 Also note that Samba 4.11 will most likely only support Python 3.6 onwards.
 135
 136 JSON logging
 137 ------------
 138
 139 Authentication messages now contain the Windows Event Id "eventId" and logon
 140 type "logonType". The supported event codes and logon types are:
 141   Event codes:
 142     4624  Successful logon
 143     4625  Unsuccessful logon
 144
 145   Logon Types:
 146     2  Interactive
 147     3  Network
 148     8  NetworkCleartext
 149
 150 The version number for Authentication messages is now 1.1, changed from 1.0
 151
 152 Password change messages now contain the Windows Event Id "eventId", the
 153 supported event Id's are:
 154   4723 Password changed
 155   4724 Password reset
 156
 157 The version number for PasswordChange messages is now 1.1, changed from 1.0
 158
 159 Group membership change messages now contain the Windows Event Id "eventId",
 160 the supported event Id's are:
 161   4728 A member was added to a security enabled global group
 162   4729 A member was removed from a security enabled global group
 163   4732 A member was added to a security enabled local group
 164   4733 A member was removed from a security enabled local group
 165   4746 A member was added to a security disabled local group
 166   4747 A member was removed from a security disabled local group
 167   4751 A member was added to a security disabled global group
 168   4752 A member was removed from a security disabled global group
 169   4756 A member was added to a security enabled universal group
 170   4757 A member was removed from a security enabled universal group
 171   4761 A member was added to a security disabled universal group
 172   4762 A member was removed from a security disabled universal group
 173
 174
 175 The version number for GroupChange messages is now 1.1, changed from 1.0. Also
 176 A GroupChange message is generated when a new user is created to log that the
 177 user has been added to their primary group.
 178
 179 The leading "JSON <message type>:" and source file  prefix of the JSON formatted
 180 log entries has been removed to make the parsing of the JSON log messages
 181 easier. JSON log entries now start with 2 spaces followed by an opening brace
 182 i.e. "  {"
 183
 184 SMBv2 samba-tool support
 185 ------------------------
 186
 187 On previous releases, some samba-tool commands would not work against a remote
 188 DC that had SMBv1 disabled. SMBv2 support has now been added for samba-tool.
 189 The affected commands are 'samba-tool domain backup|rename' and the
 190 'samba-tool gpo' set of commands. Refer also bug #13676.
 191
 192 New glusterfs_fuse VFS module
 193 -----------------------------
 194
 195 The new vfs_glusterfs_fuse module improves performance when Samba
 196 accesses a glusterfs volume mounted via FUSE (Filesystem in Userspace
 197 as part of the Linux kernel). It achieves that by leveraging a
 198 mechanism to retrieve the appropriate case of filenames by querying a
 199 specific extended attribute in the filesystem. No extra configuration
 200 is required to use this module, only glusterfs_fuse needs to be set in
 201 the "vfs objects" parameter. Further details can be found in the
 202 vfs_glusterfs_fuse(8) manpage. This new vfs_glusterfs_fuse module does
 203 not replace the existing vfs_glusterfs module, it just provides an
 204 additional, alternative mechanism to access a Gluster volume.
 205
 206 REMOVED FEATURES
 207 ================
 208
 209 MIT Kerberos build of the AD DC
 210 -------------------------------
 211
 212 While not removed, the MIT Kerberos build of the Samba AD DC is still
 213 considered experimental.  Because Samba will not issue security
 214 patches for this configuration, such builds now require the explicit
 215 configure option: --with-experimental-mit-ad-dc
 216
 217 For further details see
 218 https://wiki.samba.org/index.php/Running_a_Samba_AD_DC_with_MIT_Kerberos_KDC
 219
 220 samba_backup
 221 ------------
 222
 223 The samba_backup script has been removed. This has now been replaced by the
 224 'samba-tool domain backup offline' command.
 225
 226 SMB client Python bindings
 227 --------------------------
 228
 229 The SMB client python bindings are now deprecated and will be removed in future
 230 Samba releases. This will only affects users that may have used the Samba
 231 Python bindings to write their own utilities, i.e. users with a custom Python
 232 script that includes the line 'from samba import smb'.
 233
 234 smb.conf changes
 235 ================
 236
 237   Parameter Name                     Description                Default
 238   --------------                     -----------                -------
 239   prefork backoff increment   Delay added to process restart    10 (seconds)
 240                               between attempts.
 241   prefork maximum backoff     Maximum delay for process between 120 (seconds)
 242                               process restart attempts
 243   smbd search ask sharemode   Name changed, old name was
 244                               "smbd:search ask sharemode"
 245   smbd async dosmode          Name changed, old name was
 246                               "smbd:async dosmode"
 247   smbd max async dosmode      Name changed, old name was
 248                               "smbd:max async dosmode"
 249   smbd getinfo ask sharemode  New: similar to "smbd search ask yes
 250                               sharemode" but for SMB getinfo
 251
 252
 253 CHANGES SINCE 4.10.0rc4
 254 =======================
 255
 256 o  Andrew Bartlett <abartlet@samba.org>
 257    * BUG 13760: s4-server: Open and close a transaction on sam.ldb at startup.
 258
 259 o  Ralph Boehme <slow@samba.org>
 260    * BUG 13812: access_check_max_allowed() doesn't process "Owner Rights" ACEs.
 261
 262 o  Joe Guo <joeg@catalyst.net.nz>
 263    * s4/scripting/bin: Open unicode files with utf8 encoding and write
 264    * unicode string.
 265
 266 o  Björn Jacke <bj@sernet.de>
 267    * BUG 13759: sambaundoguididx: Use the right escaped oder unescaped sam ldb
 268      files.
 269
 270 o  Volker Lendecke <vl@samba.org>
 271    * BUG 13813: Fix idmap cache pollution with S-1-22- IDs on winbind hickup.
 272
 273 o  Christof Schmitt <cs@samba.org>
 274    * passdb: Update ABI to 0.27.2.
 275    * BUG 13813: lib/winbind_util: Add winbind_xid_to_sid for --without-winbind.
 276
 277 o  Andreas Schneider <asn@samba.org>
 278    * BUG 13823: lib:util: Move debug message for mkdir failing to log level 1.
 279
 280
 281 CHANGES SINCE 4.10.0rc3
 282 =======================
 283
 284 o  Jeremy Allison <jra@samba.org>
 285    * BUG 13803: SMB1 POSIX mkdir does case insensitive name lookup.
 286
 287 o  Ralph Boehme <slow@samba.org>
 288    * BUG 13802: Fix idmap xid2sid cache issue.
 289
 290 o  David Disseldorp <ddiss@samba.org>
 291    * BUG 13807: vfs_ceph strict_allocate_ftruncate calls (local FS) ftruncate
 292      and fallocate.
 293
 294 o  Volker Lendecke <vl@samba.org>
 295    * BUG 13786: messages_dgm: Properly handle receiver re-initialization.
 296
 297 o  Gary Lockyer <gary@catalyst.net.nz>
 298    * BUG 13765: man pages: Document prefork process model.
 299    * BUG 13773: CVE-2019-3824 ldb: wildcard_match end of data check.
 300
 301 o  Stefan Metzmacher <metze@samba.org>
 302    * tdb: Fix compatibility of wscript with older python.
 303    * tevent: version 0.9.39
 304    * BUG 13773: CVE-2019-3824 ldb: version 1.5.4
 305
 306 o  David Mulder <dmulder@suse.com>
 307    * Search for location of waf script.
 308
 309 o  Noel Power <noel.power@suse.com>
 310    * BUG 13777: buildtools/wafsamba: Avoid decode when using python2.
 311
 312 o  Jiří Šašek <jiri.sasek@oracle.com>
 313    * BUG 13704: notifyd: Fix SIGBUS on sparc.
 314
 315 o  Swen Schillig <swen@linux.ibm.com>
 316    * BUG 13791: ctdb: Buffer write beyond limits.
 317
 318 o  Lukas Slebodnik <lslebodn@fedoraproject.org>
 319    * BUG 13773: CVE-2019-3824 ldb: Out of bound read in ldb_wildcard_compare.
 320
 321 o  Martin Schwenke <martin@meltin.net>
 322    * BUG 13790: ctdb-config: Change example recovery lock setting to one that
 323      fails.
 324    * BUG 13800: Fix recovery lock bug.
 325
 326
 327 CHANGES SINCE 4.10.0rc2
 328 =======================
 329
 330 o  Jeremy Allison <jra@samba.org>
 331    * BUG 13690: smbd: uid: Don't crash if 'force group' is added to an existing
 332      share connection.
 333    * BUG 13770: s3: VFS: vfs_fruit. Fix the NetAtalk deny mode compatibility
 334      code.
 335
 336 o  Andrew Bartlett <abartlet@samba.org>
 337    * ldb: Release ldb 1.5.3
 338    * BUG 13762: Avoid inefficient one-level searches.
 339    * BUG 13772: The test api.py should not rely on order of entries in dict.
 340
 341 o  Tim Beale <timbeale@catalyst.net.nz>
 342    * BUG 13762: ldb: Avoid inefficient one-level searches.
 343
 344 o  Ralph Boehme <slow@samba.org>
 345    * BUG 13776: tldap: Avoid use after free errors.
 346
 347 o  Günther Deschner <gd@samba.org>
 348    * BUG 13746: s3-smbd: Use fruit:model string for mDNS registration.
 349
 350 o  David Disseldorp <ddiss@samba.org>
 351    * BUG 13766: printing: Check lp_load_printers() prior to pcap cache update.
 352
 353 o  Christof Schmitt <cs@samba.org>
 354    * BUG 13787: waf: Check for libnscd.
 355
 356 o  Andreas Schneider <asn@samba.org>
 357    * BUG 13770: s3:vfs: Correctly check if OFD locks should be enabled or not.
 358    * BUG 13778: Public ZERO_STRUCT() uses undefined C11 function memset_s().
 359
 360
 361 CHANGES SINCE 4.10.0rc1
 362 =======================
 363
 364 o  Jeremy Allison <jra@samba.org>
 365    * BUG 13750: libcli: dns: Change internal DNS_REQUEST_TIMEOUT from 2 to 10
 366      seconds.
 367
 368 o  Tim Beale <timbeale@catalyst.net.nz>
 369    * BUG 13676: samba-tool SMB/sysvol connections do not work if SMBv1 is
 370      disabled.
 371    * BUG 13747: join: Throw CommandError instead of Exception for simple errors.
 372
 373 o  Günther Deschner <gd@samba.org>
 374    * BUG 13774: s3-vfs: Add glusterfs_fuse vfs module.
 375
 376 o  Volker Lendecke <vl@samba.org>
 377    * BUG 13742: ctdb: Print locks latency in machinereadable stats.
 378
 379 o  Stefan Metzmacher <metze@samba.org>
 380    * BUG 13752: s4:server: Add support for 'smbcontrol samba shutdown'.
 381
 382 o  Anoop C S <anoopcs@redhat.com>
 383    * BUG 13330: vfs_glusterfs: Adapt to changes in libgfapi signatures.
 384    * BUG 13774: s3-vfs: Use ENOATTR in errno comparison for getxattr.
 385
 386 o  Justin Stephenson <jstephen@redhat.com>
 387    * BUG 13727: s3:libsmb: Honor disable_netbios option in smbsock_connect_send.
 388
 389
 390 KNOWN ISSUES
 391 ============
 392
 393 https://wiki.samba.org/index.php/Release_Planning_for_Samba_4.10#Release_blocking_bugs
 394
 395
 396 #######################################
 397 Reporting bugs & Development Discussion
 398 #######################################
 399
 400 Please discuss this release on the samba-technical mailing list or by
 401 joining the #samba-technical IRC channel on irc.freenode.net.
 402
 403 If you do report problems then please try to send high quality
 404 feedback. If you don't provide vital information to help us track down
 405 the problem then you will probably be ignored.  All bug reports should
 406 be filed under the Samba 4.1 and newer product in the project's Bugzilla
 407 database (https://bugzilla.samba.org/).
 408
 409
 410 ======================================================================
 411 == Our Code, Our Bugs, Our Responsibility.
 412 == The Samba Team
 413 ======================================================================
 414