Follow

Traverse custom monitor - SSH/SFTP test

The purpose of this KB is to show the ability of a custom monitor combined with local applications (e.g ssh/sftp client)

requirements:

* ssh server to be monitored
* ssh client (e.g. PuTTY suite for Windows)
* RSA Key connection established with the server

Assuming you have installed PuTTY suite for Windows or ssh client for GNU/Linux


To create the SSH secure connection with a RSA key:

Windows:

http://winscp.net/eng/docs/ui_puttygen

Linux:

http://www.cyberciti.biz/faq/how-to-set-up-ssh-keys-on-linux-unix/


  •  Files:


<TRAVERSE_HOME>/plugins/monitors/SFTP/sftptest.cmd
<TRAVERSE_HOME>/plugins/monitors/SFTP/sftptest.sh
<TRAVERSE_HOME>/plugins/monitors/sftp.xml


The public key should go on the server to be monitor. The OS should be the one running on the DGE/DGEx.

* copying the scripts and xml

We should copy the xml and the script files under <TRAVERSE_HOME>/plugins/monitors and the script under <TRAVERSE_HOME>/plugins/monitors/SFTP/ directory (we have to create this)
please refer to KB: https://helpdesk.kaseya.com/entries/102273266-TCP-connections-plugin-monitor for more details.

In Linux please change the status of the script to executable; #chmod 755 <TRAVERSE_HOME>/plugins/monitors/SFTP/sftptest.sh

  • Running the test:


Testing:

You can manually check that the script is properly running just call the script like the example below:

Linux:

<TRAVERSE_HOME>/plugins/monitors/SFTP/sftptest.sh <user> <ssh server>

e.g. <TRAVERSE_HOME>/plugins/monitors/SFTP/sftptest.sh sftpuser 10.20.20.90
Windows:

<TRAVERSE_HOME>\plugins\monitors\SFTP\sftptest.cmd <user> <ssh server> <location and key name> <path of psftp executable>

e.g. <TRAVERSE_HOME>\plugins\monitors\SFTP\sftptest.cmd sftpuser 10.20.20.90 c:\temp\id_rsa.ppk c:\temp

If the script is running properly and is able to connect to the sftp, will return a "10" (note this is an arbitrary number). If fail will return "20"


  •  Adding the script


Confirm on the 'Superuser->Health' page that the plugin files have been distributed from the BVE to the other servers by observing that the 'Config Rev#' number been incremented, then

    Navigate to 'Superuser->Health->Actions' to select 'Reload Config Files' from the 'Action' menu for the BVE and the DGE    
    
To provision a test to alert when the number of connections to the provisioning server is less than the expected 4 connections:

    Navigate to 'Administration->Devices'
    Select 'tests' link for the Device
    'Create New Standard Tests'
    Select 'Create new tests by selecting specific monitors'
    Check the box for monitor type 'sftp' then 'Add Tests'
    Select test category 'SFTP Test Windows' or 'SFTP Test Linux' accordingly  then 'Continue'
    Complete the requested information (e.g. user, rsa key path, psftp path)
    Check the box to the left of 'SFTP Test Windows' (to provision the test)
    

   

Was this article helpful?
1 out of 1 found this helpful
Have more questions? Submit a request

0 Comments

Article is closed for comments.