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