...

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 of an SSH Job configuration.

Mode Of Operation

...

The JobSchedulerSSHJob allows the execution of shell commands and scripts on a remote host running a an SSH server without requiring a local SSH client to be installed.

...

A minimal SSH Job configuration

<?xml version="1.0" encoding="ISO-8859-1"?>
<job title="Launch remote commands or executable files by SSH" stop_on_error="no">
    <description >
        <include  file="jobs/JobSchedulerSSHJob.xml"/>
    </description>
    <params >
        <param  name="host" value="HOSTNAME

...

"

...

/>
        <param  name="user" value="USERNAME"/>
        <param  name="password" value="PASSWORD"/>
        <param  name="auth_method" value="password"/>
        <param  name="command" value="printenv"/>
    </params>
    <script  language="java" java_class="sos.scheduler.job.SOSSSHJob2JSAdapter"/>
    <run_time />
</job>

Parameters

...

• Required Parameters
  • Parameters which are required to have to be set in the job configuration to properly run the Jobjob
    • Example: To connect to a remote host, the  'host' parameter is The  host parameter is always required to run the job properlya job that connects to a remote host.
  Conditional
• Optional Parameters
  • Parameters which depend on other parameters
    • Example: The value of the  'auth_method' parameter ('password' or 'publickey') determines whether one of the conditional parameters - the 'password' or 'publickey' parameter has to be set.
  Additional Parameters
  • are not required or parameters which are technically required but are instantiated through 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.
    • Example 2: not required
      • The proxy_host parameter is only used if the jobs
  • Parameters which are not required, but depend on specific conditions
    • Example: Only a 'host' parameter is required to connect with a remote host. However, if the
      • connection has to be instantiated over a proxy,
      an additional 'proxy_host' parameter is required.

...

Some parameters are technically required to build a connection but are not shown in the 'Required Parameters' section of this document.

...

• • • • otherwise it is not needed at all

Required Parameters

host

• 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.

...

Optional Parameters

port

• default value:
  • %%22
• 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.

Conditional Parameters

• •  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 The path name of the private key file must be set in the auth_file parameter . Should when the publickey authorization method is used. If the private key file be is secured by a password then this must be specified with the password parameter.  For the password authorization method the The password for each user account using password authorization must be specified using the password parameter. The authorization methods which are enabled depend on the SSH server configuration. Not all SSH server configurations support the password authorization method.

...

• default value:
  • empty
• description:
  • This parameter specifies the user account password for authorization by the SSH server and must be specified if the password authorization method is specified in the auth_method parameter. 
    Alternatively, this parameter may is used specify the secret key passphrase if the  publickey authorization method has been set in the auth_method parameter.

 auth_file

• default value:
  • empty
• description:
  • This parameter specifies the path and name of a user's private key file used for registration on an SSH server. This parameter must be specified if the publickey authorization method has been specified in the auth_method parameter. 
    If the private key file is secured with a passphrase, the password parameter the passphrase parameter hat to be set with the passphrase.

command_delimiter

• default value:
  • %%
• description:
  • Command delimiter characters are specified using this parameter. These delimiters are used in command parameters to separate multiple commands. These commands can then executed in separate SSH sessions.

command

• default value:
  • empty
• description:
  • This parameter specifies a command that is to be executed on the SSH server. Multiple commands can be separated by the command delimiter that is specified using the command_delimiter parameter.

...

• default value:
  • empty
• description:
  • This parameter can be used as an alternative to command, command_delimiter and command_script_file. It contains script code which will be saved to a temporary (script-)file on the remote host and executed there. The script can access task and order parameters by environment variables. The Environment variable names are written in upper case and have "SCHEDULER_PARAM_" as a prefix. Order parameters with the same name overwrite task parameters.

...

• default value:
  • empty
• description:

  • This parameter can be used as an alternative to command, command_delimiter and command_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

     Environment variable names are written in upper case and have "SCHEDULER_PARAM_" as a prefix. Order parameters with the same name overwrite task parameters.

...

• • Note
    The SSH Job is only able to transfer a command script file to the remote machine if SFTP is allowed on the remote SSH Server.

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.

...