Jupyter notebooks

Les Jupyter notebooks sont une application web open-source qui vous permettent de créer et de partager des documents qui contiennent du code, des équations, des visualisations et du texte narratif. [1]

La documentation Compute Canada sur ces notebooks contient déjà beaucoup d'informations. Ici, nous expliquerons comment utiliser ces notebooks sur les serveurs de l'UNF.

Sur cette page, nous utiliserons le serveur elm. Les instructions restent les mêmes pour les autres serveurs comme jacaranda.

Installation de jupyter

Jupyter est un module python, il est uniquement nécessaire de l'installer sur le serveur. Cette étape est déjà faites pour vous. Vous devez vous connecter au serveur elm en ssh puis charger l'environnement python du laboratoire.

user@local:~ $ ssh <your-username>@elm.criugm.qc.ca
____________________________________/\\\\\_
 __________________________________/\\\///__
  _________________________________/\\\______
   __/\\\____/\\\__/\\/\\\\\\____/\\\\\\\\\___
    _\/\\\___\/\\\_\/\\\////\\\__\////\\\//____
     _\/\\\___\/\\\_\/\\\__\//\\\____\/\\\______
      _\/\\\___\/\\\_\/\\\___\/\\\____\/\\\______ 
       _\//\\\\\\\\\__\/\\\___\/\\\____\/\\\______
        __\/////////___\///____\///_____\///_______

        Bienvenue chez vous! 
        Pour toute question, adressez-vous à support.unf@criugm.qc.ca
user@elm:~ $ source /data/brambati/quarantine/python_virtualenv/lingualab_3.6/bin/activate
lingualab_3.6|user@elm:~ $

Démarrer un notebook

Si vous avez déjà utilisé les notebooks sur votre propre ordinateur, C'est la commande jupyter notebook que vous utilisez.

Dans le cas des serveurs UNF, un script (notebook.sh) est mis à votre disposition.

lingualab_3.6|user@elm:~ $ notebook.sh 
[I 15:09:29.790 NotebookApp] Serving notebooks from local directory: /home/user
[I 15:09:29.790 NotebookApp] The Jupyter Notebook is running at:
[I 15:09:29.790 NotebookApp] http://elm.criugm.qc.ca:8888/?token=<token>
[I 15:09:29.790 NotebookApp]  or http://127.0.0.1:8888/?token=<token>
[I 15:09:29.791 NotebookApp] Use Control-C to stop this server and shut down all kernels (twice to skip confirmation).
[C 15:09:29.871 NotebookApp] 

    To access the notebook, open this file in a browser:
        file:///home/user/.local/share/jupyter/runtime/nbserver-50048-open.html
    Or copy and paste one of these URLs:
        http://elm.criugm.qc.ca:8888/?token=<token>
     or http://127.0.0.1:8888/?token=<token>

Accéder au notebook

Si vous êtes au sein du centre de recherche, il vous suffit de suivre les instructions et copier-coller l'URL dans votre navigateur.

Si vous êtes à l'extérieur du bâtiment. Il est nécessaire de créer une connection sécurisée avec elm. La documentation de Compute Canada explique le processus. En suivant les instructions, il vous suffit de remplacer:

<cluster>.computecanada.ca par elm.criugm.qc.ca
cdr544.int.cedar.computecanada.ca par elm.criugm.qc.ca
<token> par votre propre token