Windows - Using MobaXTerm

Owned by Dylan Perkins, created
Last updated: Aug 02, 2024 by Lisa Stafford
6 min read

Overview

This tutorial is describes and demonstrates how to use the ssh client MobaXTerm on a Windows computer to log into an HPC system. By the end of this Tutorial you should be able to know how to find, download and install MobaXTerm on Windows as well as creating a ssh session to a HPC system.

Introduction

MobaXterm, a very handy terminal and ssh tool for Windows that’s incredibly easy to use. MobaXterm offers support for many protocols, such as SSH, VNC, FTP, SFTP and has a tabbed interface for easy access to all of your sessions. MobaXTerm also has X11 forwarding enabled right out of the box for graphical applications when PuTTY requires additional steps to enable X11.

Downloading & Install MobaXTerm

  1. Go to the MobaXterm website.

  2. Click on ‘Download’ and you’ll see two different versions, Home and Professional. The Home edition is free and will work just fine for what we need. You’ll also notice that there will be two Editions of the Home version, Portable and Installer. In our case we’ll use the installer edition.

  3. Once the app is downloaded, extract the compressed file and double click the installer .msi file to open the installation Wizard. Click through the install, accepting the default options.

  4. You can launch the application by double clicking the desktop icon or find the application by searching for it in the Windows search bar.

 

Configuring MobaXTerm for ARCC HPC Login (using ssh password-free authentication)

These instructions assume you already have your ssh key set up correctly and verified your key file configuration by opening a new command prompt window and ssh’ing to the HPC with the following command replacing <username> with your UWYO or ARCC HPC username and <clustername> with the HPC name: ssh <username>@<clustername>.arcc.uwyo.edu. (ex: ssh cowboyjoe@beartooth.arcc.uwyo.edu). If your key is configured correctly, you will be logged into the cluster without having to enter your password or authenticate over 2 factor. If you have not yet set up an SSH key for login to our HPC resources, please see this page.

Once you have the MobXterm application open, you’ll have a number of tools and options available to you:

Start an ssh session in MobaXTerm, by:

  1. Selecting ‘Session’ from the top menu.

    sessions.png

     

  2. This will open up a new “Session settings” window. Click the ‘SSH’ tile.

  3. In the ‘Remote host’ field, enter the fully qualified hostname of the system you want to connect to. For example: medicinebow.arcc.uwyo.edu.

  4. You may specify a username, if you wish.

  5. Click on Advanced SSH settings to bring up options for specifying access to the cluster using a private key.

  6. Check the box to use a private key, then click on the small file icon on the right side of the text box to browse for your key in the location in which you placed it. (usually this is in C:\Users\<yourusername>\.ssh)

  7. Browse to the location of your key file on your computer. Select the id_ecdsa file you downloaded from the OnDemand key manager (not the PUB file).

  8. Click Open.

  9. Then Click ‘OK’ to exit out.

  10. To test the configuration, you should be asked to try and connect. Select the option to do so.

    1. Note that a new entry appears in the left-hand pane under ‘User sessions’ - you can use this as a shortcut to start a new session with your saved host and username. You may right click on this session to start a connection.

    2. If you are prompted for approval to connect to the new connection, choose the affirmative.

    3. If MobaXTerm is configured properly, you should be logged into the cluster without having to enter a username, password, or authenticate using 2 factor.

Configuring MobaXTerm for ARCC HPC Login (using username and password with 2 factor authentication)

Once you have the MobXterm application open, you’ll have a number of tools and options available to you:

Start an ssh session in MobaXTerm, by:

  1. Selecting ‘Session’ from the top menu.

  2. Click the ‘SSH’ tile.

  3. In the ‘Remote host’ field, enter the fully qualified hostname of the system you want to connect to. For example: beartooth.arcc.uwyo.edu.

  4. You may specify a username, if you wish.

  5. Click ‘OK’

    1. Note that a new entry appears in the left-hand pane under ‘User sessions’ - you can use this as a shortcut to start a new session with your saved host and username.

  6. Enter your password/first factor followed by the second factor (or accept the DuoMobile push).

If you are unsure how to do this, please see our Tutorial on Using Two-Factor Authentication. After we enter our password and 2FA, we are logged into the system successfully and our prompt in our terminal changes to what we used in our ssh command.

You won’t see any dots in the terminal window as you type your password. This is normal, please hit ‘enter’ after you finish typing your password & 2FA.

You will get two requests for 2FA with MobaXTerm, this is because not only is it logging you in with ssh, it also starts an SFTP session so you can move any files & data from your desktop onto the remote server while you are also logged in with a simple drag & drop!

Where arcc-t01 is our username and @tlog1 is the server we logged into. ‘tlog1’ is specifically one of the login nodes on the cluster host teton.arcc.uwyo.edu.

[arcc-t01@tlog1 ~]$

Now you can use the the HPC system the way you expect provided this works with your intended workflow.

 

Graphical Applications with MobaXTerm

The good news is that by default MobXTerm has X11 forwarding enabled. You can turn this on or off as you wish, but there are no additional steps to enable it.

Summary

In this tutorial we learned:

  • What an ssh client is

  • That MobaXterm has more functionality out of the box than other clients like PuTTY

  • How to download & Install MobaXTerm

  • How to create an ssh session and login to an HPC system

Next Steps

MobaXTerm has a lot more functionality that is beneficial for users including enabling SFTP data transfers while you are logged into an ssh session. Look for more Tutorials on using MobaXTerm with ARCC’s HPC services.

See Also

Logging into HPC from Windows sun the Command Prompt