83f641b2f45bf055581757f167589390f2bfdfa3
[samba.git] / 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