Hprc banner tamu.png

Difference between revisions of "HPRC:Access:Windows"

From TAMU HPRC
Jump to: navigation, search
m (J-perdue moved page TAMUSC:Access:Windows to HPRC:Access:Windows)
Line 8: Line 8:
 
Note, the illustrations/instructions below use the hostnames '''ada.tamu.edu''' but please use the hostname for the system you wish to access e.g. '''ada.tamu.edu'''. See [[HPRC:Systems | the details for our systems]] for the appropriate hostname(s).
 
Note, the illustrations/instructions below use the hostnames '''ada.tamu.edu''' but please use the hostname for the system you wish to access e.g. '''ada.tamu.edu'''. See [[HPRC:Systems | the details for our systems]] for the appropriate hostname(s).
  
== Remote Logins ==
+
== Access from Windows ==
[http://www.chiark.greenend.org.uk/~sgtatham/putty/ PuTTY] is a full-featured, SSH v1.x, v2.x compliant client for Windows. PuTTY is considered by many as the best free, SSH-compliant client for Windows. You can get PuTTY as well as PSCP (a tool for encrypted remote file transfer) at:
+
=== Using MobaXterm (Recommended) ===
 +
MobaXterm is an enhanced terminal for Windows with a built-in X11 server, tabbed SSH client, built-in file editor, SFTP functionality, and other useful features. It is available from: [http://mobaxterm.mobatek.net/download.html http://mobaxterm.mobatek.net/download.html]
  
[http://www.chiark.greenend.org.uk/~sgtatham/putty/download.html http://www.chiark.greenend.org.uk/~sgtatham/putty/download.html]
+
You will need to choose which license (free Home edition, or professional) and then select the Portable or Installer edition. The Installer edition works best on your personal machine, when you have the privileges to install software. The portable version may be necessary when using a lab workstation, for example. (Be sure to check if MobaXterm is already installed in the Windows Start menu.)
  
=== Configuration ===
+
==== Local Terminal ====
The following tutorial is based on the Putty 0.60 binaries. Different releases may have slight differences in the graphical interfaces, command line interfaces, etc...
+
<ol>
 +
<li>Open MobaXterm and start a local terminal:</li>
 +
::[[File:Moba Start-local.png|800px]]
 +
 
 +
<li>From the local terminal, connect to the cluster using [[#SSH | SSH]]:</li>
 +
::[[File:Moba from-local.png|800px]]
 +
</ol>
 +
 
 +
==== SSH Session ====
 +
<ol>
 +
<li>Open MobaXterm and open the Session settings:</li>
 +
::[[File:Session.png|800px]]
 +
 
 +
<li>Enter the hostname in the &quot;Remote Host&quot; field, check the box for &quot;Specify username&quot; and enter the proper username for the cluster you are connecting to,  <code>ada.tamu.edu</code> in this case:
 +
::[[File:Moba ssh.png|800px]]
 +
<li> Once you click OK you will be prompted to enter your password. Enter the proper password for the cluster you are connecting to. </li> </ol>
 +
 
 +
=== Using PuTTY ===
 +
[http://www.chiark.greenend.org.uk/~sgtatham/putty/ PuTTY] is a full-featured, SSH v1.x, v2.x compliant client for Windows. You can get PuTTY as well as PSCP (a tool for encrypted remote file transfer) at: [http://www.chiark.greenend.org.uk/~sgtatham/putty/download.html http://www.chiark.greenend.org.uk/~sgtatham/putty/download.html]
  
 
<ol>
 
<ol>
<li><p>After installing PuTTY, click on the PuTTY icon to get a window similar to the following:</p>
+
<li>After installing PuTTY, open PuTTY to get a window similar to the following:</li>
<p></p>
+
::[[Image:putty_main.ada.png|PuTTY main window]]
<p>[[Image:putty_main.ada.png|PuTTY main window]]</p></li>
+
 
<li>Select SSH for the protocol and enter the host name of the remote machine you want to connect to. In this case, we are attempting to connect to &quot;<code>eos.tamu.edu</code>&quot; at the TAMU Supercomputing Facility. The settings we are configuring for this connection can be saved as a session profile by PuTTY if we give this session a name and click on the &quot;Save&quot; button on this initial window. We have called this session &quot;hydra&quot;, but we will not yet save the profile since we still need to modify other parameters before we are ready to establish the connection.</li>
+
<li>Enter the host name of the remote machine you want to connect to. In this case, we are attempting to connect to <code>ada.tamu.edu</code> at the TAMU Supercomputing Facility. The settings we are configuring for this connection can be saved as a session profile by PuTTY if we give this session a name and click on the &quot;Save&quot; button on this initial window. We have called this session &quot;ada&quot;, but we will not yet save the profile since we still need to modify other parameters before we are ready to establish the connection.</li>
<li><p>Make sure the SSH parameters are correct. Click on SSH in the category tree (this is found under the &quot;Connection&quot; branch). Verify that preferred SSH protocol version is &quot;2 only&quot; and the preferred encryption algorithm is AES.</p>
 
<p></p>
 
<p>[[Image:putty_encryption.png|PuTTY encryption window]]</p></li>
 
<li><p>Next, go to the &quot;Auth&quot; portion of the GUI and make sure that the settings are configured as follows:</p>
 
<p></p>
 
<p>[[Image:putty_auth.png|PuTTY authentication window]]</p></li>
 
<li><p>Next, in the &quot;Tunnels&quot; window, enable X11 forwarding:</p>
 
<p></p>
 
<p>[[Image:putty_tunnels.png|PuTTY tunnels window]]</p></li>
 
<li><p>Since now we have configured all the parameters as we want them, we can go back to the sessions window and click on the &quot;Save&quot; button to save these settings under the session name of &quot;hydra&quot;.</p>
 
<p></p>
 
<p>[[Image:putty_main.ada.png|PuTTY main window with save]]</p></li>
 
<li>To establish a connection to Eos cluster, we can now simply highlight the session by that name and click on &quot;Open&quot;.</li>
 
<li><p>Finally, you should be presented with a window with a command line interface and will be asked to supply your login name and password:</p>
 
<p></p>
 
<p>[[Image:putty_login.ada.png|PuTTY login window]]</p></li>
 
<li>Enter these as you normally would. Congratulations! You should now have an interactive shell session on the remote machine.</li></ol>
 
  
'''NOTE''': If this is the first time you are attempting to connect to the remote machine, PuTTY will warn you that it doesn't know the machine's public key and give you the option of continuing or not. Just click on &quot;Yes&quot;. Once this is done, you won't see this message again for this machine unless the public key on the remote machine changes for some reason.
+
<li>Make sure the SSH parameters are correct. Click on SSH in the category tree (this is found under the &quot;Connection&quot; branch). Verify that the preferred SSH protocol version is &quot;2 only&quot; and the preferred encryption algorithm is AES.</li>
 +
::[[Image:putty_encryption.png|PuTTY encryption window]]
 +
 
 +
<li>Next, go to the &quot;Auth&quot; portion of the GUI and make sure that the settings are configured as follows:</li>
 +
::[[Image:putty_auth.png|PuTTY authentication window]]
 +
 
 +
<li>Next, in the &quot;Tunnels&quot; window, enable X11 forwarding:</li>
 +
::[[Image:putty_tunnels.png|PuTTY tunnels window]]
 +
 
 +
<li>Since now we have configured all the parameters as we want them, we can go back to the sessions window and click on the &quot;Save&quot; button to save these settings under the session name of &quot;ada&quot;.</li>
 +
::[[Image:putty_main.ada.png|PuTTY main window with save]]
  
== File Transfers ==
+
<li>To establish a connection to the cluster, we can now simply highlight the session and click on &quot;Open.&quot;</li>
  
WinSCP is a graphical SCP, &quot;point and click&quot; encrypted remote file transfer client for Windows. It is built on top of a portion of the [http://www.chiark.greenend.org.uk/~sgtatham/putty/ PuTTY] source code. After downloading, double-click on the icon to begin the installation. Follow all the steps (it is a typical windows install wizard) and choose the &quot;typical&quot; install option when prompted. It should only take a few seconds to install the package. When done, a WinSCP icon should appear on the Desktop.
+
<li>Finally, you should be presented with a window with a command line interface and will be asked to supply your login name and password:</li>
 +
::[[Image:putty_login.ada.png|PuTTY login window|700px]]
 +
<li>Enter the proper credentials for the cluster you are connecting to.</li></ol>
  
=== Configuration ===
+
'''NOTE''': If this is the first time you are attempting to connect to the remote machine, PuTTY will warn you that it doesn't know the machine's public key and give you the option of continuing or not. Just click on &quot;Yes&quot;. Once this is done, you won't see this message again for this machine unless the public key on the remote machine changes for some reason.
  
<ol>
 
<li><p>Double-click the WinSCP icon to start WinSCP. The following window should appear.</p>
 
<p></p>
 
<p>[[Image:winscp_session.ada.png|WinSCP session window]]</p>
 
<p>Type in the name of the system to which you seek to establish a connection (in our case, &quot;<code>eos.tamu.edu</code>&quot;) as well as your username and account password for that remote machine. The port number field should contain &quot;22&quot; and the protocol should be set to &quot;SFTP&quot;. Next, select the SSH branch from the options tree in the left portion of the window.</p></li>
 
<li><p>In the SSH portion of the GUI, AES encryption should be moved to the top by highlighting it and pressing the &quot;Up&quot; button until it is at the top of the selection policy.</p>
 
<p></p>
 
<p>[[Image:winscp_ssh.png|WinSCP ssh window]]</p></li>
 
<li><p>You can now save the settings you just adjusted by going back to the &quot;Session&quot; branch and clicking the &quot;Save&quot; button to get the following dialogue box:</p>
 
<p></p>
 
<p>[[Image:winscp_save.ada.png|WinSCP save window]]</p></li>
 
<li><p>After this is done, go back to the SSH branch and click the &quot;login&quot; button at the bottom of the window. If this is the first time you have accessed this particular remote machine through WinSCP, you will see the following message:</p>
 
<p></p>
 
<p>[[Image:winscp_hostkey.png|WinSCP host key verification window]]</p></li>
 
<li><p>Click &quot;Yes&quot; to proceed. You will then see the following window:</p>
 
<p></p>
 
<p>[[Image:winscp_main.ada.png|WinSCP main window]]</p>
 
<p>To move to the desired directories, use the navigation bars at the top. The local system is on the left and the remote system on the right. The toolbar at the bottom of the window contains function keys for performing copies, deletes, etc.</p></li>
 
<li>Let's say you wanted to copy the file &quot;sc08 template.ppt&quot; from the local computer (left window) to the remote computer (right window). Click on the file &quot;sc08 template.ppt&quot; and hit the space bar to select the file &quot;sc08 template.ppt&quot;.</li>
 
<li><p>Now, either press the F5 key or click the icon for &quot;Copy&quot; at the bottom of the window. You will be prompted for a confirmation:</p>
 
<p></p>
 
<p>[[Image:winscp_copy.ada.png|WinSCP copy window]]</p></li>
 
<li><p>Finally, a transfer progress window will appear:</p>
 
<p></p>
 
<p>[[Image:winscp_transfer.ada.png|WinSCP window]]</p>
 
<p>Depending on the size of the file(s) and the speed of your network connection, this could take a anywhere from a few seconds to several minutes. Many users at TAMU Supercomputing have very large files. Don't be surprised if a 2GB file takes tens of minutes to complete. When you are ready to disconnect from the remote system, press F10 or just exit from the program.</p></li></ol>
 
  
 
== Remote Display of Programs with Graphical Interfaces ==
 
== Remote Display of Programs with Graphical Interfaces ==
 +
MobaXterm has a built-in X11 server, no extra software is needed to display programs with graphical interfaces if you are using MobaXterm. If you are using PuTTY, you will need an X server like Xming.
  
Xming is a X Window Server for Microsoft Windows. Although the latest version requires a contribution (approximately $20 USD) there is also an older (free) '''Public Domain Release''' (version 6.9.0.31) which can be found at:
+
Xming is an X Server for Microsoft Windows. Although the latest version requires a contribution (approximately $20 USD) there is also an older (free) '''Public Domain Release''' (version 6.9.0.31) which can be found at: [http://www.straightrunning.com/XmingNotes/ http://www.straightrunning.com/XmingNotes/]
  
[http://www.straightrunning.com/XmingNotes/ http://www.straightrunning.com/XmingNotes/]
+
<ol>
 
+
<li>After installing Xming (or Xming-mesa if you need OpenGL support), start Xming using the installed shortcut.</li>
After installing Xming (or Xming-mesa if you need OpenGL support), start Xming using the installed shortcut.
 
  
Make sure your desired PuTTY session is configured with X11 forwarding as described [[#tunnels|above]].
+
<li>Make sure your desired PuTTY session is configured with X11 forwarding as described [[#tunnels|above]]. </li>
  
Login to the desired supercomputer via PuTTY.
+
<li>Login to the desired supercomputer via PuTTY.</li>
  
Start an xterm window with the following command:
+
<li>Start an xterm window with the following command:</li>
  
<pre>xterm</pre>
+
::<pre>xterm</pre>
If a new xterm terminal window for the remote system pops up on your Windows desktop, then X11 forwarding is working correctly.
+
If a new xterm terminal window for the remote system pops up on your Windows desktop, then X11 forwarding is working correctly.</ol>

Revision as of 09:53, 8 March 2016

NOTE: In the following instructions/pages, replace "ada" (.tamu.edu) with the hostname of the system you wish to access (e.g. "crick", "curie", "neumann").


Note

Note, the illustrations/instructions below use the hostnames ada.tamu.edu but please use the hostname for the system you wish to access e.g. ada.tamu.edu. See the details for our systems for the appropriate hostname(s).

Access from Windows

Using MobaXterm (Recommended)

MobaXterm is an enhanced terminal for Windows with a built-in X11 server, tabbed SSH client, built-in file editor, SFTP functionality, and other useful features. It is available from: http://mobaxterm.mobatek.net/download.html

You will need to choose which license (free Home edition, or professional) and then select the Portable or Installer edition. The Installer edition works best on your personal machine, when you have the privileges to install software. The portable version may be necessary when using a lab workstation, for example. (Be sure to check if MobaXterm is already installed in the Windows Start menu.)

Local Terminal

  1. Open MobaXterm and start a local terminal:
  2. Moba Start-local.png
  3. From the local terminal, connect to the cluster using SSH:
  4. Moba from-local.png

SSH Session

  1. Open MobaXterm and open the Session settings:
  2. Session.png
  3. Enter the hostname in the "Remote Host" field, check the box for "Specify username" and enter the proper username for the cluster you are connecting to, ada.tamu.edu in this case:
    Moba ssh.png
  4. Once you click OK you will be prompted to enter your password. Enter the proper password for the cluster you are connecting to.

Using PuTTY

PuTTY is a full-featured, SSH v1.x, v2.x compliant client for Windows. You can get PuTTY as well as PSCP (a tool for encrypted remote file transfer) at: http://www.chiark.greenend.org.uk/~sgtatham/putty/download.html

  1. After installing PuTTY, open PuTTY to get a window similar to the following:
  2. PuTTY main window
  3. Enter the host name of the remote machine you want to connect to. In this case, we are attempting to connect to ada.tamu.edu at the TAMU Supercomputing Facility. The settings we are configuring for this connection can be saved as a session profile by PuTTY if we give this session a name and click on the "Save" button on this initial window. We have called this session "ada", but we will not yet save the profile since we still need to modify other parameters before we are ready to establish the connection.
  4. Make sure the SSH parameters are correct. Click on SSH in the category tree (this is found under the "Connection" branch). Verify that the preferred SSH protocol version is "2 only" and the preferred encryption algorithm is AES.
  5. PuTTY encryption window
  6. Next, go to the "Auth" portion of the GUI and make sure that the settings are configured as follows:
  7. PuTTY authentication window
  8. Next, in the "Tunnels" window, enable X11 forwarding:
  9. PuTTY tunnels window
  10. Since now we have configured all the parameters as we want them, we can go back to the sessions window and click on the "Save" button to save these settings under the session name of "ada".
  11. PuTTY main window with save
  12. To establish a connection to the cluster, we can now simply highlight the session and click on "Open."
  13. Finally, you should be presented with a window with a command line interface and will be asked to supply your login name and password:
  14. PuTTY login window
  15. Enter the proper credentials for the cluster you are connecting to.

NOTE: If this is the first time you are attempting to connect to the remote machine, PuTTY will warn you that it doesn't know the machine's public key and give you the option of continuing or not. Just click on "Yes". Once this is done, you won't see this message again for this machine unless the public key on the remote machine changes for some reason.


Remote Display of Programs with Graphical Interfaces

MobaXterm has a built-in X11 server, no extra software is needed to display programs with graphical interfaces if you are using MobaXterm. If you are using PuTTY, you will need an X server like Xming.

Xming is an X Server for Microsoft Windows. Although the latest version requires a contribution (approximately $20 USD) there is also an older (free) Public Domain Release (version 6.9.0.31) which can be found at: http://www.straightrunning.com/XmingNotes/

  1. After installing Xming (or Xming-mesa if you need OpenGL support), start Xming using the installed shortcut.
  2. Make sure your desired PuTTY session is configured with X11 forwarding as described above.
  3. Login to the desired supercomputer via PuTTY.
  4. Start an xterm window with the following command:
  5. xterm
    If a new xterm terminal window for the remote system pops up on your Windows desktop, then X11 forwarding is working correctly.