All primary components in the Syntasa application, i.e. Apps, Dashboards, Notebooks, and the folders they are organized in, are found via the menu icon (
) then selecting Workspace. Within Workspace, you can traverse to Filters or Folders to find the notebook you're looking for.
The most common way to launch a notebook is by clicking on the notebook card. If you are Editing a Notebook there is also a Launch Notebook button. If you don't have an existing notebook or need to create a new one, then see the article on Creating a Notebook.
This article reviews the need-to-know basics when launching a notebook:
Starting the notebook
Launching a notebook will open a new browser tab and will take a few steps to load. You only need to wait a few seconds, no clicking necessary, to complete the startup actions within JupyterHub. These steps will look like the following:
If you are launching a notebook that has been shared with you, as opposed to being the owner, then you will also see the following loading screen. The Authorize button you do need to click.
Notebook basics
Once loaded, the notebook will look similar to the examples below. The information shown in the header and the first portion of the notebook will vary based on the attributes saved when the notebook was created and other configurations.
Language
The Language field in the header of the notebook screen reflects the programming language value set when Creating the Notebook. This value can be changed by Editing the Notebook, but the notebook itself needs to be refreshed for this change to take effect. Also, note that any code already written in the notebook will need to be refactored if changing the language of the notebook.
Runtime
Determining if and when you need to attach a runtime to your notebook is reviewed in the article Notebook Runtimes.
The Runtime Status field in the header of the notebook screen will appear if a runtime has been attached to the notebook. This notebook attribute is set when creating the notebook, but can also be altered within the notebook settings screen via the gear icon (
).
Within the settings screen, you can also stop and start the runtime that is attached to the notebook. Be aware, that during the selection of a runtime instance if a currently running runtime was selected, that stopping this runtime may disrupt other notebooks, if any, that are also connected to and using the runtime instance.
Reference Documents
The Reference Documents section seen at the top of the notebook is a configurable space, by a system administrator, to present any desired message, sample code, or links to documentation. If configured, all notebooks will be created with this section.