0 0 1
default
Jean-Francois Pieronne - 3 years ago 2016-11-30 15:39:27
jf.pieronne@laposte.net
WHATSNEW.txt initial version
1 file changed with 354 insertions and 0 deletions:
↑ Collapse Diff ↑
 
new file 100644
1
 
WHATSNEW For 'tsshbatch' 1.317    (Sat Oct 15 16:12:34 CDT 2016)
2
 
----------------------------------------------------------------------
3
 

	
4
 
  - It is now possible to define local variables with the
5
 
    .local directive.  These have visibilty and scope only
6
 
    with the file where they are defined, but otherwise work
7
 
    the same as globally defined variables.  Local variables
8
 
    also support "execution variable" style definition.
9
 

	
10
 
  - Hostfile names must now be passed using the -i option.  The
11
 
    argument can be the name of a single file or a quoted list of
12
 
    files.  The option can appear on the command line more than once.
13
 
    -H and -i can be used together to create custom host lists.
14
 

	
15
 
  - The -L option will list all (if any) host- and command files found
16
 
    on their respective search paths.
17
 

	
18
 
  - The -W option will write out the inventory of hosts that would be
19
 
    processed if you actually executed the program, and then
20
 
    terminates.  This works only in test mode.  This allows you
21
 
    to embed tsshbatch in external shell scripts like this:
22
 

	
23
 
       for server in $(tsshbatch.py -i devserverlist -uatserverlist -W)
24
 
       do
25
 
         ssh $server
26
 
       done
27
 

	
28
 
    Why?  Because tsshbatch has lots of powerful ways to maintain
29
 
    inventories of hosts and combine them through includes and
30
 
    multiple command line arguments.  The -W option makes it
31
 
    convenient for external programs to make use of those inventory
32
 
    features.
33
 

	
34
 
  - The -F "string ..."  option will examine every file on the host-
35
 
    or command paths, looking for matching strings within these files.
36
 
    Matches will report the file name, the location within the file,
37
 
    and the line containing any of the specified strings.
38
 

	
39
 
    This is a simple, case-insensitive string literal match and does
40
 
    not support regular expressions.
41
 

	
42
 
    This is handy when you're looking for a host name or command
43
 
    string, say like, "sudo", and you don't want to have to manually
44
 
    go through all your support files.
45
 

	
46
 
  - The -V "string ..." option does the exact opposite of -F.  It
47
 
    lists all the files that do NOT contain any of the specified
48
 
    strings.
49
 

	
50
 
  - The -r option has been added to suppress reporting of start/stop
51
 
    statistics.  This allows you to make statistics reporting the
52
 
    default, say via the $TSSHBATCH environment variable, but
53
 
    override it when you need to.
54
 

	
55
 
  - A new directive, .notify, tells tsshbatch to print an informative
56
 
    message from within a command file.  This is a runtime activity
57
 
    and is helpful, for example, when tracking progress of a long
58
 
    command file. Notifications are disabled in silent mode.
59
 

	
60
 
[CHANGES]
61
 

	
62
 
  - The -H option can now appear on the command line multiple times
63
 
    thereby creating an aggregate list of all hosts named therein.
64
 

	
65
 
  - Hostfiles must now be passed as an argument of -i.  This was
66
 
    done to provide a consistent way of passing multiple host
67
 
    files on the commandline.
68
 

	
69
 
  - .include targets (file name specifications) may now reference
70
 
    previously defined variables.
71
 

	
72
 

	
73
 
[BUG FIXES]
74
 

	
75
 
  - File transfers now properly honor the -s (silent output) flag.
76
 

	
77
 

	
78
 
WHATSNEW For 'tsshbatch' 1.228    (Mon Jan 18 18:10:50 CST 2016)
79
 
----------------------------------------------------------------------
80
 

	
81
 
- There is now limited support for ssh configuration files. Only the
82
 
  HostName and IdentityFile directives are currently supported.
83
 

	
84
 
  By default, tsshbatch will look in ~/.ssh/config for this
85
 
  configuration file. However, the location of the file can be
86
 
  overridden with the -C option.
87
 

	
88
 
- The -b option has been added to continue after a sudo failure.
89
 
  Previous releases of the program stopped all further processing
90
 
  on any sudo failure.  With -b, it's now possible to go on to
91
 
  the remaining hosts even if one of them failed to do proper
92
 
  sudo promotion.
93
 

	
94
 
- The -B option has been added to print an informative "banner"
95
 

	
96
 

	
97
 

	
98
 

	
99
 

	
100
 

	
101
 

	
102
 

	
103
 

	
104
 

	
105
 

	
106
 

	
107
 

	
108
 

	
109
 

	
110
 

	
111
 

	
112
 

	
113
 

	
114
 

	
115
 

	
116
 

	
117
 
  at the beginning and end of each program run.
