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.
- 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
set
will not be recognized.- Workaround: use
export
instead.
- Workaround: use
- Limitation: the
%
special character to mark an environment variable such as%VARIABLENAME%
will not be recognized.- Workaround: use
$VARIABLENAME
instead. - 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 /C
does not execute the specified command.
- Limitation: the Windows command
- Problem
evtl. auf Artikel verlinken; geht denn cmd /C start "clean shell" /I "${EXPLORER_WINPATH}" "${SCRIPT_WINPATH}"
- Beispiel: start "My Notepad" /I c:/tmp/hallo.cmd
- getestet:
- mit
cygstart -w launcher.bat ./test.cmd
- Vorraussetzung
cygstart
ist verfügbar, gehört nicht zu Umfang einer Copssh installation- in einer ssh Verbindung passiert nix
- in einem JUnit Test schlägt der Test mit dem exit code 127 fehl
- mit
cmd /C start /I ./test.cmd
- in einer ssh Verbindung passiert nix
- in einem JUnit Test hängt der Test sobald versucht wird das Kommando remote auszuführen
- mit
- getestet:
bitvise SSH Server
- Environment Variables
- Limitation: setting environment variables with
set
would 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=myTestParam
is being written to that file.
- Limitation: setting environment variables with