WHATSNEW.txt

   1                    =============================
   2                    Release Notes for Samba 3.3.0
   3                           January, 05 2009
   4                    =============================
   5
   6 This is the first stable release of Samba 3.3.0.
   7
   8 Major enhancements in Samba 3.3.0 include:
   9
  10  Configuration/installation:
  11  o Splitting of library directory into library directory and separate
  12    modules directory.
  13  o The default value of "ldap ssl" has been changed to "start tls".
  14
  15  File Serving:
  16  o Extended Cluster support.
  17
  18  Winbind:
  19  o Simplified idmap configuration.
  20  o New idmap backends "adex" and "hash".
  21  o Added new parameter "winbind reconnect delay".
  22  o Added support for user and group aliasing.
  23  o Added support for multiple domains to idmap_ad.
  24
  25  Administrative tools:
  26  o The destination "all" of smbcontrol does now affect all running
  27    daemons including nmbd and winbindd.
  28  o New 'net rpc vampire keytab' and 'net rpc vampire ldif' commands.
  29  o The 'net' utility can now use kerberos for joining and authentication.
  30  o The 'wbinfo' utility can now add, modify and remove identity mapping entries.
  31
  32  Libraries:
  33  o NetApi library implements various new calls for User- and Group
  34    Account Management.
  35
  36
  37 Configure changes
  38 =================
  39
  40 The configure option "--with-libdir" has been removed. The library
  41 directory can still be specified by using the existing "--libdir" option.
  42 A new option "--with-modulesdir" has been added to allow the specification
  43 of a separate directory for the shared modules.
  44
  45
  46 Configuration changes
  47 =====================
  48
  49 The default value of "ldap ssl" has been changed to "start tls". This means,
  50 Samba will use the LDAPv3 StartTLS extended operation (RFC2830) for
  51 communicating with directory servers by default. If your directory servers
  52 do not support this extended operation, you will have to set
  53 "ldap ssl = no". Otherwise, Samba could not contact the directory servers
  54 anymore!
  55
  56
  57 Winbind idmap backend changes
  58 =============================
  59
  60 The idmap configuration has changed with version 3.3 to something that
  61 allows a smoother upgrade path from pre-3.0.25 configurations that use
  62 "idmap backend". The reason for this change is that to many, also to Samba
  63 developers, the 3.0.25 style configuration with "idmap config" turned out
  64 to be very complex. Version 3.3 no longer deprecates the "idmap backend"
  65 parameter, instead with "idmap backend" the default idmap backend is
  66 specified.
  67
  68 Accordingly, the "idmap config <domain> : default = yes" setting is no
  69 longer being looked at.
  70
  71 The alloc backend defaults to the default backend, which should be able to
  72 allocate IDs. In the default distribution the tdb and ldap backends can
  73 allocate, the ad and rid backends can not. The idmap alloc range is now
  74 being set with the "old" parameters "idmap uid" and "idmap gid".
  75
  76 The "idmap domains" parameter has been removed.
  77
  78
  79 winbind reconnect delay
  80 =======================
  81
  82 This is a new parameter which specifies the number of seconds the Winbind
  83 daemon will wait between attempts to contact a Domain controller for a domain
  84 that is determined to be down or not contactable.
  85
  86
  87 Winbind's Name Aliasing
  88 =======================
  89
  90 Name aliasing in Winbind is a feature that allows an administrator to
  91 map a fully qualified user or group name from a Windows domain to a
  92 convenient short name for Unix access.  This is similar to the username
  93 map functionality supported by smbd but is primary intended for
  94 clients and servers making use of Winbind's PAM and NSS libraries.
  95
  96 For example, the user "DOMAIN\fred" has been mapped to the Unix name
  97 "freddie".
  98
  99    $ getent passwd "DOMAIN\fred"
 100    freddie:x:1000:1001:Fred Jones:/home/freddie:/bin/bash
 101
 102    $ getent passwd freddie
 103    freddie:x:1000:1001:Fred Jones:/home/freddie:/bin/bash
 104
 105 The name aliasing support is provided by individual nss_info plugins.
 106 For example, the new "adex" plugin reads the uid attribute from Active
 107 Directory to make a short login name to the fully qualified name.
 108 While the new "hash" module utilizes a local file to map "short_name
 109 = QUALIFIED\name".  Both user and group name mapping is supported.
 110 Please refer to the "winbind nss info" option in smb.conf(5) and
 111 to individual plugin man pages for further details.
 112
 113
 114 idmap_hash
 115 ==========
 116
 117 The idmap_hash plugin provides similar support as the idmap_rid
 118 module.  However, uids and gids are generated from the full domain
 119 SID using a hashing algorithm that maps the lower 19 bits from the user
 120 or group RID to bits 0 - 19 in the Unix id and hashes 96 bits from
 121 the domain SID to bits 20 - 30 in the Unix id.  The result is a 31 bit
 122 uid or gid that is consistent across machines and provides support for
 123 trusted domains.
 124
 125 Please refer to the idmap_hash(8) man page for more details.
 126
 127
 128 idmap_adex
 129 ==========
 130
 131 The adex idmap/nss_info plugin is an adaptation of the Likewise
 132 Enterprise plugin with support for OU based cells removed
 133 (since the Windows pieces to manage the cells are not available).
 134
 135 This plugin supports
 136
 137       * The RFC2307 schema for users and groups.
 138       * Connections to trusted domains
 139       * Global catalog searches
 140       * Cross forest trusts
 141       * User and group aliases
 142
 143 Prerequisite: Add the following attributes to the Partial Attribute
 144 Set in global catalog:
 145
 146       * uidNumber
 147       * uid
 148       * gidNumber
 149
 150 A basic config using the current trunk code would look like:
 151
 152 [global]
 153         idmap backend = adex
 154         idmap uid = 10000 - 29999
 155         idmap gid = 10000 - 29999
 156         winbind nss info = adex
 157
 158         winbind normalize names = yes
 159         winbind refresh tickets = yes
 160         template homedir = /home/%D/%U
 161         template shell = /bin/bash
 162
 163 Please refer to the idmap_adex(8) man page for more details.
 164
 165
 166 ######################################################################
 167 Changes
 168 #######
 169
 170 smb.conf changes
 171 ----------------
 172
 173     Parameter Name                      Description     Default
 174     --------------                      -----------     -------
 175     cups connection timeout             New             30
 176     idmap domains                       Removed
 177     init logon delayed hosts            New             ""
 178     init logon delay                    New             100
 179     ldap ssl                            Changed Default start tls
 180     winbind reconnect delay             New             30
 181
 182
 183 Changes since 3.3.0rc2:
 184 -----------------------
 185
 186
 187 o   Jeremy Allison <jra@samba.org>
 188     * BUG 5979: Fix level 2 oplocks being granted improperly.
 189     * BUG 5980: Race condition when granting level2 oplocks can cause break
 190       notify to be missed.
 191     * BUG 5986: Editing a stream is broken (rename problems).
 192     * BUG 5990: Strict allocate should be checked before ftruncate.
 193     * Fix gcc 4.3.2 warnings.
 194     * Fix more asprintf errors and error code paths.
 195
 196
 197 o   Michael Adam <obnox@samba.org>
 198     * Fix build of pam_winbind.so on older Linux systems.
 199     * Packaging RHEL-CTDB: Fix build of [u]mount.cifs.
 200     * Fix uid_to_sid mapping when the idmap cache is empty.
 201     * Remove passd check from idmap_backends_unixid_to_sid().
 202
 203
 204 o   Kai Blin <kai@samba.org>
 205     * BUG 5953: Fix smbclient crashes.
 206
 207
 208 o   Gerald (Jerry) Carter <jerry@samba.org>
 209     * Fix "allow trusted domain" so it disables trusted domains.
 210
 211
 212 o   SATOH Fumiyasu <fumiyas@osstech.jp>
 213     * Fix gmem->numgids and gmem->maxgids breakage on Solaris 64-bit.
 214     * Fix SIGBUS on non-x86 CPUs in libsmbclient.
 215     * Fix a compile-time warning.
 216
 217
 218 o   Holger Hetterich <hhetter@novell.com>
 219     * Add a simple tdb integrity check to tdbtool.
 220
 221
 222 o   Björn Jacke <bj@sernet.de>
 223     * Correct the description of the "ldap timeout" parameter.
 224
 225
 226 o   Volker Lendecke <vl@samba.org>
 227     * BUG 5913: Fix build error with at least GCC 4.2.2.
 228     * BUG 5933: Fix incrementing/decrementing of num_validated_vuids.
 229     * BUG 5953: Make cli_send_smb_direct_writeX use writev.
 230     * BUG 5969: Optimize smbclient put command.
 231     * Fix a spinning smbd when printing.
 232     * Fix a memory leak in cups_pull_comment_location.
 233     * Fix a valgrind error.
 234     * Fix a "ignoring function call result" warning.
 235     * Fix some C++ warnings.
 236     * Fix an ancient uninitialized variable read.
 237
 238
 239 o   Stefan Metzmacher <metze@samba.org>
 240     * net_status: Use dbwrap to open sessionid.tdb.
 241     * Fix dbwrap_store_uint32() to match dbwrap_store_int32().
 242     * Make marshalling struct samu from and to a buffer more generic.
 243     * Store the next rid counter in passdb.tdb instead of winbind_idmap.tdb.
 244     * Register the client connection via CTDB_CONTROL_TCP_ADD.
 245     * Don't need to call messaging_reinit() twice.
 246
 247
 248 o   Lars Müller <lars@samba.org>
 249     * Tweak with pam defines of older Linux versions.
 250
 251
 252 o   Tim Prouty <tprouty@samba.org>
 253     * Fix stream marshalling to return the correct streaminfo status.
 254
 255
 256 o   Karolin Seeger <kseeger@samba.org>
 257     * Change default value of "ldap ssl" to "start tls".
 258     * Update version number in the manpages.
 259     * Fix several small issues and typos in the manpages.
 260
 261
 262 ######################################################################
 263 Reporting bugs & Development Discussion
 264 #######################################
 265
 266 Please discuss this release on the samba-technical mailing list or by
 267 joining the #samba-technical IRC channel on irc.freenode.net.
 268
 269 If you do report problems then please try to send high quality
 270 feedback. If you don't provide vital information to help us track down
 271 the problem then you will probably be ignored.  All bug reports should
 272 be filed under the Samba 3.3 product in the project's Bugzilla
 273 database (https://bugzilla.samba.org/).
 274
 275
 276 ======================================================================
 277 == Our Code, Our Bugs, Our Responsibility.
 278 == The Samba Team
 279 ======================================================================
 280