WHATSNEW.txt

   1 Release Announcements
   2 =====================
   3
   4 This is the first release candidate of Samba 4.18.  This is *not*
   5 intended for production environments and is designed for testing
   6 purposes only.  Please report any defects via the Samba bug reporting
   7 system at https://bugzilla.samba.org/.
   8
   9 Samba 4.18 will be the next version of the Samba suite.
  10
  11
  12 UPGRADING
  13 =========
  14
  15
  16 NEW FEATURES/CHANGES
  17 ====================
  18
  19 More succinct samba-tool error messages
  20 ---------------------------------------
  21
  22 Historically samba-tool has reported user error or misconfiguration by
  23 means of a Python traceback, showing you where in its code it noticed
  24 something was wrong, but not always exactly what is amiss. Now it
  25 tries harder to identify the true cause and restrict its output to
  26 describing that. Particular cases include:
  27
  28  * a username or password is incorrect
  29  * an ldb database filename is wrong (including in smb.conf)
  30  * samba-tool dns: various zones or records do not exist
  31  * samba-tool ntacl: certain files are missing
  32  * the network seems to be down
  33  * bad --realm or --debug arguments
  34
  35 Accessing the old samba-tool messages
  36 -------------------------------------
  37
  38 This is not new, but users are reminded they can get the full Python
  39 stack trace, along with other noise, by using the argument '-d3'.
  40 This may be useful when searching the web.
  41
  42 The intention is that when samba-tool encounters an unrecognised
  43 problem (especially a bug), it will still output a Python traceback.
  44 If you encounter a problem that has been incorrectly identified by
  45 samba-tool, please report it on https://bugzilla.samba.org.
  46
  47 Colour output with samba-tool --color
  48 -------------------------------------
  49
  50 For some time a few samba-tool commands have had a --color=yes|no|auto
  51 option, which determines whether the command outputs ANSI colour
  52 codes. Now all samba-tool commands support this option, which now also
  53 accepts 'always' and 'force' for 'yes', 'never' and 'none' for 'no',
  54 and 'tty' and 'if-tty' for 'auto' (this more closely matches
  55 convention). With --color=auto, or when --color is omitted, colour
  56 codes are only used when output is directed to a terminal.
  57
  58 Most commands have very little colour in any case. For those that
  59 already used it, the defaults have changed slightly.
  60
  61  * samba-tool drs showrepl: default is now 'auto', not 'no'
  62
  63  * samba-tool visualize: the interactions between --color-scheme,
  64    --color, and --output have changed slightly. When --color-scheme is
  65    set it overrides --color for the purpose of the output diagram, but
  66    not for other output like error messages.
  67
  68 No colour with NO_COLOR environment variable
  69 --------------------------------------------
  70
  71 With both samba-tool --color=auto (see above) and some other places
  72 where we use ANSI colour codes, the NO_COLOR environment variable will
  73 disable colour output. See https://no-color.org/ for a description of
  74 this variable. `samba-tool --color=always` will use colour regardless
  75 of NO_COLOR.
  76
  77 New wbinfo option --change-secret-at
  78 ------------------------------------
  79
  80 The wbinfo command has a new option, --change-secret-at=<DOMAIN CONTROLLER>
  81 which forces the trust account password to be changed at a specified domain
  82 controller. If the specified domain controller cannot be contacted the
  83 password change fails rather than trying other DCs.
  84
  85
  86 REMOVED FEATURES
  87 ================
  88
  89
  90 smb.conf changes
  91 ================
  92
  93   Parameter Name                          Description     Default
  94   --------------                          -----------     -------
  95
  96
  97 KNOWN ISSUES
  98 ============
  99
 100 https://wiki.samba.org/index.php/Release_Planning_for_Samba_4.18#Release_blocking_bugs
 101
 102
 103 #######################################
 104 Reporting bugs & Development Discussion
 105 #######################################
 106
 107 Please discuss this release on the samba-technical mailing list or by
 108 joining the #samba-technical:matrix.org matrix room, or
 109 #samba-technical IRC channel on irc.libera.chat
 110
 111 If you do report problems then please try to send high quality
 112 feedback. If you don't provide vital information to help us track down
 113 the problem then you will probably be ignored.  All bug reports should
 114 be filed under the Samba 4.1 and newer product in the project's Bugzilla
 115 database (https://bugzilla.samba.org/).
 116
 117
 118 ======================================================================
 119 == Our Code, Our Bugs, Our Responsibility.
 120 == The Samba Team
 121 ======================================================================
 122