putty.md 4.21 KB
Newer Older
David Hrbáč's avatar
David Hrbáč committed
1
# PuTTY (Windows)
Lukáš Krupčík's avatar
Lukáš Krupčík committed
2

Lukáš Krupčík's avatar
Lukáš Krupčík committed
3
## Windows PuTTY Installer
Lukáš Krupčík's avatar
Lukáš Krupčík committed
4

5
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
6

David Hrbáč's avatar
David Hrbáč committed
7
!!! note
Lukáš Krupčík's avatar
Lukáš Krupčík committed
8
    After installation you can proceed directly to private keys authentication using ["Putty"](#putty).
9

10
    "Change Password for Existing Private Key" is optional.
11

12
    "Generate a New Public/Private key pair" is intended for users without Public/Private key in the initial email containing login credentials.
13

14
    "Pageant" is optional.
Lukáš Krupčík's avatar
Lukáš Krupčík committed
15

Lukáš Krupčík's avatar
Lukáš Krupčík committed
16
## PuTTY - How to Connect to the IT4Innovations Cluster
Lukáš Krupčík's avatar
Lukáš Krupčík committed
17

Lukáš Krupčík's avatar
Lukáš Krupčík committed
18
* Run PuTTY
Lukáš Krupčík's avatar
fix  
Lukáš Krupčík committed
19
* Enter Host name and Save session fields with login address 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
20

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

Lukáš Krupčík's avatar
Lukáš Krupčík committed
23
* Category - Connection -  SSH - Auth:
David Hrbáč's avatar
David Hrbáč committed
24 25
      Select Attempt authentication using Pageant.
      Select Allow agent forwarding.
Lukáš Krupčík's avatar
Lukáš Krupčík committed
26
      Browse and select your [private key](general/accessing-the-clusters/shell-access-and-data-transfer/ssh-keys/) file.
Lukáš Krupčík's avatar
Lukáš Krupčík committed
27

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

Lukáš Krupčík's avatar
Lukáš Krupčík committed
30
* Return to Session page and Save selected configuration with _Save_ button.
Lukáš Krupčík's avatar
Lukáš Krupčík committed
31

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

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

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

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

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

Lukáš Krupčík's avatar
Lukáš Krupčík committed
43 44 45
* 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
46

David Hrbáč's avatar
David Hrbáč committed
47
## Pageant SSH Agent
Pavel Jirásek's avatar
Pavel Jirásek committed
48 49 50

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
51 52 53 54
* 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
55

Lukáš Krupčík's avatar
Lukáš Krupčík committed
56
![](../../../img/PageantV.png)
Pavel Jirásek's avatar
Pavel Jirásek committed
57

David Hrbáč's avatar
David Hrbáč committed
58
## PuTTY Key Generator
Pavel Jirásek's avatar
Pavel Jirásek committed
59 60 61 62 63 64 65

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
66
* Load your [private key](ssh-keys.md) file with _Load_ button.
Lukáš Krupčík's avatar
Lukáš Krupčík committed
67 68 69 70
* 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
71

Lukáš Krupčík's avatar
Lukáš Krupčík committed
72
![](../../../img/PuttyKeygeneratorV.png)
Pavel Jirásek's avatar
Pavel Jirásek committed
73

David Hrbáč's avatar
David Hrbáč committed
74
### Generate a New Public/Private Key
Pavel Jirásek's avatar
Pavel Jirásek committed
75 76 77

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
78
* Start with _Generate_ button.
Pavel Jirásek's avatar
Pavel Jirásek committed
79

Lukáš Krupčík's avatar
Lukáš Krupčík committed
80
![](../../../img/PuttyKeygenerator_001V.png)
Pavel Jirásek's avatar
Pavel Jirásek committed
81

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

Lukáš Krupčík's avatar
Lukáš Krupčík committed
84
![](../../../img/PuttyKeygenerator_002V.png)
Pavel Jirásek's avatar
Pavel Jirásek committed
85

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

Lukáš Krupčík's avatar
Lukáš Krupčík committed
88
![](../../../img/PuttyKeygenerator_003V.png)
Pavel Jirásek's avatar
Pavel Jirásek committed
89

Lukáš Krupčík's avatar
Lukáš Krupčík committed
90
* Enter a _comment_ for your key using format 'username@organization.example.com'.
David Hrbáč's avatar
David Hrbáč committed
91 92 93
      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
94

Lukáš Krupčík's avatar
Lukáš Krupčík committed
95
![](../../../img/PuttyKeygenerator_004V.png)
Pavel Jirásek's avatar
Pavel Jirásek committed
96

Lukáš Krupčík's avatar
Lukáš Krupčík committed
97
* Save the public key with _Save public key_ button.
David Hrbáč's avatar
David Hrbáč committed
98
      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
99

Lukáš Krupčík's avatar
Lukáš Krupčík committed
100
![](../../../img/PuttyKeygenerator_005V.png)
Pavel Jirásek's avatar
Pavel Jirásek committed
101

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

Lukáš Krupčík's avatar
Lukáš Krupčík committed
104
![](../../../img/PuttyKeygenerator_006V.png)
Pavel Jirásek's avatar
Pavel Jirásek committed
105

Lukáš Krupčík's avatar
Lukáš Krupčík committed
106
* Now you can insert additional public key into authorized_keys file for authentication with your own private key.
Lukáš Krupčík's avatar
Lukáš Krupčík committed
107
      You must log in using ssh key received after registration. Then proceed to [How to add your own key](general/accessing-the-clusters/shell-access-and-data-transfer/ssh-keys/).