118
 

	
119
 

	
120
 
[CHANGES]
121
 

	
122
 
- On screen help now displays default settings for all options where
123
 
  appropriate.
124
 

	
125
 

	
126
 
[BUG FIXES]
127
 

	
128
 
- Fixed bug that caused program to exit after a failed
129
 
  file transfer even when -a was specified.
130
 

	
131
 
- Fixed bug that failed to present user name during key-based
132
 
  auth.  This prevented connection when the desired name
133
 
  was different than the initating user - say when using
134
 
  process IDs instead of "real" users.
135
 

	
136
 

	
137
 
WHATSNEW For 'tsshbatch' 1.212    (Wed Dec 10 09:42:08 CST 2014)
138
 
----------------------------------------------------------------------
139
 

	
140
 
[NEW]
141
 

	
142
 
- Implemented .getfile and .putfile directives for specifying
143
 
  file transfers in a cmdfile.
144
 

	
145
 
[CHANGES]
146
 

	
147
 
- Quotation characters are no longer stripped in cmdfile file
148
 
  transfer specifications.
149
 

	
150
 
[BUG FIXES]
151
 

	
152
 
None
153
 

	
154
 

	
155
 
WHATSNEW For 'tsshbatch' 1.210    (Tue Dec  9 12:20:25 CST 2014)
156
 
----------------------------------------------------------------------
157
 

	
158
 
[NEW]
159
 

	
160
 
- It is now possible to put file transfer specifications in cmdfiles.
161
 
  Each must be on its own line and in the same form as if it were
162
 
    provided on the command line:
163
 

	
164
 
    -G /path/to/srcfile destdir
165
 
    -P /path/to/srcfile destdir
166
 

	
167
 
  Any single- or double quotes will be removed.
168
 

	
169
 
- Added __LOGINNAME__ builtin.  For key exchange auth, this will just
170
 
  be the name of the user running tsshbatch.  When an explicit login
171
 
  name is provided, either via prompting or command line, that name
172
 
  will be returned by this variable.
173
 

	
174
 
- Implemented -s, "silent" option which suppresses all reporting and
175
 
  header noise and only returns the literal results of each command.
176
 

	
177
 

	
178
 
[CHANGES]
179
 

	
180
 
None
181
 

	
182
 
[BUG FIXES]
183
 

	
184
 
- Fixed bug that caused program to exit after a failed
185
 
  file transfer even when -a was specified.
186
 

	
187
 

	
188
 
WHATSNEW For 'tsshbatch' 1.204    (Thu Dec  4 18:33:10 CST 2014)
189
 
----------------------------------------------------------------------
190
 

	
191
 
[NEW]
192
 

	
193
 
- Added the following builtin variables:
194
 

	
195
 
  __DATE__       # Date in YYYYMMDD format
196
 
  __DATETIME__   # Date and time in YYYYMMDDHHMMSS format
197
 
  __HOSTNAME__   # Full name of current host as passed to program
198
 
  __HOSTNUM__    # Count of host being processed, starting at 1
199
 
  __HOSTSHORT__  # Leftmost component of hostname as passed to program
200
 
  __TIME__       # Time in HHMMSS format
201
 

	
202
 
- Added an "execution variable".  This runs a command of your
203
 
  choosing (on the local machine) and assigns the results to
204
 
  a user-defined variable.
205
 

	
206
 
- Added -E to redirect all stderr output to stdout instead,
207
 

	
208
 
- Added -T timeout option (default is 15 sec).
209
 

	
210
 
- Added -a to allow program to continue after file transfer error.
211
 

	
212
 
- Added -l logging option. Defaults to /dev/null.  This fixes the error
213
 
  that was previously being reported:
214
 

	
215
 
    "No handlers could be found for logger "paramiko.transport"
216
 

	
217
 
- Added -q for "quieter" output.
218
 

	
219
 

	
220
 
[CHANGES]
221
 

	
222
 
- File transfers now properly preserve the file's permissions.
223
 

	
224
 
- Changed hostname separator from ':' to '-' when using the -G command.
225
 

	
226
 
- The <HOSTNAME> and <HOSTSHORT> builtins have been replaced
227
 
  with the new builtins described above.
228
 

	
229
 
- Error messages now more consistent and clear.
230
 

	
231
 
- Test mode now expands variable references to their values for
232
 
  all variables except the builtins above (which are only
233
 
  evaluated at runtime).
234
 

	
235
 
- Documentation has been rewritten and improved considerably.
236
 

	
237
 

	
238
 
[BUG FIXES]
239
 

	
240
 
- Fixed bug that prevented the proper dereferencing of
241
 
  __HOSTNAME|SHORT__ (formerly <HOSTNAME|SHORT>) in file transfer
242
 
  specifications.
243
 

	
244
 
- Fixed bug that prevented variable substitution in hostnames.
245
 

	
246
 
