This is a step-by-step illustration of the configuration of SSH. If you have not installed the files to your computer, please see SSH Departmental Downloads to download the self-extracting file for your department that will install all files to your C: drive. You need to make sure that the file you linked with a shortcut to your desktop is ttssh.exe. This is the one for which the illustrations and instructions are designed.
To configure TTSSH.EXE, click on your shortcut to TTSSH to start.
Figure 1. New Connection window
When you open SSH, this is first screen you will see. (Note this is for the Arts & Sciences download. The name for Host will differ depending on the download.) In order to configure SSH, hit the ESC key. This will give you access to the menu bar. Click on Setup on this menu bar, to start your configuration.
Figure 2. "Setup | Font".
If your SSH window size is too small or too large, click on Setup | Font, and change to a larger or smaller font. This will increase or decrease the window size accordingly. Set font to give you desired window size.
Figure 3. "SETUP | SSH Authentication".
FOR WS-FTP CLIENT
CONFIGURATION
These settings are for the FTP client WS-FTP. They are from the
WS-FTP version 5.08, but remain similar regardless of client or version.
The important issues are to make sure the HOST NAME is completed as "localhost",
and that "Passive transfers" is chosen as the option for file transfer.
Whatever your client, these two options still are asked for as variables.
PEGASUS MAIL and EUDORA
For instructions on configuring IMAP for Pegasus Mail see Configuring Pegasus 3.x for IMAP.
For instructions on configuring IMAP for Eudora see Configuring Eudora 4.32 for IMAP.
This step is optional, though useful if you are the only user. Add
your user name, (login name), and click OK.
Figure 4. "Setup | SSH Forwarding".
This is the finished screen for the Arts & Sciences download configurations. From here, you can add a new "tunnel", if needed by clicking Add. Or, if the departmental defaults do not fit your needs, you can edit an existing tunnel by clicking Edit. These "tunneling" steps are necessary; they permit your other software to send and receive data via your Secure hookup to the server via SSH.
Figure 5. "Setup | TCP/IP".
Clicking on "Setup | TCP/IP" permits you to add addresses for the sites to which you want to attach. These permit you to open secure telnet sessions with these sites, assuming they are running SSH.
NOTE: If you want to use the connections for tunneling of IMAP, POP3, or FTP, only ONE of these sites can be configured to function at a time. ie), you cannot connect to "trinity", and then use tunneling to ACPUB. To do this, create and save multiple "ini" files, such as "econ.ini", or "acpub.ini". Figures 6, 7 and 8 address this issue.
Figure 6. Adding or Editing IMAP and FTP tunnels.
Clicking Edit from the window in Figure 4 will display this window, for the tunnel selected and allow you to change the server information for that specific tunnel. Clicking Add from the Figure 4 window will show the same window, only blank. To add an IMAP TUNNEL (in this case, for ACPUB), type imap into the "forward local port", or select from the scrolldown menu. Type in your server address (mail-xx.acpub.duke.edu for ACPUB, where the "xx" stands for the first two letters of your ACPUB email address), and repeat the port assignment as shown. Then add a port for smtp (usually the same address as your imap server, except smtp.duke.edu for ACPUB). When done, click on OK. If done correctly, these "tunnels" will show up as in Figure 4. To setup an FTP TUNNEL, repeat this process for ftp and for ftp-data.
Figure 7 Saving an Alternate Setup.
Once the tunnels have been configured, save the setup using Setup | Save setup. This will bring up the above window. The downloaded defaults for your department will be in Teraterm.ini. This setup will always start initially, so it is best to save your configurations for the most frequently used settings in Teraterm.ini. Save other tunnels and setups in a different .ini file, such as ACPUB.INI. Type the new filename, and click Save.
Figure 8 Opening an Alternate Setup.
If you want to connect to alternate sites with tunneling enabled, you need to restore the stored configurations, or .ini files. This window is under "Setup | Restore setup". Any alternates, such as to ACPUB, are named as you see here. To restore them, select the appropriate "ini" file, and click on OPEN. Your settings will now be for the alternate site, (such as ACPUB in this case).
Figure 9 HOST = LOCALHOST.
To use WS-FTP with tunnelling, first open SSH and connect to the server using the appropriate .ini file. Then open WS-FTP, click Connect and enter the above configuration. Note "Host Name" equals "localhost".
Figure 10 Passive Transfers.
To complete the WS-FTP profile for use in combination with SSH, you need to click on Advanced, (see figure 9), and make sure to check Passive transfers. Then click OK to begin connecting to the FTP server via the SSH tunnel.
If you have questions, please send mail to
help@aas.duke.edu.
Back to A&S Software page
Last Updated on 4/5/2000
By jbo