Skip to content
Snippets Groups Projects
putty.md 4.45 KiB
Newer Older
  • Learn to ignore specific revisions
  • Lukáš Krupčík's avatar
    Lukáš Krupčík committed
    PuTTY
    
    Lukáš Krupčík's avatar
    Lukáš Krupčík committed
    =====
    
    
    Lukáš Krupčík's avatar
    Lukáš Krupčík committed
    !!! Note "Note"
    	PuTTY -  before we start SSH connection
    
    Lukáš Krupčík's avatar
    Lukáš Krupčík committed
    
    
    David Hrbáč's avatar
    David Hrbáč committed
    Windows PuTTY Installer
    
    Lukáš Krupčík's avatar
    Lukáš Krupčík committed
    -----------------------
    
    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"
    	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
    
    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
    
    David Hrbáč's avatar
    David Hrbáč committed
    -   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
    
    -   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
    
    -   Return to Session page and Save selected configuration with *Save* button.
    
    
    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
    
    
    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
    
    Another PuTTY Settings
    ----------------------
    
    
    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.
    
    Pavel Jirásek's avatar
    Pavel Jirásek 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 backup the key.
    
    -   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.
    
    ![](../../../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.
    
    -   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 format 'username@organization.example.com'.
        Enter key passphrase.
        Confirm key passphrase.
        Save your new private key `in "*.ppk" `format with *Save private key* button.
    
    ![](../../../img/PuttyKeygenerator_004V.png)
    
    -   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.
    
    ![](../../../img/PuttyKeygenerator_005V.png)
    
    -   Export private key in OpenSSH format "id_rsa" using Conversion -> Export OpenSSH key
    
    ![](../../../img/PuttyKeygenerator_006V.png)
    
    -   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/).