Linux comes with command-line tools for both SSH (running commands) and SCP (transferring files) and is usually already running an X11 server used for the display of remote graphical applications.

To connect to the cluster using the built-in SSH client, open the terminal application, and type the following:

$ ssh [email protected]

You should replace "username" with your UT !NetID. The SSH client may ask whether or not you want to accept the remote host's encryption key (say yes). When prompted, input your UT !NetID password.

Once connected, return to reading the GettingStarted page.

Your system comes with a command-line client for transferring files between your desktop and the cluster. The client uses the same SSH protocol that is used for command-line access. Also run this client from the Terminal application. In this example, we will transfer a test file (Test.txt) from our desktop to the cluster:

$ ls Test.txt
Test.txt
$ scp Test.txt [email protected]:~/

If you need to download a file from a remote system to the cluster, it is faster to do the transfer directly using the scp (for transfers from an SSH server) or wget (for transfers from a website) commands on the cluster.

A X11 server application running on your desktop is needed in order to run graphical programs on the cluster. If the Linux desktop that you are using is currently running in graphical mode, then you are most likely already running an X11 server. You will also need to configure the SSH client to tunnel X11 connections back to your desktop. You can do this by adding the "-X" option to the command-line client:

$ ssh -X [email protected]

When you connect to login.icl.utk.edu, the variable $DISPLAY will automatically be set to the correct value. You may verify this (though the number will likely differ from this example):

$ echo $DISPLAY
localhost:29.0

You can then test that graphics will work by running a simple graphical program such as "xterm".

!MacOS X comes with command-line tools for both SSH (running commands) and SCP (transferring files). It may also have come installed with an X11 server for running graphical applications on the cluster.

To connect to the cluster using the built-in SSH client, open the terminal application (located in the Applications->Utilities folder), and type the following:

$ ssh [email protected]

You should replace "username" with your UT !NetID. The SSH client may ask whether or not you want to accept the remote host's encryption key (say yes). When prompted, input your UT !NetID password.

Once connected, return to reading the GettingStarted page.

Your system comes with a command-line client for transferring files between your desktop and the cluster. The client uses the same SSH protocol that is used for command-line access. Also run this client from the !MacOS Terminal application. In this example, we will transfer a test file (Test.txt) from our desktop to the cluster:

$ ls Test.txt
Test.txt
$ scp Test.txt [email protected]:~/

If you need to download a file from a remote system to the cluster, it is faster to do the transfer directly using the scp (for transfers from an SSH server) or wget (for transfers from a website) commands on the cluster.

You need an X11 server application running on your desktop in order to run graphical programs on the cluster. If the X11 server application is currently installed on your desktop, it will be located in the Applications->Utilities folder. Otherwise, you will need to install it from one of the installation disks that came with the operation system or computer.

You will also need to configure the SSH client to tunnel X11 connections back to your desktop. You can do this by adding the "-X" option to the command-line client:

$ ssh -X [email protected]

When you connect to login.icl.utk.edu, the variable $DISPLAY will automatically be set to the correct value. You may verify this (though the number may differ from this example):

$ echo $DISPLAY
localhost:29.0

You can then test that graphics will work by running a simple graphical program such as "xterm".

Windows does not come out-of-the-box with Secure Shell client support. Therefore, you will need to install one or more. At a minimum, you will need an SSH command-line client. You may install a secure copy client in order to transfer files between your desktop and the cluster. You may also install an X11 server in order to run graphical applications on the cluster.

We recommend using the PuTTY SSH client. You simply download the executable file to your desktop and execute it directly or create a shortcut to the downloaded file. To connect to the cluster, you will need the following information:

Hostname to connect to:	login.icl.utk.edu
Your username:	your UT !NetID
Your password:	your UT !NetID password
Remote port to connect to	22

The first time you connect to a host, the SSH client may ask whether or not you want to accept the remote host's encryption key (say yes). Once connected, return to reading the GettingStarted page.

We recommend using FileZilla client for transferring files between your desktop and the cluster. The client will transfer files over the same SSH protocol that is used for command-line access. Install the program and connect using the same information as for the above SSH client. If you need to download a file from a remote system to the cluster, it is faster to do the transfer directly using the scp (for transfers from an SSH server) or wget (for transfers from a website) commands on the cluster.

We recommend using the Xming X11 server in order to run graphical programs on the cluster. When you run the program, you will see no new windows, but it should run in your system tray. You will then need to configure the SSH client to tunnel X11 connections back to your desktop. In !PuTTY, you do this by viewing the Connection->SSH->X11 page of the configuration and checking the box for "enable X11 forwarding" (make no other change). You can then go back to the "sessions" page in order to save this as the default. When you connect to login.icl.utk.edu, the variable $DISPLAY will automatically be set to the correct value. You may check it like this (though the number may differ from this example):

$ echo $DISPLAY
localhost:29.0

You can then test that graphics will work by running a simple graphical program such as "xterm".