TPA - PuTTY Configuration guide
===============================

In order to use PuTTY under Windows to connect via ssh to the AWS
instances that were created by the TPA utility **tpaexecprovision** ,
the keys will need to be converted from the private key format (.pem)
generated by Amazon EC2 to the PuTTY format (.ppk).

::

   #  Provision the cluster

   [tpa]$ tpaexec provision <clustername>

**PuTTY** has a tool named **PuTTYgen** , which can convert keys to the
required format.

--------------

Key conversion
--------------

**Locateprivatekey**

Locate the private key in the cluster directory ``<clustername>`` - it
will be named according to the **cluster_name** variable set in
**config.yml** prefixed by **id\_** - e.g. if the cluster_name is set to
**testenv1** , then the private key will be called **id_testenv1** .

**Savekeyas.pem**

Copy this file into your Windows filesystem & save it as a .pem file -
in this example **id_testenv1.pem** - cut and pasting into a text file
will work fine for this.

**Keyconversion**

Start **PuTTYgen** and under Parameters, select appropriate Type of key
to generate:

For older versions of **PuTTYgen** , select **SSH-2RSA** ; for recent
versions select **RSA**

*DonotselectSSH-1(RSA)*

Now choose **Load** - in the box that says
**PuTTYPrivateKeyFiles(\*.ppk)** you will need to select
**AllFiles(\*.\*)**

Select your **.pem** file and choose **Open** , then click **OK** .

Select **Saveprivatekey** and click **Yes** to ignore the warning about
saving the key without a passphrase. Make sure that the file suffix is
**.ppk** and choose the same name as for the **.pem** file; in this
example the filename might be **id_testenv1.ppk**

--------------

**ConfigurePuTTY**
------------------

Start **PuTTY** and select **Session** from the **Category** window. In
the **HostName** panel, enter ``<user>@<IP address>`` and in the Port
Panel, enter **22**

The ``<user>`` and ``<IP address>`` can be found in the
``<clustername>/ssh_config`` file which gets created by the
**``tpaexecprovision``** utility.

In the Putty **Category** window, Select **Connection** , expand **SSH**
and select **Auth**

For the panel marked **Privatekeyfileforauthentication** ,click*\*
Browse **andselectthe.ppkfilethatwassavedabove,thenselect** Open*\*

In the Putty **Category** window, select **Session** again, enter a
session name in **SavedSessions** , and **Save**

You should now be able to connect to the AWS host via PuTTY by selecting
this saved session.

--------------