WHATSNEW.txt

   1 Release Announcements
   2 =====================
   3
   4 This is the first preview release of Samba 4.11.  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.11 will be the next version of the Samba suite.
  10
  11
  12 UPGRADING
  13 =========
  14
  15
  16 NEW FEATURES/CHANGES
  17 ====================
  18
  19 Default samba process model
  20 ---------------------------
  21
  22 The default for the --model argument passed to the samba executable has changed
  23 from 'standard' to 'prefork'. This means a difference in the number of samba
  24 child processes that are created to handle client connections. The previous
  25 default would create a separate process for every LDAP or NETLOGON client
  26 connection. For a network with a lot of persistent client connections, this
  27 could result in significant memory overhead.  Now, with the new default of
  28 'prefork', the LDAP, NETLOGON, and KDC services will create a fixed number of
  29 worker processes at startup and share the client connections amongst these
  30 workers. The number of worker processes can be configured by the 'prefork
  31 children' setting in the smb.conf (the default is 4).
  32
  33 Authentication Logging.
  34 -----------------------
  35
  36 Winbind now logs PAM_AUTH and NTLM_AUTH events, a new attribute "logonId" has
  37 been added to the Authentication JSON log messages.  This contains a random
  38 logon id that is generated for each PAM_AUTH and NTLM_AUTH request and is passed
  39 to SamLogon, linking the windbind and SamLogon requests.
  40
  41 The serviceDescription of the messages is set to "winbind", the authDescription
  42 is set to one of:
  43    "PASSDB, <command>, <pid>"
  44    "PAM_AUTH, <command>, <pid>"
  45    "NTLM_AUTH, <command>, <pid>"
  46 where:
  47    <command> is the name of the command makinmg the winbind request i.e. wbinfo
  48    <pid>     is the process id of the requesting process.
  49
  50 The version of the JSON Authentication messages has been changed to 1.2 from 1.1
  51
  52 Reindex performance improvements
  53 --------------------------------
  54
  55 The performance of samba-tool dbcheck --reindex has been improved, especially
  56 for large domains.
  57
  58 join performance improvements
  59 -----------------------------
  60
  61 The performance of samba-tool domain join has been improved, especially
  62 for large domains.
  63
  64 LDAP referrals
  65 --------------
  66
  67 The scheme of returned LDAP referrals now reflects the scheme of the original
  68 request, i.e. referrals received via ldap are prefixed with "ldap://"
  69 and those over ldaps are prefixed with "ldaps://"
  70
  71 Previously all referrals were prefixed with "ldap://"
  72
  73 Bind9 logging
  74 -------------
  75
  76 It is now possible to log the duration of DNS operations performed by Bind9
  77 This should aid future diagnosis of performance issues, and could be used to
  78 monitor DNS performance. The logging is enabled by setting log level to
  79 "dns:10" in smb.conf
  80
  81 The logs are currently Human readable text only, i.e. no JSON formatted output.
  82
  83 Log lines are of the form:
  84
  85     <function>: DNS timing: result: [<result>] duration: (<duration>)
  86     zone: [<zone>] name: [<name>] data: [<data>]
  87
  88     durations are in microseconds.
  89
  90 Default schema updated to 2012_R2
  91 -------------------------
  92
  93 Default AD schema changed from 2008_R2 to 2012_R2.  2012_R2 functional level
  94 is not yet available.  Older schemas can be used by provisioning with the
  95 '--base-schema' argument.  Existing installations can be updated with the
  96 samba-tool command "domain schemaupgrade".
  97
  98 Setting lmdb map size
  99 ---------------------
 100
 101 It is now possible to set the lmdb map size (The maximum permitted size for
 102 the database).  "samba-tool" now accepts the "--backend-store-size"
 103 i.e. --backend-store-size=4Gb.  If not specified it defaults to 8Gb.
 104 This option is avaiable for the following sub commands:
 105  * domain provision
 106  * domain join
 107  * domain dcpromo
 108  * drs clone-dc-database
 109
 110 LDB "batch_mode"
 111 ----------------
 112
 113 To improve performance during batch operations i.e. joins, ldb now accepts a
 114 "batch_mode" option.  However to prevent any index or database inconsistencies
 115 if an operation fails, the entire transaction will be aborted at commit.
 116
 117 REMOVED FEATURES
 118 ================
 119
 120 Web server
 121 ----------
 122
 123 As a leftover from work related to the Samba Web Administration Tool (SWAT),
 124 Samba still supported a Python WSGI web server (which could still be turned on
 125 from the 'server services' smb.conf parameter). This service was unused and has
 126 now been removed from Samba.
 127
 128
 129 samba-tool join subdommain
 130 --------------------------
 131
 132 The subdommain role has been removed from the join command.  This option did
 133 not work and has no tests.
 134
 135
 136 smb.conf changes
 137 ================
 138
 139   Parameter Name                     Description                Default
 140   --------------                     -----------                -------
 141
 142   web port                           Removed
 143   fruit:zero_file_id                 Changed default            False
 144
 145
 146 KNOWN ISSUES
 147 ============
 148
 149 https://wiki.samba.org/index.php/Release_Planning_for_Samba_4.11#Release_blocking_bugs
 150
 151
 152 #######################################
 153 Reporting bugs & Development Discussion
 154 #######################################
 155
 156 Please discuss this release on the samba-technical mailing list or by
 157 joining the #samba-technical IRC channel on irc.freenode.net.
 158
 159 If you do report problems then please try to send high quality
 160 feedback. If you don't provide vital information to help us track down
 161 the problem then you will probably be ignored.  All bug reports should
 162 be filed under the Samba 4.1 and newer product in the project's Bugzilla
 163 database (https://bugzilla.samba.org/).
 164
 165
 166 ======================================================================
 167 == Our Code, Our Bugs, Our Responsibility.
 168 == The Samba Team
 169 ======================================================================
 170