WHATSNEW.txt

   1 Release Announcements
   2 =====================
   3
   4 This is the first preview release of Samba 4.6.  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.6 will be the next version of the Samba suite.
  10
  11
  12 UPGRADING
  13 =========
  14
  15 vfs_fruit option "fruit:resource" spelling correction
  16 -----------------------------------------------------
  17
  18 Due to a spelling error in the vfs_fruit option parsing for the "fruit:resource"
  19 option, users who have set this option in their smb.conf were still using the
  20 default setting "fruit:resource = file" as the parser was looking for the string
  21 "fruit:ressource" (two "s").
  22
  23 After upgrading to this Samba version 4.6, you MUST either remove the option
  24 from your smb.conf or set it to the default "fruit:resource = file", otherwise
  25 your macOS clients will not be able to access the resource fork data.
  26
  27 This version Samba 4.6 accepts both the correct and incorrect spelling, but the
  28 next Samba version 4.7 will not accept the wrong spelling.
  29
  30 Users who were using the wrong spelling "ressource" with two "s" can keep the
  31 setting, but are advised to switch to the correct spelling.
  32
  33 ID Mapping
  34 ----------
  35 We discovered that the majority of users have an invalid or incorrect
  36 ID mapping configuration. We implemented checks in the 'testparm' tool to
  37 validate the ID mapping configuration. You should run it and check if it prints
  38 any warnings or errors after upgrading! If it does you should fix them. See the
  39 'IDENTITY MAPPING CONSIDERATIONS' section in the smb.conf manpage.
  40 There are some ID mapping backends which are not allowed to be used for the
  41 default backend. Winbind will no longer start if an invalid backend is
  42 configured as the default backend.
  43
  44 To avoid problems in future we advise all users to run 'testparm' after
  45 changing the smb.conf file!
  46
  47
  48 NEW FEATURES/CHANGES
  49 ====================
  50
  51 Kerberos client encryption types
  52 --------------------------------
  53 Some parts of Samba (most notably winbindd) perform Kerberos client
  54 operations based on a Samba-generated krb5.conf file. A new
  55 parameter, "kerberos encryption types" allows configuring the
  56 encryption types set in this file, thereby allowing the user to
  57 enforce strong or legacy encryption in Kerberos exchanges.
  58
  59 The default value of "all" is compatible with previous behavior, allowing
  60 all encryption algorithms to be negotiated. Setting the parameter to "strong"
  61 only allows AES-based algorithms to be negotiated. Setting the parameter to
  62 "legacy" allows only RC4-HMAC-MD5 - the legacy algorithm for Active Directory.
  63 This can solves some corner cases of mixed environments with Server 2003R2 and
  64 newer DCs.
  65
  66 Printing
  67 --------
  68 Support for uploading printer drivers from newer Windows clients (Windows 10)
  69 has been added until our implementation of [MS-PAR] protocol is ready.
  70 Several issues with uploading different printing drivers have been addressed.
  71
  72 The OS Version for the printing server has been increased to announce
  73 Windows Server 2003 R2 SP2. If a driver needs a newer version then you should
  74 check the smb.conf manpage for details.
  75
  76 new option for owner inheritance
  77 --------------------------------
  78 The "inherit owner" smb.conf parameter instructs smbd to set the
  79 owner of files to be the same as the parent directory's owner.
  80 Up until now, this parameter could be set to "yes" or "no".
  81 A new option, "unix only", enables this feature only for the UNIX owner
  82 of the file, not affecting the SID owner in the Windows NT ACL of the
  83 file. This can be used to emulate something very similar to folder quotas.
  84
  85 Multi-process Netlogon support
  86 ------------------------------
  87
  88 The Netlogon server in the Samba AD DC can now run as multiple
  89 processes.  The Netlogon server is a part of the AD DC that handles
  90 NTLM authentication on behalf of domain members, including file
  91 servers, NTLM-authenticated web servers and 802.1x gateways.  The
  92 previous restriction to running as a single process has been removed,
  93 and it will now run in the same process model as the rest of the
  94 'samba' binary.
  95
  96 As part of this change, the NETLOGON service will now run on a distinct
  97 TCP port, rather than being shared with all other RPC services (LSA,
  98 SAMR, DRSUAPI etc).
  99
 100 new options for controlling TCP ports used for RPC services
 101 -----------------------------------------------------------
 102
 103 The new 'rpc server port' option controls the default port used for
 104 RPC services other than Netlogon.  The Netlogon server honours instead
 105 the 'rpc server port:netlogon' option.  The default value for both
 106 these options is the first available port including or after 1024.
 107
 108 Improve AD performance and replication improvements
 109 ---------------------------------------------------
 110
 111 Samba's LDB and replication code continues to improve, particularly in
 112 respect to the handling of large numbers of linked attributes.  We now
 113 respect an 'uptodateness vector' which will dramatically reduce the
 114 over-replication of links from new DCs.  We have also made the parsing
 115 of on-disk linked attributes much more efficient.
 116
 117 DNS improvements
 118 ----------------
 119
 120 The samba-tool dns subcommand is now much more robust and can delete
 121 records in a number of situations where it was not possible to do so
 122 in the past.
 123
 124 On the server side, DNS names are now more strictly validated.
 125
 126 CTDB changes
 127 ------------
 128
 129 * "ctdb event" is a new top-level command for interacting with event scripts
 130
 131   "ctdb event status" replaces "ctdb scriptstatus" - the latter is
 132   maintained for backward compatibility but the output format has been
 133   cleaned up
 134
 135   "ctdb event run" replaces "ctdb eventscript"
 136
 137   "ctdb event script enable" replaces "ctdb enablescript"
 138
 139   "ctdb event script disable" replaces "ctdb disablescript"
 140
 141   The new command "ctdb event script list" lists event scripts.
 142
 143 * CTDB's back-end for running event scripts has been replaced by a
 144   separate, long-running daemon ctdbd_eventd.
 145
 146 * Running ctdb interactively will log to stderr
 147
 148 * CTDB logs now include process id for each process
 149
 150 * CTDB tags log messages differently.  Changes include:
 151
 152   ctdb-recoverd: Messages from CTDB's recovery daemon
 153   ctdb-recovery: Messages from CTDB database recovery
 154   ctdb-eventd: Messages from CTDB's event daemon
 155   ctdb-takeover: Messgaes from CTDB's public IP takeover subsystem
 156
 157 * The mapping between symbolic and numeric debug levels has changed
 158
 159   Configurations containing numeric debug levels should be updated.
 160   Symbolic debug levels are recommended.  See the DEBUG LEVEL section
 161   of ctdb(7) for details.
 162
 163 *  Tunable IPAllocAlgorithm replaces LCP2PublicIPs, DeterministicIPs
 164
 165    See ctdb-tunables(7) for details
 166
 167 * CTDB's configuration tunables should be consistently set across a cluster
 168
 169   This has always been the cases for most tunables but this fact is
 170   now documented.
 171
 172 * CTDB ships with recovery lock helper call-outs for etcd and Ceph RADOS
 173
 174   To build/install these, use the --enable-etcd-reclock and
 175   --enable-ceph-reclock configure options.
 176
 177
 178 smb.conf changes
 179 ================
 180
 181   Parameter Name                Description             Default
 182   --------------                -----------             -------
 183   kerberos encryption types     New                     all
 184   inherit owner                 New option
 185   fruit:resource                Spelling correction
 186   lsa over netlogon             New (deprecated)        no
 187   rpc server port               New                     0
 188
 189
 190 KNOWN ISSUES
 191 ============
 192
 193 Currently none.
 194
 195 #######################################
 196 Reporting bugs & Development Discussion
 197 #######################################
 198
 199 Please discuss this release on the samba-technical mailing list or by
 200 joining the #samba-technical IRC channel on irc.freenode.net.
 201
 202 If you do report problems then please try to send high quality
 203 feedback. If you don't provide vital information to help us track down
 204 the problem then you will probably be ignored.  All bug reports should
 205 be filed under the Samba 4.1 and newer product in the project's Bugzilla
 206 database (https://bugzilla.samba.org/).
 207
 208
 209 ======================================================================
 210 == Our Code, Our Bugs, Our Responsibility.
 211 == The Samba Team
 212 ======================================================================
 213