Skip to main content

Run SSH commands

Description

Run SSH command is a step in the Utility Plugin for Process Studio Workflows. This step executes commands and returns result over the secure shell (ssh) TCP/IP protocol

Configurations

No.Field NameDescription
General Tab
1Step nameSpecify the name of the step as it appears in the workflow workspace. This name has to be unique in a single workflow.
2Server name / IP addressSpecify the server or IP address of the machine on which you want to execute a command.
3Server portSpecify the TCP/IP port on which ssh protocol lives on the server. The default is 22.
4TimeoutSpecify the timeout in seconds. If set to a number larger than zero you can specify a non-default connection timeout.
5UsernameSpecify the username to log in with
6PasswordSpecify the password to use
7Use keyEnable this option if you want to log in using a private key
8Private keyThe private key file. The private part of a private/public RSA key-pair (see:ssh-keygen)
9PassphraseSpecify the optional pass-phrase used when the key-pair was generated
10Proxy hostSpecify the proxy server host to use (name or IP address)
11Proxy portSpecify the proxy server port to use
12Proxy usernameSpecify the proxy user name
13Proxy passwordSpecify the proxy password
14"Test connection" buttonClick to see if the supplied credentials are sufficient for logging
into the SSH server.
Settings Tab:
Output
1Response fieldnameSpecify the name of the String output field that will contain the text passed to the standard output channel (stdout) by the specified commands.

This information can then be picked up by the step and passed in a field to subsequent steps.

2Error response field nameThe name of the String output field that will contain the text passed to the standard error channel (stderr) by the specified commands.

This information can then be picked up by the step and passed in a field to subsequent steps.

Commands:
3Get commands from fieldEnable this option if you want to execute commands specified in an input field
4Commands field nameSelect the input field that will contain the commands to execute
5CommandsField allows you to specify the commands to execute.
6Wait for responseSpecify the Wait for response time in seconds. If it is more than zero seconds, the step waits to get the command output for the specified seconds.

Internally, it checks for a response after every 15 seconds. If the command output does not receive a response in the specified time, then the step exits with an error.