How to install and configure Putty

Installation/Upgrade

1. Navigate ot p:\release\public\putty\current
2. Double click on the installer (e.g. putty-[versin]-installer.exe)

If you don't have P drive mapped, please map the drive first. The path is \\importpc\imppc-apps\ .
Accept the default to allow the installer to install in the C:Program Files\Putty directory including the following binaries. It also creates the program menu in Start button.
• PuTTY (the Telnet and SSH client itself)
• PSCP (an SCP client, i.e. command-line secure file copy)
• PSFTP (an SFTP client, i.e. general file transfer sessions much like FTP)
• Plink (a command-line interface to the PuTTY back ends)
• Pageant (an SSH authentication agent for PuTTY, PSCP and Plink)
• PuTTYgen (an RSA key generation utility).

Uninstall

The default location for PuTTy is c:\program files\putty. If you wish, you can just delete the whole subdirectory.

How to run PuTTY (terminal logon)

1. Go to Start menu -> Programs -> SSH-client -> Putty . A "PuTTY Configuration" window appears.
2. Fill in the hostname you want to login and check "SSH" for protocol.
3. Click "Open" button on the bottom. A terminal window appears and you can proceed to login. If you connect the server first time, another pop-up window appears and ask you if you want to cache the host key. Answer "Yes" or "No".

Tunneling

• X11
  1. You are supposed to be running X server such as Exceed before starting ssh session.
  2. Run Putty.exe. In "PuTTY Configuration" window, in the "Category" section on the left, go to Connection > SSH > Tunnels on the bottom.
  3. Check the box marked "Enable X11 forwarding". When this box is checked, the remote server will arrange to set your DISPLAY variable to something that will cause the X protocol to travel over your SSH connection; do not set the variable yourself!
  4. Click "Session" in "Category" section on the left, logon to sshgate. You can now run X applications on sshgate itself. If you want to run X apps on some other Sun at PARC, simply ssh to the other machine (our Unix-based ssh automatically does the X forwarding for you). Again, don't set the DISPLAY variable yourself
• HTTP
  You can make your PC's web client use the PARC proxy server to get to PARC internal web pages from outside PARC:
  1. In your web browser, tell it to use a proxy of localhost port 8000 (or whatever local port you picked). In Firefox, this is Tools | Options | Advanced | Network | Connection | Settings | Manual proxy configuration; in IE, it's Tools | Internet Options | Connections, then click the Settings button for whatever connection you're using.
  2. Run Putty.exe. In "PuTTY Configuration" window, in the "Category" section on the left, click "tunnels" on the bottom.
  3. In the "Port forwarding" section, check the box marked "Local" on the bottom. Type " 8000 " in "Source port", and type " wwwproxy1.parc.xerox.com:8000 " in "Destination". Click "Add" button. A line showing the new port forwarding setup appears in the field above.
  4. Click "Session" in "Category" section on the left, logon to sshgate.
  5. Access a web server from the browser.

  Here is a detailed example of how to configure SSH HTTP forwarding.

  Unlike with the X setting, you can set up your browser for port forwarding after you've opened a ssh connection to sshgate.

How to use PSCP (Secure file copy)

1. If you want to copy file1 in C:\tmp to your home directory on sshgate, the command would be like this;
   
   > pscp C:\tmp\file1 yourname@sshgate.parc.com:/tilde/yourname/
   
   
2. If you want to copy file2 on sshgate to your PC's current directory (.), the command would be like this;
   
   > pscp yourname@sshgate.parc.com:/tilde/yourname/file2 .

Setting your Path