WHATSNEW.txt

   1 Release Announcements
   2 =====================
   3
   4 This is the third release candidate of Samba 4.10.  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.10 will be the next version of the Samba suite.
  10
  11
  12 UPGRADING
  13 =========
  14
  15
  16 NEW FEATURES/CHANGES
  17 ====================
  18
  19 GPO Improvements
  20 ----------------
  21
  22 A new 'samba-tool gpo export' command has been added that can export a
  23 set of Group Policy Objects from a domain in a generalised XML format.
  24
  25 A corresponding 'samba-tool gpo restore' command has been added to
  26 rebuild the Group Policy Objects from the XML after generalization.
  27 (The administrator needs to correct the values of XML entities between
  28 the backup and restore to account for the change in domain).
  29
  30 KDC prefork
  31 -----------
  32
  33 The KDC now supports the pre-fork process model and worker processes will be
  34 forked for the KDC when the pre-fork process model is selected for samba.
  35
  36 Prefork 'prefork children'
  37 --------------------------
  38
  39 The default value for this smdb.conf parameter has been increased from 1 to
  40 4.
  41
  42 Netlogon prefork
  43 ----------------
  44
  45 DCERPC now supports pre-forked NETLOGON processes. The netlogon processes are
  46 pre-forked when the prefork process model is selected for samba.
  47
  48 Offline domain backups
  49 ----------------------
  50
  51 The 'samba-tool domain backup' command has been extended with a new 'offline'
  52 option. This safely creates a backup of the local DC's database directly from
  53 disk. The main benefits of an offline backup are it's quicker, it stores more
  54 database details (for forensic purposes), and the samba process does not have
  55 to be running when the backup is made. Refer to the samba-tool help for more
  56 details on using this command.
  57
  58 Group membership statistics
  59 ---------------------------
  60
  61 A new 'samba-tool group stats' command has been added. This provides summary
  62 information about how the users are spread across groups in your domain.
  63 The 'samba-tool group list --verbose' command has also been updated to include
  64 the number of users in each group.
  65
  66 Prefork process restart
  67 -----------------------
  68
  69 The pre-fork process model now restarts failed processes. The delay between
  70 restart attempts is controlled by the "prefork backoff increment" (default = 10)
  71 and "prefork maximum backoff" (default = 120) smbd.conf parameters.  A linear
  72 back off strategy is used with "prefork backoff increment" added to the
  73 delay between restart attempts up until it reaches "prefork maximum backoff".
  74
  75 Using the default sequence the restart delays (in seconds) are:
  76   0, 10, 20, ..., 120, 120, ...
  77
  78 Standard process model
  79 ----------------------
  80
  81 When using the standard process model samba forks a new process to handle ldap
  82 and netlogon connections.  Samba now honours the 'max smbd processes' smb.conf
  83 parameter.  The default value of 0, indicates there is no limit.  The limit
  84 is applied individually to netlogon and ldap.  When the process limit is
  85 exceeded Samba drops new connections immediately.
  86
  87 python3 support
  88 ---------------
  89
  90 This is the first release of Samba which has full support for Python 3.
  91 Samba 4.10 still has support for Python 2, however, Python 3 will be used by
  92 default, i.e. 'configure' & 'make' will execute using python3.
  93
  94 To build Samba with python2 you *must* set the 'PYTHON' environment variable
  95 for both the 'configure' and 'make' steps, i.e.
  96    'PYTHON=python2 ./configure'
  97    'PYTHON=python2 make'
  98 This will override the python3 default.
  99
 100 Alternatively, it is possible to produce Samba Python bindings for both
 101 Python 2 and Python 3. To do so, specify '--extra-python=/usr/bin/python2'
 102 as part of the 'configure' command. Note that python3 will still be used as
 103 the default in this case.
 104
 105 Note that Samba 4.10 supports Python 3.4 onwards.
 106
 107 Future Python support
 108 ---------------------
 109
 110 Samba 4.10 will be the last release that comes with full support for
 111 Python 2. Unfortunately, the Samba Team doesn't have the resources to support
 112 both Python 2 and Python 3 long-term.
 113
 114 Samba 4.11 will not have any runtime support for Python 2. This means if
 115 you use Python 2 bindings it is time to migrate to Python 3 now.
 116
 117 If you are building Samba using the '--disable-python' option (i.e. you're
 118 excluding all the run-time Python support), then this will continue to work
 119 on a system that supports either python2 or python3.
 120
 121 Also note that Samba 4.11 will most likely only support Python 3.6 onwards.
 122
 123 JSON logging
 124 ------------
 125
 126 Authentication messages now contain the Windows Event Id "eventId" and logon
 127 type "logonType". The supported event codes and logon types are:
 128   Event codes:
 129     4624  Successful logon
 130     4625  Unsuccessful logon
 131
 132   Logon Types:
 133     2  Interactive
 134     3  Network
 135     8  NetworkCleartext
 136
 137 The version number for Authentication messages is now 1.1, changed from 1.0
 138
 139 Password change messages now contain the Windows Event Id "eventId", the
 140 supported event Id's are:
 141   4723 Password changed
 142   4724 Password reset
 143
 144 The version number for PasswordChange messages is now 1.1, changed from 1.0
 145
 146 Group membership change messages now contain the Windows Event Id "eventId",
 147 the supported event Id's are:
 148   4728 A member was added to a security enabled global group
 149   4729 A member was removed from a security enabled global group
 150   4732 A member was added to a security enabled local group
 151   4733 A member was removed from a security enabled local group
 152   4746 A member was added to a security disabled local group
 153   4747 A member was removed from a security disabled local group
 154   4751 A member was added to a security disabled global group
 155   4752 A member was removed from a security disabled global group
 156   4756 A member was added to a security enabled universal group
 157   4757 A member was removed from a security enabled universal group
 158   4761 A member was added to a security disabled universal group
 159   4762 A member was removed from a security disabled universal group
 160
 161
 162 The version number for GroupChange messages is now 1.1, changed from 1.0. Also
 163 A GroupChange message is generated when a new user is created to log that the
 164 user has been added to their primary group.
 165
 166 The leading "JSON <message type>:" and source file  prefix of the JSON formatted
 167 log entries has been removed to make the parsing of the JSON log messages
 168 easier. JSON log entries now start with 2 spaces followed by an opening brace
 169 i.e. "  {"
 170
 171 SMBv2 samba-tool support
 172 ------------------------
 173
 174 On previous releases, some samba-tool commands would not work against a remote
 175 DC that had SMBv1 disabled. SMBv2 support has now been added for samba-tool.
 176 The affected commands are 'samba-tool domain backup|rename' and the
 177 'samba-tool gpo' set of commands. Refer also bug #13676.
 178
 179
 180 REMOVED FEATURES
 181 ================
 182
 183 MIT Kerberos build of the AD DC
 184 -------------------------------
 185
 186 While not removed, the MIT Kerberos build of the Samba AD DC is still
 187 considered experimental.  Because Samba will not issue security
 188 patches for this configuration, such builds now require the explicit
 189 configure option: --with-experimental-mit-ad-dc
 190
 191 For further details see
 192 https://wiki.samba.org/index.php/Running_a_Samba_AD_DC_with_MIT_Kerberos_KDC
 193
 194 samba_backup
 195 ------------
 196
 197 The samba_backup script has been removed. This has now been replaced by the
 198 'samba-tool domain backup offline' command.
 199
 200 SMB client Python bindings
 201 --------------------------
 202
 203 The SMB client python bindings are now deprecated and will be removed in future
 204 Samba releases. This will only affects users that may have used the Samba
 205 Python bindings to write their own utilities, i.e. users with a custom Python
 206 script that includes the line 'from samba import smb'.
 207
 208 smb.conf changes
 209 ================
 210
 211   Parameter Name                     Description                Default
 212   --------------                     -----------                -------
 213   prefork backoff increment   Delay added to process restart    10 (seconds)
 214                               between attempts.
 215   prefork maximum backoff     Maximum delay for process between 120 (seconds)
 216                               process restart attempts
 217   smbd search ask sharemode   Name changed, old name was
 218                               "smbd:search ask sharemode"
 219   smbd async dosmode          Name changed, old name was
 220                               "smbd:async dosmode"
 221   smbd max async dosmode      Name changed, old name was
 222                               "smbd:max async dosmode"
 223   smbd getinfo ask sharemode  New: similar to "smbd search ask  yes
 224                               sharemode" but for SMB getinfo
 225
 226
 227 CHANGES SINCE 4.10.0rc2
 228 =======================
 229
 230 o  Jeremy Allison <jra@samba.org>
 231    * BUG 13690: smbd: uid: Don't crash if 'force group' is added to an existing
 232      share connection.
 233    * BUG 13770: s3: VFS: vfs_fruit. Fix the NetAtalk deny mode compatibility
 234      code.
 235
 236 o  Andrew Bartlett <abartlet@samba.org>
 237    * ldb: Release ldb 1.5.3
 238    * BUG 13762: Avoid inefficient one-level searches.
 239    * BUG 13772: The test api.py should not rely on order of entries in dict.
 240
 241 o  Tim Beale <timbeale@catalyst.net.nz>
 242    * BUG 13762: ldb: Avoid inefficient one-level searches.
 243
 244 o  Ralph Boehme <slow@samba.org>
 245    * BUG 13776: tldap: Avoid use after free errors.
 246
 247 o  Günther Deschner <gd@samba.org>
 248    * BUG 13746: s3-smbd: Use fruit:model string for mDNS registration.
 249
 250 o  David Disseldorp <ddiss@samba.org>
 251    * BUG 13766: printing: Check lp_load_printers() prior to pcap cache update.
 252
 253 o  Christof Schmitt <cs@samba.org>
 254    * BUG 13787: waf: Check for libnscd.
 255
 256 o  Andreas Schneider <asn@samba.org>
 257    * BUG 13770: s3:vfs: Correctly check if OFD locks should be enabled or not.
 258    * BUG 13778: Public ZERO_STRUCT() uses undefined C11 function memset_s().
 259
 260
 261 CHANGES SINCE 4.10.0rc1
 262 =======================
 263
 264 o  Jeremy Allison <jra@samba.org>
 265    * BUG 13750: libcli: dns: Change internal DNS_REQUEST_TIMEOUT from 2 to 10
 266      seconds.
 267
 268 o  Tim Beale <timbeale@catalyst.net.nz>
 269    * BUG 13676: samba-tool SMB/sysvol connections do not work if SMBv1 is
 270      disabled.
 271    * BUG 13747: join: Throw CommandError instead of Exception for simple errors.
 272
 273 o  Günther Deschner <gd@samba.org>
 274    * BUG 13774: s3-vfs: Add glusterfs_fuse vfs module.
 275
 276 o  Volker Lendecke <vl@samba.org>
 277    * BUG 13742: ctdb: Print locks latency in machinereadable stats.
 278
 279 o  Stefan Metzmacher <metze@samba.org>
 280    * BUG 13752: s4:server: Add support for 'smbcontrol samba shutdown'.
 281
 282 o  Anoop C S <anoopcs@redhat.com>
 283    * BUG 13330: vfs_glusterfs: Adapt to changes in libgfapi signatures.
 284    * BUG 13774: s3-vfs: Use ENOATTR in errno comparison for getxattr.
 285
 286 o  Justin Stephenson <jstephen@redhat.com>
 287    * BUG 13727: s3:libsmb: Honor disable_netbios option in smbsock_connect_send.
 288
 289
 290 KNOWN ISSUES
 291 ============
 292
 293 https://wiki.samba.org/index.php/Release_Planning_for_Samba_4.10#Release_blocking_bugs
 294
 295
 296 #######################################
 297 Reporting bugs & Development Discussion
 298 #######################################
 299
 300 Please discuss this release on the samba-technical mailing list or by
 301 joining the #samba-technical IRC channel on irc.freenode.net.
 302
 303 If you do report problems then please try to send high quality
 304 feedback. If you don't provide vital information to help us track down
 305 the problem then you will probably be ignored.  All bug reports should
 306 be filed under the Samba 4.1 and newer product in the project's Bugzilla
 307 database (https://bugzilla.samba.org/).
 308
 309
 310 ======================================================================
 311 == Our Code, Our Bugs, Our Responsibility.
 312 == The Samba Team
 313 ======================================================================
 314