Skip to content
Snippets Groups Projects
putty.md 4.26 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

David Hrbáč's avatar
David Hrbáč 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

David Hrbáč's avatar
David Hrbáč 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

David Hrbáč's avatar
David Hrbáč 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

David Hrbáč's avatar
David Hrbáč 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

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

David Hrbáč's avatar
David Hrbáč 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.

David Hrbáč's avatar
David Hrbáč 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.

David Hrbáč's avatar
David Hrbáč 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.

David Hrbáč's avatar
David Hrbáč committed
-   Start with _Generate_ button.
Pavel Jirásek's avatar
Pavel Jirásek committed

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

David Hrbáč's avatar
David Hrbáč committed
-   Generate some randomness.
Pavel Jirásek's avatar
Pavel Jirásek committed

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

David Hrbáč's avatar
David Hrbáč committed
-   Wait.
Pavel Jirásek's avatar
Pavel Jirásek committed

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

David Hrbáč's avatar
David Hrbáč committed
-   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.
Pavel Jirásek's avatar
Pavel Jirásek committed

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

David Hrbáč's avatar
David Hrbáč committed
-   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.
Pavel Jirásek's avatar
Pavel Jirásek committed

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

David Hrbáč's avatar
David Hrbáč 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)

David Hrbáč's avatar
David Hrbáč committed
-   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/).