SURVIVOR: tunnel Transport Module
About tunnel
basics
Module Type Scheduler Remote
transport Yes No
syntax 
     module tunnel {
       command <string>
       [rinstdir <string>]
       [srname <string>]
     }

Dependencies

  • None

Arguments

Name Type Value
command string Command to invoke to provide transport.
rinstdir optional string, default is instdir Path to the directory containing sbin/sr and mod/check on the remote hosts.
srname optional string, default is "sr" Name of the remote daemon executable.

Description

The tunnel module establishes a connection over the requested transport to a remote host to execute a check module there. The transport must be configured appropriately to allow automatic command executions before this module will work, see the documentation for the Remote Daemon (sr) for pointers on how to set this up. Communication is performed using a simple, text-based protocol.

The command that will be executed by the module is as follows:

$command hostname $rinstdir/sbin/$srname -m $rinstdir/mod

It may be useful to run this command by hand before installing this module to verify that the connection establishes with no prompts. Failure to do this may result in the module hanging or timing out.

Examples

  1. To execute the disk check module using the tunnel transport module to operate over ssh: 
         transport ssh {
       module tunnel {
         command   /usr/bin/ssh -l nobody
         rinstdir  /opt/survivor-remote
       }
     }

     check disk {
       module disk {}
       via ssh
     }
  2. To execute the mailq check module using the tunnel transport module to operate over ssh: 
         transport ssh {
       module tunnel {
         command   /usr/bin/ssh -l nobody
         rinstdir  /opt/survivor-remote
       }
     }

     check mailq {
       module mailq {
         warn   100
         prob   1000
       }	
       via ssh
     }
$Date: 2006/11/19 22:21:46 $
$Revision: 0.7 $
 keywords
command
rinstdir
srname