Démarrer en 5 minutes

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.

1. Obtenir un compte

Envoyez un mail à Hélène Toussaint (helene.toussaint -AT- uca.fr) ou Raphaël Amato (raphael.amato -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.

2. Se connecter au cluster

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.

Le frontal sert uniquement à se connecter, lancer les jobs et créer des images apptainer quand nécessaire, il n'est pas dimensionné pour supporter des calculs. Les calculs doivent passer par SLURM (étapes suivantes).

3. Copier votre programme sur le cluster

Copiez votre programme dans votre répertoire sur le cluster. Le plus simple est de monter ce répertoire sur votre PC (voir accès fichiers sshfs) : vous pouvez alors y copier vos fichiers comme dans n'importe quel dossier.

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

4. Écrire le script du job

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. SLURM propose de nombreuses options pour choisir les ressources de votre job (nombre de CPU, mémoire, durée, nœud…). Ici, pour faire simple, on garde les options par défaut.

À 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 (pour choisir le nœud, voir les options de sbatch) ;
avec les ressources par défaut : 1 CPU, 2 Go de mémoire, et 7 jours maximum avant que le job soit arrêté (voir la configuration du cluster).

5. Lancer le job

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

6. Suivre le job

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

7. Récupérer le résultat

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, par exemple depuis votre PC si vous avez monté votre répertoire.

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

Et après ?

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.
Jobs de plus de 7 jours ou très gourmands : partitions.
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.