WHATSNEW For 'tsshbatch' 1.317 (Sat Oct 15 16:12:34 CDT 2016) ---------------------------------------------------------------------- - It is now possible to define local variables with the .local directive. These have visibilty and scope only with the file where they are defined, but otherwise work the same as globally defined variables. Local variables also support "execution variable" style definition. - Hostfile names must now be passed using the -i option. The argument can be the name of a single file or a quoted list of files. The option can appear on the command line more than once. -H and -i can be used together to create custom host lists. - The -L option will list all (if any) host- and command files found on their respective search paths. - The -W option will write out the inventory of hosts that would be processed if you actually executed the program, and then terminates. This works only in test mode. This allows you to embed tsshbatch in external shell scripts like this: for server in $(tsshbatch.py -i devserverlist -uatserverlist -W) do ssh $server done Why? Because tsshbatch has lots of powerful ways to maintain inventories of hosts and combine them through includes and multiple command line arguments. The -W option makes it convenient for external programs to make use of those inventory features. - The -F "string ..." option will examine every file on the host- or command paths, looking for matching strings within these files. Matches will report the file name, the location within the file, and the line containing any of the specified strings. This is a simple, case-insensitive string literal match and does not support regular expressions. This is handy when you're looking for a host name or command string, say like, "sudo", and you don't want to have to manually go through all your support files. - The -V "string ..." option does the exact opposite of -F. It lists all the files that do NOT contain any of the specified strings. - The -r option has been added to suppress reporting of start/stop statistics. This allows you to make statistics reporting the default, say via the $TSSHBATCH environment variable, but override it when you need to. - A new directive, .notify, tells tsshbatch to print an informative message from within a command file. This is a runtime activity and is helpful, for example, when tracking progress of a long command file. Notifications are disabled in silent mode. [CHANGES] - The -H option can now appear on the command line multiple times thereby creating an aggregate list of all hosts named therein. - Hostfiles must now be passed as an argument of -i. This was done to provide a consistent way of passing multiple host files on the commandline. - .include targets (file name specifications) may now reference previously defined variables. [BUG FIXES] - File transfers now properly honor the -s (silent output) flag. WHATSNEW For 'tsshbatch' 1.228 (Mon Jan 18 18:10:50 CST 2016) ---------------------------------------------------------------------- - There is now limited support for ssh configuration files. Only the HostName and IdentityFile directives are currently supported. By default, tsshbatch will look in ~/.ssh/config for this configuration file. However, the location of the file can be overridden with the -C option. - The -b option has been added to continue after a sudo failure. Previous releases of the program stopped all further processing on any sudo failure. With -b, it's now possible to go on to the remaining hosts even if one of them failed to do proper sudo promotion. - The -B option has been added to print an informative "banner" at the beginning and end of each program run. [CHANGES] - On screen help now displays default settings for all options where appropriate. [BUG FIXES] - Fixed bug that caused program to exit after a failed file transfer even when -a was specified. - Fixed bug that failed to present user name during key-based auth. This prevented connection when the desired name was different than the initating user - say when using process IDs instead of "real" users. WHATSNEW For 'tsshbatch' 1.212 (Wed Dec 10 09:42:08 CST 2014) ---------------------------------------------------------------------- [NEW] - Implemented .getfile and .putfile directives for specifying file transfers in a cmdfile. [CHANGES] - Quotation characters are no longer stripped in cmdfile file transfer specifications. [BUG FIXES] None WHATSNEW For 'tsshbatch' 1.210 (Tue Dec 9 12:20:25 CST 2014) ---------------------------------------------------------------------- [NEW] - It is now possible to put file transfer specifications in cmdfiles. Each must be on its own line and in the same form as if it were provided on the command line: -G /path/to/srcfile destdir -P /path/to/srcfile destdir Any single- or double quotes will be removed. - Added __LOGINNAME__ builtin. For key exchange auth, this will just be the name of the user running tsshbatch. When an explicit login name is provided, either via prompting or command line, that name will be returned by this variable. - Implemented -s, "silent" option which suppresses all reporting and header noise and only returns the literal results of each command. [CHANGES] None [BUG FIXES] - Fixed bug that caused program to exit after a failed file transfer even when -a was specified. WHATSNEW For 'tsshbatch' 1.204 (Thu Dec 4 18:33:10 CST 2014) ---------------------------------------------------------------------- [NEW] - Added the following builtin variables: __DATE__ # Date in YYYYMMDD format __DATETIME__ # Date and time in YYYYMMDDHHMMSS format __HOSTNAME__ # Full name of current host as passed to program __HOSTNUM__ # Count of host being processed, starting at 1 __HOSTSHORT__ # Leftmost component of hostname as passed to program __TIME__ # Time in HHMMSS format - Added an "execution variable". This runs a command of your choosing (on the local machine) and assigns the results to a user-defined variable. - Added -E to redirect all stderr output to stdout instead, - Added -T timeout option (default is 15 sec). - Added -a to allow program to continue after file transfer error. - Added -l logging option. Defaults to /dev/null. This fixes the error that was previously being reported: "No handlers could be found for logger "paramiko.transport" - Added -q for "quieter" output. [CHANGES] - File transfers now properly preserve the file's permissions. - Changed hostname separator from ':' to '-' when using the -G command. - The and builtins have been replaced with the new builtins described above. - Error messages now more consistent and clear. - Test mode now expands variable references to their values for all variables except the builtins above (which are only evaluated at runtime). - Documentation has been rewritten and improved considerably. [BUG FIXES] - Fixed bug that prevented the proper dereferencing of __HOSTNAME|SHORT__ (formerly ) in file transfer specifications. - Fixed bug that prevented variable substitution in hostnames. - Fixed bug that prevented '.define' variables from being substituted in file transfer specifications. - Fixed bug that only recognized sudo invocations if they were the first statement on a command line. All instances of the string "sudo " will now force sudo password prompting and processing. That string is ignored if it appears inside single- or double quotes. - Fixed bug that intermittently occurred during password-based auth sessions because ssh-agent and key searching were still being used. - Fixed error reporting blowout when key-exchange auth fails. WHATSNEW For 'tsshbatch' 1.177 (Thu Mar 27 19:09:03 CDT 2014) ---------------------------------------------------------------------- - Test mode is now the default. Actual operation requires explicit use of the -x option. - A new option, -K, has been added to force prompting for passwords. This is to provide a means to override a -k (key exchange) default if the user set it that way in the $TSSHBATCH environment variable. - It is now possible to substitute the name of the current host into either commands or file transfer specifications via the '' and '' strings. This allows commands and/or file transfers to behave in a host-specific manner. WHATSNEW For 'tsshbatch' 1.171 (Fri Nov 1 12:08:31 CDT 2013) ---------------------------------------------------------------------- CHANGES: - Changed default behavior to pick up $USER from the environment and not prompt for it. - When prompting for username, now shows $USER or the user presented via -n as default if present. - Cosmetic changes in reporting output - Cleaned up sudo handling and reporting NEW FEATURES: - A new option, -N, to forces prompting for username to overcome the new default behavior of using $USER or the name provided by -n without promptng. This option also overrides any previous request for key exchange authentication. - A new option, -S, forces prompting for the sudo password, with the default being any previously provided password (interactive or -p). This allows you to use one password to authenticate to the system and a different one to do sudo promotion. - Two new options, -G and -P, support file transfer GETs and PUTs respectively from the selected hosts. - A new option, -f cmdfile, allows multiple commands stored in the file to be run on each of the selected hosts. This allows for considerably more complex operations than the single command string at the end of the command line supported in previous versions. - A new option, -y, turns on 'noisy' reporting and produces context information (hostname, output stream, and command) for every line of output. This makes the output more useful when filtered through something like 'grep'. - There is a new options, -t, to turn on "test mode" which will show what would be done, but will not actually do it. This mode also displays useful diagnostic information about the command line, variable defintions, file tranfer requests, and so on. - The new -x option is used to negate a prior -t and thereby force execution of the requested file transfers and/or commands. - Both cmdfiles and hostlistfiles now support freeform whitespace and commenting via the "#" character. - Both cmdfiles and hostlistfiles now support including other files via the .include directive. Circular include detection is also implemented. - Both cmdfiles and hostlistfiles can contain variable definitions that are literally replaced in any following text. WHATSNEW For 'tsshbatch' 1.137 (Fri Feb 22 15:30:24 CST 2013) ---------------------------------------------------------------------- - Changed error reporting to place the entire message on a single line. - Changed the manner of error reporting to provide more specific detail. The original error messages could be misleading because both the inability to connect and an ssh rejection reported the exact same error. WHATSNEW For 'tsshbatch' 1.134 (Tue Jan 17 09:00:04 CST 2012) ---------------------------------------------------------------------- Initial public release