Installing SSH 3.22
SSH Secure Shell for Workstations has 2 components: the secure Shell Client and the secure File Transfer Client. These programs encrypt all data passing between the PC and the remote machine, including passwords. SSH has become the de facto standard for secure logins.
The SSH client does not have any special hardware or software requirements. SSH client is compatible with any computer running Microsoft Windows XP, Windows Vista, and Windows 7.
The default installation will take about 12 megabytes of disk space.
Installing the SSH package
- SSH can be downloaded from the ITS Supported Software page. When downloading the installation file, save it on the Desktop for easy access.
- Exit from all other programs before installing the SSH package.
- When download is completed, go to the Desktop and open the installation file.
The SSH SetupWizard will start. Click Next.
- The SSH License Agreement screen will come up. Click Yes to accept these terms. Click No to decline.
The SetupWizard will now prompt you to select the installation folder. Click Next to accept the default location or Browse to define a different folder.
The SetupWizard will now prompt you to add a Program Folder into which it will place the SSH program icons. Click Next to accept the default or rename to your preference.
The SetupWizard prompts you to select which components to install. By default it will install everything. Click Next to accept the default or choose components as needed.
- The SetupWizard prompts you to confirm the installation settings. Click Next to accept it or click Back to make changes.
The SetupWizard will now install SSH onto your computer.
Click Finish to complete the installation.
Starting the Programs
After the installation, you will find two new icons on your desktop: one for SSH Secure Shell Client and one for SSH Secure File Transfer Client. To start one of these programs, double-click the appropriate icon on the desktop.
Now, to connect to a remote computer, click the Quick Connect button on the tool bar in the program window.
The Connect to Remote Host window will appear.
The first time you connect to a new Host, you will receive a Host Identification message informing you that an encryption key for this remote machine is being created. Click Yes to accept this key and continue.
Type in a Host name (for example: uhunix.hawaii.edu) and your UH Username. Do not change the Port Number or Authentication Method. Click Connect.
- You are now prompted for your UH password. Enter it and click OK. You are now able to use the programs.
(Optional) The Add Profiles window will appear. Type a name for this profile (It is a good idea to name the profile something like "UHUNIX"). Click Add the Current Connection to Profiles.
You have now saved your choice of remote Host (e.g.: uhunix.hawaii.edu) and your UH Username (e.g.: joesmith) as a profile (perhaps named "UHUNIX").
From now on, when you start the program, you can click the Profiles button and select the profile you just created. All the configuration information will be recalled and you will then be prompted for your UH password.
You can create many different profiles, each of which could have different combination of host name, user name, fonts, keyboard layouts, colors, etc.
Note: To make a secure connection using SSH, you must connect to a machine running the SSH server, such as uhunix.hawaii.edu. If you try to use the SSH client to connect to a machine not running SSH server, you will not be able to make a secure connection.
Both the Shell Client and the File Transfer Client use Host profiles. These instructions also apply to both programs. You go through the same steps for each: connecting to the remote Host, creating a profile with a Host name and a user name, save the profile, etc. The File Transfer Client will be covered more in detail later in this document.
Using the Shell Client
If you followed the steps above using the Shell Client and entered your UH password, you should now be logged into your UHUNIX account. You can use all unix commands in SSH Shell Client. For example, you can type pine and press enter on the keyboard to use the Alpine email client.
The Secure Shell window has a toolbar with several buttons. If you are not certain what a button does, move the mouse over the button for a few seconds and a short description of the button will appear. It is good practice to familiarize yourself with the different functions of the program.
Hint: If someone mails you the URL to a website, just click on the text of that URL and SSH will automatically open a web browser to that site.
Note to Alpine/Gpine users: This version of the SSH Secure Shell Client does allow you to print to a locally attached printer from Alpine/Gpine.
When you finish using your session, log out as you normally would (by typing logout) and close the Shell Client.
Using the File Transfer Client
The SSH Secure File Transfer program allows you to transfer files between your local machine and the remote machine quickly, easily and securely. The graphical user interface is very similar to the Microsoft Windows Explorer. For example, you can cut files and folders from your PC and paste to the remote machine, or from remote machine to PC. You can also open a file (like a MS Word document) on a remote machine by simple clicking on it (you do not have to download it to work with it).
How to start SSH Secure File Transfer
To Start SSH Secure File Transfer and connect to a remote machine, follow the procedure described in Starting the Programs.
After you open the File Transfer Client and login to the remote machine, you will see a familiar graphical user interface, similar to the Microsoft Windows Explorer. The screen is split in half: the left pane shows the content of the local computer, while the right shows the content of the remote computer. You can use it like Windows Explorer for most functions you can delete, copy, or rename files and folders on the remote machine the same way you do it in Windows Explorer.
Simple Uploading and Downloading
The File Transfer Client window has a toolbar with several buttons. If you are not certain what a button does, move the mouse over the button for a few seconds and a short description of the button will appear. It is good practice to familiarize yourself with the different functions of the program.
You can use the File Transfer Client the same way you move files in Windows Explorer. To upload files from the PC to the remote machine, first open the folder on the remote machine (left pane) to specify where to upload the files. Next open the folder that contains the files on your PC. To transfer the files, you can just drag and drop the files from the PC to the remote machine, just as if you were copying files between two folders in Windows Explorer.
To download files from the remote machine to your PC, you can follow the same procedure as above just drag and drop files from the remote machine to your PC. This method can be used to transfer folders as well as individual files.
Important note: The program attempts to automatically detect whether the files should be transferred as ASCII or as Binary. When in doubt, the program transfers files as ASCII. If you want to force the program to transfer a file as ASCII, click the ASCII button on the toolbar (the toolbar is pictured above). If you want to force the program to transfer a file as Binary, click the Binary button on the toolbar. If you want the program to automatically determine whether the file should be transferred as ASCII or Binary, click the AUTO button on the toolbar.
Note that ASCII files are simple text files, while Binary files are usually executable files, or MS Office files formatted with MS Word, Excel, or PowerPoint.
There are a few small differences between the SSH File Transfer Client and the Windows Explorer:
- On the remote machine, you can only delete empty folders, not folders that still contain files. Delete or move the files in the folder first before deleting the folder.
- In Windows, you can paste the same file to a folder several times (and get new file names like "Copy of Resume.doc".) With the File Transfer Client, file names are not changed during the paste operation on the remote machine. Be careful not to over-write a file you want to keep.
- If you want others to be able to view a document you upload to your UNIX account, you will need to right-click on the uploaded file and click on Properties. Then click the appropriate privileges for the Owner (you), Group, and Others (everyone not in your group). Click the OK button when you are finished.
To end your file transfer session and disconnect from the remote machine, click the Disconnect button in the File Transfer Client toolbar (an icon of a PC with a slash through it). To open a transfer session again, click on the Connect button (an icon of a PC). The icons are circled in red in the picture below.
Note: The Shell Client and the File Transfer Client are very tightly integrated programs. You can open the File Transfer Client from within the Shell Client and vice versa by clicking the appropriate buttons on the toolbar (which look like the icons on the desktop, they are circled in green in picture above).
Un-Installing the SSH package
The SSH Security Shell can be uninstalled using the Programs control panel. Select: Start --> Control Panel --> Programs (labelled "Add/Remove Programs" in Windows XP). Select SSH Secure Shell and click Change / Remove. Then select Remove, then click Next. SSH should no longer be listed in programs or installed on your machine. Restart your PC to finalize the uninstallation.