Skip to content
Snippets Groups Projects
putty.md 4.45 KiB
Newer Older
Lukáš Krupčík's avatar
Lukáš Krupčík committed
PuTTY
Lukáš Krupčík's avatar
Lukáš Krupčík committed
=====

Lukáš Krupčík's avatar
Lukáš Krupčík committed
!!! Note "Note"
	PuTTY -  before we start SSH connection
Lukáš Krupčík's avatar
Lukáš Krupčík committed

David Hrbáč's avatar
David Hrbáč committed
Windows PuTTY Installer
Lukáš Krupčík's avatar
Lukáš Krupčík committed
-----------------------
Lukáš Krupčík's avatar
Lukáš Krupčík committed

We recommned you to download "**A Windows installer for everything except PuTTYtel**" with **Pageant** (SSH authentication agent) and **PuTTYgen** (PuTTY key generator) which is available [here](http://www.chiark.greenend.org.uk/~sgtatham/putty/download.html).
Lukáš Krupčík's avatar
Lukáš Krupčík committed

!!! Note "Note"
	After installation you can proceed directly to private keys authentication using ["Putty"](putty#putty).
    "Change Password for Existing Private Key" is optional.
    "Generate a New Public/Private key pair" is intended for users without Public/Private key in the initial email containing login credentials.
    "Pageant" is optional.
Lukáš Krupčík's avatar
Lukáš Krupčík committed

PuTTY - how to connect to the IT4Innovations cluster
Lukáš Krupčík's avatar
Lukáš Krupčík committed
----------------------------------------------------
Lukáš Krupčík's avatar
Lukáš Krupčík committed

-   Run PuTTY
David Hrbáč's avatar
David Hrbáč committed
-   Enter Host name and Save session fields with [Login address](../../../salomon/shell-and-data-access.md) and browse Connection - > SSH -> Auth menu. The *Host Name* input may be in the format **"username@clustername.it4i.cz"** so you don't have to type your login each time.In this example we will connect to the Salomon cluster using **"salomon.it4i.cz"**.
Lukáš Krupčík's avatar
Lukáš Krupčík committed

Lukáš Krupčík's avatar
Lukáš Krupčík committed
![](../../../img/PuTTY_host_Salomon.png)
Lukáš Krupčík's avatar
Lukáš Krupčík committed

-   Category -> Connection - > SSH -> Auth:
    Select Attempt authentication using Pageant.
    Select Allow agent forwarding.
    Browse and select your [private key](ssh-keys/) file.
Lukáš Krupčík's avatar
Lukáš Krupčík committed

Lukáš Krupčík's avatar
Lukáš Krupčík committed
![](../../../img/PuTTY_keyV.png)
Lukáš Krupčík's avatar
Lukáš Krupčík committed

-   Return to Session page and Save selected configuration with *Save* button.

Lukáš Krupčík's avatar
Lukáš Krupčík committed
![](../../../img/PuTTY_save_Salomon.png)
Lukáš Krupčík's avatar
Lukáš Krupčík committed

Lukáš Krupčík's avatar
Lukáš Krupčík committed
-   Now you can log in using *Open* button.
Lukáš Krupčík's avatar
Lukáš Krupčík committed

Lukáš Krupčík's avatar
Lukáš Krupčík committed
![](../../../img/PuTTY_open_Salomon.png)
Lukáš Krupčík's avatar
Lukáš Krupčík committed

David Hrbáč's avatar
David Hrbáč committed
-   Enter your username if the *Host Name* input is not in the format "username@salomon.it4i.cz".
-   Enter passphrase for selected [private key](ssh-keys/) file if Pageant **SSH authentication agent is not used.**
Lukáš Krupčík's avatar
Lukáš Krupčík committed

Another PuTTY Settings
----------------------

Lukáš Krupčík's avatar
Lukáš Krupčík committed
-   Category -> Windows -> Translation -> Remote character set and select **UTF-8**.
-   Category -> Terminal -> Features and select **Disable application keypad mode** (enable numpad)
-   Save your configuration on Session page in to Default Settings with *Save* button.
Pavel Jirásek's avatar
Pavel Jirásek committed

Pageant SSH agent
-----------------

Pageant holds your private key in memory without needing to retype a passphrase on every login.

-   Run Pageant.
-   On Pageant Key List press *Add key* and select your private key (id_rsa.ppk).
-   Enter your passphrase.
-   Now you have your private key in memory without needing to retype a passphrase on every login.

![](../../../img/PageantV.png)

PuTTY key generator
-------------------

PuTTYgen is the PuTTY key generator. You can load in an existing private key and change your passphrase or generate a new public/private key pair.

### Change Password for Existing Private Key

You can change the password of your SSH key with "PuTTY Key Generator". Make sure to backup the key.

-   Load your [private key](../shell-access-and-data-transfer/ssh-keys/) file with *Load* button.
-   Enter your current passphrase.
-   Change key passphrase.
-   Confirm key passphrase.
-   Save your private key with *Save private key* button.

![](../../../img/PuttyKeygeneratorV.png)

Pavel Jirásek's avatar
h3  
Pavel Jirásek committed
### Generate a New Public/Private key
Pavel Jirásek's avatar
Pavel Jirásek committed

You can generate an additional public/private key pair and insert public key into authorized_keys file for authentication with your own private key.

-   Start with *Generate* button.

![](../../../img/PuttyKeygenerator_001V.png)

-   Generate some randomness.

![](../../../img/PuttyKeygenerator_002V.png)

-   Wait.

![](../../../img/PuttyKeygenerator_003V.png)

-   Enter a *comment* for your key using format 'username@organization.example.com'.
    Enter key passphrase.
    Confirm key passphrase.
    Save your new private key `in "*.ppk" `format with *Save private key* button.

![](../../../img/PuttyKeygenerator_004V.png)

-   Save the public key with *Save public key* button.
    You can copy public key out of the ‘Public key for pasting into authorized_keys file’ box.

![](../../../img/PuttyKeygenerator_005V.png)

-   Export private key in OpenSSH format "id_rsa" using Conversion -> Export OpenSSH key

![](../../../img/PuttyKeygenerator_006V.png)

-   Now you can insert additional public key into authorized_keys file for authentication with your own private key.
    You must log in using ssh key received after registration. Then proceed to [How to add your own key](../shell-access-and-data-transfer/ssh-keys/).