Skip to content
Snippets Groups Projects
putty.md 4.2 KiB
Newer Older
  • Learn to ignore specific revisions
  • 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
    
    
    David Hrbáč's avatar
    David Hrbáč committed
    !!! 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:
    
    David Hrbáč's avatar
    David Hrbáč 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.
    
    David Hrbáč's avatar
    David Hrbáč 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)
    
    
    David Hrbáč's avatar
    David Hrbáč 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)
    
    
    David Hrbáč's avatar
    David Hrbáč 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'.
    
    David Hrbáč's avatar
    David Hrbáč committed
          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)
    
    
    Lukáš Krupčík's avatar
    Lukáš Krupčík committed
    * Save the public key with _Save public key_ button.
    
    David Hrbáč's avatar
    David Hrbáč committed
          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)
    
    
    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.
    
    David Hrbáč's avatar
    David Hrbáč 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/).