Accéder à eXplor-v2
Deux méthodes permettent d’accéder à eXplor-v2 :
| Méthode | À privilégier pour |
|---|---|
| SSH | Le terminal, les transferts de fichiers, la compilation, les scripts et la soumission de jobs |
| Open OnDemand | L’accès depuis un navigateur, les terminaux web, les notebooks et les applications interactives |
Les deux méthodes utilisent votre compte et donnent accès aux ressources gérées par SLURM.
Vous devez disposer d’un compte actif, être rattaché à un projet eXplor-v2 et avoir l’accès réseau requis au mésocentre.
Connexion par SSH
La connexion SSH passe par le bastion :
login.explor.univ-lorraine.fr
Le service ballast vous oriente ensuite vers un serveur de connexion (login) disponible. Pour configurer SSH, vous devez vérifier l’accès au bastion, installer votre clé publique, puis créer des alias SSH.
Vérifier l’accès au bastion
Depuis un terminal sur votre poste :
ssh <login-UL>@login.explor.univ-lorraine.fr
Remplacez <login-UL> par votre identifiant universitaire ou votre identifiant de compte invité. Utilisez votre mot de passe habituel de l’Université de Lorraine.
Si la connexion échoue, contactez le support avant de poursuivre.
Créer ou réutiliser une clé SSH
Si vous n’avez pas déjà de clé Ed25519, créez-en une :
ssh-keygen -t ed25519 -C "Acces eXplor"
Acceptez l’emplacement proposé et définissez une phrase secrète. La commande crée deux fichiers :
~/.ssh/id_ed25519 # clé privée
~/.ssh/id_ed25519.pub # clé publique
Ne transmettez jamais ~/.ssh/id_ed25519. Seule la clé publique (~/.ssh/id_ed25519.pub) peut être copiée sur le bastion.
Si vous avez déjà une clé Ed25519, vous pouvez la réutiliser. Vous devrez alors indiquer son chemin dans la configuration SSH ci-dessous.
Installer la clé publique
Copiez la clé publique sur le bastion :
ssh-copy-id -i ~/.ssh/id_ed25519.pub <login-UL>@login.explor.univ-lorraine.fr
Saisissez votre mot de passe lorsque le serveur le demande, puis vérifiez la connexion :
ssh <login-UL>@login.explor.univ-lorraine.fr
Après vérification, quittez la session :
exit
Configurer les alias SSH
Créez le répertoire SSH avec les permissions appropriées :
mkdir -p ~/.ssh
chmod 700 ~/.ssh
Ouvrez ou créez le fichier de configuration :
nano ~/.ssh/config
Ajoutez les blocs suivants en remplaçant <login-UL> par votre identifiant :
Host explor
User <login-UL>
IdentityFile ~/.ssh/id_ed25519
IdentitiesOnly yes
ProxyCommand ssh -oCompression=no <login-UL>@login.explor.univ-lorraine.fr /usr/local/bin/ballast login
HostKeyAlias login
HostbasedAuthentication no
Host explor-last
User <login-UL>
IdentityFile ~/.ssh/id_ed25519
IdentitiesOnly yes
ProxyCommand ssh -oCompression=no <login-UL>@login.explor.univ-lorraine.fr /usr/local/bin/ballast login-last
HostKeyAlias login
HostbasedAuthentication no
IdentitiesOnly yes demande au client SSH d’utiliser la clé indiquée, plutôt que d’essayer toutes les clés disponibles dans l’agent SSH.
Protégez le fichier :
chmod 600 ~/.ssh/config
Se connecter
Pour demander une connexion à un serveur login disponible :
ssh explor
Pour tenter de retrouver le serveur associé à votre dernière session :
ssh explor-last
Si la dernière session n’est plus disponible, utilisez ssh explor.
Lors de la première connexion, SSH peut demander de confirmer l’empreinte du serveur. Vérifiez l’empreinte communiquée par l’équipe d’administration avant de l’accepter. En cas de changement inattendu d’empreinte, contactez le support.
Vérifier la session
Une fois connecté, vérifiez votre compte et le serveur utilisé :
whoami
id
groups
hostname
pwd
Pour afficher les informations du système :
cat /etc/os-release
Le système d’exploitation attendu sur eXplor-v2 est Rocky Linux 9.8.
Accès à vos projets
Les variables de stockage sont configurées automatiquement à la connexion. Pour les afficher :
echo "HOME: ${HOME:-non défini}"
echo "SCRATCHDIR: ${SCRATCHDIR:-non défini}"
echo "PROJECTS: ${PROJECTS:-aucun projet disponible}"
echo "PROJECT: ${PROJECT:-aucun projet sélectionné}"
Si vous appartenez à plusieurs projets, utilisez cproj pour afficher les projets disponibles et sélectionner celui que vous souhaitez utiliser :
cproj
cproj project1
La sélection vous place dans le répertoire du projet et définit $PROJECT. Par exemple :
echo "$PROJECT"
pwd
/project/project1
/project/project1
Utilisez le répertoire du projet pour les données partagées avec les autres membres. Pour plus d’informations sur les espaces de stockage, consultez Espaces de stockage.
Connexion avec Open OnDemand
Open OnDemand est le portail web d’eXplor-v2. Il permet d’utiliser des terminaux, des notebooks et des applications interactives depuis un navigateur, sans installer de client SSH.
Ouvrir le portail Open OnDemand
Se connecter au portail
- Ouvrez le portail Open OnDemand dans un navigateur récent.
- Connectez-vous avec votre compte universitaire ou votre compte invité.
- Choisissez le service ou l’application souhaité.
Les comptes invités doivent être actifs et rattachés à un projet validé.
Applications interactives
Selon la configuration du portail, les applications disponibles peuvent inclure des terminaux, JupyterLab, VS Code, Relion ou des outils de visualisation.
Pour lancer une application, choisissez les ressources demandées dans le formulaire, puis soumettez la session. Open OnDemand demande à SLURM de démarrer cette session sur un nœud de calcul ; elle peut attendre dans la file d’attente, comme tout autre job. [147]
Fermez les sessions lorsque vous avez terminé. Une session encore active peut continuer à réserver des ressources jusqu’à sa fin ou à l’expiration de sa durée.
Consultez la section Services pour connaître les applications disponibles et leur utilisation.
Accéder à un nœud de calcul
Ne vous connectez pas directement à un nœud de calcul par SSH, sauf si une procédure d’administration ou de support vous y autorise.
Depuis une session SSH, demandez une allocation SLURM pour obtenir un terminal interactif :
salloc \
--partition=std \
--ntasks=1 \
--cpus-per-task=2 \
--time=00:15:00
Puis lancez un shell sur le nœud alloué :
srun --pty bash
Vérifiez le nœud obtenu :
hostname
Avec Open OnDemand, utilisez un terminal ou une application interactive configurée pour demander une allocation SLURM.
Pour plus d’informations, consultez Jobs interactifs.
Transférer des fichiers
Les alias SSH peuvent être utilisés avec scp et rsync.
Copier un fichier vers votre répertoire personnel :
scp fichier.txt explor:"\$HOME/"
Copier un fichier depuis eXplor-v2 vers votre poste :
scp explor:"\$HOME/fichier.txt" .
Copier un répertoire avec rsync :
rsync -avh --progress ./mon-projet/ explor:"\$HOME/mon-projet/"
Vous pouvez aussi utiliser l’explorateur de fichiers Files d’Open OnDemand. Consultez Transférer des données pour les autres méthodes et recommandations.
Dépannage
La connexion affiche Permission denied
Vérifiez que votre identifiant est correct, que votre compte est actif et que votre clé publique a bien été installée sur le bastion. Vérifiez d’abord la connexion directe :
ssh <login-UL>@login.explor.univ-lorraine.fr
Pour obtenir davantage de détails sur l’authentification :
ssh -vvv explor
SSH n’utilise pas la bonne clé
Vérifiez que les fichiers existent :
ls -l ~/.ssh/id_ed25519 ~/.ssh/id_ed25519.pub
Affichez la configuration effective de l’alias :
ssh -G explor | grep -E 'user|identityfile|proxycommand|hostkeyalias'
Le nom du bastion ne se résout pas
Vérifiez la résolution DNS :
getent hosts login.explor.univ-lorraine.fr
Vérifiez également votre connexion réseau et l’éventuelle nécessité d’un VPN.
L’empreinte SSH a changé
N’acceptez pas automatiquement une empreinte différente de celle enregistrée précédemment. Contactez le support pour vérifier le changement.
explor-last ne fonctionne pas
La dernière session peut ne plus être disponible. Essayez :
ssh explor
Open OnDemand ne démarre pas une application
Vérifiez le statut de la session et le message d’erreur affiché par le portail. Si un job SLURM a été créé, communiquez son identifiant au support.