for_maclinux_users.md 4.74 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 = "22"
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
11
12
13
14
15
- [Access to HCC Supercomputers] (#access-to-hcc-supercomputers)
- [File Transferring with HCC Supercomputers] (#file-transfering)
 - [SCP] (#using-the-scp-command)
 - [CyberDuck] (#using-cyberduck)
- [Mac Tutorial Video](#mac-tutorial-video)
- [Linux Tutorial Video](#linux-tutorial-video)
16
17
18
19
20

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
21
Users]({{< relref "for_windows_users" >}}).
22

Adam Caprez's avatar
Adam Caprez committed
23
Access to HCC Supercomputers
24
25
-------------------------------

26
For Mac/Linux users, use the system program Terminal to access to the
27
28
29
30
31
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
32
33
34
35
36
({{< 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 >}}
37
38
$ ssh <username>@tusker.unl.edu
$ <password>
Adam Caprez's avatar
Adam Caprez committed
39
{{< /highlight >}}
40
41
42
43

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

44
45
### Using the SCP command

46
47
48
49
50
51
52
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
53
{{< highlight bash >}}
54
$ scp -r ./<folder name> <username>@tusker.unl.edu:/work/<group name>/<username>
Adam Caprez's avatar
Adam Caprez committed
55
{{< /highlight >}}
56
57
58
59
60
61
62
63

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
64
{{< highlight bash >}}
65
$ scp -r <username>@tusker.unl.edu:/work/<group name>/<username>/<folder name> ./
Adam Caprez's avatar
Adam Caprez committed
66
{{< /highlight >}}
67
68
69
70
71

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

72
### Using Cyberduck
73
74
75
76
---------------

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
77
78
to use [Cyberduck](http://cyberduck.io). It is compatible with Duo, but a 
few settings need to be changed.
79
80
81

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

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

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
88
{{< figure src="/images/7274498.png" height="450" >}}
89
90
91
92

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

Adam Caprez's avatar
Adam Caprez committed
93
{{< figure src="/images/7274499.png" height="450" >}}
94
95
96

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

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

Adam Caprez's avatar
Adam Caprez committed
99
100
101
102
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.
103

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

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

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

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

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

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

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

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
125
{{< figure src="/images/7274509.png" height="450" >}}
126
127
128
129

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

Adam Caprez's avatar
Adam Caprez committed
130
131
132
133
134
135
136
137
138
139
140
{{< figure src="/images/7274511.png" height="450" >}}

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

{{< youtube ulfcmRGfqxU >}}

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

{{< youtube K0i3swpwtdc >}}