s3:WHATSNEW.txt: remove the "strict allocate" default value
[ira/wip.git] / WHATSNEW.txt
1                    =================================
2                    Release Notes for Samba 3.6.0pre1
3                              July 28, 2010
4                    =================================
5
6
7 This is the first preview release of Samba 3.6.  This is *not*
8 intended for production environments and is designed for testing
9 purposes only.  Please report any defects via the Samba bug reporting
10 system at https://bugzilla.samba.org/.
11
12
13 Major enhancements in Samba 3.6.0 include:
14
15
16 Changed security defaults
17 -------------------------
18
19 Samba 3.6 has adopted a number of improved security defaults that will
20 impact on existing users of Samba.
21
22  client ntlmv2 auth = yes
23  client use spnego principal = no
24  send spnego principal = no
25
26 The impact of 'client ntlmv2 auth = yes' is that by default we will not
27 use NTLM authentication as a client.  This applies to the Samba client
28 tools such as smbclient and winbind, but does not change the separately
29 released in-kernel CIFS client.  To re-enable the poorer NTLM encryption
30 set '--option=clientusentlmv2auth=no' on your smbclient command line, or
31 set 'client ntlmv2 auth = no' in your smb.conf
32
33 The impact of 'client use spnego principal = no' is that we may be able
34 to use Kerberos to communicate with a server less often in smbclient,
35 winbind and other Samba client tools.  We may fall back to NTLMSSP in
36 more situations where we would previously rely on the insecure
37 indication from the 'NegProt' CIFS packet.  This mostly occursed when
38 connecting to a name alias not recorded as a servicePrincipalName for
39 the server.  This indication is not available from Windows 2008 or later
40 in any case, and is not used by modern Windows clients, so this makes
41 Samba's behaviour consistent with other clients and against all servers.
42
43 The impact of 'send spnego principal = no' is to match Windows 2008 and
44 not to send this principal, making existing clients give more consistent
45 behaviour (more likely to fall back to NTLMSSP) between Samba and
46 Windows 2008, and between Windows versions that did and no longer use
47 this insecure hint.
48
49
50 SMB2 support
51 ------------
52
53 SMB2 support in 3.6.0 is fully functional (with one omission),
54 and can be enabled by setting:
55
56 max protocol = SMB2
57
58 in the [global] section of your smb.conf and re-starting
59 Samba. All features should work over SMB2 except the modification
60 of user quotas using the Windows quota management tools.
61
62 As this is the first release containing what we consider
63 to be a fully featured SMB2 protocol, we are not enabling
64 this by default, but encourage users to enable SMB2 and
65 test it. Once we have enough confirmation from Samba
66 users and OEMs that SMB2 support is stable in wide user
67 testing we will enable SMB2 by default in a future Samba
68 release.
69
70
71 Internal Winbind passdb changes
72 -------------------------------
73
74 Winbind has been changed to use the internal samr and lsa rpc pipe to get
75 local user and group information instead of calling passdb functions. The
76 reason is to use more of our infrastructure and test this infrastructure by
77 using it. With this approach more code in Winbind is shared.
78
79
80 New Spoolss code
81 ----------------
82
83 The spoolss and the old RAP printing code have been completely
84 overhauled and refactored.
85
86 All calls from lanman/printing code has been changed to go through the
87 spoolss RPC interfaces, this allows us to keep all checks in one place
88 and avoid special cases in the main printing code.
89 Printing code has been therefore confined within the spoolss code.
90
91 All the printing code, including the spoolss RPC interfaces has been
92 changed to use the winreg RPC interfaces to store all data.
93 All data has been migrated from custom, arbitrary TDB files to the
94 registry interface. This transition allow us to present correct data to
95 windows client accessing the server registry through the winreg RPC
96 interfaces to query for printer data. Data is served out from a real
97 registry implementation and therefore arguably 100% forward compatible.
98
99 Migration code from the previous TDB files formats is provided. This
100 code is automatically invoked the first time the new code is run on the
101 server. Although manual migration is also available using the 'net
102 printer migrate' command.
103
104 These changes not only make all the spoolss code much more closer to
105 "the spec", it also greatly improves our internal testing of both
106 spoolss and winreg interfaces, and reduces overall code duplication.
107
108 As part of this work, new tests have been also added to increase
109 coverage.
110
111 This code will also allow, in future, an easy transition to split out
112 the spooling functions into a separate daemon for those OEMs that do not
113 need printing functionality in their appliances, reducing the code
114 footprint.
115
116
117 ID Mapping Changes
118 ------------------
119
120 The id mapping configuration has been a source of much grief in the past.
121 For this release, id mapping has ben rewritten yet again with the goal
122 of making the configuration more simple and more coherent while keeping
123 the needed flexibility and even adding to the flexibility in some respects.
124
125 The major change that implies the configuration simplifications is at
126 the heart of the id mapping system: The separation of the "idmap alloc
127 system" that is responsible for the unix id counters in the tdb, tdb2
128 and ldap idmap backends from the id mapping code itself has been removed.
129 The sids_to_unixids operation is now atomic and encapsulates (if needed)
130 the action of allocating a unix id for a mapping that is to be created.
131 Consequently all idmap alloc configuration parameters have vanished and
132 it is hence now also not possible any more to specify an idmap alloc
133 backend different from the idmap backend. Each idmap backend uses its
134 own idmap unixid creation mechanism transparently.
135
136 As a consequence of the id mapping changes, the methods that are used
137 for storing and deleting id mappings have been removed from the winbindd
138 API. The "net idmap dump/restore" commands have been rewritten to
139 not speak through winbindd any more but directly act on the databases.
140 This is currently available for the tdb and tdb2 backends, the implementation
141 for ldap still missing.
142
143 The allocate_id functionality is preserved for the unix id creator of the
144 default idmap configuration is also used as the source of unix ids
145 for the group mapping database and for the posix attributes in a
146 ldapsam:editposix setup.
147
148 As part of the changes, the default idmap configuration has been
149 changed to be more coherent with the per-domain configuration.
150 The parameters "idmap uid", "idmap gid" and "idmap range" are now
151 deprecated in favour of the systematic "idmap config * : range"
152 and "idmap config * : backend" parameters. The reason for this change
153 is that the old options only provided an incomplete and hence deceiving
154 backwards compatibility, which was a source of many problems with
155 updgrades. By introducing this change in configuration, it should be
156 brought to the conciousness of the users that even the simple
157 id mapping is not working exactly as in Samba 3.0 versions any more.
158
159
160 SMB Traffic Analyzer
161 --------------------
162
163 Added the new SMB Traffic Analyzer (SMBTA) VFS module protocol 2
164 featuring encryption, multiple arguments, and easier parseability. A new
165 tool 'smbta-util' has been created to control the encryption behaviour
166 of SMBTA. For compatibility, SMBTA by default operates on version 1.
167 There are programs consuming the data that the module sends.
168
169 More information can be found on
170 http://holger123.wordpress.com/smb-traffic-analyzer/
171
172
173 NFS quota backend on Linux
174 --------------------------
175
176 A new nfs quota backend for Linux has been added that is based
177 on the existing Solaris/FreeBSD implementation. This allows samba
178 to communicate correct diskfree information for nfs imports that
179 are re-exported as samba shares.
180
181
182 ######################################################################
183 Changes
184 #######
185
186 smb.conf changes
187 ----------------
188
189    Parameter Name                      Description     Default
190    --------------                      -----------     -------
191
192    async smb echo handler              New             No
193    client ntlmv2 auth                  Changed Default Yes
194    client use spnego principal         New             No
195    ctdb locktime warn threshold        New             0
196    idmap alloc backend                 Removed
197    log writeable files on exit         New             No
198    multicast dns register              New             Yes
199    ncalrpc dir                         New
200    send spnego principal               New             No
201    smb2 max credits                    New             128
202    smb2 max read                       New             1048576
203    smb2 max trans                      New             1048576
204    smb2 max write                      New             1048576
205    username map cache time             New             0
206    winbind max clients                 New             200
207
208
209 ######################################################################
210 Reporting bugs & Development Discussion
211 #######################################
212
213 Please discuss this release on the samba-technical mailing list or by
214 joining the #samba-technical IRC channel on irc.freenode.net.
215
216 If you do report problems then please try to send high quality
217 feedback. If you don't provide vital information to help us track down
218 the problem then you will probably be ignored.  All bug reports should
219 be filed under the Samba 3.6 product in the project's Bugzilla
220 database (https://bugzilla.samba.org/).
221
222
223 ======================================================================
224 == Our Code, Our Bugs, Our Responsibility.
225 == The Samba Team
226 ======================================================================
227