Ruby

SSH Execute Remote Commands

Demonstrates running several commands on an SSH server using QuickCommand, which performs the entire open-channel, exec, receive, and retrieve sequence in a single call and returns the command's stdout.

Background: QuickCommand is the simplest way to run one-off commands: each call uses its own session channel on the same authenticated connection, so several commands can be issued in sequence without managing channels yourself. Because no PTY is involved the output is clean, with no prompt or echoed input to strip. Reach for the individual channel methods only when you need stderr separately, the exit status, or a long-lived interactive session.

Chilkat Ruby Downloads

Download Chilkat for Ruby

Ruby

require 'chilkat'

success = false

#  This example requires the Chilkat API to have been previously unlocked.
#  See Global Unlock Sample for sample code.

#  Demonstrates running several commands on an SSH server using QuickCommand, which handles the
#  whole open-channel, exec, receive, and retrieve sequence in a single call.

ssh = Chilkat::CkSsh.new()

port = 22
success = ssh.Connect("ssh.example.com",port)
if (success == false)
    print ssh.lastErrorText() + "\n";
    exit
end

#  Normally you would not hard-code the password in source.  You should instead obtain it
#  from an interactive prompt, environment variable, or a secrets vault.
password = "mySshPassword"

success = ssh.AuthenticatePw("mySshLogin",password)
if (success == false)
    print ssh.lastErrorText() + "\n";
    exit
end

#  Each QuickCommand call runs one command on its own session channel and returns its stdout.
strOutput = ssh.quickCommand("df","utf-8")
if (ssh.get_LastMethodSuccess() == false)
    print ssh.lastErrorText() + "\n";
    exit
end

print "---- df ----" + "\n";
print strOutput + "\n";

strOutput = ssh.quickCommand("echo hello world","utf-8")
if (ssh.get_LastMethodSuccess() == false)
    print ssh.lastErrorText() + "\n";
    exit
end

print "---- echo hello world ----" + "\n";
print strOutput + "\n";

strOutput = ssh.quickCommand("date","utf-8")
if (ssh.get_LastMethodSuccess() == false)
    print ssh.lastErrorText() + "\n";
    exit
end

print "---- date ----" + "\n";
print strOutput + "\n";

ssh.Disconnect()