# Connecting to Monsoon

There are two main methods to connect to Monsoon that we support.

The primary Monsoon interface is through text-based *command-line* interface, available through any program that uses the *SSH* protocol.

Command-line interfaces can be especially daunting for novice users, but they can also be extremely powerful; for this reason, we also offer a web-portal that lends a more-familiar graphical-interface to many of the most common tools and features needed to utilize Monsoon.

## Connecting via the OnDemand Web-Portal

The OnDemand Web-Portal progides a graphical user interface (GUI) to access Monsoon. This is great if you are not very familiar with using a terminal, but still need to access Monsoon.

![Screenshot of the OnDemand Webpage](<https://rcdata.nau.edu/hpcpub/docs-test/assets/in.nau.edu/wp-content/uploads/sites/208/image.png>)

[More OnDemand Information](<https://rcdata.nau.edu/hpcpub/docs-test/ondemand.html>)

## Connecting via Command-Line SSH

The primary mechanism for connecting to Monsoon, submitting work, monitoring progress, and retrieving results via a terminal is the *Secure Shell* Protocol (*SSH*), a terminal-based application that allows you to remotely access Monsoon securely.

One of the benefits of using Monsoon is that you don't have to remember a separate username and password for Monsoon as your Monsoon credentials are the same as your NAU credentials. If you don't know what those are, please [contact ITS](<https://www.nau.edu/its/help/>).

> [!NOTE]
>
> If you are not connected to the NAU WiFi, you must use the [NAU VPN](<https://in.nau.edu/its/remote-services/>) in order to access Monsoon.\*

### Opening a Terminal

The method of opening a terminal will vary depending on your operating system.

In recent years, Microsoft has been developing an application called *Windows Terminal* to bring a feature-rich terminal to Windows. Modern versions of Windows come with Windows Terminal pre-installed. If you do not have Windows Terminal installed or if you are unsure if it is installed on your system, you can download the program from the [Microsoft Store](<https://apps.microsoft.com/detail/9n0dx20hk701>).

#### Opening Windows Terminal

To open the Windows Terminal, press the *Windows* or *Start* key on your keyboard (looks like a square made up of four squares), type "Terminal", and press *Enter* on your keyboard.

![Visualization of the Terminal app in the Windows Start Menu](<https://rcdata.nau.edu/hpcpub/docs-test/assets/in.nau.edu/wp-content/uploads/sites/208/Screenshot-2024-01-19-150308.png>)

For more information on how to use the Windows Terminal, you can visit [Microsoft's documentation page](<https://learn.microsoft.com/en-us/windows/terminal/>).

On Mac OS, Apple provides a build-in terminal application called *Terminal.* To open this application, open [*Launchpad*](<https://support.apple.com/guide/mac-help/open-apps-with-launchpad-mh35840/14.0/mac/14.0>) and click on the icon labeled "Terminal".

For more information on how to use the Terminal application on Mac OS, you can visit Apple's [Terminal User Guide](<https://support.apple.com/guide/terminal/welcome/mac>).

Since you are using Linux, you are likely already familiar with the command-line interface and how to find it. Regardless, opening a terminal in Linux will vary depending on your desktop environment (Gnome, KDE, etc.).

For most major desktop environments, you can hit your *Super* key (sometimes referred to as the *Windows* or *Start* key) and type "Terminal", and your list of terminals should show up.

### Starting an SSH Connection

In Windows, Mac, and Linux, connecting to Monsoon is as simple as opening a terminal and using the *ssh* command to connect to monsoon:

```bash
ssh [UID]@monsoon.hpc.nau.edu
```

For example, someone with the NAU User ID of `abc123` would connect to Monsoon using the command:

```bash
ssh abc123@monsoon.hpc.nau.edu
```

> [!NOTE]
>
> If you are a classroom Monsoon user, you **MUST** replace `monsoon` with `rain`.

![Terminal SSH Demo](<https://rcdata.nau.edu/hpcpub/docs-test/assets/in.nau.edu/wp-content/uploads/sites/208/Screenshot-2024-01-19-151429.png>)

When you're first logging into a remote server using SSH, as an extra step of precaution, the client displays the following message: "*the authenticity of the host cannot be established*" to ensure that the remote server you are connecting to is correct. If this shows in your terminal, you can type "yes" and hit enter to continue.

![SSH Authenticity Demo](<https://rcdata.nau.edu/hpcpub/docs-test/assets/in.nau.edu/wp-content/uploads/sites/208/Screenshot-2024-01-19-151627-2.png>)

Once you are prompted with entering a password, enter your *NAU password*.

> [!NOTE]
>
> **Info**
>
> When typing your password, you will not receive visual feedback of what characters you entered.

## Next Steps

If you're unfamiliar with how to use a Linux system, you may next want to visit our [Linux/Bash Basics](<https://rcdata.nau.edu/hpcpub/docs-test/using-the-cluster/introduction/linux-bash-basics.html>) page.

If you need access to GUI applications on Monsoon, check to see if your program is available in OnDemand as an interactive app. If your app is not available, read our article on [how to set up X11 forwarding](<https://rcdata.nau.edu/hpcpub/docs-test/connecting-to-monsoon/x11-forwarding.html>).
