survivor: Tunnel Transport Module

SURVIVOR: `tunnel` Transport Module
About `tunnel` Dependencies Arguments Description Examples
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.
1. ### 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 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