How to Install and Configure PuTTY: Difference between revisions

From Research Computing Center Wiki
Jump to navigation Jump to search
(Created page with "Category:Sapelo2Category:Teaching __TOC__ ==Downloading PuTTY== [https://www.putty.org/ PuTTY] is an SSH and telnet client, developed originally by Simon Tatham for...")
 
No edit summary
 
(3 intermediate revisions by the same user not shown)
Line 2: Line 2:
__TOC__
__TOC__


==Downloading PuTTY==
==Introduction==


[https://www.putty.org/ PuTTY] is an SSH and telnet client, developed originally by Simon Tatham for the Windows platform. PuTTY is open source software that is available with source code and is developed and supported by a group of volunteers. PuTTY can be directly downloaded [https://www.chiark.greenend.org.uk/~sgtatham/putty/latest.html here]. 
[https://www.putty.org/ PuTTY] is an SSH and telnet client, developed originally by Simon Tatham for the Windows platform. PuTTY is open source software that is available with source code and is developed and supported by a group of volunteers.  


Click the 64-bit MSI installer as shown here:
Please note, these screenshots may become out of date as newer versions of PuTTY are released.


Please note that with releases of newer versions of PuTTY, these screenshots may not match what you see.
==Downloading PuTTY==


PuTTY can be directly downloaded [https://www.chiark.greenend.org.uk/~sgtatham/putty/latest.html here].  Click the '''64-bit x86''' MSI installer as shown in the following screenshot:


[[File:Putty1.png]]
 
[[File:Puttydl.png]]




Line 17: Line 19:


Now that you have downloaded the PuTTY installer, click the installer as shown in the bottom-left corner of your browser
Now that you have downloaded the PuTTY installer, click the installer as shown in the bottom-left corner of your browser


[[File:Putty19.png]]
[[File:Putty19.png]]
Line 28: Line 31:


Click "Next once more.
Click "Next once more.


[[File:Putty5.png]]
[[File:Putty5.png]]
Line 33: Line 37:


In the next setup screen, click the red "X" next to "Add shortcut to PuTTY on the Desktop, and select "Entire feature will be installed on local hard drive."
In the next setup screen, click the red "X" next to "Add shortcut to PuTTY on the Desktop, and select "Entire feature will be installed on local hard drive."


[[File:Putty6.png]]
[[File:Putty6.png]]
Line 40: Line 45:


Next, click "Install."  A window will appear in the middle of your screen asking "Do you want to allow this app to make changes to your device?"  Click "Yes."
Next, click "Install."  A window will appear in the middle of your screen asking "Do you want to allow this app to make changes to your device?"  Click "Yes."


[[File:Putty8.png]]
[[File:Putty8.png]]
Line 45: Line 51:


Once the installation has completed, you will see this screen as shown below.  You may un-check the "View README" file if you wish, and then click "Finish."
Once the installation has completed, you will see this screen as shown below.  You may un-check the "View README" file if you wish, and then click "Finish."


[[File:Putty9.png]]
[[File:Putty9.png]]
Line 51: Line 58:
==Configuring PuTTY==
==Configuring PuTTY==


Now That PuTTY is installed on your computer, you can follow these steps to configure PuTTY to connect to UGA's HPC cluster.  Double-click the PuTTY shortcut on your desktop, and you will see the following window.  This is where you can create and save your connections to our cluster, so you don't have to type the host name every time.  You only have to edit these two text fields:
 
'''Please Note:''' If you're off-campus or not connected to a UGA network, you will need to connect to UGA's '''remote.uga.edu''' VPN via the '''Cisco AnyConnect''' client before you can successfully connect to GACRC resources with PuTTY (or any other similar program).  If you are on campus, connected to a UGA network, you don't have to worry about that.  If you have set up Cisco AnyConnect before, more information can be found [https://eits.uga.edu/access_and_security/infosec/tools/vpn/ here]
 
 
Now That PuTTY is installed on your computer, you can follow these steps to connect to GACRC resources (to which you are authorized to connect) with it.  Double-click the PuTTY shortcut on your desktop, and you will see the following window (If you didn't put a shortcut on your desktop, search for "putty" in the windows search bar in the bottom left of your screen, next to the start button.  Click the one that says "PuTTY", ''not'' PuTTYgen).  You only have to edit these two text fields:
 


[[File:Putty10_2.png]]
[[File:Putty10_2.png]]




First, type ''YourMyID''@sapelo2.gacrc.uga.edu in the "Host Name (or IP address)" text field. Then give this connection a name in the "Saved Sessions" text field.  I will simply call mine "sapelo2."  Next, click the "Save" button as shown below.
First, type ''YourMyID''@''hostname'' in the "Host Name (or IP address)" text field.  ''hostname'' is the hostname of the GACRC resource to which you are connecting.  Examples of those may be:
{| class="wikitable"
|+
!GACRC Resource
!Hostname
|-
|Linux Training Computer
|trainer.gacrc.uga.edu
|-
|Sapelo2 Login Nodes
|sapelo2.gacrc.uga.edu
|-
|Sapelo2 Transfer Nodes
|xfer.gacrc.uga.edu
|-
|Teaching Cluster Login Nodes
|teach.gacrc.uga.edu
|-
|Teaching Cluster Transfer Nodes
|txfer.gacrc.uga.edu
|}
 
So for example, if my MyID were abc12345, and I was going to connect to the GACRC Linux training computer, then in the "Host Name (or IP address)" field, I would type abc12345@trainer.gacrc.uga.edu
 
To save yourself the time, you can have PuTTY save what you type in the "Host Name (or IP address)" field by giving the connection a name in the "Saved Sessions" text field.  In the screenshot below, I called mine "sapelo2", because I'm connecting to the Sapelo2 login nodes in that screenshot. The naming here is arbitrary.  It's just a label for the text in the "Host Name (or IP address)" field. After typing a name for the connection in the "Saved Sessions" field, click the "Save" button as shown below.
 


[[File:Putty11_2.png]]
[[File:Putty11_2.png]]




In order to open the connection you have just saved, either double click your connection name, or click it, then click "Load," and then click "Open" as shown below.
Now the next time you open PuTTY, you can just click the label you made before, and then click "Load", and then "Open", to open a connection to the GACRC resource.
 


[[File:Putty12.png]]
[[File:Putty12.png]]




The first time you connect to a new computer with PuTTY, it will give you this security alert window.  Click "Yes" and it won't ask you this again.
The first time you connect to a new computer with PuTTY, it will give you this security alert window, basically asking if you trust the computer you're connecting to.  Answer affirmatively to the prompt shown and it won't ask you that again from that computer.
 
 
[[File:Puttyacceptkey.png |frameless|850px]]]


[[File:Putty15.png]]


Now you're ready to enter your MyID password.  <big>'''It will look like you're not typing anything, but it is accepting your keyboard input.'''</big>  Just type your password and press enter.  '''If it asks you for your password again''', that could mean several things:


Now you're ready to enter your MyID password and initiate a DUO prompt.
* Your password was typed incorrectly (make sure caps lock is off)
* Your username was typed incorrectly in PuTTY
* You are trying to access something you have not been given access to (in this case it would say something like "Access Denied".


[[File:Putty16.png]]


Most GACRC resources (except the Linux training computer), require authentication with ArchPass Duo, after a successful username/password authentication.  As you can see in the screenshot below, you can type a 1, 2, or 3, depending on how you want to authenticate with ArchPass Duo.  Most people use option 1.  So you could just type 1 in the prompt, and then press enter.  If have not set up ArchPass Duo on your mobile device, you can find more information about setting that up [https://eits.uga.edu/access_and_security/infosec/tools/archpass/ here]


You can save multiple connections in PuTTY.  For example, in the following screenshots, I'm repeating the steps from before to save a connection to our transfer node.


[[File:Putty13.png]]
[[File:Puttyduo.png | frameless|850px]]]




You can also have multiple PuTTY windows/connections open at the same time (even to the same computer, e.g. two concurrent connections to Sapelo2).  To do this, simply double click the PuTTY shortcut on your desktop, and you will be able to open a new connection even if you already have one open, as shown below.
Once you successfully connect to a GACRC resource, you will see a command prompt with your username @ the name of the computer you're connected to, followed by a cursor, waiting for you to type a command.  In the screenshot below, I connected to the Sapelo2 login nodes, and it put me on ss-sub3.


[[File:Putty17.png]]


[[File:Putty18.png]]
[[File:Puttyduosuccess.png | frameless|850px]]

Latest revision as of 09:28, 4 October 2021

Introduction

PuTTY is an SSH and telnet client, developed originally by Simon Tatham for the Windows platform. PuTTY is open source software that is available with source code and is developed and supported by a group of volunteers.

Please note, these screenshots may become out of date as newer versions of PuTTY are released.

Downloading PuTTY

PuTTY can be directly downloaded here. Click the 64-bit x86 MSI installer as shown in the following screenshot:


Puttydl.png


Installing PuTTY

Now that you have downloaded the PuTTY installer, click the installer as shown in the bottom-left corner of your browser


Putty19.png


You will see a new window appear. Click "Next."


Putty4.png


Click "Next once more.


Putty5.png


In the next setup screen, click the red "X" next to "Add shortcut to PuTTY on the Desktop, and select "Entire feature will be installed on local hard drive."


Putty6.png

Putty7.png


Next, click "Install." A window will appear in the middle of your screen asking "Do you want to allow this app to make changes to your device?" Click "Yes."


Putty8.png


Once the installation has completed, you will see this screen as shown below. You may un-check the "View README" file if you wish, and then click "Finish."


Putty9.png


Configuring PuTTY

Please Note: If you're off-campus or not connected to a UGA network, you will need to connect to UGA's remote.uga.edu VPN via the Cisco AnyConnect client before you can successfully connect to GACRC resources with PuTTY (or any other similar program). If you are on campus, connected to a UGA network, you don't have to worry about that. If you have set up Cisco AnyConnect before, more information can be found here


Now That PuTTY is installed on your computer, you can follow these steps to connect to GACRC resources (to which you are authorized to connect) with it. Double-click the PuTTY shortcut on your desktop, and you will see the following window (If you didn't put a shortcut on your desktop, search for "putty" in the windows search bar in the bottom left of your screen, next to the start button. Click the one that says "PuTTY", not PuTTYgen). You only have to edit these two text fields:


Putty10 2.png


First, type YourMyID@hostname in the "Host Name (or IP address)" text field. hostname is the hostname of the GACRC resource to which you are connecting. Examples of those may be:

GACRC Resource Hostname
Linux Training Computer trainer.gacrc.uga.edu
Sapelo2 Login Nodes sapelo2.gacrc.uga.edu
Sapelo2 Transfer Nodes xfer.gacrc.uga.edu
Teaching Cluster Login Nodes teach.gacrc.uga.edu
Teaching Cluster Transfer Nodes txfer.gacrc.uga.edu

So for example, if my MyID were abc12345, and I was going to connect to the GACRC Linux training computer, then in the "Host Name (or IP address)" field, I would type abc12345@trainer.gacrc.uga.edu

To save yourself the time, you can have PuTTY save what you type in the "Host Name (or IP address)" field by giving the connection a name in the "Saved Sessions" text field. In the screenshot below, I called mine "sapelo2", because I'm connecting to the Sapelo2 login nodes in that screenshot. The naming here is arbitrary. It's just a label for the text in the "Host Name (or IP address)" field. After typing a name for the connection in the "Saved Sessions" field, click the "Save" button as shown below.


Putty11 2.png


Now the next time you open PuTTY, you can just click the label you made before, and then click "Load", and then "Open", to open a connection to the GACRC resource.


Putty12.png


The first time you connect to a new computer with PuTTY, it will give you this security alert window, basically asking if you trust the computer you're connecting to. Answer affirmatively to the prompt shown and it won't ask you that again from that computer.


Puttyacceptkey.png]


Now you're ready to enter your MyID password. It will look like you're not typing anything, but it is accepting your keyboard input. Just type your password and press enter. If it asks you for your password again, that could mean several things:

  • Your password was typed incorrectly (make sure caps lock is off)
  • Your username was typed incorrectly in PuTTY
  • You are trying to access something you have not been given access to (in this case it would say something like "Access Denied".


Most GACRC resources (except the Linux training computer), require authentication with ArchPass Duo, after a successful username/password authentication. As you can see in the screenshot below, you can type a 1, 2, or 3, depending on how you want to authenticate with ArchPass Duo. Most people use option 1. So you could just type 1 in the prompt, and then press enter. If have not set up ArchPass Duo on your mobile device, you can find more information about setting that up here


Puttyduo.png]


Once you successfully connect to a GACRC resource, you will see a command prompt with your username @ the name of the computer you're connected to, followed by a cursor, waiting for you to type a command. In the screenshot below, I connected to the Sapelo2 login nodes, and it put me on ss-sub3.


Puttyduosuccess.png

Retrieved from "https://wiki.gacrc.uga.edu/index.php?title=How_to_Install_and_Configure_PuTTY&oldid=20570"