Difference between revisions of "New user training"

From UFRC
Jump to navigation Jump to search
 
(50 intermediate revisions by 8 users not shown)
Line 1: Line 1:
[[File:MyTraining.jpg|frameless|right|link=https://mytraining-ufshands.sumtotal.host/Core/pillarRedirect?relyingParty=LM&url=core%2Factivitydetails%2FViewActivityDetails%3FActivityId%3D50413%26UserMode%3D0]] This page mirrors and expands upon the content provided in the [https://mytraining-ufshands.sumtotal.host/Core/pillarRedirect?relyingParty=LM&url=core%2Factivitydetails%2FViewActivityDetails%3FActivityId%3D50413%26UserMode%3D0 HiPerGator Account Training module in myTraining]. This is myTraining course code UF_ITT423_OLT, called "HiPerGator Account Training".
+
{|align=right
 +
  |__TOC__
 +
  |}
 +
This page mirrors and expands upon the content provided in the '''[https://coursera.org/groups/hipergator-account-training-as15p/invitation HiPerGator Account Training in Coursera]'''. This is a private course, only accessible by the link above; it will ''not'' appear in a search on Coursera. '''You will need a Coursera account. Unfortunately, you cannot log in to Coursera with your GatorLink.'''
  
'''Note:''' While this page mirrors the content, '''to get credit for taking the training, you must complete the training and pass the assessment on the [https://mytraining-ufshands.sumtotal.host/Core/pillarRedirect?relyingParty=LM&url=core%2Factivitydetails%2FViewActivityDetails%3FActivityId%3D50413%26UserMode%3D0 myTraining site]'''
+
{{Note|While this page mirrors the content, you must complete the training and pass the final quiz in the Coursera course to get credit for taking the training.|warn}}
  
Effective January 11th, 2021, this raining module is required for all new account holders to obtain an account. New accounts will not be created until the myTraining system records successful completion of the training.
+
Effective January 11th, 2021, this training module is required for all new account holders to obtain an account. New accounts will not be created until Coursera successfully completes the training.
  
 
==Training Objectives==
 
==Training Objectives==
# Recognize the role of Research Computing, utilize HiPerGator as a research tool and select appropriate resource allocations for analyses
+
# Recognize the role of Research Computing, utilize HiPerGator as a research tool, and select appropriate resource allocations for analyses
 
# Login to HiPerGator using an ssh client
 
# Login to HiPerGator using an ssh client
# Describe appropriate use of the login servers and how to request resources for work beyond those limits
+
# Describe the appropriate use of the login servers and how to request resources for work beyond those limits
 
# Describe HiPerGator's three main storage systems and the appropriate use for each
 
# Describe HiPerGator's three main storage systems and the appropriate use for each
 
# Use the module system for loading application environments
 
# Use the module system for loading application environments
Line 19: Line 22:
  
 
===HiPerGator===
 
===HiPerGator===
* About 60,000 cores [[File:Hpg3-rc-header.png|300px|right|text-top|alt="A row of HiPerGator 3 compute node racks"]]
+
* About 70,000 cores [[File:Hpg3-rc-header.png|300px|right|text-top|alt="A row of HiPerGator 3 compute node racks"]]
 
* Hundreds of GPUs
 
* Hundreds of GPUs
 
* 10 Petabytes of storage
 
* 10 Petabytes of storage
Line 26: Line 29:
 
** 17,000 AMD Rome Epyc Cores
 
** 17,000 AMD Rome Epyc Cores
  
For additional information visit our website: https://www.rc.ufl.edu/
+
For additional information, visit our website: https://www.rc.ufl.edu/
  
 
The [https://www.rc.ufl.edu/about/cluster-history/ Cluster History page] has updated information on the current and historical hardware at Research Computing.
 
The [https://www.rc.ufl.edu/about/cluster-history/ Cluster History page] has updated information on the current and historical hardware at Research Computing.
  
'''Summary:''' HiPerGator is a large, high-performance compute cluster capable of tackling some of the largest computational challenges, but users need to understand how to responsibly and efficiently use the resources.
+
{{Note|'''Summary:''' HiPerGator is a large, high-performance compute cluster capable of tackling some of the largest computational challenges, but users need to understand how to responsibly and efficiently use the resources.|note}}
  
 
===Investor Supported===
 
===Investor Supported===
Line 44: Line 47:
  
 
Investments can either be '''hardware''' investments, lasting for 5-years or '''service''' investments lasting 3-months or longer.
 
Investments can either be '''hardware''' investments, lasting for 5-years or '''service''' investments lasting 3-months or longer.
* Price sheets are located here: https://www.rc.ufl.edu/services/rates/
+
* Price sheets are located here: https://www.rc.ufl.edu/get-started/price-list/
* Submit a purchase request here: https://www.rc.ufl.edu/services/purchase-request/
+
* Submit a purchase request for:
 +
** [https://gravity.rc.ufl.edu/access/purchase-request/hpg-hardware/ Hardware (5-years)]
 +
** [https://gravity.rc.ufl.edu/access/purchase-request/hpg-service/ Services (3-months to longer)]
 
* For a full explanation of services offered by Research Computing, see: https://www.rc.ufl.edu/services/
 
* For a full explanation of services offered by Research Computing, see: https://www.rc.ufl.edu/services/
  
 
----
 
  
 
==Module 2: How to Access and Run Jobs==
 
==Module 2: How to Access and Run Jobs==
Line 59: Line 62:
  
 
===Accessing HiPerGator===
 
===Accessing HiPerGator===
* [[Training#Connecting_to_HiPerGator|ssh to host hpg.rc.ufl.edu]]
+
* [[Training Videos#Connecting_to_HiPerGator|ssh to host hpg.rc.ufl.edu]]
** [[File:Play_icon.png|frameless|30px|link=https://mediasite.video.ufl.edu/Mediasite/Play/0b238bfffb684fd6b7306129af63a6711d]][https://mediasite.video.ufl.edu/Mediasite/Play/0b238bfffb684fd6b7306129af63a6711d Watch a video on connecting from MacOS.]
+
** [[File:Play_icon.png|frameless|30px|link=https://mediasite.video.ufl.edu/Mediasite/Play/89b780ef71094f568a6c091953445ff31d]][https://mediasite.video.ufl.edu/Mediasite/Play/89b780ef71094f568a6c091953445ff31d Watch a video on connecting from MacOS.]
** [[File:Play_icon.png|frameless|30px|link=https://mediasite.video.ufl.edu/Mediasite/Play/2bf4c860f19b48a593fb581018b813a11d]][https://mediasite.video.ufl.edu/Mediasite/Play/2bf4c860f19b48a593fb581018b813a11d Watch a video on connecting from Windows.]
+
** [[File:Play_icon.png|frameless|30px|link=https://mediasite.video.ufl.edu/Mediasite/Play/227c2cae1147422c91afff28435a51ac1d]][https://mediasite.video.ufl.edu/Mediasite/Play/227c2cae1147422c91afff28435a51ac1d Watch a video on connecting from Windows.]
  
 
* [https://jhub.rc.ufl.edu/ jhub.rc.ufl.edu] (requires UF Network)
 
* [https://jhub.rc.ufl.edu/ jhub.rc.ufl.edu] (requires UF Network)
** See also [[File:Play_icon.png|frameless|30px|link=Training#Using_Jupyter_Notebooks_on_HiPerGator]][[Training#Using_Jupyter_Notebooks_on_HiPerGator|overview video]].
+
** See also [[File:Play_icon.png|frameless|30px|link=https://mediasite.video.ufl.edu/Mediasite/Play/8efcf534ef3c408e9238d8deeeda083a1d]][[https://mediasite.video.ufl.edu/Mediasite/Play/8efcf534ef3c408e9238d8deeeda083a1d|overview video]].
 
* [https://galaxy.rc.ufl.edu/ galaxy.rc.ufl.edu]  
 
* [https://galaxy.rc.ufl.edu/ galaxy.rc.ufl.edu]  
 
* Open on Demand: [https://ood.rc.ufl.edu/ ood.rc.ufl.edu] (requires UF Network)
 
* Open on Demand: [https://ood.rc.ufl.edu/ ood.rc.ufl.edu] (requires UF Network)
** See also [[File:Play_icon.png|frameless|30px|link=Training#Using_Open_on_Demand_on_HiPerGator|]][[Training#Using_Open_on_Demand_on_HiPerGator|overview video]].
+
** See also [[File:Play_icon.png|frameless|30px|link=https://mediasite.video.ufl.edu/Mediasite/Play/4654bfa838624de894085bf54678848f1d|]][[https://mediasite.video.ufl.edu/Mediasite/Play/4654bfa838624de894085bf54678848f1d|overview video]].
  
 
===Proper use of Login Nodes===
 
===Proper use of Login Nodes===
Line 76: Line 79:
 
See [[Development_and_Testing|more information here]].
 
See [[Development_and_Testing|more information here]].
  
Acceptable use limits:
+
{{Note|
 +
Login server acceptable use limits:
  
 
* No more than '''16-cores'''
 
* No more than '''16-cores'''
 
* No longer than '''10 minutes (wall time)'''
 
* No longer than '''10 minutes (wall time)'''
* No more than '''64 GB of RAM'''
+
* No more than '''64 GB of RAM'''|warn}}
  
 
===Resources for Scheduling a Job===
 
===Resources for Scheduling a Job===
Line 100: Line 104:
 
# Request those resources:
 
# Request those resources:
 
#* [[Sample SLURM Scripts|See sample job scripts]]
 
#* [[Sample SLURM Scripts|See sample job scripts]]
#* Watch the HiPerGator: SLURM Submission Scripts training video. This video is approximately 30 minutes and includes a demonstration [[File:Play_icon.png|frameless|30px|link=https://training.it.ufl.edu/training/items/hipergator-slurm-submission-scripts.html]]
+
#* Watch the HiPerGator: SLURM Submission Scripts training video. This video is approximately 35 minutes and includes a demonstration [[File:Play_icon.png|frameless|30px|link=https://mediasite.video.ufl.edu/Mediasite/Play/3fe6e15428ad401e97afa093252e0e151d]]
#* Watch the HiPerGator: SLURM Submission Scripts for MPI Jobs training video. This video is approximately 26 minutes and includes a demonstration [[File:Play_icon.png|frameless|30px|link=https://training.it.ufl.edu/training/items/hipergator-slurm-scripts-for-mpi-jobs.html]]
+
#* Watch the HiPerGator: SLURM Submission Scripts for MPI Jobs training video. This video is approximately 25 minutes and includes a demonstration [[File:Play_icon.png|frameless|30px|link=https://mediasite.video.ufl.edu/Mediasite/Play/9d09e1dda67a4993b1877b33e40b30b51d]]
 
#* Open on Demand, JupyterHub and Galaxy all have other mechanisms to request resources as SLURM needs this information to schedule your job.
 
#* Open on Demand, JupyterHub and Galaxy all have other mechanisms to request resources as SLURM needs this information to schedule your job.
 
# Submit the Job
 
# Submit the Job
Line 110: Line 114:
  
  
----
+
==Module 3: HiPerGator Storage and the Module System for Applications==
==Module 3: HiPerGator Storage==
+
 
===Three Locations for Storage===
+
===Locations for Storage===
 
The storage systems are [[Storage|reviewed on this page]].  [[File:BlueStorageRacks.JPG|250px|right|text-top|alt="Photo of the Blue storage racks"]]
 
The storage systems are [[Storage|reviewed on this page]].  [[File:BlueStorageRacks.JPG|250px|right|text-top|alt="Photo of the Blue storage racks"]]
  
Line 129: Line 133:
 
#*'''Not''' intended for large I/O for jobs
 
#*'''Not''' intended for large I/O for jobs
 
#*Primarily for archival purposes
 
#*Primarily for archival purposes
 +
# Red Storage: <code>/red/<group></code>
 +
#*All flash parallel filesystem primarily for HiPerGator AI
 +
#*Space allocated based on need
 +
#*Scratch filesystem with data regularly deleted
  
 
===Backup and Quotas===
 
===Backup and Quotas===
 
[[File:No backup.png|noboarder|right|150px]]
 
[[File:No backup.png|noboarder|right|150px]]
* Unless purchased separately, '''nothing''' is backed up on HiPerGator!!
+
{{Note|Unless purchased separately, '''nothing''' is backed up on HiPerGator!!|error}}
  
** [https://www.rc.ufl.edu/services/procedures/storage/protection/ This page describes the tape backup options and costs].
+
* [https://www.rc.ufl.edu/documentation/procedures/storage/data-protection/ This page describes the tape backup options and costs].
 
* Orange and Blue storage quotas are at the group level and based on investment.
 
* Orange and Blue storage quotas are at the group level and based on investment.
 
** See [https://www.rc.ufl.edu/services/rates/ price sheets]
 
** See [https://www.rc.ufl.edu/services/rates/ price sheets]
 
** [https://www.rc.ufl.edu/services/purchase-request/ Submit a purchase request]
 
** [https://www.rc.ufl.edu/services/purchase-request/ Submit a purchase request]
 +
** The <code>blue_quota</code> and <code>orange_quota</code> commands will show your group's current quota and use.
 +
** The <code>home_quota</code> command will show you home directory quota and use.
  
 
===Directories===
 
===Directories===
[[File:Automount.gif|300px|frame|This gif shows how an <code>ls</code> in <code>/blue</code> does not show the group directory for <code>ufhpc</code>. After a <code>cd</code> into the directory, and back out, it does show. This shows how the directory is automounted on access. Of course, it would be easier to just go directly without stopping in <code>/blue</code> first.|right|text-top|alt="A gif showing how a directory is automounted upon access."]]
+
[[File:Automount.gif|275px|frame|This gif shows how an <code>ls</code> in <code>/blue</code> does not show the group directory for <code>ufhpc</code>. After a <code>cd</code> into the directory, and back out, it does show. This shows how the directory is automounted on access. Of course, it would be easier to just go directly without stopping in <code>/blue</code> first.|right|text-top|alt="A gif showing how a directory is automounted upon access."]]
 +
{{Note|
 
* Directories on the Orange and Blue filesystems are automounted--they are only added when accessed.
 
* Directories on the Orange and Blue filesystems are automounted--they are only added when accessed.
 
* Your group's directory may not appear until you access it.
 
* Your group's directory may not appear until you access it.
 +
* Do not remove files necessary for your account to function normally, such as the ~/.ssh and /home directories.|warn}}
 +
 
* '''Remember'''
 
* '''Remember'''
 
** Directories may not show up in an <code>ls</code> of <code>/blue</code> or <code>/orange</code>
 
** Directories may not show up in an <code>ls</code> of <code>/blue</code> or <code>/orange</code>
Line 159: Line 172:
  
  
----
+
==Module 4: Common Mistakes and Getting Support==
==Module 4: Common User Mistakes and How to Avoid Them==
+
 
# Running resource intensive applications on the login nodes
+
===Common Mistakes===
 +
# Running resource intensive applications on the login nodes is against HPG usage policy. Learn more at [[HPC Computation]]. To avoid involuntary policy violation, we recommend to run computational processes using either of the following methods:
 
#*Submit a batch job: see [[Sample SLURM Scripts|Sample Slurm Scripts]]
 
#*Submit a batch job: see [[Sample SLURM Scripts|Sample Slurm Scripts]]
 
#*Request a development session for [[Development and Testing|testing and development]]
 
#*Request a development session for [[Development and Testing|testing and development]]
 
# Writing to <code>/home</code> during batch job execution
 
# Writing to <code>/home</code> during batch job execution
#*Use <code>/blue/<group></code> for job input/output. See [[Storage]].
+
#*Use <code>/blue/<group></code> for job input/output. See [[Storage]] and [[Conda]].
 
#Wasting resources
 
#Wasting resources
 
#*Understand CPU and memory needs of your application
 
#*Understand CPU and memory needs of your application
Line 176: Line 190:
 
#*Each group has specific limits
 
#*Each group has specific limits
 
#*Burst jobs are run as idle resources are available
 
#*Burst jobs are run as idle resources are available
#**The [[Account_and_QOS_limits_under_SLURM#Choosing_QOS_for_a_Job|<code>slurmInfo</code>]] command in the [[UFRC_environment_module|ufrc module]] can show your group's investment and current use.
+
#**The [[Account_and_QOS_limits_under_SLURM#Choosing_QOS_for_a_Job|<code>slurmInfo</code>]] command can show your group's investment and current use as well as HPG cluster utilization.
 +
#When using our Python environment modules, attempting to install new Python packages may not work because incompatible packages may get installed into the ~/.local folder and result in errors at run time. If you need to install packages, create a personal or project-specific [[Conda]] environment or request the addition of new packages in existing environment modules via the [https://support.rc.ufl.edu RC Support System].
  
 
+
===How to get Help===
----
+
See the [[FAQ]] page for these and more hints, answers, and potential pitfalls that you may want to avoid.
==Module 5: How to get Help==
+
See the [[Get Help]] page for more details. In general,
* Submit support requests at: https://support.rc.ufl.edu/
+
* Submit support requests via the [https://support.rc.ufl.edu/ UFRC Support System]
 
* For problems with running jobs, provide:
 
* For problems with running jobs, provide:
 
**JobID number(s)
 
**JobID number(s)
**Path(s) to job scripts and output
+
**Filesystem path(s) to job scripts and job logs
 
**As much detailed information as you can about your problem
 
**As much detailed information as you can about your problem
 
*For requests to install an application, provide:
 
*For requests to install an application, provide:
Line 190: Line 205:
 
** URL to download the application
 
** URL to download the application
  
 +
==Additional information for students using the cluster for courses==
  
----
+
The instructor will provide a list of students enrolled in the course
==Additional information for students using the cluster for courses==
+
Course group names will be in the format <code>pre1234</code> with the 3-letter department prefix and 4-digits course code.
 +
* All sections of a course will typically use the same group name, so the name may be different from the specific course you are enrolled in.
 +
* In the documentation below, substitute the generic <code>pre1234</code> with your particular group name.
 +
Students who do not have a HiPerGator Account will have one created for them
 +
Students who already have a HiPerGator Account will be added to the course group (as a secondary group)
 +
* You can create a folder in the class's <code>/blue/pre1234</code> folder with your GatorLink username
 +
* To use the resources of the class rather than your primary group, use the <code>--account</code> and <code>--qos</code> flags, in the submit script, in the <code>sbatch</code> command or in the boxes in the Open on Demand interface.
 +
*# In your submit script, add these lines:<code><br>#SBATCH --account=pre1234<br>#SBATCH --qos=pre1234</code>
 +
*# In the <code>sbatch</code> command: <code>sbatch --account=pre1234 --qos=pre1234 my_script.sh</code>
 +
*# Using Open on Demand:[[File:OOD.account qos.screenshot.png|thumb|center|How to set account and qos options to use resources from a secondary group]]
 +
*#{{Note|JupyterHub can only use your primary group's resources and cannot be used for accessing secondary group resources. To use Jupyter using your secondary group, please use [[Jupyter|Open on Demand]].|warn}}
  
* The instructor will provide a list of students enrolled in the course
+
Using your account implies agreeing to the [https://www.rc.ufl.edu/about/procedures/ Acceptable use policy].
** Students who do not have a HiPerGator Account will have one created for them
+
Students understand that no restricted data should be used on HiPerGator
** Students who already have a HiPerGator Account will be added to the course group (as a secondary group)
+
Classes are typically allocate 32-cores, 112GB RAM and 2TB of storage
***You can create a folder in the class's <code>/blue</code> folder with your GatorLink username
+
* Instructors should keep this in mind when designing exercises and assignments
***To use the resources of the class rather than your primary group, load the class module: <code>module load class/pre1234</code> (where <code>pre</code> is the course prefix, and <code>1234</code> is the course number)
+
* Students should understand that these are shared resources: use them efficiently, share them fairly and know that if everyone waits until the last minute, there may not be enough resources to run all jobs.
* Using your account implies agreeing to the [https://www.rc.ufl.edu/about/procedures/ Acceptable use policy].
+
All storage should be used for research and coursework only.
* Students understand that no restricted data should be used on HiPerGator
+
Accounts created for the class and the contents of the class <code>/blue/pre1234</code> folder will be deleted at the end of the semester. Please copy anything you want to keep off of the cluster before the end of the semester.
* Classes are typically allocate 32-cores, 112GB RAM and 2TB of storage
+
Students should consult with their professor or TA rather than opening a support request.  
** Instructors should keep this in mind when designing exercises and assignments
+
* Only the professor or TA should open support requests if needed.
** Students should understand that these are shared resources: use them efficiently, share them fairly and know that if everyone waits until the last minute, there may not be enough resources to run all jobs.
 
* All storage should be used for research and coursework only.
 
* Accounts created for the class and the contents of the class <code>/blue</code> folder will be deleted at the end of the semester. Please copy anything you want to keep off of the cluster before the end of the semester.
 
* Students should consult with their professor or TA rather than opening a support request. Only the professor or TA should open support requests if needed.
 

Latest revision as of 13:57, 22 August 2024

This page mirrors and expands upon the content provided in the HiPerGator Account Training in Coursera. This is a private course, only accessible by the link above; it will not appear in a search on Coursera. You will need a Coursera account. Unfortunately, you cannot log in to Coursera with your GatorLink.

While this page mirrors the content, you must complete the training and pass the final quiz in the Coursera course to get credit for taking the training.

Effective January 11th, 2021, this training module is required for all new account holders to obtain an account. New accounts will not be created until Coursera successfully completes the training.

Training Objectives

  1. Recognize the role of Research Computing, utilize HiPerGator as a research tool, and select appropriate resource allocations for analyses
  2. Login to HiPerGator using an ssh client
  3. Describe the appropriate use of the login servers and how to request resources for work beyond those limits
  4. Describe HiPerGator's three main storage systems and the appropriate use for each
  5. Use the module system for loading application environments
  6. Locate where to receive user support
  7. Identify common user mistakes and how to avoid them.



Module 1: Introduction to Research Computing and HiPerGator

HiPerGator

  • About 70,000 cores
    "A row of HiPerGator 3 compute node racks"
  • Hundreds of GPUs
  • 10 Petabytes of storage
  • The HiPerGator AI cluster has
    "A photo of a row of HiPerGator AI servers"
    • 1,120 NVIDIA A100 GPUs
    • 17,000 AMD Rome Epyc Cores

For additional information, visit our website: https://www.rc.ufl.edu/

The Cluster History page has updated information on the current and historical hardware at Research Computing.

Summary: HiPerGator is a large, high-performance compute cluster capable of tackling some of the largest computational challenges, but users need to understand how to responsibly and efficiently use the resources.

Investor Supported

HiPerGator is heavily subsidized by the university, but we do require faculty researchers to make investments for access. Research Computing sell three main products:

  1. Compute: NCUs (Normalized Compute Units)
    "A composite image showing a CPU, a DDN storage cabinet and an NVIDIA A100 front plate"
    • 1 CPU core and 7.8 GB of RAM (updated Jan 2021)
  2. Storage:
    • Blue (/blue): High-performance storage for most data during analyses
    • Orange (/orange): Intended for archival use
  3. GPUs
    • Sold in units of GPU cards
    • NCU investment also required to make use of GPU

Investments can either be hardware investments, lasting for 5-years or service investments lasting 3-months or longer.


Module 2: How to Access and Run Jobs

Cluster Components

  1. Login servers
  2. SLURM Scheduler
  3. Compute Cluster

Accessing HiPerGator

Proper use of Login Nodes

  • Generally speaking, interactive work other than managing jobs and data is discouraged on the login nodes.
  • Login nodes are intended for file and job management, and short-duration testing and development.
"Acceptable login server use limits"

See more information here.

Login server acceptable use limits:

  • No more than 16-cores
  • No longer than 10 minutes (wall time)
  • No more than 64 GB of RAM

Resources for Scheduling a Job

For use beyond what is acceptable on the login servers, you can request resources on development servers, GPUs servers, through JupyterHub, Galaxy, Graphical User Interface servers via open on demand or submit batch jobs. All of these services work with the scheduler to allocate your requested resources so that your computations run efficiently and do not impact other users.

Scheduling a Job

  1. Understand the resources that your analysis will use:
    • CPUs: Can your job use multiple CPU cores? Does it scale?
    • Memory: How much RAM will it use? Requesting more will not make your job run faster!
    • GPUs: Does your application use GPUs?
    • Time: How long will it run?
  2. Request those resources:
    • See sample job scripts
    • Watch the HiPerGator: SLURM Submission Scripts training video. This video is approximately 35 minutes and includes a demonstration Play icon.png
    • Watch the HiPerGator: SLURM Submission Scripts for MPI Jobs training video. This video is approximately 25 minutes and includes a demonstration Play icon.png
    • Open on Demand, JupyterHub and Galaxy all have other mechanisms to request resources as SLURM needs this information to schedule your job.
  3. Submit the Job
    • Either using sbatch on the command line or through on of the interfaces
    • Once your job is submitted, SLURM will check that there are resources available in your group and schedule the job to run
  4. Run
    • SLURM will work through the queue and run your job


Module 3: HiPerGator Storage and the Module System for Applications

Locations for Storage

The storage systems are reviewed on this page.

"Photo of the Blue storage racks"

Note: In the examples below, the text in angled brackets (e.g. <user>) indicates example text for user-specific information (e.g. /home/albertgator).

  1. Home Storage: /home/<user>
    • Each user has 40GB of space
    • Good for scripts, code and compiled applications
    • Do not use for job input/output
    • Snapshots are available for seven days
  2. Blue Storage: /blue/<group>
    • Our highest-performance filesystem
    • All input/output from jobs should go here
  3. Orange Storage: /orange/<group>
    • Slower than /blue
    • Not intended for large I/O for jobs
    • Primarily for archival purposes
  4. Red Storage: /red/<group>
    • All flash parallel filesystem primarily for HiPerGator AI
    • Space allocated based on need
    • Scratch filesystem with data regularly deleted

Backup and Quotas

noboarder
Unless purchased separately, nothing is backed up on HiPerGator!!

Directories

"A gif showing how a directory is automounted upon access."
This gif shows how an ls in /blue does not show the group directory for ufhpc. After a cd into the directory, and back out, it does show. This shows how the directory is automounted on access. Of course, it would be easier to just go directly without stopping in /blue first.
  • Directories on the Orange and Blue filesystems are automounted--they are only added when accessed.
  • Your group's directory may not appear until you access it.
  • Do not remove files necessary for your account to function normally, such as the ~/.ssh and /home directories.
  • Remember
    • Directories may not show up in an ls of /blue or /orange
      • If you cd to /blue and type ls, you will likely not see your group directory. You also cannot tab-complete the path to your group's directory. However, if you add the name of the group directory (e.g. cd /blue/<group>/ the directory becomes available and tab-completion functions.
      • Of course, there is no need to change directories one step at a time...cd /blue/<group>, will get there in one command.
    • You may need to type the path in SFTP clients or Globus for your group directory to appear
    • You cannot always use tab completion in the shell

Environment Modules System

  • HiPerGator uses the lmod environment modules system to hide application installation complexity and make it easy to use the installed applications.
  • For applications, compilers or interpreters, load the corresponding module


Module 4: Common Mistakes and Getting Support

Common Mistakes

  1. Running resource intensive applications on the login nodes is against HPG usage policy. Learn more at HPC Computation. To avoid involuntary policy violation, we recommend to run computational processes using either of the following methods:
  2. Writing to /home during batch job execution
    • Use /blue/<group> for job input/output. See Storage and Conda.
  3. Wasting resources
    • Understand CPU and memory needs of your application
    • Over-requesting resources generally does not make your application run faster--it prevents other users from accessing resources.
  4. Blindly copying lab mate scripts
    • Make sure you understand what borrowed scripts do
    • Many users copy previous lab mate scripts, but do not understand the details
    • This often leads to wasted resources
  5. Misunderstanding the group investment limits and the burst QOS
    • Each group has specific limits
    • Burst jobs are run as idle resources are available
      • The slurmInfo command can show your group's investment and current use as well as HPG cluster utilization.
  6. When using our Python environment modules, attempting to install new Python packages may not work because incompatible packages may get installed into the ~/.local folder and result in errors at run time. If you need to install packages, create a personal or project-specific Conda environment or request the addition of new packages in existing environment modules via the RC Support System.

How to get Help

See the FAQ page for these and more hints, answers, and potential pitfalls that you may want to avoid. See the Get Help page for more details. In general,

  • Submit support requests via the UFRC Support System
  • For problems with running jobs, provide:
    • JobID number(s)
    • Filesystem path(s) to job scripts and job logs
    • As much detailed information as you can about your problem
  • For requests to install an application, provide:
    • Name of application
    • URL to download the application

Additional information for students using the cluster for courses

The instructor will provide a list of students enrolled in the course Course group names will be in the format pre1234 with the 3-letter department prefix and 4-digits course code.

  • All sections of a course will typically use the same group name, so the name may be different from the specific course you are enrolled in.
  • In the documentation below, substitute the generic pre1234 with your particular group name.

Students who do not have a HiPerGator Account will have one created for them Students who already have a HiPerGator Account will be added to the course group (as a secondary group)

  • You can create a folder in the class's /blue/pre1234 folder with your GatorLink username
  • To use the resources of the class rather than your primary group, use the --account and --qos flags, in the submit script, in the sbatch command or in the boxes in the Open on Demand interface.
    1. In your submit script, add these lines:
      #SBATCH --account=pre1234
      #SBATCH --qos=pre1234
    2. In the sbatch command: sbatch --account=pre1234 --qos=pre1234 my_script.sh
    3. Using Open on Demand:
      How to set account and qos options to use resources from a secondary group
    4. JupyterHub can only use your primary group's resources and cannot be used for accessing secondary group resources. To use Jupyter using your secondary group, please use Open on Demand.

Using your account implies agreeing to the Acceptable use policy. Students understand that no restricted data should be used on HiPerGator Classes are typically allocate 32-cores, 112GB RAM and 2TB of storage

  • Instructors should keep this in mind when designing exercises and assignments
  • Students should understand that these are shared resources: use them efficiently, share them fairly and know that if everyone waits until the last minute, there may not be enough resources to run all jobs.

All storage should be used for research and coursework only. Accounts created for the class and the contents of the class /blue/pre1234 folder will be deleted at the end of the semester. Please copy anything you want to keep off of the cluster before the end of the semester. Students should consult with their professor or TA rather than opening a support request.

  • Only the professor or TA should open support requests if needed.