Scope
- When using SSH jobs users might experience limitations that are specific for Windows operating systems. One reason for such limitations is the fact that SSH is not available with the OS but is implemented by third party products.
- A complete re-write of the JITL SSH Job is provided by
JITL-123 - Getting issue details... STATUS - FEATURE AVAILABILITY STARTING FROM RELEASE 1.9
- A complete re-write of the JITL SSH Job is provided by
- When using this JITL job please consider our experiences concerning limitations with some SSH products for Windows. Before posting a support request please check the following behavior of your SSH server and verify by use of a command line tool if possible SSH issues were related to the SSH server or to the JITL job.
- The list of products and limitations is not complete, please contact your SSH server vendor for details.
Copssh
Copssh is a Windows SSH Service based on the Linux SSH implementation OpenSSH provided by Itefix in collaboration with Cygwin. We experienced the following limitations when using Copssh 5.0.3:
- Interactive Shell
- Problem
- The Windows shell can only be used as an interactive shell and does not support command or script execution.
- The reason for this behavior is the fact that CopSSH does not support the non-interactive shell
cmd.sh. - For details see https://www.itefix.net/content/windows-shell-sftp.
- Solution
- Using the "Bash and sFTP shell" with Copssh will work for Windows systems when using the cygwin supported Linux commands.
- Examples for Limitations
- Limitation: the Windows command
setwill not be recognized.- Workaround: use
exportinstead.
- Workaround: use
- Limitation: the
%special character to mark an environment variable such as%VARIABLENAME%will not be recognized.- Workaround: use
$VARIABLENAMEinstead. - Hint: be careful when using mixed case spelling for environment variables.
- Workaround: use
- Limitation: executing chained Windows commands in one line with the command delimiters
&or&&will result in executing only the first command.- Workaround: use the Linux command delimiter "
;"together with the proper Linux command instead.
- Workaround: use the Linux command delimiter "
- Limitation: prefixing a command with
cmd /Cdoes not execute the specified command.
- Limitation: the Windows command
- Problem
probably link to the article, iscmd /C start "clean shell" /I "${EXPLORER_WINPATH}" "${SCRIPT_WINPATH}"
working?
- example: start "My Notepad" /I c:/tmp/hallo.cmd
- tested:
- with
cygstart -w launcher.bat ./test.cmd cygstarthas to be available, it is not integrated in the Copssh installation, but available through the standard cygwin installation- nothing happens in the ssh connection
- JUnit Test fails with exit code 127
- with
cmd /C start /I ./test.cmd- nothing happens in the ssh connection
- JUnit Test hangs as soon as the command will be executed remotely
- with
- tested:
bitvise SSH Server
- Environment Variables
- Limitation: setting environment variables with
setwould not allow using this variable in further commands. - Example: unsuccessful use of an environment variable in a subsequent command:
set TESTFILE=test.txt
echo MYPARAM=myTestParam >> %TESTFILE%- This example shows that %TESTFILE% is not substituted, instead a file with the name
%TESTFILE%is being created andMYPARAM=myTestParamis being written to that file.
- Limitation: setting environment variables with