Skip to content
Snippets Groups Projects
putty.md 4.19 KiB
Newer Older
David Hrbáč's avatar
David Hrbáč committed
# PuTTY (Windows)
Lukáš Krupčík's avatar
Lukáš Krupčík committed

Lukáš Krupčík's avatar
Lukáš Krupčík committed
## Windows PuTTY Installer
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"
Lukáš Krupčík's avatar
Lukáš Krupčík committed
    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

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
* 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

Lukáš Krupčík's avatar
Lukáš Krupčík committed
* Category - Connection -  SSH - Auth:
Lukáš Krupčík's avatar
Lukáš Krupčík committed
    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

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

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

Lukáš Krupčík's avatar
Lukáš Krupčík 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

Lukáš Krupčík's avatar
Lukáš Krupčík committed
## Another PuTTY Settings
Lukáš Krupčík's avatar
Lukáš Krupčík committed

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.
Lukáš Krupčík's avatar
Lukáš Krupčík committed
## Pageant SSH agent
Pavel Jirásek's avatar
Pavel Jirásek committed

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

Lukáš Krupčík's avatar
Lukáš Krupčík committed
* 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.
Pavel Jirásek's avatar
Pavel Jirásek committed

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

Lukáš Krupčík's avatar
Lukáš Krupčík committed
## PuTTY key generator
Pavel Jirásek's avatar
Pavel Jirásek committed

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.

Lukáš Krupčík's avatar
Lukáš Krupčík committed
* 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.
Pavel Jirásek's avatar
Pavel Jirásek committed

![](../../../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.

Lukáš Krupčík's avatar
Lukáš Krupčík committed
* Start with *Generate* button.
Pavel Jirásek's avatar
Pavel Jirásek committed

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

Lukáš Krupčík's avatar
Lukáš Krupčík committed
* Generate some randomness.
Pavel Jirásek's avatar
Pavel Jirásek committed

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

Lukáš Krupčík's avatar
Lukáš Krupčík committed
* Wait.
Pavel Jirásek's avatar
Pavel Jirásek committed

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

Lukáš Krupčík's avatar
Lukáš Krupčík committed
* Enter a *comment* for your key using format 'username@organization.example.com'.
Pavel Jirásek's avatar
Pavel Jirásek committed
    Enter key passphrase.
    Confirm key passphrase.
Lukáš Krupčík's avatar
Lukáš Krupčík committed
    Save your new private key in "*.ppk" format with *Save private key* button.
Pavel Jirásek's avatar
Pavel Jirásek committed

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

Lukáš Krupčík's avatar
Lukáš Krupčík committed
* Save the public key with *Save public key* button.
Pavel Jirásek's avatar
Pavel Jirásek committed
    You can copy public key out of the ‘Public key for pasting into authorized_keys file’ box.

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

Lukáš Krupčík's avatar
Lukáš Krupčík committed
* Export private key in OpenSSH format "id_rsa" using Conversion - Export OpenSSH key
Pavel Jirásek's avatar
Pavel Jirásek committed

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

Lukáš Krupčík's avatar
Lukáš Krupčík committed
* Now you can insert additional public key into authorized_keys file for authentication with your own private key.
Pavel Jirásek's avatar
Pavel Jirásek committed
    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/).