FutureQuest, Inc. FutureQuest, Inc. FutureQuest, Inc.
Knowledgebase
Connecting with PuTTY
Posted on 26 July 2007 06:48 AM
PuTTY is a client program for Windows that will allow you to establish an SSH connection to the FutureQuest server in order to work in the shell environment at the command line.

This guide is based on PuTTY release version .58 and covers only the basics of configuring PuTTY to access your FutureQuest account via SSH. For further details on using PuTTY, please see the PuTTY documentation page at:
http://www.chiark.greenend.org.uk/~sgtatham/putty/docs.html

 

If you haven't done so already, you'll need to download PuTTY and install it on your computer:
http://www.chiark.greenend.org.uk/~sgtatham/putty/download.html

Now that you have PuTTY installed on your computer, let's get started with entering the settings you'll need to use in order to connect with your FutureQuest account space.

When you open PuTTY, you should be viewing the Session screen (see below).

You'll need to enter your domain name in the Host Name field (in our example above, we used example.com). Note: This is just your domain name, do not include the http or www. part. (If your site is not yet pointed at FutureQuest, you'll need to use your dedicated IP address. Refer to your Activation Letter.)

For SSH, the Port setting should be set to 22 with SSH selected as the Protocol.

You can simply click the Open button now and PuTTY will attempt a connection to your site and you will be prompted for your account username and password. But continue along and we'll lead you through the process of entering and saving your settings so that they can be re-used for future connections.

To have PuTTY remember your username so that it will automatically be entered for you when connecting to your site, click on Data which is under the Connection category. At the top of the screen, you should see Auto-login username. Just enter your account username there. This is the same username that you use to access your CNC.

Now, go back to the Session screen and you should see Saved Sessions. In the box under it, enter a descriptive name that will remind you what the connection is for (our example below just uses "my site") and click Save.

You should now see "my site" listed under Default Settings (see image below). This will allow you to simply open PuTTY in the future, choose the "my site" session, and click Open. PuTTY will have the domain name, username, and any other special selections saved for you. You'll just need to enter the password.

If you don't wish to have to enter the password either, you can have the login authorization done with keys instead. For more information on this, please see:
Key Authentication with PuTTY

Not having to type in your account username and password each time you connect can help you avoid having your IP blocked for erroneous login attempts (see Cannot access services for my account).

NOTE: The first time you initiate a SSH connection, you will see a "Warning" window stating that the host key is not cached in the registry. Selecting "OK" will allow you to continue with the connection process and add the host key. The host key is a means to identify that you are connecting to the intended server. You should only need to do this once.

If you're not familiar with working via the command line, the following reference guide should help you to get started:
Common Unix/Linux Commands Used Via SSH

Additional assistance with using SSH or PuTTY is made available in the FutureQuest Community Forums:
http://www.AOTA.net/Forums/