SSH Server Monitoring

An SSH server is a computer program that accepts connections from client systems and allows data to be exchanged between the two network devices via secure channel using Secure Shell (SSH) protocol. SSH is used primarily to access shell accounts as a replacement for Telnet and other insecure remote shells.

SSH monitor provides availability and operability monitoring for SSH servers. The service also provides remote script execution. This means the SSH monitoring service can be used for performing various administration tasks on remote systems.

Synchronization Details

SSH monitor performs the following operations during synchronization:

  • Establishes connection to the SSH server.
  • Authenticates using name and password specified by service settings.
  • [Optional] Uploads script to the remote host. Script is specified in the settings' Script field as an explicit text or a file. Monitor first tries to upload script using scp; if the attempt fails it creates file using echo commands.
  • [Optional] Executes uploaded script using sh command. Script execution output is intercepted and saved in monitoring results.
  • Closes connection.

    • If all the operations are executed successfully the SSH service is deemed Online. If no script is specified in service parameters (i.e. Script field is NULL) steps 3 and 4 are omitted; thus, only connection, authentication and disconnection operations are performed.

    If an error was encountered during execution the service is denoted as Offline and error message is saved in Error field.

    Execute Remote Script Action

    Additionally, an Execute script on remote server using SSH (executeRemoteScript) action is installed in Root context. It accepts connection settings and script as input parameters:

    Property

    Name

    Description

    Address

    address

    Host address

    Port

    port

    Port number the SSH server is running on.

    Timeout, milliseconds

    timeout

    Timeout for SSH operations.

    User Name

    userName

    User name to use for authorization.

    Password

    password

    Password to use for authorization.

    Script

    script

    Script specified as explicit text or as a file; may be NULL.

    Results of the script execution are presented in the following format:

    Property

    Name

    Description

    Successful

    successful

    Indicates that no error occurred during connection to SSH server, authorization, and remote script execution.

    Error

    error

    Error text, if any.

    Result

    result

    Output of a remote script.

    Was this page helpful?