...
This document describes the functionality of the JobSchedulerSSHJob and the parameters to configure the Job properly. Additionally this document provides a minimal example for a SSH Job configuration.
...
Excerpt | |||||||||
---|---|---|---|---|---|---|---|---|---|
|
Parameters
...
- Required Parameters
- Parameters which have to be set in the job configuration to proerly run the job
- Example: To connect to a remote host, the '
host
' parameter is always required to run the job properly.
- Example: To connect to a remote host, the '
- Parameters which have to be set in the job configuration to proerly run the job
- Optional Parameters
- Parameters which are not required or parameters which are technically required but are instantiated throug a default value and therefore do not have to be set in the job configuration
- Example 1: technically required, but instantiated with default value
- To connect to a remote host, the '
port
' parameter is required. The parameter is instantiated with the default value '22
' therefore the 'port' parameter does not have to be set in the job configuration.
- To connect to a remote host, the '
- Example 2: not required
- The '
proxy_host
' parameter is only used if the jobs connection has to be instantiated over a proxy, otherwise it is not needed at all
- The '
- Example 1: technically required, but instantiated with default value
- Parameters which are not required or parameters which are technically required but are instantiated throug a default value and therefore do not have to be set in the job configuration
...
- default value:
- empty
- description:
- This parameter specifies the hostname or IP address of the SSH server to which a connection is to be made.
port
- default value:
- 22
- description:
- This parameter specifies the port number of the SSH server.
user
- default value:
- empty
- description:
- This parameter specifies the user account to be used when connecting to the SSH server.
...
- default value:
- %%
- description:
- Command delimiter characters are specified using this parameter. These delimiters can then used in the command parameter to separate multiple commands. These commands are then executed in a separate SSH session.
...
Optional Parameters
port
- default value:
- 22
- description:
- This parameter specifies the port number of the SSH server.
auth_method
- default value:
- publickey
- description:
- This parameter specifies the authorization method for the SSH server - the publickey and password methods are supported. When the publickey authorization method is used, then the path name of the private key file must be set in the
auth_file
parameter. Should the private key file be secured by a password then this must be specified with thepassword
parameter. For the password authorization method the password for each user account must be specified using thepassword
parameter. The authorization methods which are enabled depend on the SSH server configuration. Not all SSH server configurations support the password authorization method.
- This parameter specifies the authorization method for the SSH server - the publickey and password methods are supported. When the publickey authorization method is used, then the path name of the private key file must be set in the
...
- default value:
- empty
- description:
- This parameter can be used as an alternative to
command
,command_delimiter
andcommand_script
. It contains the name of a local (script-)file, which will be transferred to the remote host and executed there. The script can access task and order parameters by environment variables. The names are in upper case and have "SCHEDULER_PARAM_" as a prefix. Order parameters with the same name overwrite task parameters.
- This parameter can be used as an alternative to
...
proxy_host
- default value:
- empty
- description
- The value of this parameter is the host name or the IP address of a proxy used to create the connection to the SSH server. The use of a proxy is optional.
...