Skip to end of metadata
Go to start of metadata

Contents

Introduction

RUSS can be built and installed from source (root not needed) or installed from pre-built packages (as root). However full functionality will require installation to the system directories.

Installation

Download pre-built package from:

https://bitbucket.org/russng/russng/downloads

For Ubuntu and Debian systems:

dpkg -i russng_6.5-ubuntu-16.04_amd64.deb

For RedHat systems:

rpm -i russng-6.5-rhel.7.x86_64.rpm

Configuration

RUSS comes with a set of standard servers and sample configurations that can typically be copied in place without any modification:

cd /etc/russ/samples/conf
cp debug.conf exec.conf ssh.conf sshr.conf tee.conf /etc/russ/conf

Copy PAM support into place:

cd /etc/russ/samples/pam.d
cp russexec /etc/pam.d

Start all servers:

ruservice . restart

Test

For status of all servers:

ruservice status

Execute service:

ruexec +/debug/daytime

Echo to stdout:

echo "hi" | ruexec +/debug/echo

Generate exit value:

ruexec +/debug/exit 5
echo $? 

Show help:

ruhelp +/debug

List services:

ruls +/debug

List all "system" servers:

ruls +

If you've got your ssh configuration set up to not require interaction (i.e., for a password/passphrase or to check host keys):

ruexec +/ssh/localhost/+/exec/shell "hostname; whoami"

If it all works, you're ready!