Differences

This shows you the differences between two versions of the page.

Link to this comparison view

Both sides previous revisionPrevious revision
Next revision
Previous revision
en:services:application_services:jupyter:start [2023/03/30 16:16] – [Installing additional kernels in an Conda environment] bwegman1en:services:application_services:jupyter:start [2024/01/24 16:46] (current) – [Selecting a notebook image] bwegman1
Line 25: Line 25:
 Storage and calculation of notebooks happens server side, the client does not need to install any software or meet any other prerequisites other than having a fairly modern browser to work with. To log into the service a [[en:services:general_services:customer_portal:account_info|GWDG full account]] is required. Storage and calculation of notebooks happens server side, the client does not need to install any software or meet any other prerequisites other than having a fairly modern browser to work with. To log into the service a [[en:services:general_services:customer_portal:account_info|GWDG full account]] is required.
  
 +==== Selecting a notebook image ====
 +
 +After successfully logging in a selection screen appears with a choice of notebook images to start the notebook server with:
 +  * GWDG default image (based on jupyter/datascience-notebook)
 +      * This was also the default image in the past.
 +  * Python Stack w/ TensorFlow (jupyter/tensorflow-notebook)
 +  * Python and R Spark Jupyter Notebook (jupyter/all-pyspark-notebook)
 +  * Data Science Jupyter Notebook (jupyter/datascience-notebook)
 +
 +The notebook image provides the environment for the notebook server, in particular the pre-installed software.
 +While the GWDG default image is heavily extended from the regular data science notebook the regular notebooks from the Jupyter project may be preferable in some cases or provide a more specialized environment for a specific software set.
 +
 +Irrespective of the selected image the user's home directory and data remains the same.
 +
 +The notebook image can only be changed when the current notebook server is stopped and restarted. The server does not automatically stop when logging off or closing the browser, although this will cause it to timeout after a while and then stop. The server can be explicitly stopped from the menu File -> Hub Control Panel -> "Stop my server". This actually stops the running server which can then be restarted via "Start my server" and a new image can be selected.
 +
 +=== Changelog of notebook images ===
 +
 +A simple changelog with [[en:services:application_services:jupyter:version-history|changes]] to the "GWDG default image" is available.
 ==== Starting a notebook ==== ==== Starting a notebook ====
  
 After successful login at Jupyter-Hub there is a drop down menu at the top left corner. Under „File - New“ a new notebook can be created. Previously used notebooks and their files are listed on the left hand side. After successful login at Jupyter-Hub there is a drop down menu at the top left corner. Under „File - New“ a new notebook can be created. Previously used notebooks and their files are listed on the left hand side.
  
-Detailed informationen about the user interface: https://jupyterlab.readthedocs.io/en/stable/index.html +Detailed information about the user interface: https://jupyterlab.readthedocs.io/en/stable/index.html
  
 ==== Managing notebooks ==== ==== Managing notebooks ====
Line 48: Line 66:
   * <code bash> mv -v .local/ .local.gwdg-disable </code>   * <code bash> mv -v .local/ .local.gwdg-disable </code>
   * Restart notebook server: File - Hub Control Panel - Stop My Server   * Restart notebook server: File - Hub Control Panel - Stop My Server
 +
 +<WRAP info>
 +This action is also available through the selfservice portal: https://jupyter-cloud.gwdg.de/selfservice
 +</WRAP>
 ==== Installing additional python modules ==== ==== Installing additional python modules ====
 Additional Python modules can be installed via the terminal and the Python package manager "pip". To do this, a terminal must be opened via the menu "New" -> "Terminal". Afterwards <code>pip install --user <module></code> installs a new module in the home directory. Additional Python modules can be installed via the terminal and the Python package manager "pip". To do this, a terminal must be opened via the menu "New" -> "Terminal". Afterwards <code>pip install --user <module></code> installs a new module in the home directory.
Line 71: Line 93:
 mv -v .local/ .local.gwdg-disable mv -v .local/ .local.gwdg-disable
 </code> </code>
 +
 <WRAP tip> <WRAP tip>
 **mamba** is an alternative implementation of the **conda** package manager. They are interchangeable, it's use is recommended. **mamba** is an alternative implementation of the **conda** package manager. They are interchangeable, it's use is recommended.
 +https://github.com/mamba-org/mamba
 </WRAP> </WRAP>