Skip to content
Snippets Groups Projects
Commit d64366a5 authored by Adam Caprez's avatar Adam Caprez
Browse files

Update quickstarts

parent 1f6e2722
Branches
No related tags found
No related merge requests found
Showing
with 459 additions and 1852 deletions
+++
title = "HCC Documentation"
description = "HCC Documentation Home"
weight = "1"
+++
HCC Documentation HCC Documentation
============================ ============================
...@@ -13,7 +19,7 @@ existing resource, acquiring 'priority access'. Finally, several ...@@ -13,7 +19,7 @@ existing resource, acquiring 'priority access'. Finally, several
machines are available via Condor for opportunistic use. This will allow machines are available via Condor for opportunistic use. This will allow
users almost immediate access, but the job is subject to preemption. users almost immediate access, but the job is subject to preemption.
#### <a href="http://hcc.unl.edu/new-user-request" class="external-link">New Users Sign Up</a> #### [New Users Sign Up](http://hcc.unl.edu/new-user-request)
#### [Quick Start Guides](/quickstarts) #### [Quick Start Guides](/quickstarts)
...@@ -31,12 +37,6 @@ campus users. It has 4 CPU/ 64 cores and 256GB RAM per nodes. Two nodes ...@@ -31,12 +37,6 @@ campus users. It has 4 CPU/ 64 cores and 256GB RAM per nodes. Two nodes
have 512GB RAM for very large memory jobs. So for jobs requiring more have 512GB RAM for very large memory jobs. So for jobs requiring more
than 16 cores per node or large memory, Tusker would be a better option. than 16 cores per node or large memory, Tusker would be a better option.
**Sandhills**: Sandhills is a condominium-style cluster, and the
majority is owned by various research groups on campus. Jobs from
resource owners have first priority in their owned partitions. Users
that do not own resources (Guests) can do opportunistic computation, but
we would recommend using Crane or Tusker.
User Login User Login
---------- ----------
...@@ -79,27 +79,19 @@ $ cd $WORK ...@@ -79,27 +79,19 @@ $ cd $WORK
Resources Resources
--------- ---------
- <span style="color: rgb(0,0,0);">Crane</span> - HCC's newest - ##### Crane - HCC's newest machine, Crane has 7232 Intel Xeon cores in 452 nodes with 64GB RAM per node.
machine, Crane has 7232 Intel Xeon cores in 452 nodes with 64GB RAM
per node.
- Tusker - consists of 106 AMD Interlagos-based nodes (6784 cores) - ##### Tusker - consists of 106 AMD Interlagos-based nodes (6784 cores) interconnected with Mellanox QDR Infiniband.
interconnected with Mellanox QDR Infiniband.
- Sandhills - has 1440 AMD cores housed in 42 nodes with 128GB per - ##### [Red](http://hcc.unl.edu/red/index.php) - This cluster is the resource for UNL's US CMS Tier-2 site.
node and 2 nodes with 256GB per node.
- <a href="http://hcc.unl.edu/red/index.php" class="external-link">Red </a>- - [CMS](http://www.uscms.org/)
This cluster is the resource for UNL's US CMS Tier-2 site. - [Open Science Grid](http://www.opensciencegrid.org)
- [MyOSG](https://myosg.grid.iu.edu/)
- <a href="http://www.uscms.org/" class="external-link">CMS</a> - ##### Anvil - HCC's cloud computing cluster based on Openstack
- <a href="http://www.opensciencegrid.org/" class="external-link">Open Science Grid</a>
- <a href="https://myosg.grid.iu.edu/" class="external-link">MyOSG</a>
- [Glidein](The-Open-Science-Grid_11635314.html) - A gateway to - ##### [Glidein](The-Open-Science-Grid_11635314.html) - A gateway to running jobs on the OSG, a collection of computing resources across the US.
running jobs on the OSG, a collection of computing resources across
the US.
- Anvil - HCC's cloud computing cluster based on Openstack
Resource Capabilities Resource Capabilities
--------------------- ---------------------
......
1. [HCC-DOCS](index.html) +++
2. [HCC-DOCS Home](HCC-DOCS-Home_327685.html) title = "Basic Linux commands"
3. [HCC Documentation](HCC-Documentation_332651.html) description = "Simple commands you'll want to know"
4. [Quick Start Guides](Quick-Start-Guides_1245279.html) weight = "32"
+++
<span id="title-text"> HCC-DOCS : Bash Commands </span> Basic commands
======================================================= --------------
Created by <span class="author"> Carrie Brown</span>, last modified on ###### [[Jump to the Video Tutorial]](#tutorial-video)
Oct 26, 2017
[Video Tutorial](#BashCommands-video)
Holland clusters all run on the Linux operating system, similarly to how Holland clusters all run on the Linux operating system, similarly to how
your personal computer might run Windows or Mac OS. However, unlike your personal computer might run Windows or Mac OS. However, unlike
...@@ -26,12 +24,12 @@ versatility and performance.** ...@@ -26,12 +24,12 @@ versatility and performance.**
Below, we have compiled a list of common commands and usage examples. Below, we have compiled a list of common commands and usage examples.
For a more information, check out one of these references: For a more information, check out one of these references:
- <a href="https://eharstad.github.io/shell-novice/" class="external-link">Software Carpentry's &quot;Introduction to the Bash Shell&quot; Lesson</a> - - [Software Carpentrys "Introduction to the Bash Shell" Lesson](https://eharstad.github.io/shell-novice) -
a great walkthrough of the basics of Bash designed for novice users a great walkthrough of the basics of Bash designed for novice users
- <a href="http://www.comptechdoc.org/os/linux/usersguide/" class="external-link">Linux Users Guide</a> - - [Linux Users Guide](http://www.comptechdoc.org/os/linux/usersguide) -
detailed information about the Linux command line and how to utilize detailed information about the Linux command line and how to utilize
it it
- <a href="https://www.cheatography.com/davechild/cheat-sheets/linux-command-line/" class="external-link">Linux Command Line Cheat Sheet</a> - - [Linux Command Line Cheat Sheet](https://www.cheatography.com/davechild/cheat-sheets/linux-command-line) -
a quick reference for Linux commands. Offers a PDF version that you a quick reference for Linux commands. Offers a PDF version that you
can print out. can print out.
...@@ -210,8 +208,7 @@ cd $HOME (or $WORK) ...@@ -210,8 +208,7 @@ cd $HOME (or $WORK)
</tbody> </tbody>
</table> </table>
<span id="BashCommands-video" class="confluence-anchor-link"></span> Tutorial Video
--------------
Document generated by Confluence on Oct 24, 2018 14:47
[Atlassian](http://www.atlassian.com/) {{< youtube B0VdKiHNjU4 >}}
+++ +++
title = "For Mac/Linux Users" title = "For Mac/Linux Users"
description = "Quickstart Guide for Mac/Linux Users" description = "Quickstart Guide for Mac/Linux Users"
weight = "30" weight = "22"
+++ +++
##### Use of Duo two-factor authentication is **required** to access HCC resources. ##### Use of Duo two-factor authentication is **required** to access HCC resources.
...@@ -16,7 +16,7 @@ with the HCC supercomputers. ...@@ -16,7 +16,7 @@ with the HCC supercomputers.
If you are running Windows, please use the quickstart [For Windows If you are running Windows, please use the quickstart [For Windows
Users]({{< relref "for_windows_users" >}}). Users]({{< relref "for_windows_users" >}}).
Accessing to HCC Supercomputers Access to HCC Supercomputers
------------------------------- -------------------------------
For Mac/Linux users, use the system program Terminal to assess to the For Mac/Linux users, use the system program Terminal to assess to the
......
+++
title = "Fortran/C on HCC"
description = "How to compile and run Fortran/C program on HCC machines"
weight = "50"
+++
This quick start demonstrates how to implement a Fortran/C program on
HCC supercomputers. The sample codes and submit scripts can be
downloaded from [serial_dir.zip](/attachments/serial_dir.zip).
#### Login to a HCC Cluster (Tusker or Crane)
Log in to a HCC cluster through PuTTY ([For Windows Users]({{< relref "/quickstarts/for_windows_users">}})) or Terminal ([For Mac/Linux
Users]({{< relref "/quickstarts/for_maclinux_users">}})) and make a subdirectory called `serial_dir` under the `$WORK` directory.
{{< highlight bash >}}
$ cd $WORK
$ mkdir serial_dir
{{< /highlight >}}
In the subdirectory `serial_dir`, save all the relevant Fortran/C codes. Here we include two demo
programs, `demo_f_serial.f90` and `demo_c_serial.c`, that compute the sum from 1 to 20.
{{%expand "demo_f_serial.f90" %}}
{{< highlight bash >}}
Program demo_f_serial
implicit none
integer, parameter :: N = 20
real*8 w
integer i
common/sol/ x
real*8 x
real*8, dimension(N) :: y
do i = 1,N
w = i*1d0
call proc(w)
y(i) = x
write(6,*) 'i,x = ', i, y(i)
enddo
write(6,*) 'sum(y) =',sum(y)
Stop
End Program
Subroutine proc(w)
real*8, intent(in) :: w
common/sol/ x
real*8 x
x = w
Return
End Subroutine
{{< /highlight >}}
{{% /expand %}}
{{%expand "demo_c_serial.c" %}}
{{< highlight c >}}
//demo_c_serial
#include <stdio.h>
double proc(double w){
double x;
x = w;
return x;
}
int main(int argc, char* argv[]){
int N=20;
double w;
int i;
double x;
double y[N];
double sum;
for (i = 1; i <= N; i++){
w = i*1e0;
x = proc(w);
y[i-1] = x;
printf("i,x= %d %lf\n", i, y[i-1]) ;
}
sum = 0e0;
for (i = 1; i<= N; i++){
sum = sum + y[i-1];
}
printf("sum(y)= %lf\n", sum);
return 0;
}
{{< /highlight >}}
{{% /expand %}}
---
#### Compiling the Code
The compiling of a Fortran/C++ code to executable is usually done behind
the scene in a Graphical User Interface (GUI) environment, such as
Microsoft Visual Studio. In a HCC cluster, the compiling is done
explicitly by first loading a choice compiler and then executing the
corresponding compiling command. Here we will use the GNU Complier
Collection, `gcc`, for demonstration. Other available compilers such as
`intel` or `pgi` can be looked up using the command
line `module avail`. Before compiling the code, make sure there is no
dependency on any numerical library in the code. If invoking a numerical
library is necessary, contact a HCC specialist
({{< icon name="envelope" >}}[hcc-support@unl.edu] (mailto:hcc-support@unl.edu)) to
discuss implementation options.
{{< highlight bash >}}
$ module load compiler/gcc/8.2
$ gfortran demo_f_serial.f90 -o demo_f_serial.x
$ gcc demo_c_serial.c -o demo_c_serial.x
{{< /highlight >}}
The above commends load the `gcc` complier and use the compiling
commands `gfortran` or `gcc` to compile the codes to`.x` files
(executables).
#### Creating a Submit Script
Create a submit script to request one core (default) and 1-min run time
on the supercomputer. The name of the main program enters at the last
line.
{{% panel header="`submit_f.serial`"%}}
{{< highlight bash >}}
#!/bin/sh
#SBATCH --mem-per-cpu=1024
#SBATCH --time=00:01:00
#SBATCH --job-name=Fortran
#SBATCH --error=Fortran.%J.err
#SBATCH --output=Fortran.%J.out
module load compiler/gcc/4.9
./demo_f_serial.x
{{< /highlight >}}
{{% /panel %}}
{{% panel header="`submit_c.serial`"%}}
{{< highlight bash >}}
#!/bin/sh
#SBATCH --mem-per-cpu=1024
#SBATCH --time=00:01:00
#SBATCH --job-name=C
#SBATCH --error=C.%J.err
#SBATCH --output=C.%J.out
module load compiler/gcc/4.9
./demo_c_serial.x
{{< /highlight >}}
{{% /panel %}}
#### Submit the Job
The job can be submitted through the command `sbatch`. The job status
can be monitored by entering `squeue` with the `-u` option.
{{< highlight bash >}}
$ sbatch submit_f.serial
$ sbatch submit_c.serial
$ squeue -u <username>
{{< /highlight >}}
Replace `<username>` with your HCC username.
#### Sample Output
The sum from 1 to 20 is computed and printed to the `.out` file (see
below).
{{%expand "Fortran.out" %}}
{{< highlight batchfile>}}
i,x = 1 1.0000000000000000
i,x = 2 2.0000000000000000
i,x = 3 3.0000000000000000
i,x = 4 4.0000000000000000
i,x = 5 5.0000000000000000
i,x = 6 6.0000000000000000
i,x = 7 7.0000000000000000
i,x = 8 8.0000000000000000
i,x = 9 9.0000000000000000
i,x = 10 10.000000000000000
i,x = 11 11.000000000000000
i,x = 12 12.000000000000000
i,x = 13 13.000000000000000
i,x = 14 14.000000000000000
i,x = 15 15.000000000000000
i,x = 16 16.000000000000000
i,x = 17 17.000000000000000
i,x = 18 18.000000000000000
i,x = 19 19.000000000000000
i,x = 20 20.000000000000000
sum(y) = 210.00000000000000
{{< /highlight >}}
{{% /expand %}}
{{%expand "C.out" %}}
{{< highlight batchfile>}}
i,x= 1 1.000000
i,x= 2 2.000000
i,x= 3 3.000000
i,x= 4 4.000000
i,x= 5 5.000000
i,x= 6 6.000000
i,x= 7 7.000000
i,x= 8 8.000000
i,x= 9 9.000000
i,x= 10 10.000000
i,x= 11 11.000000
i,x= 12 12.000000
i,x= 13 13.000000
i,x= 14 14.000000
i,x= 15 15.000000
i,x= 16 16.000000
i,x= 17 17.000000
i,x= 18 18.000000
i,x= 19 19.000000
i,x= 20 20.000000
sum(y)= 210.000000
{{< /highlight >}}
{{% /expand %}}
This diff is collapsed.
1. [HCC-DOCS](index.html) +++
2. [HCC-DOCS Home](HCC-DOCS-Home_327685.html) title = "Changing Your Password"
3. [HCC Documentation](HCC-Documentation_332651.html) description = "How to change your HCC password"
4. [Quick Start Guides](Quick-Start-Guides_1245279.html) weight = "30"
+++
<span id="title-text"> HCC-DOCS : How to change your password </span>
===================================================================== How to change your password
---------------------------
Created by <span class="author"> Adam Caprez</span>, last modified by
<span class="editor"> Carrie Brown</span> on Oct 24, 2018 {{% notice info%}}
**Your account must be active with Duo authentication setup in order for
<span the following instructions to work.**
class="aui-icon aui-icon-small aui-iconfont-info confluence-information-macro-icon"></span> {{% /notice %}}
Your account must be active with Duo authentication setup in order for - [HCC password requirements](#hcc-password-requirements)
the following instructions to work. - [Changing a known HCC password](#changing-a-known-hcc-password)
- [Change your password via the command line](#change-your-password-via-the-command-line)
- [HCC password - [Change your password using the myHCC User Portal](#change-your-password-using-the-myhcc-user-portal)
requirements](#Howtochangeyourpassword-HCCpasswordrequirements) - [Resetting a forgotten HCC password](#resetting-a-forgotten-hcc-password)
- [Changing a known HCC - [Tutorial Video](#tutorial-video)
password](#Howtochangeyourpassword-ChangingaknownHCCpassword)
- [Change your password via the command
line](#Howtochangeyourpassword-Changeyourpasswordviathecommandline)
- [Change your password using the myHCC User
Portal](#Howtochangeyourpassword-ChangeyourpasswordusingthemyHCCUserPortal)
- [Resetting a forgotten HCC
password](#Howtochangeyourpassword-ResettingaforgottenHCCpassword)
- [Tutorial Video](#Howtochangeyourpassword-TutorialVideo)
Every HCC user has a password that is same on all HCC machines Every HCC user has a password that is same on all HCC machines
(Sandhills, Tusker, Crane). This password needs to satisfy the HCC (Tusker, Crane, Anvil). This password needs to satisfy the HCC
password requirements.<span style="line-height: 1.42857;"> </span> password requirements.
### **HCC password requirements** ### HCC password requirements
All HCC passwords must meet the following requirements when they are All HCC passwords must meet the following requirements when they are
created or changed: created or changed:
...@@ -39,36 +31,33 @@ created or changed: ...@@ -39,36 +31,33 @@ created or changed:
- at least 8 characters long - at least 8 characters long
- at least 1 capital letter - at least 1 capital letter
- at least 1 number - at least 1 number
- **can not**<span style="line-height: 1.42857;"> contain an existing - **can not** contain an existing dictionary word
dictionary word</span> - **can not** contain information from user's account details (*username*,
- **can not**<span style="line-height: 1.42857;"> contain information *email*)
from user's account details (</span>*username*<span
style="line-height: 1.42857;">, </span>*email*<span
style="line-height: 1.42857;">)</span>
Using special characters in the password is not required, but it is Using special characters in the password is not required, but it is
allowed. Also, the system keeps a history of the user's previous two allowed. Also, the system keeps a history of the user's previous two
passwords, and their reuse is not allowed. passwords, and their reuse is not allowed.
### **Changing a known HCC password** ### Changing a known HCC password
If you know your current HCC password, you can use one of two approaches If you know your current HCC password, you can use one of two approaches
to change it: to change it:
#### **Change your password via the command line ** #### Change your password via the command line
To change a current or temporary password, the user needs to login to To change a current or temporary password, the user needs to login to
any HCC cluster (Crane or Tusker) and use the ***passwd*** command: any HCC cluster (Crane or Tusker) and use the ***passwd*** command:
**Change HCC password** **Change HCC password**
``` syntaxhighlighter-pre {{< highlight bash >}}
$ passwd $ passwd
Changing password for user <username>. Changing password for user <username>.
Current Password: Current Password:
New password: New password:
New password: New password:
``` {{< /highlight >}}
With this command, the user is first prompted for his/her old password. With this command, the user is first prompted for his/her old password.
If the "*Current Password*" is correct, then the user is asked twice for If the "*Current Password*" is correct, then the user is asked twice for
...@@ -77,30 +66,24 @@ needs to fulfill the HCC password requirements. ...@@ -77,30 +66,24 @@ needs to fulfill the HCC password requirements.
#### Change your password using the myHCC User Portal #### Change your password using the myHCC User Portal
1. Login to the 1. Login to the [myHCC User Portal](https://hcc.unl.edu/myhcc)
<a href="https://hcc.unl.edu/myhcc/" class="external-link">myHCC User Portal</a>
with your HCC credentials. with your HCC credentials.
2. Click **Update Account** in the top menu 2. Click **Update Account** in the top menu
<span {{< figure src="/images/35326617.png" height="150" >}}
class="confluence-embedded-file-wrapper image-center-wrapper confluence-embedded-manual-size"><img src="assets/images/13041705/35326617.png" class="confluence-embedded-image image-center" height="150" /></span>
3. Enter your new password in the **Password** and **Retype Password** 3. Enter your new password in the **Password** and **Retype Password**
boxes and click **Modify** to save boxes and click **Modify** to save
<span {{< figure src="/images/35326618.png" height="150" >}}
class="confluence-embedded-file-wrapper image-center-wrapper confluence-embedded-manual-size"><img src="assets/images/13041705/35326618.png" class="confluence-embedded-image image-center" height="150" /></span>
### **Resetting a forgotten HCC password** ### Resetting a forgotten HCC password
To reset your password, navigate to the To reset your password, navigate to the [myHCC User Portal](https://hcc.unl.edu/myhcc/) in your browser
<a href="https://hcc.unl.edu/myhcc/" class="external-link">myHCC User Portal</a>
in your browser
Click the link to reset your forgotten password Click the link to reset your forgotten password
<span {{< figure src="/images/35326619.png" height="400" >}}
class="confluence-embedded-file-wrapper image-center-wrapper confluence-embedded-manual-size"><img src="assets/images/13041705/35326619.png" class="confluence-embedded-image image-center" height="400" /></span>
Fill in the requested information (your HCC user name and email Fill in the requested information (your HCC user name and email
associated with your account) and click **Reset Password**. A reset link associated with your account) and click **Reset Password**. A reset link
...@@ -109,24 +92,4 @@ onscreen prompts to set a new password. ...@@ -109,24 +92,4 @@ onscreen prompts to set a new password.
### Tutorial Video ### Tutorial Video
{{< youtube eaTW6FDhpsM >}}
<span id="Howtochangeyourpassword-Video"
class="confluence-anchor-link"></span>
Attachments:
------------
<img src="assets/images/icons/bullet_blue.gif" width="8" height="8" />
[image2018-10-18\_13-25-46.png](attachments/13041705/35326617.png)
(image/png)
<img src="assets/images/icons/bullet_blue.gif" width="8" height="8" />
[image2018-10-18\_13-27-34.png](attachments/13041705/35326618.png)
(image/png)
<img src="assets/images/icons/bullet_blue.gif" width="8" height="8" />
[image2018-10-18\_13-31-22.png](attachments/13041705/35326619.png)
(image/png)
Document generated by Confluence on Oct 24, 2018 14:47
[Atlassian](http://www.atlassian.com/)
1. [HCC-DOCS](index.html) +++
2. [HCC-DOCS Home](HCC-DOCS-Home_327685.html) title = "How to setup X11 forwarding"
3. [HCC Documentation](HCC-Documentation_332651.html) description = "Use X11 forwarding to view GUI programs remotely"
4. [Quick Start Guides](Quick-Start-Guides_1245279.html) weight = "35"
+++
<span id="title-text"> HCC-DOCS : How to setup X11 forwarding </span> ##### If you are connecting to HCC clusters via a PC running Windows, please take the following steps to setup X11 forwarding.
=====================================================================
Created by <span class="author"> Jingchao Zhang</span>, last modified by
<span class="editor"> Adam Caprez</span> on Jun 20, 2018
If you are connecting to HCC clusters via a PC running Windows, please take the following steps to setup X11 forwarding.
------------------------------------------------------------------------------------------------------------------------
1. Download Xming to your local PC and install. Download 1. Download Xming to your local PC and install. Download
link: <a href="http://sourceforge.net/project/downloading.php?group_id=156984&amp;filename=Xming-6-9-0-31-setup.exe" class="external-link">http://sourceforge.net/project/downloading.php?group_id=156984&amp;filename=Xming-6-9-0-31-setup.exe</a> link: https://downloads.sourceforge.net/project/xming/Xming/6.9.0.31/Xming-6-9-0-31-setup.exe
2. Download PuTTY to your local PC and install. Download 2. Download PuTTY to your local PC and install. Download link: http://the.earth.li/~sgtatham/putty/latest/x86/putty.exe
link: <a href="http://the.earth.li/~sgtatham/putty/latest/x86/putty.exe" class="external-link">http://the.earth.li/~sgtatham/putty/latest/x86/putty.exe</a>
3. Open Xming and keep it running in the background. 3. Open Xming and keep it running in the background.
4. Configure PuTTY as below: 4. Configure PuTTY as below:
<span {{< figure src="/images/11637370.png" height="400" >}}
class="confluence-embedded-file-wrapper confluence-embedded-manual-size"><img src="assets/images/11637375/11637370.png" class="confluence-embedded-image" height="400" /></span><span {{< figure src="/images/11637371.jpg" height="400" >}}
class="confluence-embedded-file-wrapper confluence-embedded-manual-size"><img src="assets/images/11637375/11637371.jpg" class="confluence-embedded-image" height="400" /></span>
5. To test your X11 setup, after login, type command "xeyes" and press 5. To test your X11 setup, after login, type command `xeyes` and press
enter. enter.
<span {{< figure src="/images/11637372.png" height="400" >}}
class="confluence-embedded-file-wrapper confluence-embedded-manual-size"><img src="assets/images/11637375/11637372.png" class="confluence-embedded-image" height="400" /></span>
6. Close the xeyes application by "Ctrl + c" from the terminal or click 6. Close the xeyes application by "Ctrl + c" from the terminal or click
the close button on the up-right corner of the graphical window. the close button on the up-right corner of the graphical window.
If you are connecting to HCC clusters via a Macintosh, please take the following steps to setup X11 forwarding. ##### If you are connecting to HCC clusters via a Macintosh, please take the following steps to setup X11 forwarding.
---------------------------------------------------------------------------------------------------------------
- <span style="color: rgb(51,51,51);font-size: 14.0px;line-height: 1.42857;">Check the OS version on your Mac, if it's below 10.8., you can simply type "ssh -Y username@hostname" in your terminal to login.</span> - Check the OS version on your Mac, if it's below 10.8., you can simply type `ssh -Y username@hostname` in your terminal to login.
------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------
<span
style="color: rgb(51,51,51);font-size: 14.0px;line-height: 1.42857;">
</span>
- If your OS version is newer than 10.8, please do the following: - If your OS version is newer than 10.8, please do the following:
1. Download and install XQuartz. 1. Download and install XQuartz.
Download link: <a href="http://xquartz.macosforge.org/downloads/SL/XQuartz-2.7.7.dmg" class="external-link">http://xquartz.macosforge.org/downloads/SL/XQuartz-2.7.7.dmg</a> Download link: https://dl.bintray.com/xquartz/downloads/XQuartz-2.7.11.dmg
2. Type "ssh -Y username@hostname" in your terminal to login. 2. Type `ssh -Y username@hostname` in your terminal to login.
3. To test your X11 setup, after login, type command "xeyes" and press 3. To test your X11 setup, after login, type command "xeyes" and press
enter. enter.
<span
class="confluence-embedded-file-wrapper confluence-embedded-manual-size"><img src="assets/images/11637375/11637374.png" class="confluence-embedded-image" height="400" /></span> {{< figure src="/images/11637374.png" height="400" >}}
4. Close the xeyes application by "control + c" from the terminal or 4. Close the xeyes application by "Control + c" from the terminal or
click the close button on the up-left corner of the graphical click the close button on the up-left corner of the graphical
window. window.
##### If you are connecting to HCC clusters via a Linux laptop, please take the following steps to setup X11 forwarding.
If you are connecting to HCC clusters via a Linux laptop, please take the following steps to setup X11 forwarding.
------------------------------------------------------------------------------------------------------------------
1. Open the remote client terminal. 1. Open the remote client terminal.
2. Type "ssh -Y username@hostname" in your terminal to login. 2. Type `ssh -Y username@hostname`" in your terminal to login.
3. To test your X11 setup, after login, type command "xeyes" and press 3. To test your X11 setup, after login, type command "xeyes" and press
enter. enter.
4. Close the xeyes application by "Ctrl + c" from the terminal or click 4. Close the xeyes application by "Ctrl + c" from the terminal or click
...@@ -66,37 +50,10 @@ If you are connecting to HCC clusters via a Linux laptop, please take the follo ...@@ -66,37 +50,10 @@ If you are connecting to HCC clusters via a Linux laptop, please take the follo
Related articles #### Related articles
----------------
<a href="http://www.straightrunning.com/XmingNotes/" class="external-link">X11 on Windows</a> [X11 on Windows](http://www.straightrunning.com/XmingNotes)
<a href="https://en.wikipedia.org/wiki/XQuartz" class="external-link">X11 on Mac</a> [X11 on Mac](https://en.wikipedia.org/wiki/XQuartz)
<a href="http://www.wikihow.com/Configure-X11-in-Linux" class="external-link">X11 on Linux</a>
Attachments: [X11 on Linux](http://www.wikihow.com/Configure-X11-in-Linux)
------------
<img src="assets/images/icons/bullet_blue.gif" width="8" height="8" />
[PuTTY\_1.jpg](attachments/11637375/11637369.jpg) (image/jpeg)
<img src="assets/images/icons/bullet_blue.gif" width="8" height="8" />
[PuTTY\_1.jpg](attachments/11637375/11637368.jpg) (image/jpeg)
<img src="assets/images/icons/bullet_blue.gif" width="8" height="8" />
[PuTTY\_1.png](attachments/11637375/11637370.png) (image/png)
<img src="assets/images/icons/bullet_blue.gif" width="8" height="8" />
[PuTTY\_2.jpg](attachments/11637375/11637371.jpg) (image/jpeg)
<img src="assets/images/icons/bullet_blue.gif" width="8" height="8" />
[PuTTY\_3.png](attachments/11637375/11637372.png) (image/png)
<img src="assets/images/icons/bullet_blue.gif" width="8" height="8" />
[max\_02.png](attachments/11637375/11637374.png) (image/png)
Document generated by Confluence on Oct 24, 2018 14:47
[Atlassian](http://www.atlassian.com/)
1. [HCC-DOCS](index.html) +++
2. [HCC-DOCS Home](HCC-DOCS-Home_327685.html) title = "Reusing SSH connections in Linux/Mac"
3. [HCC Documentation](HCC-Documentation_332651.html) description = "Reusing connections makes it easier to use multiple terminals"
4. [Quick Start Guides](Quick-Start-Guides_1245279.html) weight = "37"
+++
<span id="title-text"> HCC-DOCS : Reusing SSH connections in Linux/Mac </span>
==============================================================================
Created by <span class="author"> Adam Caprez</span>, last modified by
<span class="editor"> Derek Weitzel</span> on Feb 27, 2014
To make it more convenient for users who use multiple terminal sessions To make it more convenient for users who use multiple terminal sessions
simultaneously, SSH can reuse an existing connection if connecting from simultaneously, SSH can reuse an existing connection if connecting from
...@@ -16,25 +11,20 @@ that connection, eliminating the need to enter the username and password ...@@ -16,25 +11,20 @@ that connection, eliminating the need to enter the username and password
each time for every connection. To enable this feature, add the each time for every connection. To enable this feature, add the
following lines to your `~/.ssh/config `file: following lines to your `~/.ssh/config `file:
**\~/.ssh/config** {{% panel header="`~/.ssh/config`"%}}
{{< highlight bash >}}
``` syntaxhighlighter-pre
Host * Host *
ControlMaster auto ControlMaster auto
ControlPath /tmp/%r@%h:%p ControlPath /tmp/%r@%h:%p
ControlPersist 2h ControlPersist 2h
``` {{< /highlight >}}
{{% /panel %}}
<span
class="aui-icon aui-icon-small aui-iconfont-info confluence-information-macro-icon"></span>
{{% notice info%}}
You may not have an existing `~/.ssh/config.` If not, simply create the You may not have an existing `~/.ssh/config.` If not, simply create the
file and set the permissions appropriately first: file and set the permissions appropriately first:
`touch ~/.ssh/config && chmod 600 ~/.ssh/config` `touch ~/.ssh/config && chmod 600 ~/.ssh/config`
{{% /notice %}}
This will enable connection reuse when connecting to any host via SSH or This will enable connection reuse when connecting to any host via SSH or
SCP. SCP.
Document generated by Confluence on Oct 24, 2018 14:47
[Atlassian](http://www.atlassian.com/)
+++
title = "Using NU's Gitlab instance"
description = "How to use the NU-hosted git.unl.edu"
weight = "40"
+++
[Git](http://git-scm.com) is a free
and open source distributed version control system designed to handle
everything from small to very large projects with speed and efficiency.
Users are encouraged to make use of git for source code management of
their projects.
[GitLab](https://about.gitlab.com) is a web-based Git repository manager
with wiki and issue tracking features. NU OneIT hosts an instance of
GitLab at https://git.unl.edu,
which can be accessed using credentials from any campus participating in
the InCommon federation. This includes UNL, UNO, and UNMC, as well as
most major US Universities. Using a service such as GitLab provides several
additional advantages over a simple repository, including collaboration, repository
management, issue tracking, and code review.
To get started, go to [git.unl.edu](https://git.unl.edu). Click the "Sign in with Shibboleth" button.
{{< figure src="/images/11304982.png" height="400" >}}
This will take you to the InCommon site to select your school,
organization, etc. You may wish to choose the "Remember my selection
permanently" option to bypass this step in the future.
{{< figure src="/images/11304983.png" height="400" >}}
Next, scroll through to find your particular institution. For example, for UNL users, select "University
of Nebraska-Lincoln".
{{< figure src="/images/11304984.png" height="400" >}}
After you click "Next", you will be redirected to your particular
institution or campus's login page. Complete the login to proceed to
your account's Dashboard page and begin using GitLab.
For more information on using GitLab on the HCC Clusters, see [Setting up GitLab on HCC Clusters]({{< relref "setting_up_gitlab_on_hcc_clusters" >}}).
See [Getting Started with Git and GitLab](https://about.gitlab.com/2014/02/26/getting-started-with-gitlab) or
the full GitLab [documentation](http://doc.gitlab.com/ce/) for additional help.
1. [HCC-DOCS](index.html) +++
2. [HCC-DOCS Home](HCC-DOCS-Home_327685.html) title = "Setting up GitLab on HCC Clusters"
3. [HCC Documentation](HCC-Documentation_332651.html) description = "How to use git.unl.edu from HCC machines"
4. [Quick Start Guides](Quick-Start-Guides_1245279.html) +++
5. [Using UNL's GitLab instance](11304962.html)
<span id="title-text"> HCC-DOCS : Setting up GitLab on HCC Clusters </span> The easiest way to use GitLab on HCC clusters is by adding SSH keys to your account.
===========================================================================
Created by <span class="author"> Carrie Brown</span>, last modified on {{% notice info %}}
May 30, 2017 These steps must be repeated for each cluster that you wish to use the service on.
{{% /notice %}}
The easiest way to use GitLab on HCC clusters is by adding SSH keys to After you have [setup your GitLab account]({{< relref "../using_nus_gitlab_instance">}}), follow these
your account.
<span
class="aui-icon aui-icon-small aui-iconfont-info confluence-information-macro-icon"></span>
These steps must be repeated for each cluster that you wish to use the
service on.
After you have [setup your GitLab account](11304962.html), follow these
steps to add SSH keys to your account: steps to add SSH keys to your account:
1. Login to the cluster that you wish to set up GitLab access on. 1. Login to the cluster that you wish to set up GitLab access on.
2. Check for an existing key by typing the command: 2. Check for an existing key by typing the command:
``` syntaxhighlighter-pre {{< highlight bash >}}
cat ~/.ssh/id_rsa.pub cat ~/.ssh/id_rsa.pub
``` {{< /highlight >}}
If you see a long string of characters starting with \`ssh-rsa\` If you see a long string of characters starting with `ssh-rsa`
then you can skip step 3 and proceed directly to step 4. then you can skip step 3 and proceed directly to step 4.
3. Generate an SSH Key pair with the command below, replacing 3. Generate an SSH Key pair with the command below, replacing
**your\_email\_here** with the email you used to login to GitLab: **your\_email\_here** with the email you used to login to GitLab:
``` syntaxhighlighter-pre {{< highlight bash >}}
ssh-keygen -t rsa -C "your_email_here" ssh-keygen -t rsa -C "your_email_here"
``` {{< /highlight >}}
This command will prompt you for a location and filename to store This command will prompt you for a location and filename to store
the key pair and for a password. When prompted for the location and the key pair and for a password. When prompted for the location and
...@@ -52,15 +42,15 @@ steps to add SSH keys to your account: ...@@ -52,15 +42,15 @@ steps to add SSH keys to your account:
If you want to change the password of your key later, you can use If you want to change the password of your key later, you can use
the following command: the following command:
``` syntaxhighlighter-pre {{< highlight bash >}}
ssh-keygen -p <keyname> ssh-keygen -p <keyname>
``` {{< /highlight >}}
4. Retrieve your public key with the command: 4. Retrieve your public key with the command:
``` syntaxhighlighter-pre {{< highlight bash >}}
cat ~/.ssh/id_rsa.pub cat ~/.ssh/id_rsa.pub
``` {{< /highlight >}}
Copy all the text after the command (starting with ssh-rsa) to but Copy all the text after the command (starting with ssh-rsa) to but
not including the next prompt (ending with your email address). not including the next prompt (ending with your email address).
...@@ -70,11 +60,11 @@ steps to add SSH keys to your account: ...@@ -70,11 +60,11 @@ steps to add SSH keys to your account:
to your profile icon in the top right corner. Click on Profile to your profile icon in the top right corner. Click on Profile
Settings. Settings.
<span {{< figure src="/images/18548051.png" height="250" >}}
class="confluence-embedded-file-wrapper image-center-wrapper confluence-embedded-manual-size"><img src="assets/images/18548049/18548051.png" class="confluence-embedded-image image-center" height="250" /></span>
Then click SSH Keys from the top menu. Then click SSH Keys from the top menu.
<span
class="confluence-embedded-file-wrapper image-center-wrapper confluence-embedded-manual-size"><img src="assets/images/18548049/18548052.png" class="confluence-embedded-image image-center" width="1100" /></span> {{< figure src="/images/18548052.png" width="1100" >}}
Paste your copied key into the Key box. The Title box will Paste your copied key into the Key box. The Title box will
automatically populate with your email. You can accept this title or automatically populate with your email. You can accept this title or
...@@ -82,33 +72,10 @@ steps to add SSH keys to your account: ...@@ -82,33 +72,10 @@ steps to add SSH keys to your account:
the cluster name to the title so you can easily identify what key is the cluster name to the title so you can easily identify what key is
associated with a particular machine. associated with a particular machine.
<span {{< figure src="/images/18548053.png" height="400" >}}
class="confluence-embedded-file-wrapper image-center-wrapper confluence-embedded-manual-size"><img src="assets/images/18548049/18548053.png" class="confluence-embedded-image image-center" height="400" /></span>Click
the Add Key button to save the key to your account. Click the Add Key button to save the key to your account.
Now you can clone and push repositories as usual. When pushing to an Now you can clone and push repositories as usual. When pushing to an
existing repository, you will be prompted for the passkey associated existing repository, you will be prompted for the passkey associated
with the keys (if you added one). with the keys (if you added one).
Attachments:
------------
<img src="assets/images/icons/bullet_blue.gif" width="8" height="8" />
[image2017-5-30\_12-43-20.png](attachments/18548049/18548051.png)
(image/png)
<img src="assets/images/icons/bullet_blue.gif" width="8" height="8" />
[image2017-5-30\_12-46-11.png](attachments/18548049/18548052.png)
(image/png)
<img src="assets/images/icons/bullet_blue.gif" width="8" height="8" />
[image2017-5-30\_12-49-51.png](attachments/18548049/18548053.png)
(image/png)
Document generated by Confluence on Oct 24, 2018 14:47
[Atlassian](http://www.atlassian.com/)
1. [HCC-DOCS](index.html)
2. [HCC-DOCS Home](HCC-DOCS-Home_327685.html)
3. [HCC Documentation](HCC-Documentation_332651.html)
4. [Quick Start Guides](Quick-Start-Guides_1245279.html)
<span id="title-text"> HCC-DOCS : Using UNL's GitLab instance </span>
=====================================================================
Created by <span class="author"> Adam Caprez</span>, last modified by
<span class="editor"> Carrie Brown</span> on May 30, 2017
<a href="http://git-scm.com/" class="external-link">Git</a> is a free
and open source distributed version control system designed to handle
everything from small to very large projects with speed and efficiency.
Users are encouraged to make use of git for source code management of
their projects.
<a href="https://about.gitlab.com/" class="external-link">GitLab</a><span
style="line-height: 1.4285715;"> </span><span
style="line-height: 1.4285715;"> is a web-based Git repository manager
with wiki and issue tracking features. UNL ITS hosts an instance of
GitLab at
</span><a href="https://git.unl.edu" class="external-link">git.unl.edu</a>,
which can be accessed using credentials from any campus participating in
the InCommon federation<span style="line-height: 1.4285715;">. This
includes UNL, UNO, and UNMC, as well as most major US Universities.
Using a service such as GitLab provides several additional advantages
over a </span>simple repository<span
style="line-height: 1.4285715;"> including collaboration, repository
management, issue tracking, and code review. </span>
To get started, go
to <a href="https://git.unl.edu" class="external-link">git.unl.edu</a>.
Click the "Sign in with Shibboleth" button.
<span
class="confluence-embedded-file-wrapper image-center-wrapper confluence-embedded-manual-size"><img src="assets/images/11304962/11304982.png" class="confluence-embedded-image image-center" height="400" /></span>
This will take you to the InCommon site to select your school,
organization, etc. You may wish to choose the "Remember my selection
permanently" option to bypass this step in the future.
<span
class="confluence-embedded-file-wrapper image-center-wrapper confluence-embedded-manual-size"><img src="assets/images/11304962/11304983.png" class="confluence-embedded-image image-center" height="400" /></span>
<span style="line-height: 1.4285715;">Next, scroll through to find your
particular institution. For example, for UNL users, select "University
of Nebraska-Lincoln".</span>
<span
class="confluence-embedded-file-wrapper image-center-wrapper confluence-embedded-manual-size"><img src="assets/images/11304962/11304984.png" class="confluence-embedded-image image-center" height="400" /></span>
After you click "Next", you will be redirected to your particular
institution or campus's login page. Complete the login to proceed to
your account's Dashboard page and begin using GitLab.
For more information on using GitLab on the HCC Clusters, see [Setting
up GitLab on HCC
Clusters](Setting-up-GitLab-on-HCC-Clusters_18548049.html).
See <a href="https://about.gitlab.com/2014/02/26/getting-started-with-gitlab/" class="external-link">Getting Started with Git and GitLab</a> or
the full
GitLab <a href="http://doc.gitlab.com/ce/" class="external-link">documentation</a> for
additional help.
Attachments:
------------
<img src="assets/images/icons/bullet_blue.gif" width="8" height="8" />
[signin\_1.png](attachments/11304962/11304982.png) (image/png)
<img src="assets/images/icons/bullet_blue.gif" width="8" height="8" />
[signin\_2.png](attachments/11304962/11304983.png) (image/png)
<img src="assets/images/icons/bullet_blue.gif" width="8" height="8" />
[signin\_3.png](attachments/11304962/11304984.png) (image/png)
Document generated by Confluence on Oct 24, 2018 14:47
[Atlassian](http://www.atlassian.com/)
File added
static/images/11304982.png

109 KiB

static/images/11304983.png

244 KiB

static/images/11304984.png

434 KiB

static/images/11637368.jpg

47 KiB

static/images/11637369.jpg

47 KiB

static/images/11637370.png

16.1 KiB

static/images/11637371.jpg

47 KiB

static/images/11637372.png

19.6 KiB

0% Loading or .
You are about to add 0 people to the discussion. Proceed with caution.
Please register or to comment