- Fixed bug that prevented '.define' variables from being substituted
247
 
  in file transfer specifications.
248
 

	
249
 
- Fixed bug that only recognized sudo invocations if they were the
250
 
  first statement on a command line.  All instances of the string
251
 
  "sudo " will now force sudo password prompting and processing.
252
 
  That string is ignored if it appears inside single- or double quotes.
253
 

	
254
 
- Fixed bug that intermittently occurred during password-based auth
255
 
  sessions because ssh-agent and key searching were still being used.
256
 

	
257
 
- Fixed error reporting blowout when key-exchange auth fails.
258
 

	
259
 

	
260
 
WHATSNEW For 'tsshbatch' 1.177    (Thu Mar 27 19:09:03 CDT 2014)
261
 
----------------------------------------------------------------------
262
 

	
263
 
- Test mode is now the default.  Actual operation requires
264
 
  explicit use of the -x option.
265
 

	
266
 
- A new option, -K, has been added to force prompting for passwords.
267
 
  This is to provide a means to override a -k (key exchange)
268
 
  default if the user set it that way in the $TSSHBATCH environment
269
 
  variable.
270
 

	
271
 
- It is now possible to substitute the name of the current host into
272
 
  either commands or file transfer specifications via the '<HOSTNAME>'
273
 
  and '<HOSTSHORT>' strings.  This allows commands and/or file
274
 
  transfers to behave in a host-specific manner.
275
 

	
276
 

	
277
 
WHATSNEW For 'tsshbatch' 1.171    (Fri Nov  1 12:08:31 CDT 2013)
278
 
----------------------------------------------------------------------
279
 

	
280
 
CHANGES:
281
 

	
282
 
  - Changed default behavior to pick up $USER from the environment and
283
 
    not prompt for it.
284
 

	
285
 
  - When prompting for username, now shows $USER or the user presented
286
 
    via -n as default if present.
287
 

	
288
 
  - Cosmetic changes in reporting output
289
 

	
290
 
  - Cleaned up sudo handling and reporting
291
 

	
292
 
NEW FEATURES:
293
 

	
294
 
  - A new option, -N, to forces prompting for username to overcome the
295
 
    new default behavior of using $USER or the name provided by -n
296
 
    without promptng.  This option also overrides any previous
297
 
    request for key exchange authentication.
298
 

	
299
 
  - A new option, -S, forces prompting for the sudo password, with the
300
 
    default being any previously provided password (interactive or -p).
301
 
    This allows you to use one password to authenticate to the system
302
 
    and a different one to do sudo promotion.
303
 

	
304
 
  - Two new options, -G and -P, support file transfer GETs and PUTs
305
 
    respectively from the selected hosts.
306
 

	
307
 
  - A new option, -f cmdfile, allows multiple commands stored
308
 
    in the file to be run on each of the selected hosts.  This
309
 
    allows for considerably more complex operations than the
310
 
    single command string at the end of the command line supported
311
 
    in previous versions.
312
 

	
313
 
  - A new option, -y, turns on 'noisy' reporting and produces
314
 
    context information (hostname, output stream, and command)
315
 
    for every line of output.  This makes the output more useful
316
 
    when filtered through something like 'grep'.
317
 

	
318
 
  - There is a new options, -t, to turn on "test mode" which
319
 
    will show what would be done, but will not actually do it.
320
 
    This mode also displays useful diagnostic information
321
 
    about the command line, variable defintions, file tranfer
322
 
    requests, and so on.
323
 

	
324
 
  - The new -x option is used to negate a prior -t and thereby
325
 
    force execution of the requested file transfers and/or
326
 
    commands.
327
 

	
328
 
  - Both cmdfiles and hostlistfiles now support freeform whitespace
329
 
    and commenting via the "#" character.
330
 

	
331
 
  - Both cmdfiles and hostlistfiles now support including other
332
 
    files via the .include directive.  Circular include detection
333
 
    is also implemented.
334
 

	
335
 
  - Both cmdfiles and hostlistfiles can contain variable
336
 
    definitions that are literally replaced in any following
337
 
    text.
338
 

	
339
 

	
340
 
WHATSNEW For 'tsshbatch' 1.137    (Fri Feb 22 15:30:24 CST 2013)
341
 
----------------------------------------------------------------------
342
 

	
343
 
- Changed error reporting to place the entire message on a single line.
344
 

	
345
 
- Changed the manner of error reporting to provide more specific
346
 
  detail.  The original error messages could be misleading because
347
 
  both the inability to connect and an ssh rejection reported
348
 
  the exact same error.
349
 

	
350
 

	
351
 
WHATSNEW For 'tsshbatch' 1.134    (Tue Jan 17 09:00:04 CST 2012)
352
 
----------------------------------------------------------------------
353
 

	
354
 
Initial public release
0 comments (0 inline, 0 general)