HPC/Network Access/PuTTY Configuration: Difference between revisions

Latest revision as of 16:48, March 10, 2021

The Carbon cluster is reachable from networks outside of Argonne through SSH tunneling or VPN, either of which has advantages and disadvantages. This page explains how to set up and use SSH tunneling.

Should your connection attempt fail, first review your access requirements and take steps as indicated.

Configuring

The following steps need to be performed once for each workstation you wish to use to access Carbon.

The SSH Gateway
The Carbon login nodes
Accessing Carbon licenses remotely (advanced)

Connecting

To connect to Carbon for interactive work, or to access its networked licenses, perform a preparatory step, needed only once for a given Windows login session.

Connecting to the SSH Gateway

From then on, and while the preparatory window remains active, connect as often as desired.

Connecting to a Carbon login node

File Transfers using PSFTP

Configure your PuTTY installation as shown above.
Connect to the SSH Gateway, as shown in the preceeding section.
Open the psftp application.
Use clogin (your configured PuTTY saved session name) as host to connect to.

To learn more, see the PSFTP documentation.

Support

If you have difficulties connecting:

Stop all open PuTTY sessions.
Review the PuTTY configuration for both the SSH Gateway profile and the Carbon Login profile, as shown in section #Configuring above.
- Make sure that tunneled port numbers match between the two profiles.
Carefully follow the steps at #Connecting . Remember:
- You need one preparatory connection to the SSH gateway running, then you can open one or more terminal or file transfer connections.
- For the connection framework described here, open all SSH connections from your own machine, never from Mega.

If you still have difficulties, submit a support request with Remote Acces chosen from the drop-down menu Type of Request or Issue.

@@ Line 1: / Line 1: @@
-== Introduction ==
+The Carbon cluster is reachable from networks outside of Argonne through SSH tunneling or VPN,
-The Carbon cluster is reachable from networks outside Argonne only through SSH tunneling or VPN.
+either of which has advantages and disadvantages. This page explains how to set up and use SSH tunneling.
-Either way has advantages and disadvantages.  This page explains how to connect through an ssh tunnel.
-Tunneling is a two-step process:
+Should your connection attempt fail, first review your [[../#Requirements|'''access requirements''']] and take steps as indicated.
-# Establish the tunnel.
-# Connect through the tunnel.
-[[media:HPC_Using_Carbon_-_II_Remote_Access.pdf|Overview slides (pdf)]] and [[HPC/Network_Access/SSH_Tunnel_Setup_on_Linux_and_MacOS| specifics for Carbon]] are detailed elsewhere.  The PuTTY setup for both steps is illustrated below.
+<!--
+[[media:HPC_Using_Carbon_-_II_Remote_Access.pdf|Overview slides (pdf)]] and [[HPC/Network_Access/SSH_Tunnel_Setup_on_Linux_and_MacOS| specifics for Carbon]] are detailed elsewhere.  The PuTTY setup for both steps is explained below.
 Note that the ''PuTTY Configuration'' panel is somewhat idiosyncratic to operate, notably regarding the concept of ''Sessions''.  Numerous [http://images.google.com/images?um=1&hl=en&rls=en-us&q=PuTTY+ssh&btnG=Search+Images screenshots on Google] provide general guidance.
+-->
-== Configuring PuTTY to access Carbon ==
+== Configuring ==
+The following steps need to be performed once for each workstation you wish to use to access Carbon.
 * [[HPC/Network Access/PuTTY Configuration/The SSH Gateway | The SSH Gateway]]
-* [[HPC/Network Access/PuTTY Configuration/The Carbon login node | The Carbon login node]]
+* [[HPC/Network Access/PuTTY Configuration/The Carbon login nodes | The Carbon login nodes]]
+* [[HPC/Network Access/PuTTY Configuration/Accessing Carbon licenses remotely | Accessing Carbon licenses remotely]] (advanced)
-== Connecting to Carbon ==
+== Connecting ==
+To connect to Carbon for interactive work, or to access its networked licenses, perform a preparatory step, needed only once for a given Windows login session.
 * [[HPC/Network Access/PuTTY Configuration/Connecting to the SSH Gateway | Connecting to the SSH Gateway]]
-* [[HPC/Network Access/PuTTY Configuration/Connecting to the SSH Gateway | Connecting to a Carbon login node]]
+From then on, and while the preparatory window remains active, connect as often as desired.
+* [[HPC/Network Access/PuTTY Configuration/Connecting to a Carbon login node | Connecting to a Carbon login node]]
-# In the PuTTY Configuration window, click Session at the top of the tree on the left.
+== File Transfers using PSFTP ==
-# Select the session named '''Mega''' and push Load.
+# [[#Configuring | Configure your PuTTY installation]] as shown above.
-# Make sure the Host Name field shows mega.cnm.anl.gov.
+# [[#Connecting | Connect to the SSH Gateway]], as shown in the preceeding section.
-# Push Open.
+# Open the <code>psftp</code> application.
-#: [[Image:HPC 2012-08 PuTTY config 11 Load mega.png]][[Image:HPC 2012-08 PuTTY config 12 Open mega.png]]
+#: Use <code>clogin</code> (your configured PuTTY saved session name) as host to connect to.
-# When prompted, enter your Argonne account password. When accepted, the cursor will wait at the next line and nothing further will happen.
-#:[[Image:HPC 2012-08 PuTTY config 13 mega prompt.png]]
-# Minimize the window to the taskbar (as opposed to closing it).
-== Connecting to Carbon itself ==
+To learn more, see the [https://the.earth.li/~sgtatham/putty/0.71/htmldoc/Chapter5.html#pscp PSFTP documentation].
-# Open another PuTTY window.
-# Select the session named '''Clogin''' and push Load.
+== Support ==
-# Make sure the Host Name field shows localhost.
+If you have difficulties connecting:
-#: [[Image:HPC 2012-08 PuTTY config 14 Load clogin.png]][[Image:HPC 2012-08 PuTTY config 15 Open clogin.png]]
+# Stop all open PuTTY sessions.
-# Push Open.
+# Review the PuTTY configuration for ''both''  the SSH Gateway profile and the Carbon Login profile, as shown in section [[#Configuring]] above.
-# Welcome to Carbon! - You should get our NOTICE TO USERS and a prompt saying login5 or login6 followed by /home/username.
+#* Make sure that ''tunneled port numbers match'' between the two profiles.
-#: [[Image:HPC 2012-08 PuTTY config 16 clogin prompt.png]][[Image:HPC 2012-08 PuTTY config 17 clogin OK.png]]
+# Carefully follow the steps at [[#Connecting]] . Remember:
+#* You need ''one preparatory'' connection to the SSH gateway running, then you can open ''one or more'' terminal or file transfer connections.
+#* For the connection framework described here, open ''all'' SSH connections from ''your'' own machine, ''never'' from Mega.
+If you still have difficulties, [[HPC/Support#Compose a support request for CNM HPC | '''submit a support request''']] with ''Remote Acces'' chosen from the drop-down menu ''Type of Request or Issue''.
 [[Category:HPC|Network]]