This is an old revision of the document!
Table of Contents
HPC Quick Start (15 Minutes)
This guide walks you through the basic HPC workflow:
- Connect to the HPC system
- Create a simple job script
- Submit your first job
- View the results
If you can complete this guide, you are ready to use the HPC cluster for your own workloads.
Before You Start
Make sure that:
- You have access to the HPC system.
- You have completed Registration.
- You have an SSH client installed.
Need access first?
Step 1: Connect to the Cluster
Open a terminal and connect to the login node:
ssh username@login.hpc.mif.vu.lt
Replace username with your HPC username.
After logging in, verify your current location:
pwd
You should be in your home directory.
For detailed connection instructions see:
Step 2: Create a Working Directory
Create a directory for this tutorial:
mkdir getting-started cd getting-started
Verify your location:
pwd
Step 3: Create a Simple Job Script
Create a file named hello.sh:
nano hello.sh
Paste the following content:
#!/bin/bash #SBATCH --job-name=hello #SBATCH --output=hello.out #SBATCH --time=00:01:00 echo "Hello from HPC!" hostname date
Save the file.
Make it executable:
chmod +x hello.sh
Step 4: Submit Your First Job
Submit the job to SLURM:
sbatch hello.sh
Example output:
Submitted batch job 12345
The number is your Job ID.
Step 5: Check Job Status
View your jobs:
squeue -u $USER
When the job disappears from the queue, it has finished.
Step 6: View the Results
Display the output file:
cat hello.out
Example output:
Hello from HPC! compute01 Mon Nov 17 14:32:05 EET 2026
Congratulations! You have successfully executed your first HPC job.
Useful Commands
| Command | Purpose |
|---|---|
pwd | Show current directory |
ls | List files |
cd | Change directory |
sbatch job.sh | Submit a job |
squeue -u $USER | View your jobs |
scancel JOBID | Cancel a job |
cat file | Display file contents |
Next Steps
Now that you can run jobs, learn how to:
Common Problems
Permission denied
Verify that your account has been activated and that you are using the correct username.
sbatch: command not found
Ensure you are connected to the HPC login node and not running commands locally.
Invalid account or account/partition combination specified
Your SLURM account may still be provisioning. Wait a few minutes after your first login and try again.
Job stays in PENDING state
Resources may currently be unavailable. Check the reason:
squeue -j JOBID
For more information see:
Where to Go Next
Recommended learning path:
