Workshops

Jupyter-JSC provides a dedicated endpoint to facilitate workshops through the Jupyter infrastructure.

Motivation

Organizing workshops can be a complex task. Instructors must coordinate participant access, prepare materials such as presentations and Jupyter notebooks, and ensure that all components run reliably for every participant. Due to the wide range of options available when starting a service, users may inadvertently select incorrect configurations, such as the wrong system, partition, kernel, or Docker image. These misconfigurations may not trigger immediate errors, but they can result in a non-functional or inconsistent runtime environment.

To address these challenges and streamline the workshop experience, we offer the ability to create a dedicated Workshop Website. This site allows instructors to define a controlled environment for their workshop, which can then be shared with participants.

Managing Workshops (for Instructors)

Instructors can visit the Workshop Manager Website to configure and manage their workshops.

https://jupyter.jsc.fz-juelich.de/workshopmanager

Each instructor can define a subset of configuration options that are permitted during the workshop. These settings are then made accessible to participants via a unique "Workshop Link." You may edit your workshop configuration at any time. Clicking "Create" (or "Share" for existing workshops) will provide you with a personalized link to distribute.

Workshop ID

By default, a randomly generated ID is assigned when a new workshop is created. This ID forms the URL for the workshop, such as:

https://jupyter.jsc.fz-juelich.de/workshops/id

If you prefer a custom identifier (e.g., myworkshop2025), please contact support to enable this feature for your account.

Description

Include a short description of your workshop. This will be displayed on the corresponding workshop page, helping users verify they are on the correct site.

Configuration Options

Each available option includes a checkbox. If a checkbox is not selected, users will retain access to all available values for that option. To restrict user selection, ensure the checkbox is checked and specify the allowed values.

For dropdown selections, multiple values may be chosen using CTRL+Click or SHIFT+Click. At least one value must be selected for the configuration to be valid. If multiple values are selected, a default value can be specified.

Input Fields

Input fields can be used to enforce specific values (e.g., setting the runtime to 30 minutes or nodes to 1). If the checkbox next to an input field is selected, the defined value will be enforced. If the checkbox is left unchecked, users may input their own value when starting a service.

Expert Mode

Instructors who are part of the Workshop Instructor group gain access to additional features, such as:

Creating custom workshop IDs
Activating Expert Mode during workshop creation

Expert Mode enables the selection of multiple services and systems. However, this mode is disabled by default, as it introduces a higher risk of invalid configurations. For instance, selecting both JURECA and JUWELS as systems, but allowing only the partition dc-cpu (which is not available on JUWELS), will result in an unusable setup.

To join the Workshop Instructor group contact support.

Workshop Website

User Account is Ready for the Workshop

If a user account has the necessary access permissions, the workshop website will resemble the regular configuration interface. However, only the options pre-defined by the instructor will be available for selection.

User Account is Not Ready for the Workshop

If the workshop requires access to HPC systems, user authorization is managed via JuDoor. If a participant lacks access to the necessary system, project, or partition, the workshop website will display guidance and troubleshooting documentation.

In case of uncertainties, participants are encouraged to contact their workshop instructor or use the Support button located in the website footer.

Example of a user account without the necessary permissions: https://jupyter.jsc.fz-juelich.de/workshops/systemunavailable