prepare WHATSNEW for Samba 4.0alpha19 release and mark as release.
[samba.git] / WHATSNEW.txt
1 What's new in Samba 4 alpha19
2 =============================
3
4 Samba 4.0 will be the next version of the Samba suite and incorporates
5 all the technology found in both the Samba4 alpha series and the
6 stable 3.x series. The primary additional features over Samba 3.6 are
7 support for the Active Directory logon protocols used by Windows 2000
8 and above.
9
10 WARNINGS
11 ========
12
13 Samba4 alpha19 is not a final Samba release, however we are now making
14 good progress towards a Samba 4.0 release, of which this is a preview.
15 Be aware the this release contains both the technology of Samba 3.6
16 (that you can reasonably expect to upgrade existing Samba 3.x releases
17 to) and the AD domain controller work previously known as 'samba4'.
18
19 While binaries for the stable file server are provided in this
20 release, for a stable, supported file server, Samba3 domain or AD
21 domain member installation, please run a Samba 3.x release, as we are
22 still bedding down the new single build system.
23
24 Samba4 is subjected to an awesome battery of tests on an automated
25 basis, we have found Samba 4.0 to be very stable in it's behavior.
26 However, we still recommend against upgrading production servers from
27 Samba 3.x release to Samba 4.0 alpha at this stage.
28
29 If you are upgrading, or looking to develop, test or deploy Samba 4.0
30 alpha releases, you should backup all configuration and data.
31
32 NEW FEATURES
33 ============
34
35 Samba 4.0 alpha supports the server-side of the Active Directory logon
36 environment used by Windows 2000 and later, so we can do full domain
37 join and domain logon operations with these clients.
38
39 Our Domain Controller (DC) implementation includes our own built-in
40 LDAP server and Kerberos Key Distribution Center (KDC) as well as the
41 Samba3-like logon services provided over CIFS.  We correctly generate
42 the infamous Kerberos PAC, and include it with the Kerberos tickets we
43 issue.
44
45 Samba 4.0 alpha ships with two distinct file servers.  The file server
46 from the Samba 3.x series is 'smbd', and works with the binaries users
47 would expect from that series (nmbd, winbindd, smbpasswd).
48
49 Samba 4.0 also ships with a new file server, which is tuned to match
50 the requirements of an AD domain controller.  Users should not use the
51 file server in the 'samba' binary for non-DC related tasks.
52
53 A new scripting interface has been added to Samba 4, allowing Python
54 programs to interface to Samba's internals, and many tools and
55 internal workings of the DC code is now implemented in python.
56
57
58 CHANGES SINCE alpha18
59 =====================
60
61 For a list of changes since alpha 18, please see the git log.
62
63 $ git clone git://git.samba.org/samba.git
64 $ cd samba.git
65 $ git log samba-4.0.0alpha18..samba-4.0.0alpha19
66
67 Some major user-visible changes include:
68
69 CVE-2012-1182:
70    Samba 3.0.x to 3.6.3 are affected by a
71    vulnerability that allows remote code
72    execution as the "root" user.
73
74 Portability to MacOS X.  By using the CC_MD5*() routines we no longer
75 segfault on MacOS X.
76
77 The source4/librpc layer has been reworked to be much more robust to
78 connection failures.
79
80 security=share in smbd has now been removed.
81
82 A segfault in vfs_aio_fork for the smbd file server has been fixed
83
84 ldbadd and ldbmodify now handle each ldif file in a single
85 transaction, when modifying a local ldb.
86
87 Further improvements to the dlz_bind9 and internal DNS servers.
88
89
90 Some major but less visible changes include:
91
92 Initial support for s3fs, using the smbd file server in the AD Domain
93 controller has been added (but not yet finished, so not exposed)
94
95 Samba now only uses the _FILE_OFFSET_BITS=64 API for accessing large
96 files, not the _LARGEFILE64_SOURCE API.
97
98 All Samba daemons now monitor stdin when launched in the foreground,
99 and shutdown when stdin is closed.  We also ensure that all child
100 processes are clened up by a similar mechanism.  This ensures that
101 stray processes do not hang around, particularly in make test.
102
103 Further preparation work for moving to TDB2, a new version of Samba's core TDB
104 database.
105
106 Early implementation work on the SMB 2.2 protocol client and server as
107 the team improves and develops support these new protocols.
108
109 The last of the old-style krb5 ticket handling has been removed.
110
111
112 KNOWN ISSUES
113 ============
114
115 - upgradeprovision should not be run when upgrading to this release
116   from a recent release.  No important database format changes have
117   been made since alpha16.  
118
119 - The BIND 9 DLZ plugin is compatible only with BIND 9.8, not BIND 9.9. 
120
121 - Systems with tdb or ldb installed as a system library may have
122   difficulty building this release of Samba4.  The --disable-tdb2
123   configure switch may be of assistance.
124
125 - Installation on systems without a system iconv (and developer
126   headers at compile time) is known to cause errors when dealing with
127   non-ASCII characters.
128
129 - In some situations, group members may not be upgraded by the
130   samba-tool domain samba3upgrade tool
131
132 - Domain member support in the 'samba' binary is in it's infancy, and
133   is not comparable to the support found in winbindd.  As such, do not
134   use the 'samba' binary (provided for the AD server) on a member
135   server.
136
137 - There is no printing support in the 'samba' binary (use smbd instead)
138
139 - There is no NetBIOS browsing support (network neighbourhood) in the
140   'samba' binary (use nmbd and smbd instead)
141
142 - Clock Synchronisation is critical.  Many 'wrong password' errors are
143   actually due to Kerberos objecting to a clock skew between client
144   and server.  (The NTP work in the previous alphas are partly to assist
145   with this problem).
146
147 - The DRS replication code may fail.  Please contact the team if you
148   experience issues with DRS replication, as we have fixed many issues
149   here in response to feedback from our production users. 
150
151 RUNNING Samba 4.0 as an AD DC
152 =============================
153
154 A short guide to setting up Samba 4 as an AD DC can be found on the wiki:
155
156   http://wiki.samba.org/index.php/Samba4/HOWTO
157
158 #######################################
159 Reporting bugs & Development Discussion
160 #######################################
161
162 Please discuss this release on the samba-technical mailing list or by
163 joining the #samba-technical IRC channel on irc.freenode.net.
164
165 If you do report problems then please try to send high quality
166 feedback. If you don't provide vital information to help us track down
167 the problem then you will probably be ignored.  All bug reports should
168 be filed under the Samba 4.0 product in the project's Bugzilla
169 database (https://bugzilla.samba.org/).
170
171
172 ======================================================================
173 == Our Code, Our Bugs, Our Responsibility.
174 == The Samba Team
175 ======================================================================
176