mobaxterm.md 4.07 KB
Newer Older
Caughlin Bohn's avatar
Caughlin Bohn committed
1
+++
2
3
title = "Connecting with MobaXterm"
description = "Connecting to and Transfering files between HCC Clusters with MobaXterm"
Caughlin Bohn's avatar
Caughlin Bohn committed
4
5
6
7
weight = "22"
+++

##### Use of Duo two-factor authentication is **required** to access HCC resources.
8
##### Please see [Setting up and Using Duo]({{< relref "setting_up_and_using_duo" >}}).
Caughlin Bohn's avatar
Caughlin Bohn committed
9
10
11
12
13
14
---

This quick start will help you configure your MobaXterm installation to work with HCC resources.

Access to HCC Supercomputers using MobaXterm
-------------------------------
Caughlin Bohn's avatar
Caughlin Bohn committed
15

Caughlin Bohn's avatar
Caughlin Bohn committed
16
To connect to HCC resources using MobaXterm, open the application and select the Session Icon. 
Caughlin Bohn's avatar
Caughlin Bohn committed
17
18
{{< figure src="/images/moba/main.png" height="450" >}}

19
20
Select SSH as the session type. Enter the cluster you are connecting to, in the example, `crane.unl.edu`, is used.  Check `Specify username`  and enter your HCC username in the the box. Note that &lt;username&gt;
should be replaced by your HCC account username. If you do not have a
Caughlin Bohn's avatar
Caughlin Bohn committed
21
HCC account, please contact a HCC specialist
22
({{< icon name="envelope" >}}[hcc-support@unl.edu](mailto:hcc-support@unl.edu))
Caughlin Bohn's avatar
Caughlin Bohn committed
23
or go to https://hcc.unl.edu/newusers.
24
To use the **Rhino** cluster, replace crane.unl.edu with with rhino.unl.edu.
Caughlin Bohn's avatar
Caughlin Bohn committed
25
{{< figure src="/images/moba/session.png" height="450" >}}
Caughlin Bohn's avatar
Caughlin Bohn committed
26
27

Select OK. You will be asked to enter your password and to authenticate with duo. 
Caughlin Bohn's avatar
Caughlin Bohn committed
28
{{< figure src="/images/moba/login.png" height="450" >}}
Caughlin Bohn's avatar
Caughlin Bohn committed
29
30
31
32
33
34
35
36
37
38
39
{{< figure src="/images/moba/loggedin.png" height="450" >}}

File Transferring with HCC Supercomputers
-----------------------------------------

### Using MobaXterm

MobaXterm allows file transfering in a 'drag and drop' style, similar to WinSCP. MobaXterm also allows editing of files from a built in text editor or an editor of your choice already installed on your local machine. 

**Uploading from local to remote**

Caughlin Bohn's avatar
Caughlin Bohn committed
40

Caughlin Bohn's avatar
Caughlin Bohn committed
41
42
43

The above example transfers a folder from a local directory of the your computer to the `$HOME` directory of the HCC
supercomputer, Crane. Note that you need to replace `<group name>`
44
and `<username>` with your HCC group name and username. 
Caughlin Bohn's avatar
Caughlin Bohn committed
45
{{< figure src="/images/moba/upload.png" height="450" >}}
Caughlin Bohn's avatar
Caughlin Bohn committed
46
47
**Downloading from remote to local**

Caughlin Bohn's avatar
Caughlin Bohn committed
48

Caughlin Bohn's avatar
Caughlin Bohn committed
49

50
51
The above example transfers a folder from the `$HOME` directory of
the HCC supercomputer, Crane, to a local directory on 
Caughlin Bohn's avatar
Caughlin Bohn committed
52
your computer.
Caughlin Bohn's avatar
Caughlin Bohn committed
53
{{< figure src="/images/moba/download.png" height="450" >}}
Caughlin Bohn's avatar
Caughlin Bohn committed
54
55
56
57
58
59
60
61
62
63
64
**Editing remote files**

By double clicking on a file in the toolbar of the left, you are able to open the file in the editor from MobaXterm.

{{< figure src="/images/moba/defaulttext.png" height="450" >}}

There is the option to use your own choice of editor already installed on your local machine. Under the `General` Tab in MobaXterm's settings, set the path of the editor's installation.

{{< figure src="/images/moba/editor.png" height="450" >}}

In the example above, Notepad++ is used as the choice editor. Once the editor is selected, it becomes the default editor for double clicking files and editing.
Caughlin Bohn's avatar
Caughlin Bohn committed
65
### Using an SFTP Session
Caughlin Bohn's avatar
Caughlin Bohn committed
66

Caughlin Bohn's avatar
Caughlin Bohn committed
67
68
69
70
71
72
73
74
75
With HCC Clusters, MobaXterm requires an additional option to be marked to allow SFTP sessions to properly work. MobaXterm will still prompt you for DUO authentication, but will not properly work unless the `2-Steps Authentication` checkbox is enabled in your session settings

To accomplish this, go to the `Advanced Sftp Settings` when creating a new SFTP session and select `2-Steps Authentication`


{{< figure src="/images/moba/MobaXTermSFTP2FA.png" height="450" >}}


### Generating SSH Keys
Caughlin Bohn's avatar
Caughlin Bohn committed
76
77
78
79
80
81
82
83
84
85
86
87

With Anvil, you will need to generate SSH keys in order to access your instances. These are able to be generated in MobaXterm. 

{{< figure src="/images/moba/menussh.png" height="450" >}}

In the Generator window, click `Generate` and move your mouse around in the `Key` box randomly to generate the key. 

{{< figure src="/images/moba/genssh.png" height="450" >}}

After the key is generated, go to the `Conversions` tab and select `Export OpenSSH key` and save it to your local machine. 

{{< figure src="/images/moba/exportssh.png" height="450" >}}
88
**Treat the private key file the same as you would a password.  Keep your private key in a secure location and do not share it with anyone.**
89