Skip to content
Snippets Groups Projects
putty.md 3.85 KiB
Newer Older
  • Learn to ignore specific revisions
  • Lukáš Krupčík's avatar
    Lukáš Krupčík committed
    # PuTTY (Windows)
    
    ## Windows PuTTY Installer
    
    We recommend you to download "**A Windows installer for everything except PuTTYtel**" with **Pageant** (SSH authentication agent) and **PuTTYgen** (PuTTY key generator) which is available [here][a].
    
    !!! note
        "Pageant" is optional.
    
    Jan Siwiec's avatar
    Jan Siwiec committed
    
    
    Jan Siwiec's avatar
    Jan Siwiec committed
        "Change Password for Existing Private Key" is optional.
    
    Lukáš Krupčík's avatar
    Lukáš Krupčík committed
    
    ## PuTTY - How to Connect to the IT4Innovations Cluster
    
    * Run PuTTY
    
    Jan Siwiec's avatar
    Jan Siwiec committed
    * 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 do not have to type your login each time. In this example, replace the word `cluster` in the `cluster.it4i.cz` address with the name of the cluster to which you want to connect.
    
    Lukáš Krupčík's avatar
    Lukáš Krupčík committed
    
    
    Jan Siwiec's avatar
    Jan Siwiec committed
    ![](../../../img/PuTTY_host_cluster.png)
    
    Lukáš Krupčík's avatar
    Lukáš Krupčík committed
    
    * Category - Connection -  SSH - Auth:
          Select Attempt authentication using Pageant.
          Select Allow agent forwarding.
    
    Jan Siwiec's avatar
    Jan Siwiec committed
          Browse and select your private key file.
    
    Lukáš Krupčík's avatar
    Lukáš Krupčík committed
    
    ![](../../../img/PuTTY_keyV.png)
    
    * Return to Session page and Save selected configuration with _Save_ button.
    
    
    Jan Siwiec's avatar
    Jan Siwiec committed
    ![](../../../img/PuTTY_save_cluster.png)
    
    Lukáš Krupčík's avatar
    Lukáš Krupčík committed
    
    * Now you can log in using _Open_ button.
    
    
    Jan Siwiec's avatar
    Jan Siwiec committed
    ![](../../../img/PuTTY_open_cluster.png)
    
    Lukáš Krupčík's avatar
    Lukáš Krupčík committed
    
    
    Jan Siwiec's avatar
    Jan Siwiec committed
    * Enter your username if the _Host Name_ input is not in the format "username@cluster.it4i.cz".
    
    Jan Siwiec's avatar
    Jan Siwiec committed
    * Enter passphrase for selected private key file if Pageant **SSH authentication agent is not used.**
    
    Lukáš Krupčík's avatar
    Lukáš Krupčík committed
    
    ## Another PuTTY Settings
    
    * Category - Windows - Translation - Remote character set and select **UTF-8**.
    * Category - Terminal - Features and select **Disable application keypad mode** (enable numpad)
    
    Jan Siwiec's avatar
    Jan Siwiec committed
    * Save your configuration in the Session - Basic options for your PuTTY section with the _Save_ button.
    
    Lukáš Krupčík's avatar
    Lukáš Krupčík 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 back up the key.
    
    
    Jan Siwiec's avatar
    Jan Siwiec committed
    * Load your private key file with _Load_ button.
    
    Lukáš Krupčík's avatar
    Lukáš Krupčík committed
    * Enter your current passphrase.
    * Change key passphrase.
    * Confirm key passphrase.
    * Save your private key with the _Save private key_ button.
    
    ![](../../../img/PuttyKeygeneratorV.png)
    
    ### Generate a New Public/Private Key
    
    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 the 'username@organization.example.com' format.
          Enter a key passphrase, confirm it and save your new private key in the _ppk_ format.
    
    ![](../../../img/PuttyKeygenerator_004V.png)
    
    * Save the public key with the _Save public key_ button.
          You can copy public key out of the ‘Public key for pasting into the authorized_keys file’ box.
    
    ![](../../../img/PuttyKeygenerator_005V.png)
    
    * Export the private key in the OpenSSH format "id_rsa" using Conversion - Export OpenSSH key
    
    ![](../../../img/PuttyKeygenerator_006V.png)
    
    
    Jan Siwiec's avatar
    Jan Siwiec committed
    ## Managing Your SSH Key
    
    To manage your SSH key for authentication to clusters, see the [SSH Key Management][3] section.
    
    [1]: ./ssh-key-management.md
    
    Lukáš Krupčík's avatar
    Lukáš Krupčík committed
    
    [1]: #putty
    [2]: ssh-keys.md#how-to-add-your-own-key
    
    Jan Siwiec's avatar
    Jan Siwiec committed
    [3]: ./ssh-key-management.md
    
    Lukáš Krupčík's avatar
    Lukáš Krupčík committed
    
    [a]: http://www.chiark.greenend.org.uk/~sgtatham/putty/download.html