WHATSNEW.txt

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