Cette page donne la marche à suivre pour lancer rapidement votre premier calcul sur le cluster. Pour une utilisation optimale de la plateforme, il est conseillé de lire également les pages listées en bas de cette page.

Envoyez un mail à Hélène Toussaint (helene.toussaint -AT- uca.fr).

Une fois votre compte ouvert :

• si vous êtes membre de l'UCA, vous vous connectez avec vos identifiants UCA (ceux de l'ENT) ;
• sinon, vous recevez un identifiant par mail.

Si vous n'êtes pas dans le bâtiment ISIMA, connectez-vous d'abord au VPN (voir installation du VPN).

Connectez-vous ensuite en ssh sur le frontal frontalhpc2025. Dans un terminal de votre PC, tapez :

ssh login@frontalhpc2025

Remplacez login par votre identifiant. Sous Windows, utilisez un logiciel comme MobaXterm (voir accès aux serveurs).

Une fois connecté, toutes les commandes des étapes suivantes se tapent dans ce terminal, sur le frontal.

Copiez votre programme dans votre répertoire sur le cluster. La méthode dépend de votre système (Windows, macOS ou Linux) : voir transférer ses fichiers.

Vos fichiers sont accessibles depuis tous les nœuds de calcul.

Sur le cluster, les calculs ne sont pas lancés directement : ils passent par SLURM, l'outil qui répartit les calculs des utilisateurs sur les nœuds de calcul.

À côté de votre programme, créez le fichier mon_job.sh avec ce contenu :

mon_job.sh

#!/bin/bash
 
./mon_exe

Remplacez ./mon_exe par la commande qui lance votre programme (avec ses paramètres d'entrée si elle en a).

C'est le script minimal pour lancer un job. Votre programme sera exécuté :

• sur un nœud de calcul choisi par SLURM,
• avec les ressources par défaut : 1 CPU, 2 Go de mémoire, et 7 jours maximum avant que le job soit arrêté.

Pour choisir vous-même les ressources allouées à votre job, ajoutez des lignes #SBATCH au début du script. Voici les options les plus utiles :

mon_job.sh

#!/bin/bash
#SBATCH --time=1-00:00:00         # durée maximale : jours-heures:minutes:secondes
#SBATCH --mem=8G                  # mémoire allouée au job
#SBATCH --cpus-per-task=4         # nombre de cœurs alloués au job
 
./mon_exe

SLURM alloue les ressources demandées. Attention si vous dépassez la mémoire ou le temps demandé, le job est automatiquement tué.

Pour comprendre le fonctionnement de SLURM et savoir quelles options sont les plus pertinentes pour votre job, il est recommandé de lire découverte de SLURM.

Votre programme nécessite des bibliothèques non installées sur le cluster ? Voir Apptainer.

Depuis le répertoire où se trouve mon_job.sh, dans le terminal, tapez :

sbatch mon_job.sh

Le terminal affiche le numéro de votre job :

Submitted batch job 123456

Pour voir les jobs, dans le terminal, tapez :

squeue

La colonne ST indique l'état du job :

• PD : en attente de ressources,
• R : en cours d'exécution.

Quand le job est terminé, il disparaît de la liste.

Pour arrêter un job, dans le terminal, tapez (en remplaçant 123456 par le numéro de votre job) :

scancel 123456

Tout ce que votre programme affiche (messages et erreurs) est écrit dans le fichier slurm-123456.out, dans le répertoire d'où vous avez lancé sbatch. Vous pouvez l'ouvrir comme n'importe quel fichier texte.

C'est tout ! Vous savez lancer un calcul sur le cluster.

• Lisez les bonnes pratiques avant de lancer de gros calculs.
• Comprendre le fonctionnement de SLURM : découverte de SLURM.
• Plusieurs CPU, plus de mémoire, un nœud particulier : options de sbatch.
• Lancer le même programme sur beaucoup d'instances : tableaux de jobs.
• Tester ou compiler sur un nœud de calcul : shell interactif.
• Un logiciel ou une bibliothèque manque : Apptainer, Python.
• Un job ne démarre pas ou s'arrête : erreurs classiques.