Chapter 3.  Running Programs

Running programs on a Tycoon cluster is very much like running programs on an ordinary Linux cluster. One difference is that users log in using tycoon_ssh and copy files using tycoon_scp. Another is that users run on virtual machines rather than directly on physical machines. The virtual machines prevent users from interfering with each other and preserve privacy. These virtual machines appear to be physical machines over which the user has sole and complete control, with the caveats described in Section 3.2, “Virtual Machine Configuration”.

3.1. Accessing Virtual Machines: tycoon_ssh and tycoon_scp

Tycoon users use tycoon_ssh to log into virtual machines and tycoon_scp copy files in and out of virtual machines. Tycoon virtual machines have ssh ports that vary between virtual machines on the same physical machine. The modified versions of ssh and scp automatically compute these ports so that users do have to calculate them manually. These non-standard ports are necessary becaue the Tycoon virtual machines are NAT-ed by default. Some providing hosts can allocate IP addresses to their virtual machines, so users can use the ssh and scp commands.

The usage for tycoon_ssh is as follows:

usage: tycoon_ssh [options] [user@]hostname [command]

tycoon_ssh uses the OpenSSH ssh command to login to Tycoon host accounts on
remote resource providing hosts. In addition to those listed below, tycoon_ssh
also accepts all of the standard OpenSSH ssh options.

options:
  --config_path=CONFIG_PATH
                        Set the configuration files search path
  --debug=DEBUG         Set the debugging level
  -O OPTIONS, --options=OPTIONS
                        Set arbitrary configuration options
  -u HOSTACCOUNTNAME, --hostaccountname=HOSTACCOUNTNAME
                        Set the UNIX account name to use on the remote host(s)
  -a BANKACCOUNTNAME, --bankaccountname=BANKACCOUNTNAME
                        Set the bank account name
  --version             show program's version number and exit
  -h, --help            show this help message and exit
  --testing             configure internal testing
	

The usage for tycoon_scp is as follows:

usage: tycoon_scp [options] [[user@]host1:]file1 [...] [[user@]host2:]file2

tycoon_scp uses the OpenSSH scp command to copy files to and from Tycoon host
accounts on remote resource providing hosts. In addition to those listed
below, tycoon_scp also accepts all of the standard OpenSSH scp options.

options:
  --config_path=CONFIG_PATH
                        Set the configuration files search path
  --debug=DEBUG         Set the debugging level
  -O OPTIONS, --options=OPTIONS
                        Set arbitrary configuration options
  -u HOSTACCOUNTNAME, --hostaccountname=HOSTACCOUNTNAME
                        Set the UNIX account name to use on the remote host(s)
  -a BANKACCOUNTNAME, --bankaccountname=BANKACCOUNTNAME
                        Set the bank account name
  --version             show program's version number and exit
  -h, --help            show this help message and exit
  --testing             configure internal testing