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.
+-->
-== Configuration ==
+== Configuring ==
-[[HPC/Network Access/PuTTY Configuration/The SSH Gateway]]
+The following steps need to be performed once for each workstation you wish to use to access Carbon.
-[[HPC/Network Access/PuTTY Configuration/The Carbon login node]]
+* [[HPC/Network Access/PuTTY Configuration/The SSH Gateway | The SSH Gateway]]
+* [[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 Mega ==
+== Connecting ==
-# In the PuTTY Configuration window, click Session at the top of the tree on the left.
+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.
-# Select the session named '''Mega''' and push Load.
+* [[HPC/Network Access/PuTTY Configuration/Connecting to the SSH Gateway | Connecting to the SSH Gateway]]
-# Make sure the Host Name field shows mega.cnm.anl.gov.
+From then on, and while the preparatory window remains active, connect as often as desired.
-# Push Open.
+* [[HPC/Network Access/PuTTY Configuration/Connecting to a Carbon login node | Connecting to a Carbon login node]]
-#: [[Image:HPC 2012-08 PuTTY config 11 Load mega.png]]
-# 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 12 Open mega.png]]
-# Minimize the window.
-== Connecting to Carbon itself ==
+== File Transfers using PSFTP ==
-# Open another PuTTY window.
+# [[#Configuring | Configure your PuTTY installation]] as shown above.
-# Select the session named '''Clogin''' and push Load.
+# [[#Connecting | Connect to the SSH Gateway]], as shown in the preceeding section.
-# Make sure the Host Name field shows localhost.
+# Open the <code>psftp</code> application.
-#:[[Image:HPC 2012-08 PuTTY config 13 Load clogin.png]]
+#: Use <code>clogin</code> (your configured PuTTY saved session name) as host to connect to.
-# Push Open.
-# Welcome to Carbon! - You should get our NOTICE TO USERS and a prompt saying login5 or login6 followed by /home/username.
-== Setup for step 2 ==
+To learn more, see the [https://the.earth.li/~sgtatham/putty/0.71/htmldoc/Chapter5.html#pscp PSFTP documentation].
-[[Image:putty-session-clogin.png]]
+== 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, [[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]]