Poudlard

# Guide de l'utilisateur

{{>toc}}

## Obtenir un compte utilisateur

L'inscription à Poudlard est automatique. Nos services vous contracterons directement par hibou pour vous informer des démarches pour démarrer votre scolarité.

## Description de la machine

Voir: [[Wiki#Présentation-de-la-machine-Poudlard|Présentation de la machine Poudlard]]

## Se connecter à Poudlard

### Se connecter depuis Linux

Pour accéder aux nœuds frontaux du cluster depuis un Unix:

```

ssh user_name@poudlard.mcia.fr

```

### Se connecter depuis Windows

Pour se connecter de Windows au serveur Poudlard vous aurez besoin d'un serveur client ssh. Si vous ne l'aviez pas encore installé sur votre machine, un utilitaire possible est PuTTY, et pour ceux qui ont besoin de lancer des applications graphiques installées sur Poudlard (éditeurs, logiciels, ... etc), ils peuvent installer et configurer un X serveur sous Windows. *Xming* fera l'affaire utilisé avec *PuTTY*.

- Qu'est ce que *PuTTY* ?

 *PuTTY* est un client SSH sous Windows qui vous permet de se connecter et utiliser un terminal comme sous Linux. téléchargeable [ici](http://www.clubic.com/telecharger-fiche10874-putty.html)

- Qu'est ce que *Xming* ?

 *Xming* est un serveur X open-source sous Windows. autrement dit c'est un portage sous Windows du système de fenêtrage X des systèmes Unix, Linux et BSD. Il permet ainsi de rediriger l'affichage sous Windows d'une application graphique tournant sur une machine distante, sous un autre système supporté par X.org. téléchargeable  [ici](http://www.clubic.com/lancer-le-telechargement-202646-0-xming.html).

 Si vous voulez utiliser juste la ligne de commande en mode texte, vous n'aurez pas besoin de cette utilitaire. 

- Installation de *PuTTY* et *Xming*

 Lancer une installation par défaut des deux utilitaires sur votre machine, et créer un raccourci sur le bureau pour chacun des deux. A noter que *Xming* doit être lancé en premier pour que *PuTTY* le prenne en compte.

- Configuration de *PuTTY* et *Xming*

  - Etape 1 : Entrer dans cette case le nom du serveur Poudlard: poudlard.mcia.fr et laisser le port 22 par défaut.

  - Etape 2 : Sélectionner le protocole SSH.

  - Etape 3 : Entrer votre login pour cette session (ou le nom qui vous chante pour se rappeler de votre session et la sauvegarder pour une ultérieure connexion).

  - Etape 4 : Si vous voulez activer le serveur X, cliquer sur l'item [-]SSH dans la fenêtre à gauche de *PuTTY* et sélectionner X11.

Après avoir coché la case "Enable X11 Forwarding", aller en haut de la fenêtre à gauche et cliquer sur "Session logging", vous aurez une fenêtre comme dans l'étape *1*.

- .

  - Etape 5 : Cliquer sur le bouton "Save", pour enregistrer le hostname et les changements effectués, cela crée un raccourci pour les futurs connexions.

  - Etape 6 : Cliquer sur "Open".

  - Etape 7 : Cliquer sur "Yes" dans la fenêtre qui apparait.

- .

  - Etape 8 : Entrer votre `<user_name>`.

  - Etape 9 : Quand vous verrez `<user_name>@poudlard.mcia.fr's password`: Entrer votre mot de passe.

## Accéder à poudlard par un montage (sshfs)

Le traitement des données directement Poudlard puise dans les ressources des serveurs frontaux. La visualisation graphique est, entre autre, assez gourmande et peu se révéler peu fluide en raison de la quantité de données à transférer pour construire les images 3D. Pour contourner ce problème, il est possible avec la commande *sshfs* d'accéder à ses fichiers sur Poudlard comme n'importe quel autre fichier sur sa machine en faisant un montage. De cette manière vous pouvez utiliser tous les programmes disponibles sur votre machine pour traiter les fichiers situés sur Poudlard. La seule limitation est la vitesse de la connexion, cependant une fois que les données sont lues le programme s'exécutant sur votre machine locale ce n'est plus un problème.

La procédure à suivre pour monter un dossier est la suivante 

- Créer un dossier qui servira de point de montage. Ce dossier contiendra vos fichiers sur Poudlard (créer ce point de montage sur votre machine local et pas sur Poudlard).

```bash

mkdir $HOME/poudlard

```

- Exécuter la commande suivante pour accéder à votre `$HOME` ou `$SCRATCH`. Il faudra remplacer _user_ par votre nom d'utilisateur sur poudlard.

```bash

# pour acceder a votre $HOME (à exécuter depuis votre machine local et pas sur Poudlard)

sshfs user@poudlard.mcia.fr:/nfs/home/user $HOME/poudlard

# pour acceder a votre $SCRATCH

sshfs user@poudlard.mcia.fr:/scratch/user $HOME/poudlard

```

Suite à cette commande, via le dossier `$HOME/poudlard` de votre machine vous aurez accès aux fichiers sur Poudlard comme s'ils étaient sur votre machine. 

Pour démonter le lien vers poudlard : 

```bash

fusermount -u $HOME/poudlard

```

Comme pour `scp`, il existe une option `-C` pour activer la compression.

## Calculer sur le cluster

Il n'est pas autorisé de se connecter directement aux ressources de calcul du cluster (ssh par exemple). Afin d'y accéder, on doit demander une réservation au système de [[Wiki#Gestionnaire-de-travaux|gestion de travaux]]. Ce système se charge donc de réserver pour une durée déterminée les ressources nécessaires au travail décrit par l'utilisateur. Cette description est fournie par l'utilisateur au moyen d'un script. Ce script contient à la fois:

- l'enchaînement des tâches à effectuer pour exécuter le travail (des commandes shell, en général)

- une description des ressources et du contexte du travail (voir la syntaxe particulière du [[Wiki#Gestionnaire-de-travaux|gestionnaire de travaux]])

Une fois soumis avec la commande appropriée, ce script devient un _job_ qui va être ordonnancé et finalement lancé sur les ressources spécifiées dès que celles-ci sont libres.

## Obtenir de l'aide

Pour résoudre vos problèmes sur le cluster Poudlard, vous pouvez:

1. consulter la [[FAQ]]

2. Déposer une [demande d'assistance](https://gazette-du-sorcier.mcia.fr/projects/cluster-poudlard/issues/new) (connexion avec vos identifiants Poudlard).