ssh-pdf

Using SSH/SFTP Secure Shell Client on Windows

This document contains the following sections:

• Introduction
• Connecting Remotely with SSH
• Transferring Files
• Profiles: Creating & Editing

For information related to this topic refer to:

• Fetch (http://www.cmu.edu/computingdoc/software/fetch/index.html)
• Fugu SFTP (http://www.cmu.edu/computingdoc/software/fugu/index.html)
• Terminal (http://www.cmu.edu/computingdoc/software/terminal/index.html)

Note: This application has an extensive help file. Refer to this online help for detailed
instructions on using the program. For more information, visit the SSH Communications
Security website: http://www.ssh.com (http://www.ssh.com) .
Last Updated: 11/05/08

-1-
 ssh-pdf

Introduction
SSH/SFTP Secure Shell Client (version 3.3.2), is a secure network connection system
that provides an alternative method to establish an encrypted connection to a remote
machine. It also provides a secure file transfer program that transfers files from your
local machine to a remote machine or server.
Please Note: The sftp protocol makes a terminal connection to the remote server
to perform the file transfer. Therefore, any unexpected output from the users default
shell or login scripts may cause sftp to exit with errors. If you experience trouble
connecting with sftp, examine your .login and/or .cshrc files, or send an email to Advisor
(mailto:advisor@andrew.cmu.edu) including the error messages you recieved and the
contents of your .login and .cshrc files.
If you do not have SSH Secure Shell, you can download a copy from the Software
download (http://www.cmu.edu/computingsoftware/all/index.html) web page.
Complete these steps to download SSH Secure Shell:

1. From the My Accounts tab of the Carnegie Mellon Web Portal, select the
Alphabetical link under Software and then select SSH Communications
Security from the list.
2. Follow the instructions provided to download and install SSH for your operating
system.

Last Updated: 6/3/09

-2-
 ssh-pdf

Using SSH to Connect Remotely on Windows

Computing Services supports the use of the SSH.com Secure Shell client on Windows.
Its graphic interface follows most of the standard Windows Explorer conventions, such
as drag-and-drop for copying files from one drive to another, right-clicking on an item to
generate a menu of options, and left-clicking a selected item to edit the item’s label.
Follow these instructions to use SSH to connect remotely on a Windows Machine:

1.

Launch the Secure Shell program. The SSH Secure Shell window is
displayed.
2. Select File > Quick Connect or click on the Quick Connect button.
The Connect to Remote Host dialog box is displayed.

3. In the Host Name field, enter the name or address of the Server you want to
connect to.
Note: SSH and SFTP will work with any standard Andrew UNIX host,
including the unix.andrew pool of machines. Special purpose machines (like
staging.andrew.cmu.edu) may not have SSH and SFTP enabled.

-3-
 ssh-pdf

4. Enter your User ID and click Connect.

You will be connected to the specified server.
Note: If this is the first time you are connecting to a host name, a Profile Name
dialog box appears. This dialog box allows you to store the connection information
under an assigned name for easy selection during future sessions. The dialog box
disappears after entering a name or continuing.

5. To end your session, select File > Disconnect or click on the Disconnect icon.
The Confirm Disconnect dialog box is displayed.

-4-
 ssh-pdf

Note: If you do not want the Confirm Disconnect dialog box to appear each time
you exit Secure Shell, click in the box next to Remember my answer.
6. Click OK.
7. Select File > Exit to close the Secure Shell window.

-5-
 ssh-pdf

Using SFTP to Transfer Files on Windows

SFTP is set up so you can connect to a remote server simply by entering the name of
the server, or its Internet address in the Hostname field of the Open Connection dialog
box. The SSH window displays two Explorer-type subwindows: one for the Local Drives
and one for the connected FTP directory. Files and directories can be dragged from one
view and dropped on a target directory in the other, in order to generate standard FTP
transfer operations.
Note: Computing Services also provides support for the Unix (http://www.openssh.com)
and Macintosh OSX (http://www.cmu.edu/computingdoc/software/fugu/index.html)
platforms.
Follow these steps to use SFTP on Windows.

1.

Launch the SSH Secure File Transfer program. The SSH Secure File
Transfer window is displayed.
Note: The first time you launch SFTP, your local machine directories will be
displayed. Once you navigate to the selected directory, the path is recorded and
becomes the default location in each subsequent session. Each local directory
that you access can be added to a list and selected in future SFTP sessions by
navigating to the directory and clicking the Add button.

2. Navigate to the Local directory where the files that you want to transfer reside.
3. Click on Quick Connect.
The Connect to Remote Host dialog box is displayed.

-6-
 ssh-pdf

4. Enter the name of the server in the Host Name field. Enter your Andrew user ID in
the User Name field and click Connect.
Note: SFTP and SSH will work with any standard Andrew UNIX host,
including the unix.andrew pool of machines. Special purpose machines (like
staging.andrew.cmu.edu) may not have SSH and SFTP enabled.
A password dialog box is displayed.

5. Enter your Andrew password and click OK.

Note: If you are connecting to a new Host Name, the Host Identification dialog box
is displayed. Click Yes to save the host key to the local database and dismiss the
message box.

-7-
 ssh-pdf

The SFTP window is displayed with the selected remote host directory.

Note: When connecting to a host, a Profile Name dialog box appears. This dialog
box allows you to store the connection information under an assigned name for
easy selection during future sessions. The dialog box disappears after staying idle
for a few seconds.
6. Select the file(s) to be transferred by clicking and dragging each to the respective
location.
Note: Select the Transfer View tab to review the transfers you've made during the
current session.

7. To end your session, select File > Disconnect or click on the Disconnect icon

.
-8-
 ssh-pdf

The Confirm Disconnect dialog box is displayed.

Note: If you do not want the Confirm Disconnect dialog box to appear each time
you exit SFTP, click in the box next to Remember my answer.
8. Click OK.
9. Select File > Exit to close the Secure Shell window.

Transfer Files from Another's AFS Space

To transfer files from another user's home directory (AFS space) on
unix.andrew.cmu.edu, follow these steps:

1. Launch SFTP.
2. Click Quick Connect and in the Connect to Remote Host dialog box, type
unix.andrew.cmu.edu.
3. Click Connect and enter your password when prompted.

4. Next, enter the path to the person's home directory

in the text field:
/afs/andrew/cmu.edu/

usr/AndrewUserID.
5. Follow the steps (above) to transfer file(s) to your local computer. Be default, the
public folder is readable by all Andrew users. Use this folder when sharing files.
-9-
 ssh-pdf

Note: Each user can set access rights for their AFS space. You
may or may not have access to read other folders in this space.
For more information on access rights, see the Protection Rights
(http://www.cmu.edu/computingdoc/unix/pts-groups/protect-rights.html) section of
the Unix documentation.
Last Updated: 02/20/09

- 10 -
 ssh-pdf

SSH Profiles
Profiles are created to aid in connecting to servers. In other software applications,
"profiles" would be known as "favorites" or "shortcuts".

Creating a Profile
1. Open the SSH Secure Shell Client application.
2. Under the File menu, select Profiles > Add Profile.

3. Type a name for your profile into the text field (for example, Unix) and select Add
to Profiles.

4. Under the Profiles folder icon, select the name of the profile you just added.

- 11 -
 ssh-pdf

5. Enter the host name information (such as “unix.andrew.cmu.edu”) and your userID.
Under Authentication Method, select Password.

6. Select Connect. Enter your password when prompted.

7. The profile is now available under the Profiles folder icon.

Editing a Profile
1. Open the SSH Secure Shell Client application.
2. Under the File menu, select Profiles > Edit Profile.

- 12 -
 ssh-pdf

3. Select the name of the profile you want to edit (i.e., Unix).
4. Under the Connection tab, select and edit the information.

5. Select OK.
- 13 -