0251ffdd72fdd6344f110ae09fd40df7753f43d1
[kai/samba.git] / WHATSNEW.txt
1 What's new in Samba 4 alpha16
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 alpha16 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 No migration path is currently provided between these two sets of
19 technology.  These missing migration paths will be the focus of
20 development between now and a Samba 4.0 release.
21
22 While binaries for the stable file server are provided in this
23 release, for a stable, supported file server, Samba3 domain or AD
24 domain member installation, please run a Samba 3.x release, as we are
25 still bedding down the new single build system.
26
27 Samba4 is subjected to an awesome battery of tests on an automated
28 basis, we have found Samba 4.0 to be very stable in it's behavior.
29 However, we still recommend against upgrading production servers from
30 Samba 3.x release to Samba 4.0 alpha at this stage.
31
32 If you are upgrading, or looking to develop, test or deploy Samba 4.0
33 alpha releases, you should backup all configuration and data.
34
35 NEW FEATURES
36 ============
37
38 Samba 4.0 alpha supports the server-side of the Active Directory logon
39 environment used by Windows 2000 and later, so we can do full domain
40 join and domain logon operations with these clients.
41
42 Our Domain Controller (DC) implementation includes our own built-in
43 LDAP server and Kerberos Key Distribution Center (KDC) as well as the
44 Samba3-like logon services provided over CIFS.  We correctly generate
45 the infamous Kerberos PAC, and include it with the Kerberos tickets we
46 issue.
47
48 Samba 4.0 alpha ships with two distinct file servers.  The file server
49 from the Samba 3.x series is 'smbd', and works with the binaries users
50 would expect from that series (nmbd, winbindd, smbpasswd).
51
52 Samba 4.0 also ships with a new file server, which is tuned to match
53 the requirements of an AD domain controller.  Users should not use the
54 file server in the 'samba' binary for non-DC related tasks.
55
56 A new scripting interface has been added to Samba 4, allowing Python
57 programs to interface to Samba's internals, and many tools and
58 internal workings of the DC code is now implemented in python.
59
60
61 CHANGES SINCE alpha15
62 =====================
63
64 For a list of changes since alpha 15, please see the git log.
65
66 $ git clone git://git.samba.org/samba.git
67 $ cd samba.git
68 $ git log release-4-0-0alpha15..release-4-0-0alpha16
69
70 The biggest user-visible change is that binaries from the Samba 3.x
71 series of development are now built and installed.  These binaries
72 (smbd, nmbd, winbindd, net, testparm, etc) operate much as they do in
73 the Samba 3.6 release candidates. 
74
75 CHANGES
76 =======
77
78 smb.conf changes
79 ----------------
80
81    Parameter Name                      Description     Default
82    --------------                      -----------     -------
83    announce version                    Removed
84    announce as                         Removed
85
86 Those familiar with Samba 3 can find a list of user-visible changes
87 between the two technology sets provided in the NEWS file.
88
89 KNOWN ISSUES
90 ============
91
92 - Domain member support in the 'samba' binary is in it's infancy, and
93   is not comparable to the support found in winbindd.  As such, do not
94   use the 'samba' binary (provided for the AD server) on a member
95   server.
96
97 - There is no printing support in the 'samba' binary (use smbd instead)
98
99 - There is no NetBIOS browsing support in the 'samba' binary (use nmbd
100   and smbd instead)
101
102 - Clock Synchronisation is critical.  Many 'wrong password' errors are
103   actually due to Kerberos objecting to a clock skew between client
104   and server.  (The NTP work in the previous alphas are partly to assist
105   with this problem).
106
107 - The DRS replication code may fail.  Please contact the team if you
108   experience issues with DRS replication, as we have fixed many issues
109   here in response to feedback from our production users. 
110
111 - Users upgrading existing databases to Samba4 should carefully
112   consult upgrading-samba4.txt.  We have made a number of changes in
113   this release that should make it easier to upgrade in future.
114   Btw: there exists also a script under the "setup" directory of the
115   source distribution called "upgrade_from_s3" which should allow a step-up
116   from Samba3 to Samba4. It's not included yet in the binary distributions
117   since it's completely experimental!
118
119 RUNNING Samba 4.0 as an AD DC
120 =============================
121
122 A short guide to setting up Samba 4 as an AD DC can be found on the wiki:
123
124   http://wiki.samba.org/index.php/Samba4/HOWTO
125
126 #######################################
127 Reporting bugs & Development Discussion
128 #######################################
129
130 Please discuss this release on the samba-technical mailing list or by
131 joining the #samba-technical IRC channel on irc.freenode.net.
132
133 If you do report problems then please try to send high quality
134 feedback. If you don't provide vital information to help us track down
135 the problem then you will probably be ignored.  All bug reports should
136 be filed under the Samba 4.0 product in the project's Bugzilla
137 database (https://bugzilla.samba.org/).
138
139
140 ======================================================================
141 == Our Code, Our Bugs, Our Responsibility.
142 == The Samba Team
143 ======================================================================
144