Welcome to the [email protected] Virtual Machine JupyterLab

Where is this JupyterLab running?

      This JupyterLab instance is running on a virtual machine on the HDF-Cloud. It is started as a Docker Container.

How do I stop this JupyterLab?

      You can stop this JupyterLab in the Control Panel of [email protected]
      You can reach the Control Panel here or in the menu File -> Hub Control Panel.

How can I upload files to JupyterLab?

      You can use git or you upload files with this button in the top left corner:

      Upload files

How can I download a file from JupyterLab?

      Just right click on a file and click "Download".

What kind of Docker Images do we support?

      You can select between these eight Images.
      We installed additionally a few JupyterLab extensions.
      If you want to add your own Docker Image to [email protected] please contact the [email protected] support.

How much disk space do I have?

      You can store 10 GB of data in /home/jovyan/work.
      All files in the ~/work directory will be stored persistently.
      Any other files or directories will be deleted if you stop this JupyterLab.
      Under no circumstances are we liable for any lost data.

Collaborative work

      We offer four different solutions to share your work with your colleagues.

GIT

      You can use the git command in a terminal to work on any git repositories.

Projects

      Projects are the best way, if you just want to share a few files (or notebooks) with your colleague, that is also using [email protected]
      Projects are directories, that are generated on the virtual machine where your JupyterLab is running.
      If you add another user to your project this directory will be mounted into their Docker Container .
      You can manage your projects with the following command:

  $ bash /home/jovyan/manage_projects.sh

      You can store up to 10 GB of data on all your projects combined.
      If you want to add users to your project you need their email address. It must be the same email address, that is connected to their JSC webservice credentials .

B2DROP

      You can easily mount your B2DROP files into this JupyterLab.
      Just run the command mount B2DROP in a terminal and insert your application credentials.
      If you want to store your application credentials add the following line to /home/jovyan/work/.davfs2/secrets:
            https://b2drop.eudat.eu/remote.php/webdav \ \
      To unmount it run umount B2DROP

HPCMOUNT

      You can mount your files on the HPC system with sshfs .
      For this we created the script at /home/jovyan/mount_hpc.sh .
      To mount your HPC files just execute

$ bash /home/jovyan/mount_hpc.sh

    What will the script do?

            If you run it for the first time, it will create a private/public key pair for you. For your safety, a passphrase is required for this key.
            Afterward, it will upload the public key to your JUDAC ~/.ssh/authorized_keys file. This will be done with UNICORE and the credentials you used to log in to [email protected]
            If your key is uploaded (or you have already used this script before) it will run the sshfs command to mount your HPC files.
            You have to enter your passphrase, that you chose in the first run, to use your generated private key.

    How can I unmount it?

            Just run the command
                        $ fusermount -u /home/jovyan/HPCMOUNT

            The folder will be automatically unmounted if you stop this JupyterLab.

    Where is my private key stored?

            The private key will be stored, like your other files, in the /home/jovyan/work directory, on a virtual machine on the HDF-Cloud .
            The access to this virtual machine is limited to the administrators of [email protected]
            Since your private key is encrypted with a passphrase, even an administrator is not able to use your private key to connect to any HPC system.

    I want to mount another account

            If you have multiple accounts (connected to your JSC webservice credentials) you can tell the script which one it should use.
                        $ bash /home/jovyan/mount_hpc.sh <SYSTEM> <ACCOUNT>

            \ is the HPC system that is used to upload your public key. Please use one of these: JURECA, JUWELS, JURON. Your account must have an active project on the chosen system.
            \ is your HPC account on this system ( and on JUDAC) .

    I want to delete the public key from my HPC account

            [email protected] does not delete anything from your authorized_keys file. So if you want to remove the public key you have to log in to JUDAC and remove it manually.