preparing for release of alpha.0.1
[Samba.git] / WHATSNEW.txt
blobae03dad26dfc27b27ceb3b92fa160641fce5d8ce
1           WHATS NEW IN Samba (The Next Generation) 0.0
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 3). Portability
51 ---------------
53 Samba is now self-configuring using GNU autoconf and libtool, removing
54 the need for people installing Samba to have to hand configure
55 Makefiles, as was needed in previous versions.
57 You now configure Samba by running "./configure" then "make".  See
58 docs/textdocs/UNIX_INSTALL.txt for details.
60 The use of libtool dramatically reduces the size of samba binaries.
61 As we are using libtool in a slightly different way from usual,
62 you may encounter run-time or compilation errors, so please repoty
63 them to us.
65 4). New SAM Database Daemons
66 ----------------------------
68 The SAM database daemon, samrd, is being considered "legacy", and
69 the aim is to replace it.  To this end, some new SAM database
70 daemons are being developed - samrtdbd and samrnt5ldapd.
71 They need to be run with their counterparts, netlogontdbd or
72 netlogonnt5ldapd.  None of these are build as part of the standard
73 make, they have to be explicitly built because they are in
74 development.
76 =====================================================================
78 NOTE - Some important information
79 ---------------------------------------
81 If you wish to use Samba as a PDC, you *must* join Samba to its own
82 Domain.  It is important that you read the source/README file for
83 instructions, and it is recommended that you join samba-ntdom@samba.org
84 for update information and status reports.  For details, please see:
86 http://samba.org/listproc/samba-ntdom
88 =====================================================================
90 NOTE - Primary Domain Controller Functionality
91 ----------------------------------------------
93 This version of Samba contains code that correctly implements
94 the undocumented Primary Domain Controller authentication
95 protocols.  However, there is much more to being a Primary
96 Domain Controller than serving Windows NT logon requests.
98 A useful version of a Primary Domain Controller contains
99 many remote procedure calls to do things like enumerate users, 
100 groups, and security information, 98% of which Samba TNG currently
101 implements.  
103 This work is being done in the CVS (developer) versions of Samba,
104 development of which continues at a fast pace.  If you are
105 interested in participating in or helping with this development
106 please join the Samba-NTDOM mailing list.  Details on joining
107 are available at :
109 http://samba.org/listproc/
111 Details on obtaining CVS (developer) versions of Samba
112 are available at:
114 http://samba.org/cvs.html
116 =====================================================================
118 NOTE - Known Bugs
119 -----------------
121 It is *not* recommended that this version of Samba be run in a
122 production environment, for at least the following reasons:
124 1) nmbd is known to fork() every 20 minutes, resulting in an extra
125 process that hangs around.  It has also been reported, in a large
126 network neighbourhood environment with "wins support = no"
127 and "wins server = x.x.x.x" to flood the WINS server with about
128 3 requests per second to resolve every single name in the
129 network neighbourhood.  Be Warned!
131 You can avoid this by using a stable, production release of nmbd, such
132 as can be found in 2.0.6a or later.
134 2) The new MSRPC architecture forks() one MSRPC daemon per incoming
135 service request.  The msrpc daemon stays around for as long as
136 the remote server maintains a connection to it.  An investigation
137 is underway to attempt to minimise the number of outstanding
138 connections, because a *single* NT user logon can result in up to
139 5 or 6 msrpc daemons waiting around, doing nothing but take up
140 process table space.
142 3) The Samba TNG code base was cut from the 2.0 development tree
143 approximately eighteen months ago.  That means that it does not have
144 any of the file and print server improvements or bug-fixes since
145 that time.  The use of Samba TNG as a file and print server is
146 therefore not recommended, and can be avoided by setting user
147 profiles and home directories to be on another Windows NT (tm) or
148 compatible file server.
151 =====================================================================
153 If you have problems, or think you have found a bug please email 
154 a report to :
156         samba-technical@samba.org
158 As always, all bugs are our responsibility.
160 Regards,
162         The Samba Team.