Deepak: new

2026-04-20T06:25:54Z

new

New page

{{DISPLAYTITLE:Getting Started — Magus02 HPC}}
<div style="background:#0d1b2a;border:1px solid #1e3a5a;border-radius:8px;padding:12px 18px;margin-bottom:20px;font-size:13px;font-family:monospace;color:#5ba3d9;">
📍 [[Magus02/Knowledge_Base|Magus02 Knowledge Base]] → Basics → Getting Started
</div>

This guide walks you through the essential steps to start using the Magus02 HPC cluster — from getting access all the way to running your first batch job.

__TOC__

== Access — How to get a Magus02 account ==

To use Magus02, you need an account provisioned by the HPC Administration Team. Depending on your role:

* '''Students / Research Scholars:''' Request an account through your supervisor or PI. The PI submits an access request to the HPC admin team.
* '''Faculty:''' Contact the HPC admin team directly at <code>hpc-admin@snu.edu.in</code>.
* '''External collaborators:''' Require a formal request letter from a SNU faculty sponsor.

Once your account is created, you will receive a welcome email with your username and initial password. You should [[Magus02|reset your password]] on first login.

<div style="background:#2a1a00;border-left:4px solid #f0c040;border-radius:6px;padding:14px 18px;margin:16px 0;font-size:14px;color:#d4b870;">
⚠️ <strong>VPN Required for Off-Campus Access:</strong> Magus02 login nodes are only directly reachable from within the SNU campus network. If you are working remotely, you must first connect to the SNU VPN. Contact the HPC admin to obtain VPN credentials.
</div>

== Login — How to connect to Magus02 ==

Magus02 uses [[Magus02/SSH|SSH]] (Secure Shell) for all user logins. Connect to the login nodes — not the compute nodes directly.

=== From Linux / macOS ===

Open a terminal and run:

<pre>
$ ssh your_username@magus02.snu.edu.in
</pre>

On first login, you will be prompted to verify the host key fingerprint. Type <code>yes</code> to accept.

=== From Windows ===

Use one of the following free SSH clients:

{| class="wikitable" style="width:100%;"
|-
! Client !! Description !! Download
|-
| '''PuTTY''' || Classic SSH client, widely used || [https://putty.org putty.org]
|-
| '''MobaXterm''' || SSH + X11 + file browser in one || [https://mobaxterm.mobatek.net mobaxterm.mobatek.net]
|-
| '''Windows Terminal / cmd''' || Built-in since Windows 10 1709 — just run <code>ssh</code> || Built-in
|}

Enter <code>magus02.snu.edu.in</code> as the hostname and port <code>22</code>.

=== For graphical applications (X11) ===

If you need to run GUI tools remotely, enable X11 forwarding:

<pre>
$ ssh -X your_username@magus02.snu.edu.in
</pre>

See the full [[Magus02/SSH|SSH guide]] for more details including key-based authentication.

== File Transfer — Moving data onto / off the cluster ==

You cannot run jobs from your local machine — files must be on the cluster's filesystem. Use one of these methods:

* '''<code>scp</code>''' — for individual files (built into Linux/macOS/Windows 10+)
* '''<code>rsync</code>''' — for syncing directories efficiently
* '''WinSCP''' or '''FileZilla''' — graphical clients for Windows users

Quick example with <code>scp</code>:

<pre>
# Upload a file to your home directory on Magus02:
$ scp myinput.dat your_username@magus02.snu.edu.in:~/

# Download results back to your local machine:
$ scp your_username@magus02.snu.edu.in:~/results/output.log ./
</pre>

See the full [[Magus02/File_Transfer|File Transfer guide]] for rsync usage and graphical client setup.

== Scheduler — How to run programs on the cluster ==

On Magus02, you cannot run compute-intensive programs directly on the login nodes. All production work must be submitted as '''batch jobs''' to the [[Magus02/Scheduling_Basics|Slurm scheduler]], which manages the queue and allocates resources on compute nodes.

The basic workflow is:

# Write a '''jobscript''' — a shell script that specifies resource requirements and the commands to run
# Submit it with <code>sbatch</code>
# Monitor with <code>squeue</code>
# Retrieve results from your output files

A minimal Slurm jobscript looks like:

<pre>
#!/bin/bash
#SBATCH --job-name=my_first_job
#SBATCH --partition=small
#SBATCH --nodes=1
#SBATCH --ntasks=8
#SBATCH --mem=32G
#SBATCH --time=01:00:00
#SBATCH --output=job_%j.out
#SBATCH --error=job_%j.err

# Load required modules
module purge
module load intel/oneapi mpi/intelmpi

# Run your program
./my_program input.dat
</pre>

Submit it with:

<pre>
$ sbatch my_jobscript.sh
Submitted batch job 12345
</pre>

→ See [[Magus02/Scheduling_Basics|Scheduling Basics]] and [[Magus02/Batch_Scheduler|Batch Scheduler]] for full details on queues, job types, and resource requests.

== Modules — Using pre-installed software ==

Magus02 uses the [[Magus02/Modules|Environment Modules]] system to manage software. Rather than installing everything yourself, you load the version you need:

<pre>
$ module avail # list all available software
$ module load intel/oneapi # load Intel compilers
$ module list # check what is currently loaded
$ module unload intel/oneapi # unload a module
$ module purge # unload everything
</pre>

→ See [[Magus02/Modules|Environment Modules]] for full documentation.

== Parallel Programming — Using multiple cores ==

Most HPC workloads are designed to run in parallel across many CPU cores or nodes. Magus02 supports two primary paradigms:

* '''[[Magus02/OpenMP_Usage|OpenMP]]''' — shared-memory parallelism within a single node (multithreading)
* '''[[Magus02/MPI_Usage|MPI]]''' — distributed-memory parallelism across multiple nodes (message passing)

Hybrid jobs using both OpenMP and MPI simultaneously are also supported.

== Useful Starting Points ==

* [[Magus02/Shell|Linux Shell Quick Reference]] — basic commands you'll use every day
* [[Magus02/FAQ_Batch_Jobs|FAQ: Batch Jobs]] — troubleshooting common Slurm issues
* [[Magus02|Magus02 Main Page]] — full cluster specs, queue structure, and applications

<div style="background:#0d1a2a;border-left:4px solid #00c9ff;border-radius:6px;padding:14px 18px;margin:20px 0;font-size:14px;color:#94a8be;">
💡 <strong>Tip:</strong> Always use <code>module purge</code> at the start of your jobscripts to ensure a clean environment. Jobs that rely on modules loaded interactively can fail unpredictably. See [[Magus02/FAQ_Batch_Jobs|FAQ: Batch Jobs]] for more.
</div>

----
<div style="font-family:monospace;font-size:11px;color:#484f58;text-align:right;">
[[Magus02/Knowledge_Base|↑ Back to Knowledge Base]] · Maintained by HPC Administration · wiki.snu.edu.in
</div>

Magus02/Getting Started - Revision history

Deepak: new