Skip to content
Snippets Groups Projects
Commit 2f4706e2 authored by Natasha Pavlovikj's avatar Natasha Pavlovikj
Browse files

Add class info

parent d27124e4
Branches
No related tags found
1 merge request!446Add class info
+++
title = "HCC Class Info for Instructors"
description = "Information for instructors teaching class using HCC resources"
weight = "95"
+++
The Holland Computing Center (HCC) provides high-performance computing resources for Universities and Colleges in the state of Nebraska. HCC supports both research and creative, and class activity.
This guide provides a list of useful links for classes utilizing HCC resources.
## Useful links for instructors
- Class group creation form, https://hcc.unl.edu/new-group-request
- Class group renewal form, https://hcc.unl.edu/class-renewal-request
- Link to HCC class policy page, https://hcc.unl.edu/hcc-policies#class-groups
## Useful notes for instructors
- Each student request to join the class HCC group needs to be approved by the instructor. To ease this process, you can send us roster of the class so we can create the accounts without further approval.
- Some classes may utilize custom conda environments. Some conda environments, especially the GPU-based ones, **can be very large and can easily exceed the available $HOME quotas** of 20GBs. To avoid this, **we recommend creating group-level custom conda environment**. If you are interested in this, please email hcc-support@unl.edu for further information.
- If data needs to be shared among all class members, please see https://hcc.unl.edu/docs/handling_data/swan_data_sharing/#using-group-level-shared-directory for best practices.
- Some instructors utilize the **command-line to access Swan** (https://hcc.unl.edu/docs/connecting/terminal/), while some instructors utilze the **HCC OnDemand web portal** (https://hcc.unl.edu/docs/open_ondemand/). The HCC OnDemand portal provides graphical interface to Swan, and includes many graphical applications such as JupyterLab, RStudio, Virtual Desktop, etc.
- We provide many software tools and packages as system-wide modules on Swan, https://hcc.unl.edu/docs/applications/modules/available_software_for_swan/. If you need Linux software package that is not currently available, you can request for it to be installed system-wide using the Software Install Request Form https://hcc.unl.edu/software-installation-request.
- You can request in-class HCC training/presentation, https://hcc.unl.edu/docs/faq/#can-hcc-provide-training-for-my-group.
- Creating and setting HCC accounts takes some time. **To motivate students to create HCC accounts before the training/assignments are due, some instructors make this process a graded assignment**.
- We would strongly recommend you to send Canvas announcement to your students with various useful links and information, especially if in-class HCC training/presentation is scheduled. You can use the template below, where you need to change `COURSE_GROUP` and the dates at the end. Please feel free to modify the template accordingly.
```
We will be utilizing the Holland Computing Center (HCC) for our course this semester and will be having a hands-on tutorial during the first few weeks of the semester.
To use these resources, you will need an account associated with HCC that is separate from your University of Nebraska account and credentials.
Below are links to get access to HCC resources specific for this class:
- If you already have an HCC account from a prior class or research, you can add the class group to your account or move your account to the COURSE_GROUP group: https://hcc.unl.edu/group-addchange-request.
- If you need an HCC account: https://hcc.unl.edu/new-user-request.
For more useful links and notes for students taking class using HCC resources, please see https://hcc.unl.edu/docs/faq/class_students.
While using HCC resources for this class, you will need to be aware of HCC's class account guidelines and center's policies: https://hcc.unl.edu/hcc-policies.
Pay special attention to the guidelines for class accounts since data is removed at the end of the semester: https://hcc.unl.edu/hcc-policies#class-groups.
**You will need to activate your DUO two factor for your HCC account in order to use the resources. Without this you will not have access!**
This will need completed by <INSERT DATE HERE> since we will have staff from HCC providing a tutorial on <INSERT DATE HERE>.
```
+++
title = "HCC Class Info for Students"
description = "Information for students taking class using HCC resources"
weight = "95"
+++
The Holland Computing Center (HCC) provides high-performance computing resources for Universities and Colleges in the state of Nebraska. HCC supports both research and creative, and class activity.
This guide provides a list of useful links for classes utilizing HCC resources.
## Useful links for students
### Account creation and setup
- New user account form, https://hcc.unl.edu/new-user-request/
- If you already have existing HCC account, use the Add/Change group request form instead, https://hcc.unl.edu/group-addchange-request
- How to activate HCC Duo, https://hcc.unl.edu/docs/accounts/setting_up_and_using_duo/
- How to reset your HCC password, https://hcc.unl.edu/docs/accounts/how_to_change_your_password/
- What are good HCC practices, https://hcc.unl.edu/docs/good_hcc_practices/
### Application links
- HCC Open OnDemand (OOD) web access to Swan, https://swan-ood.unl.edu/
- Detailed HCC Open OnDemand guide, https://hcc.unl.edu/docs/open_ondemand/
- Creating custom CPU/GPU conda environments, https://hcc.unl.edu/docs/applications/user_software/using_anaconda_package_manager/#creating-custom-anaconda-environments
- Various SLURM examples of applications that run on Swan, https://github.com/unlhcc/job-examples/
- How to share data across group members, https://hcc.unl.edu/docs/handling_data/swan_data_sharing/
### Training
- HCC info sheet, https://go.unl.edu/hcc_info_sheet
- HCC SLURM scheduler cheat sheet, https://go.unl.edu/hcc_slurm_cheatsheet
- Conda user cheat sheet, https://know.continuum.io/rs/387-XNW-688/images/conda-cheatsheet.pdf
- YouTube videos of previous HCC training events, https://www.youtube.com/@hollandcomputingcenter8962
- Upcoming HCC events, https://hcc.unl.edu/upcoming-events
### Support
- For issues related to classwork or assignments, **please contact your TA**.
- For general HCC issues, **please first check the FAQ page**, https://hcc.unl.edu/docs/faq/.
- For issues with HCC resources (e.g., unavailable resources, sudden errors and job failures), contact HCC support at hcc-support@unl.edu. **Please note that non-critical tickets/issues will be addressed during business hours (Monday through Friday, 9am-5pm CST).** Critical issues include, but not limited to, sudden unavailability to login and file-system irresponsiveness for all HCC users.
## Useful notes for students
- The **login node** is shared among all HCC users and it **should be used only for light tasks**, and not for running computationally intensive tasks. For any CPU or memory intensive operations, such as testing and running applications, one should use an interactive session (https://hcc.unl.edu/docs/submitting_jobs/creating_an_interactive_job/), or submit a job to the batch queue (https://hcc.unl.edu/docs/submitting_jobs/).
- If the Open OnDemand resources are not enough, you can run JupyterLab Notebooks within SLURM job, https://hcc.unl.edu/docs/applications/submitting_jupyter_code/running_jupyter_lab_code.
- Custom conda environments are created in $HOME by default. **You can change the location of the conda environment**, https://hcc.unl.edu/docs/applications/user_software/using_anaconda_package_manager/#using-common-for-environments/.
- Custom conda environments can easily fill the 20GBs quota on $HOME. **To clean space, you can remove unused Anaconda packages and caches**, https://hcc.unl.edu/docs/applications/user_software/using_anaconda_package_manager/#remove-unused-anaconda-packages-and-caches.
- Open OnDemand can not be launched and will show error **if your $HOME quota is exceeded**.
- If you are not sure if the storage utilization is causing issues for you, you can run `ncdu` (https://hcc.unl.edu/docs/faq/#how-can-i-check-which-directories-utilize-the-most-storage-on-swan) from the Swan terminal with the location in question.
0% Loading or .
You are about to add 0 people to the discussion. Proceed with caution.
Please register or to comment