1. Getting Started
  2. Using PuTTY
  3. Configuring PuTTY
  4. Running PuTTY on Campus Machines
  5. Frequent Problems and their Solutions

Getting Started

PuTTY is the preferred way to connect to Io since it supports the SSH protocol (which is required for Io terminal windows) and is free. Download it from here. The basic way to use it is to enter io.uwplatt.edu as the Host Name, select SSH as the Protocol, and click on Open. If this is the first time someone has logged in to Io from this machine, you'll get a Security Alert about the host key not being cached in the registry. The "server key's fingerprint" should be
    1024 cb:7c:3f:54:e2:45:3e:e9:05:04:14:bb:e5:d8:af:f8
Click on Yes. The system will then prompt you for your username (also known as your "email" name); be sure to enter it in lower case. Finally you'll see a "Password:" prompt; enter your email/netware password followed by the enter key. Remember that passwords are case-sensitive as well. The system will not echo anything back as you type in your password, and unless you configure the backspace key (see below) you'll have to press the enter key or Control-U and start over to fix mistakes.

More information about using PuTTY with io.uwplatt.edu is available here.

Using PuTTY

A common issue related to PuTTY is how to cut and paste between windows. If you hold down the mouse button and "paint" a section of text in the PuTTY window, it's automatically in the cut and paste buffer and you can insert it into another application (Word, for example) by typing that application's Paste key (for instance, Control-V). To paste into PuTTY, use Shift-Insert.

Configuring PuTTY

You can use Putty without changing any settings, but there several settings that most people find useful. Each assumes you're looking at the "PuTTY Configuration" dialog, the one that opens when you first run PuTTY. You can save these settings by clicking on Session, entering something reasonable under "Saved Sessions" such as "io", and clicking on Save. This allows you to load the settings the next time.

One way to load settings is to just start PuTTY and selected the saved session. Alternatively, you can create a shortcut to PuTTY with the Target set to

        "C:\Program Files\PuTTY\PuTTY.exe" -load io
where the path would be replaced by wherever you have saved PuTTY and "io" would be replaced by whatever session name you used earlier.

Running PuTTY on Campus Machines

The above directions work, but as you switch from computer to computer you'll discover you have to reconfigure each one. A better solution is to use a bat file to load your changes into the registry automatically. Download and extract putty-to-io.jar on your j: drive (using the command jar xf putty-to-io.jar to extract the files). You can then enter
after logging in to Netware to automatically configure your machine and then start up PuTTY to log in to io. Note that after running this command once you'll probably want to execute
to set up and save your configuration preferences. Improvements to these bat files should be sent to Dr. Hasker.

Frequent Problems and their Solutions

This list is based on things you can fix in PuTTY. You might also check the list of Unix issues to see if there's a solution to your problem there.

Other tools