WHATSNEW.txt

   1 Release Announcements
   2 =====================
   3
   4 This is the first preview release 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 Query record for open file or directory
 150 ---------------------------------------
 151
 152 The record attached to an open file or directory in Samba can be
 153 queried through the 'net tdb locking' command. In clustered Samba this
 154 can be useful to determine the file or directory triggering
 155 corresponding "hot" record warnings in ctdb.
 156
 157 Removal of lpcfg_register_defaults_hook()
 158 -----------------------------------------
 159
 160 The undocumented and unsupported function lpcfg_register_defaults_hook()
 161 that was used by external projects to call into Samba and modify
 162 smb.conf default parameter settings has been removed. If your project
 163 was using this call please raise the issue on
 164 samba-technical@lists.samba.org in order to design a supported
 165 way of obtaining the same functionality.
 166
 167 Change of loadable module interface
 168 -----------------------------------
 169
 170 The _init function of all loadable modules in Samba has changed
 171 from:
 172
 173 NTSTATUS _init(void);
 174
 175 to:
 176
 177 NTSTATUS _init(TALLOC_CTX *);
 178
 179 This allows a program loading a module to pass in a long-lived
 180 talloc context (which must be guaranteed to be alive for the
 181 lifetime of the module). This allows modules to avoid use of
 182 the talloc_autofree_context() (which is inherently thread-unsafe)
 183 and still be valgrind-clean on exit. Modules that don't need to
 184 free long-lived data on exist should use the NULL talloc context.
 185
 186 Parameter changes
 187 -----------------
 188
 189 The "strict sync" global parameter has been changed from
 190 a default of "no" to "yes". This means smbd will by default
 191 obey client requests to synchronize unwritten data in operating
 192 system buffers safely onto disk. This is a safer default setting
 193 for modern SMB1/2/3 clients.
 194
 195 smb.conf changes
 196 ================
 197
 198   Parameter Name                Description             Default
 199   --------------                -----------             -------
 200   allow unsafe cluster upgrade  New parameter           no
 201   auth event notification       New parameter           no
 202   auth methods                  Deprecated
 203   client max protocol           Effective               SMB3_11
 204                                 default changed
 205   map untrusted to domain       New value/              auto
 206                                 Default changed/
 207                                 Deprecated
 208   mit kdc command               New parameter
 209   profile acls                  Deprecated
 210   rpc server dynamic port range New parameter           49152-65535
 211   strict sync                   Default changed         yes
 212
 213
 214 KNOWN ISSUES
 215 ============
 216
 217 https://wiki.samba.org/index.php/Release_Planning_for_Samba_4.7#Release_blocking_bugs
 218
 219
 220 #######################################
 221 Reporting bugs & Development Discussion
 222 #######################################
 223
 224 Please discuss this release on the samba-technical mailing list or by
 225 joining the #samba-technical IRC channel on irc.freenode.net.
 226
 227 If you do report problems then please try to send high quality
 228 feedback. If you don't provide vital information to help us track down
 229 the problem then you will probably be ignored.  All bug reports should
 230 be filed under the Samba 4.1 and newer product in the project's Bugzilla
 231 database (https://bugzilla.samba.org/).
 232
 233
 234 ======================================================================
 235 == Our Code, Our Bugs, Our Responsibility.
 236 == The Samba Team
 237 ======================================================================
 238