preparing for release of alpha.0.8
[Samba.git] / WHATSNEW.txt
blobbfe6dfaf0bae0369f16201a9621de4580863a075
1           WHATS NEW IN Samba (The Next Generation) 0.8
2           ============================================
4 This is an ALPHA release of Samba TNG, the UNIX based SMB/CIFS file,
5 print and login server for Windows systems.
7 This release is to enlist the help of people who are unable to use
8 cvs (http://samba.org/cvs.html) in a major development project to
9 integrate Samba into a Windows NT (tm) Domain environment - the
10 NT Domains for Unix project.
12 If you are running Windows 9x and do not forsee the need for or
13 need to use any Windows NT Workstations on your network in the near
14 future, you will not need Samba TNG or any of its functionality,
15 and your assistance is not being solicited in the development of
16 this project.
18 Major changes in Samba TNG
19 --------------------------
21 There are many major changes in Samba TNG.  Here are some of them:
23 =====================================================================
25 1). Windows NT (tm) Primary Domain Controller compatibility
26 -----------------------------------------------------------
28 Samba TNG can act as a Primary Domain Controller to Windows NT 3.5,
29 4.0 and 5.0 (in 4.0 backwards-compatible mode) Workstations.  Backup
30 Domain Controller and Inter-Domain Trust Relationships are at an
31 early, but functional and very hands-on, stage.
33 2). Support for Windows NT (tm) Administrative tools
34 ----------------------------------------------------
36 Significant in-roads have been made into providing support for at least
37 the following Windows NT (tm) tools and services:
39 - User Manager for Domains
40 - Server Manager for Domains
41 - Event Log
42 - Service Control Manager
43 - Registry Editor
45 A command-line tool named rpcclient, with a command-syntax similar to
46 smbclient, has over sixty five commands that provide equivalent
47 functionality for the same Windows NT (tm) Administrative tools,
48 including the ability to remotely shut down a Windows NT (tm) Server.
50 rpcclient has now been joined by net, samedit, regedit, spoolss,
51 eventlog, lsa, cmdat and svccontrol.  If anyone can think of better
52 names for these, suggestions are welcomed.
54 3). Portability
55 ---------------
57 Samba is now self-configuring using GNU autoconf and libtool, removing
58 the need for people installing Samba to have to hand configure
59 Makefiles, as was needed in previous versions.
61 You now configure Samba by running "./configure" then "make".  See
62 docs/textdocs/UNIX_INSTALL.txt for details.
64 The use of libtool dramatically reduces the size of samba binaries.
65 As we are using libtool in a slightly different way from usual,
66 you may encounter run-time or compilation errors, so please repoty
67 them to us.
69 4). New SAM Database Daemons
70 ----------------------------
72 The SAM database daemon, samrd, is being considered "legacy", and
73 the aim is to replace it.  To this end, some new SAM database
74 daemons are being developed - samrtdbd and samrnt5ldapd.
75 They need to be run with their counterparts, netlogontdbd or
76 netlogonnt5ldapd.  None of these are build as part of the standard
77 make, they have to be explicitly built because they are in
78 development.
81 =====================================================================
83 NOTE - Some important information
84 ---------------------------------------
86 Samba TNG up to alpha-0.3 required that the samba server be joined
87 to its own Domain.  This requirement has been removed.
89 It is important that you read the source/README file for
90 instructions, and it is recommended that you join samba-ntdom@samba.org
91 for update information and status reports.  For details, please see:
93 http://samba.org/listproc/samba-ntdom
95 =====================================================================
97 NOTE - Primary Domain Controller Functionality
98 ----------------------------------------------
100 This version of Samba contains code that correctly implements
101 the undocumented Primary Domain Controller authentication
102 protocols.  However, there is much more to being a Primary
103 Domain Controller than serving Windows NT logon requests.
105 A useful version of a Primary Domain Controller contains
106 many remote procedure calls to do things like enumerate users, 
107 groups, and security information, 98% of which Samba TNG currently
108 implements.  
110 This work is being done in the CVS (developer) versions of Samba,
111 development of which continues at a fast pace.  If you are
112 interested in participating in or helping with this development
113 please join the Samba-NTDOM mailing list.  Details on joining
114 are available at :
116 http://samba.org/listproc/
118 Details on obtaining CVS (developer) versions of Samba
119 are available at:
121 http://samba.org/cvs.html
123 For this version, use a tag of SAMBA_TNG
126 =====================================================================
128 NOTE - Known Bugs
129 -----------------
131 It is *not* recommended that this version of Samba be run in a
132 production environment, for at least the following reasons:
134 1) nmbd is known to fork() every 20 minutes, resulting in an extra
135 process that hangs around.  It has also been reported, in a large
136 network neighbourhood environment with "wins support = no"
137 and "wins server = x.x.x.x" to flood the WINS server with about
138 3 requests per second to resolve every single name in the
139 network neighbourhood.  Be Warned!
141 This issue appears to have been resolved, cause unknown, fix unknown.
143 You can avoid this by using a stable, production release of nmbd, such
144 as can be found in 2.0.6a or later.
146 2) The new MSRPC architecture forks() one MSRPC daemon per incoming
147 service request.  The msrpc daemon stays around for as long as
148 the remote server maintains a connection to it.  An investigation
149 is underway to attempt to minimise the number of outstanding
150 connections, because a *single* NT user logon can result in up to
151 5 or 6 msrpc daemons waiting around, doing nothing but take up
152 process table space.
154 Connection reuse has now been added and debugged: the number of
155 incoming connections is reduced but still fairly large.
158 3) The Samba TNG code base was cut from the 2.0 development tree
159 approximately eighteen months ago.  That means that it does not have
160 any of the file and print server improvements or bug-fixes since
161 that time.  The use of Samba TNG as a file and print server is
162 therefore not recommended, and can be avoided by setting user
163 profiles and home directories to be on another Windows NT (tm) or
164 compatible file server.
167 =====================================================================
169 If you have problems, or think you have found a bug please email 
170 a report to :
172         samba-technical@samba.org
174 As always, all bugs are our responsibility.
176 Regards,
178         The Samba Team.