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 :

ssh login@frontalhpc2025

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

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.

Créez, à côté de votre programme, un fichier mon_job.sh :

#!/bin/bash
 
./mon_exe

Remplacez ./mon_exe par la commande qui lance votre programme.

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 :

sbatch mon_job.sh

SLURM répond avec le numéro de votre job :

Submitted batch job 123456

6. Suivre le job

Pour voir vos jobs :

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 :

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.

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.