for_maclinux_users.md 4.55 KB
Newer Older
1
2
3
+++
title = "For Mac/Linux Users"
description = "Quickstart Guide for Mac/Linux Users"
Adam Caprez's avatar
Adam Caprez committed
4
weight = "30"
5
6
+++

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

Adam Caprez's avatar
Adam Caprez committed
11
###### [Jump to the Mac Tutorial Video](#mac-tutorial-video) | [Jump to the Linux Tutorial Video](#linux-tutorial-video)
12
13
14
15
16

This quick start will help you configure your personal computer to work
with the HCC supercomputers.

If you are running Windows, please use the quickstart [For Windows
Adam Caprez's avatar
Adam Caprez committed
17
Users]({{< relref "for_windows_users" >}}).
18
19
20
21
22
23
24
25
26
27

Accessing to HCC Supercomputers
-------------------------------

For Mac/Linux users, use the system program Terminal to assess to the
HCC supercomputers. In the Terminal prompt,
type `ssh <username>@tusker.unl.edu` and the corresponding password
to get access to the HCC cluster **Tusker**. Note that &lt;username&gt;
should be replaced by your HCC account username. If you do not have a
HCC account, please contact a HCC specialist
Adam Caprez's avatar
Adam Caprez committed
28
29
30
31
32
({{< icon name="envelope" >}}[hcc-support@unl.edu] (mailto:hcc-support@unl.edu))
or go to http://hcc.unl.edu/newusers.
To use the **Crane** cluster, replace tusker.unl.edu with with crane.unl.edu.

{{< highlight bash >}}
33
34
$ ssh <username>@tusker.unl.edu
$ <password>
Adam Caprez's avatar
Adam Caprez committed
35
{{< /highlight >}}
36
37
38
39
40
41
42
43
44
45
46

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

For Mac/Linux users, file transferring between your personal computer
and the HCC supercomputers can be achieved through the commend `scp`.
Here we use **Tusker** for example. **The following commands should be
executed from your computer. **

**Uploading from local to remote**

Adam Caprez's avatar
Adam Caprez committed
47
{{< highlight bash >}}
48
$ scp -r ./<folder name> <username>@tusker.unl.edu:/work/<group name>/<username>
Adam Caprez's avatar
Adam Caprez committed
49
{{< /highlight >}}
50
51
52
53
54
55
56
57

The above commend line transfers a folder from the current directory
(`./`) of the your computer to the `$WORK` directory of the HCC
supercomputer, Tusker. Note that you need to replace `<group name>`
and `<username>` with your HCC group name and username. 

**Downloading from remote to local**

Adam Caprez's avatar
Adam Caprez committed
58
{{< highlight bash >}}
59
$ scp -r <username>@tusker.unl.edu:/work/<group name>/<username>/<folder name> ./
Adam Caprez's avatar
Adam Caprez committed
60
{{< /highlight >}}
61
62
63
64
65
66
67
68
69
70

The above commend line transfers a folder from the `$WORK` directory of
the HCC supercomputer, Tusker, to the current directory (`./`) of the
your computer.

Using Cyberduck
---------------

If you wish to use a GUI, be aware that not all programs will function
correctly with Duo two-factor authentication.  Mac users are recommended
Adam Caprez's avatar
Adam Caprez committed
71
72
to use [Cyberduck](http://cyberduck.io). It is compatible with Duo, but a 
few settings need to be changed.
73
74
75

Under **Preferences - General**, change the default protocol to SFTP:

Adam Caprez's avatar
Adam Caprez committed
76
{{< figure src="/images/7274497.png" height="450" >}}
77
78
79
80
81

Under **Preferences - Transfers**, reuse the browser connection for file
transfers.  This will avoid the need to reenter your password for every
file transfer:

Adam Caprez's avatar
Adam Caprez committed
82
{{< figure src="/images/7274498.png" height="450" >}}
83
84
85
86

Finally, under **Preferences - SFTP**, set the file transfer method to
SCP:

Adam Caprez's avatar
Adam Caprez committed
87
{{< figure src="/images/7274499.png" height="450" >}}
88
89
90

To add an HCC machine, in the bookmarks pane click the "+" icon:

Adam Caprez's avatar
Adam Caprez committed
91
{{< figure src="/images/7274500.png" height="450" >}}
92

Adam Caprez's avatar
Adam Caprez committed
93
94
95
96
Ensure the type of connection is SFTP.  Enter the hostname of the machine 
you wish to connect to (tusker.unl.edu, crane.unl.edu) in the **Server**
field, and your HCC username in the **Username** field.  The
**Nickname** field is arbitrary, so enter whatever you prefer.
97

Adam Caprez's avatar
Adam Caprez committed
98
{{< figure src="/images/7274501.png" height="450" >}}
99
100
101

After you add the bookmark, double-click it to connect.

Adam Caprez's avatar
Adam Caprez committed
102
{{< figure src="/images/7274505.png" height="450" >}}
103
104
105
106

Enter your HCC username and password in the dialog box that will appear
and click *Login*.

Adam Caprez's avatar
Adam Caprez committed
107
{{< figure src="/images/7274508.png" height="450" >}}
108
109
110
111

A second login dialogue will now appear.  Notice the text has changed to
say Duo two-factor.

Adam Caprez's avatar
Adam Caprez committed
112
{{< figure src="/images/7274510.png" height="450" >}}
113
114
115
116
117
118

Clear the **Password** field in the dialogue.  If you are using the Duo
Mobile app, enter '1' to have a push notification send to your phone or
tablet.  If you are using a Yubikey, ensure the cursor is active in the
**Password** field, and press the button on the Yubikey.

Adam Caprez's avatar
Adam Caprez committed
119
{{< figure src="/images/7274509.png" height="450" >}}
120
121
122
123

The login should complete and you can simply drag and drop files to or
from the window.

Adam Caprez's avatar
Adam Caprez committed
124
125
126
127
128
129
130
131
132
133
134
{{< figure src="/images/7274511.png" height="450" >}}

Mac Tutorial Video
------------------

{{< youtube ulfcmRGfqxU >}}

Linux Tutorial Video
--------------------

{{< youtube K0i3swpwtdc >}}